Skip to content

Commit 7ea3229

Browse files
albertoabellagarciaalbertoabellagarcia
committed
Update IT
1 parent c28a942 commit 7ea3229

1 file changed

Lines changed: 108 additions & 69 deletions

File tree

‎OSMBuildingPart/doc/spec_IT.md‎

Lines changed: 108 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,77 @@
1-
<!-- 10-Header -->
2-
[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org)
3-
Entità: OSMBuildingPart
4-
=======================<!-- /10-Header -->
5-
<!-- 15-License -->
6-
[Open License](https://github.com/smart-data-models//dataModel.OpenStreetMap/blob/master/OSMBuildingPart/LICENSE.md)
7-
[document generated automatically](https://docs.google.com/presentation/d/e/2PACX-1vTs-Ng5dIAwkg91oTTUdt8ua7woBXhPnwavZ0FxgR8BsAI_Ek3C5q97Nd94HS8KhP-r_quD4H0fgyt3/pub?start=false&loop=false&delayms=3000#slide=id.gb715ace035_0_60)
8-
<!-- /15-License -->
9-
<!-- 20-Description -->
10-
Descrizione globale: **Una parte o sezione di un edificio di OpenStreetMap etichettata con building:part=*. Utilizzata per rappresentare edifici con altezze, forme del tetto o materiali variabili tra diverse sezioni, consentendo la visualizzazione 3D degli edifici (standard Simple 3D Buildings).**
11-
versione: 0.0.1
12-
<!-- /20-Description -->
13-
<!-- 30-PropertiesList -->
1+
<!-- 10-Header -->
2+
[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org)
3+
Entità: OSMBuildingPart
4+
=======================<!-- /10-Header -->
5+
<!-- 15-License -->
6+
[Open License](https://github.com/smart-data-models//dataModel.OpenStreetMap/blob/master/OSMBuildingPart/LICENSE.md)
7+
[document generated automatically](https://docs.google.com/presentation/d/e/2PACX-1vTs-Ng5dIAwkg91oTTUdt8ua7woBXhPnwavZ0FxgR8BsAI_Ek3C5q97Nd94HS8KhP-r_quD4H0fgyt3/pub?start=false&loop=false&delayms=3000#slide=id.gb715ace035_0_60)
8+
<!-- /15-License -->
9+
<!-- 20-Description -->
1410

15-
## Elenco delle proprietà
11+
Descrizione globale: **Una parte o sezione di un edificio proveniente da OpenStreetMap contrassegnata con building:part=*. Viene utilizzata per rappresentare edifici con altezze, forme del tetto o materiali diversi nelle varie sezioni, consentendo la visualizzazione 3D degli edifici (standard Simple 3D Buildings).**
12+
version: 0.0.1
13+
<!-- /20-Description -->
14+
<!-- 30-PropertiesList -->
1615

17-
<sup><sub>[*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o formati/pattern differenti</sub></sup>
18-
- `address[object]`: L'indirizzo postale. Modello: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Il paese. Ad esempio, Spagna. Modello: [https://schema.org/addressCountry](https://schema.org/addressCountry)
19-
- `addressLocality[string]`: La località in cui si trova l'indirizzo civico, e che si trova nella regione. Modello: [https://schema.org/addressLocality](https://schema.org/addressLocality)
20-
- `addressRegion[string]`: La regione in cui si trova la località, e che si trova nel paese. Modello: [https://schema.org/addressRegion](https://schema.org/addressRegion)
21-
- `district[string]`: Un distretto è un tipo di divisione amministrativa che, in alcuni paesi, è gestita dal governo locale
22-
- `postOfficeBoxNumber[string]`: Il numero della casella postale per gli indirizzi di casella postale. Ad esempio, 03578. Modello: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber)
23-
- `postalCode[string]`: Il codice postale. Ad esempio, 24004. Modello: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode)
24-
- `streetAddress[string]`: L'indirizzo civico. Modello: [https://schema.org/streetAddress](https://schema.org/streetAddress)
25-
- `streetNr[string]`: Numero che identifica una proprietà specifica su una strada pubblica
26-
- `alternateName[string]`: Un nome alternativo per questo elemento - `areaServed[string]`: L'area geografica in cui viene fornito un servizio o un elemento offerto. Modello: [https://schema.org/Text](https://schema.org/Text)- `buildingColour[string]`: Colore della facciata di questa parte dell'edificio, espresso come nome di colore CSS o codice esadecimale. Modello: [https://wiki.openstreetmap.org/wiki/Key:building:colour](https://wiki.openstreetmap.org/wiki/Key:building:colour)- `buildingHeight[number]`: Altezza totale di questa parte dell'edificio in metri. Modello: [https://wiki.openstreetmap.org/wiki/Key:height](https://wiki.openstreetmap.org/wiki/Key:height)- `buildingLevels[number]`: Numero di piani fuori terra in questa parte dell'edificio. Modello: [https://wiki.openstreetmap.org/wiki/Key:building:levels](https://wiki.openstreetmap.org/wiki/Key:building:levels)- `buildingMaterial[string]`: Materiale primario della facciata o strutturale di questa parte dell'edificio. Modello: [https://wiki.openstreetmap.org/wiki/Key:building:material](https://wiki.openstreetmap.org/wiki/Key:building:material)- `buildingPartType[string]`: Il valore del tag OSM building:part. Tipicamente 'yes' o un'etichetta di tipo specifico per la sezione architettonica. Modello: [https://wiki.openstreetmap.org/wiki/Key:building:part](https://wiki.openstreetmap.org/wiki/Key:building:part)- `dataProvider[string]`: Una sequenza di caratteri che identifica il fornitore dell'entità dati armonizzata - `dateCreated[date-time]`: Timestamp di creazione dell'entità. Questo sarà solitamente assegnato dalla piattaforma di archiviazione - `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Questo sarà solitamente assegnato dalla piattaforma di archiviazione - `description[string]`: Una descrizione di questo elemento - `id[*]`: Identificatore unico dell'entità - `location[*]`: Riferimento Geojson all'elemento. Può essere Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon - `minHeight[number]`: Altezza dal suolo alla quale inizia questa parte dell'edificio, in metri. Utilizzata per sporgenze e sezioni elevate. Modello: [https://wiki.openstreetmap.org/wiki/Key:min_height](https://wiki.openstreetmap.org/wiki/Key:min_height)- `minLevel[number]`: Livello del piano al quale inizia questa parte dell'edificio. Utilizzato per la mappatura interna. Modello: [https://wiki.openstreetmap.org/wiki/Key:min_level](https://wiki.openstreetmap.org/wiki/Key:min_level)- `name[string]`: Il nome di questo elemento - `osmId[number]`: L'identificatore intero dell'elemento OpenStreetMap originale. Modello: [https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)- `osmLastModified[date-time]`: Timestamp dell'ultima modifica dell'elemento OSM. - `osmType[string]`: Il tipo dell'elemento OpenStreetMap originale. Modello: [https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)- `owner[array]`: Una lista contenente una sequenza di caratteri codificata in JSON che fa riferimento agli ID unici del/dei proprietario/i - `refBuilding[uri]`: Riferimento URI all'entità genitore OSMBuilding a cui appartiene questa parte. - `roofColour[string]`: Colore del tetto su questa parte, espresso come nome di colore CSS o codice esadecimale. Modello: [https://wiki.openstreetmap.org/wiki/Key:roof:colour](https://wiki.openstreetmap.org/wiki/Key:roof:colour)- `roofMaterial[string]`: Materiale primario della superficie del tetto su questa parte. Modello: [https://wiki.openstreetmap.org/wiki/Key:roof:material](https://wiki.openstreetmap.org/wiki/Key:roof:material)- `roofShape[string]`: Forma del tetto su questa parte dell'edificio. Enum:'flat, gabled, hipped, half-hipped, pyramidal, gambrel, mansard, dome, skillion, round, saltbox, onion, cone'. Modello: [https://wiki.openstreetmap.org/wiki/Key:roof:shape](https://wiki.openstreetmap.org/wiki/Key:roof:shape)- `seeAlso[*]`: Elenco di URI che puntano a risorse aggiuntive su questo elemento. - `source[string]`: Una sequenza di caratteri che fornisce la fonte originale dei dati dell'entità come URL. Si raccomanda di utilizzare il nome di dominio completamente qualificato del fornitore della fonte, o l'URL dell'oggetto fonte - `type[string]`: Tipo di entità NGSI. Deve essere OSMBuildingPart <!-- /30-PropertiesList -->
27-
<!-- 35-RequiredProperties -->
28-
Proprietà richieste
29-
- `buildingPartType` - `id` - `location` - `osmId` - `osmType` - `type` <!-- /35-RequiredProperties -->
30-
<!-- 40-NotesYaml -->
31-
<!-- /40-NotesYaml -->
32-
<!-- 50-DataModelHeader -->
33-
## Descrizione del modello di dati delle proprietà
34-
Ordinate alfabeticamente (clicca per i dettagli)
35-
<!-- /50-DataModelHeader -->
36-
<!-- 60-ModelYaml -->
37-
<details><summary><strong>dettagli yaml completi</strong></summary>
16+
## Elenco delle proprietà
17+
18+
<sup><sub>[*] Se in un attributo non è presente un tipo, significa che può avere diversi tipi o formati/modelli diversi</sub></sup>
19+
- `address[object]`: L'indirizzo postale. Modello: [https://schema.org/address](https://schema.org/address)
20+
- `addressCountry[string]`: Il paese. Ad esempio, Spagna. Modello: [https://schema.org/addressCountry](https://schema.org/addressCountry)
21+
- `addressLocality[string]`: La località in cui si trova l'indirizzo stradale, all'interno della regione. Modello: [https://schema.org/addressLocality](https://schema.org/addressLocality)
22+
- `addressRegion[string]`: La regione in cui si trova la località, all'interno del paese. Modello: [https://schema.org/addressRegion](https://schema.org/addressRegion)
23+
- `district[string]`: Un distretto è un tipo di divisione amministrativa che, in alcuni paesi, è gestita dal governo locale
24+
- `postOfficeBoxNumber[string]`: Il numero di casella postale per indirizzi con casella postale. Ad esempio, 03578. Modello: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber)
25+
- `postalCode[string]`: Il codice postale. Ad esempio, 24004. Modello: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode)
26+
- `streetAddress[string]`: L'indirizzo stradale. Modello: [https://schema.org/streetAddress](https://schema.org/streetAddress)
27+
- `streetNr[string]`: Numero che identifica una proprietà specifica su una strada pubblica
28+
- `alternateName[string]`: Un nome alternativo per questo elemento
29+
- `areaServed[string]`: L'area geografica in cui viene fornito un servizio o un articolo offerto. Modello: [https://schema.org/Text](https://schema.org/Text)
30+
- `buildingColour[string]`: Colore della facciata di questa parte dell'edificio, espresso come nome di colore CSS o codice esadecimale. Modello: [https://wiki.openstreetmap.org/wiki/Key:building:colour](https://wiki.openstreetmap.org/wiki/Key:building:colour)
31+
- `buildingHeight[number]`: Altezza totale di questa parte dell'edificio in metri. Modello: [https://wiki.openstreetmap.org/wiki/Key:height](https://wiki.openstreetmap.org/wiki/Key:height)
32+
- `buildingLevels[number]`: Numero di piani sopra il livello del suolo in questa parte dell'edificio. Modello: [https://wiki.openstreetmap.org/wiki/Key:building:levels](https://wiki.openstreetmap.org/wiki/Key:building:levels)
33+
- `buildingMaterial[string]`: Materiale principale della facciata o struttura di questa parte dell'edificio. Modello: [https://wiki.openstreetmap.org/wiki/Key:building:material](https://wiki.openstreetmap.org/wiki/Key:building:material)
34+
- `buildingPartType[string]`: Il valore del tag OSM building:part. Tipicamente 'yes' o un'etichetta specifica per la sezione architettonica. Modello: [https://wiki.openstreetmap.org/wiki/Key:building:part](https://wiki.openstreetmap.org/wiki/Key:building:part)
35+
- `dataProvider[string]`: Una sequenza di caratteri che identifica il fornitore dell'entità dati armonizzata
36+
- `dateCreated[date-time]`: Timestamp di creazione dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione
37+
- `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione
38+
- `description[string]`: Una descrizione di questo elemento
39+
- `id[*]`: Identificatore univoco dell'entità
40+
- `location[*]`: Riferimento Geojson all'elemento. Può essere Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon
41+
- `minHeight[number]`: Altezza dal suolo a cui inizia questa parte dell'edificio, in metri. Utilizzato per sporgenze e sezioni rialzate. Modello: [https://wiki.openstreetmap.org/wiki/Key:min_height](https://wiki.openstreetmap.org/wiki/Key:min_height)
42+
- `minLevel[number]`: Livello del piano a cui inizia questa parte dell'edificio. Utilizzato per la mappatura indoor. Modello: [https://wiki.openstreetmap.org/wiki/Key:min_level](https://wiki.openstreetmap.org/wiki/Key:min_level)
43+
- `name[string]`: Il nome di questo elemento
44+
- `osmId[number]`: L'identificatore intero originale dell'elemento OpenStreetMap. Modello: [https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)
45+
- `osmLastModified[date-time]`: Timestamp dell'ultima modifica dell'elemento OSM
46+
- `osmType[string]`: Il tipo dell'elemento originale OpenStreetMap. Modello: [https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)
47+
- `owner[array]`: Un elenco contenente una sequenza JSON codificata di caratteri che fa riferimento agli ID univoci del/dei proprietario/i
48+
- `refBuilding[uri]`: Riferimento URI all'entità OSMBuilding genitore a cui questa parte appartiene
49+
- `roofColour[string]`: Colore del tetto di questa parte, espresso come nome di colore CSS o codice esadecimale. Modello: [https://wiki.openstreetmap.org/wiki/Key:roof:colour](https://wiki.openstreetmap.org/wiki/Key:roof:colour)
50+
- `roofMaterial[string]`: Materiale principale della superficie del tetto di questa parte. Modello: [https://wiki.openstreetmap.org/wiki/Key:roof:material](https://wiki.openstreetmap.org/wiki/Key:roof:material)
51+
- `roofShape[string]`: Forma del tetto di questa parte dell'edificio. Enum: 'piatto, a due falde, a padiglione, a falde ridotte, piramidale, a mansarda olandese, a mansarda, a cupola, a shed, arrotondato, a forma di capanna, a cipolla, conica'. Modello: [https://wiki.openstreetmap.org/wiki/Key:roof:shape](https://wiki.openstreetmap.org/wiki/Key:roof:shape)
52+
- `seeAlso[*]`: Elenco di URI che puntano a risorse aggiuntive su questo elemento
53+
- `source[string]`: Una sequenza di caratteri che fornisce la fonte originale dei dati dell'entità come URL. Consigliato sia il nome di dominio completo del fornitore della fonte o l'URL dell'oggetto sorgente
54+
- `type[string]`: Tipo di entità NGSI. Deve essere OSMBuildingPart
55+
<!-- /30-PropertiesList -->
56+
<!-- 35-RequiredProperties -->
57+
58+
Proprietà obbligatorie
59+
- `buildingPartType`
60+
- `id`
61+
- `location`
62+
- `osmId`
63+
- `osmType`
64+
- `type`
65+
<!-- /35-RequiredProperties -->
66+
<!-- 40-NotesYaml -->
67+
<!-- /40-NotesYaml -->
68+
<!-- 50-DataModelHeader -->
69+
70+
## Descrizione del modello dati delle proprietà
71+
Ordinate alfabeticamente (clicca per i dettagli)
72+
<!-- /50-DataModelHeader -->
73+
<!-- 60-ModelYaml -->
74+
<details><summary><strong>dettagli yaml completi</strong></summary>
3875
```yaml
3976
OSMBuildingPart:
4077
description: A part or section of a building from OpenStreetMap tagged with building:part=*. Used to represent buildings with varying heights, roof shapes, or materials across different sections, enabling 3D building visualisation (Simple 3D Buildings standard).
@@ -513,16 +550,17 @@ OSMBuildingPart:
513550
x-model-schema: https://smart-data-models.github.io/dataModel.OpenStreetMap/OSMBuildingPart/schema.json
514551
x-model-tags: OSM OpenStreetMap Buildings 3D
515552
x-version: 0.0.1
516-
```
517-
</details>
518-
<!-- /60-ModelYaml -->
519-
<!-- 70-MiddleNotes -->
520-
<!-- /70-MiddleNotes -->
521-
<!-- 80-Examples -->
522-
## Esempi di payload
523-
#### Esempio di valori chiave NGSI-v2 di OSMBuildingPart
524-
Ecco un esempio di OSMBuildingPart in formato JSON come valori chiave. Questo è compatibile con NGSI-v2 quando si usa `options=keyValues` e restituisce i dati di contesto di una singola entità.
525-
<details><summary><strong>mostra/nascondi esempio</strong></summary>
553+
```
554+
</details>
555+
<!-- /60-ModelYaml -->
556+
<!-- 70-MiddleNotes -->
557+
<!-- /70-MiddleNotes -->
558+
<!-- 80-Examples -->
559+
560+
## Esempi di payload
561+
#### Esempio di OSMBuildingPart NGSI-v2 in formato chiave-valore
562+
Ecco un esempio di OSMBuildingPart in formato JSON come chiave-valore. È compatibile con NGSI-v2 quando si utilizza `options=keyValues` e restituisce i dati contestuali di un'entità singola.
563+
<details><summary><strong>mostra/nascondi esempio</strong></summary>
526564
```json
527565
{
528566
"id": "urn:ngsi-ld:OSMBuildingPart:way:305981241",
@@ -571,11 +609,11 @@ Ecco un esempio di OSMBuildingPart in formato JSON come valori chiave. Questo è
571609
"https://www.openstreetmap.org/way/305981241"
572610
]
573611
}
574-
```
575-
</details>
576-
#### Esempio normalizzato NGSI-v2 di OSMBuildingPart
577-
Ecco un esempio di OSMBuildingPart in formato JSON come normalizzato. Questo è compatibile con NGSI-v2 quando non si usano opzioni e restituisce i dati di contesto di una singola entità.
578-
<details><summary><strong>mostra/nascondi esempio</strong></summary>
612+
```
613+
</details>
614+
#### Esempio di OSMBuildingPart NGSI-v2 normalizzato
615+
Ecco un esempio di OSMBuildingPart in formato JSON normalizzato. È compatibile con NGSI-v2 quando non si utilizzano opzioni e restituisce i dati contestuali di un'entità singola.
616+
<details><summary><strong>mostra/nascondi esempio</strong></summary>
579617
```json
580618
{
581619
"id": "urn:ngsi-ld:OSMBuildingPart:way:305981241",
@@ -681,11 +719,11 @@ Ecco un esempio di OSMBuildingPart in formato JSON come normalizzato. Questo è
681719
]
682720
}
683721
}
684-
```
685-
</details>
686-
#### Esempio di valori chiave NGSI-LD di OSMBuildingPart
687-
Ecco un esempio di OSMBuildingPart in formato JSON-LD come valori chiave. Questo è compatibile con NGSI-LD quando si usa `options=keyValues` e restituisce i dati di contesto di una singola entità.
688-
<details><summary><strong>mostra/nascondi esempio</strong></summary>
722+
```
723+
</details>
724+
#### Esempio di OSMBuildingPart NGSI-LD in formato chiave-valore
725+
Ecco un esempio di OSMBuildingPart in formato JSON-LD come chiave-valore. È compatibile con NGSI-LD quando si utilizza `options=keyValues` e restituisce i dati contestuali di un'entità singola.
726+
<details><summary><strong>mostra/nascondi esempio</strong></summary>
689727
```json
690728
{
691729
"id": "urn:ngsi-ld:OSMBuildingPart:way:305981241",
@@ -737,11 +775,11 @@ Ecco un esempio di OSMBuildingPart in formato JSON-LD come valori chiave. Questo
737775
"https://raw.githubusercontent.com/smart-data-models/dataModel.OpenStreetMap/refs/heads/master/context.jsonld"
738776
]
739777
}
740-
```
741-
</details>
742-
#### Esempio normalizzato NGSI-LD di OSMBuildingPart
743-
Ecco un esempio di OSMBuildingPart in formato JSON-LD come normalizzato. Questo è compatibile con NGSI-LD quando non si usano opzioni e restituisce i dati di contesto di una singola entità.
744-
<details><summary><strong>mostra/nascondi esempio</strong></summary>
778+
```
779+
</details>
780+
#### Esempio di OSMBuildingPart NGSI-LD normalizzato
781+
Ecco un esempio di OSMBuildingPart in formato JSON-LD normalizzato. È compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati contestuali di un'entità singola.
782+
<details><summary><strong>mostra/nascondi esempio</strong></summary>
745783
```json
746784
{
747785
"id": "urn:ngsi-ld:OSMBuildingPart:way:305981241",
@@ -843,13 +881,14 @@ Ecco un esempio di OSMBuildingPart in formato JSON-LD come normalizzato. Questo
843881
"https://raw.githubusercontent.com/smart-data-models/dataModel.OpenStreetMap/refs/heads/master/context.jsonld"
844882
]
845883
}
846-
```
847-
</details><!-- /80-Examples -->
848-
<!-- 90-FooterNotes -->
849-
<!-- /90-FooterNotes -->
850-
<!-- 95-Units -->
851-
Vedi [FAQ 10](https://smartdatamodels.org/index.php/faqs/) per ottenere una risposta su come gestire le unità di misura
852-
<!-- /95-Units -->
853-
<!-- 97-LastFooter -->
854-
---
884+
```
885+
</details><!-- /80-Examples -->
886+
<!-- 90-FooterNotes -->
887+
<!-- /90-FooterNotes -->
888+
<!-- 95-Units -->
889+
890+
Consulta [FAQ 10](https://smartdatamodels.org/index.php/faqs/) per sapere come gestire le unità di misura
891+
<!-- /95-Units -->
892+
<!-- 97-LastFooter -->
893+
---
855894
[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM)<!-- /97-LastFooter -->

0 commit comments

Comments
 (0)