Skip to content

Commit 0685318

Browse files
albertoabellagarciaalbertoabellagarcia
committed
Update IT
1 parent 45f3e74 commit 0685318

1 file changed

Lines changed: 113 additions & 69 deletions

File tree

‎OSMRailway/doc/spec_IT.md‎

Lines changed: 113 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,78 @@
1-
<!-- 10-Header -->
2-
[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org)
3-
Entity: OSMRailway
4-
==================<!-- /10-Header -->
5-
<!-- 15-License -->
6-
[Open License](https://github.com/smart-data-models//dataModel.OpenStreetMap/blob/master/OSMRailway/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-
Global description: **Un binario ferroviario o elemento infrastrutturale di OpenStreetMap etichettato con la chiave railway. Copre tutti i tipi di infrastrutture ferroviarie, dalla ferrovia pesante di linea principale a tram, metropolitane e funicolari.**
11-
version: 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+
Entity: OSMRailway
4+
==================<!-- /10-Header -->
5+
<!-- 15-License -->
6+
[Open License](https://github.com/smart-data-models//dataModel.OpenStreetMap/blob/master/OSMRailway/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-
## List of properties
11+
Descrizione globale: **Un binario ferroviario o un elemento di infrastruttura da OpenStreetMap contrassegnato con la chiave railway. Copre tutti i tipi di infrastrutture ferroviarie, dalle linee ferroviarie principali ai tram, metropolitane e funicolari.**<!-- /20-Description -->
12+
<!-- 30-PropertiesList -->
1613

17-
<sup><sub>[*] Se non è presente 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 articolo offerto . Modello: [https://schema.org/Text](https://schema.org/Text)- `bridge[boolean]`: Indica se questo segmento ferroviario passa su un ponte . Modello: [https://wiki.openstreetmap.org/wiki/Key:bridge](https://wiki.openstreetmap.org/wiki/Key:bridge)- `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 - `electrified[string]`: Metodo di elettrificazione della ferrovia . Modello: [https://wiki.openstreetmap.org/wiki/Key:electrified](https://wiki.openstreetmap.org/wiki/Key:electrified)- `frequency[number]`: Frequenza elettrica della corrente di trazione in Hertz . Modello: [https://wiki.openstreetmap.org/wiki/Key:frequency](https://wiki.openstreetmap.org/wiki/Key:frequency)- `gauge[number]`: Scartamento del binario in millimetri (distanza tra le due rotaie) . Modello: [https://wiki.openstreetmap.org/wiki/Key:gauge](https://wiki.openstreetmap.org/wiki/Key:gauge)- `id[*]`: Identificatore univoco dell'entità - `layer[number]`: Strato verticale relativo ad altre caratteristiche nella stessa posizione . Modello: [https://wiki.openstreetmap.org/wiki/Key:layer](https://wiki.openstreetmap.org/wiki/Key:layer)- `location[*]`: Riferimento Geojson all'elemento. Può essere Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon - `maxSpeed[number]`: Velocità massima consentita su questo binario in chilometri all'ora . Modello: [https://wiki.openstreetmap.org/wiki/Key:maxspeed](https://wiki.openstreetmap.org/wiki/Key:maxspeed)- `name[string]`: Il nome di questo elemento - `operator[string]`: Nome dell'operatore o della compagnia ferroviaria . Modello: [https://wiki.openstreetmap.org/wiki/Key:operator](https://wiki.openstreetmap.org/wiki/Key:operator)- `osmId[number]`: L'identificatore intero dell'elemento originale di OpenStreetMap . 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 originale di OpenStreetMap . Modello: [https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)- `owner[array]`: Un elenco contenente una sequenza di caratteri codificata in JSON che fa riferimento agli ID univoci del/dei proprietario/i - `railwayType[string]`: Il valore del tag railway di OSM che classifica il tipo di infrastruttura ferroviaria. Enum:'rail, subway, tram, light_rail, narrow_gauge, monorail, funicular, miniature, preserved, disused, abandoned, construction, proposed' . Modello: [https://wiki.openstreetmap.org/wiki/Key:railway](https://wiki.openstreetmap.org/wiki/Key:railway)- `ref[string]`: Numero o codice di riferimento ufficiale della linea . Modello: [https://wiki.openstreetmap.org/wiki/Key:ref](https://wiki.openstreetmap.org/wiki/Key:ref)- `seeAlso[*]`: Elenco di URI che puntano a risorse aggiuntive su questo elemento. - `service[string]`: Tipo di binario di servizio, se non fa parte della linea principale di corsa . Modello: [https://wiki.openstreetmap.org/wiki/Key:service](https://wiki.openstreetmap.org/wiki/Key:service)- `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 - `tracks[number]`: Numero di binari paralleli . Modello: [https://wiki.openstreetmap.org/wiki/Key:tracks](https://wiki.openstreetmap.org/wiki/Key:tracks)- `tunnel[boolean]`: Indica se questo segmento ferroviario attraversa una galleria . Modello: [https://wiki.openstreetmap.org/wiki/Key:tunnel](https://wiki.openstreetmap.org/wiki/Key:tunnel)- `type[string]`: Tipo di entità NGSI. Deve essere OSMRailway - `usage[string]`: Utilizzo previsto della linea ferroviaria . Modello: [https://wiki.openstreetmap.org/wiki/Key:usage](https://wiki.openstreetmap.org/wiki/Key:usage)- `voltage[number]`: Tensione elettrica utilizzata per la trazione in Volt . Modello: [https://wiki.openstreetmap.org/wiki/Key:voltage](https://wiki.openstreetmap.org/wiki/Key:voltage)<!-- /30-PropertiesList -->
27-
<!-- 35-RequiredProperties -->
28-
Proprietà richieste
29-
- `id` - `location` - `osmId` - `osmType` - `railwayType` - `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>full yaml details</strong></summary>
14+
## Elenco delle proprietà
15+
16+
<sup><sub>[*] Se in un attributo non è presente un tipo, significa che può avere diversi tipi o formati/modelli diversi</sub></sup>
17+
- `address[object]`: L'indirizzo postale. Modello: [https://schema.org/address](https://schema.org/address)
18+
- `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 stradale, che a sua volta si trova nella regione. Modello: [https://schema.org/addressLocality](https://schema.org/addressLocality)
20+
- `addressRegion[string]`: La regione in cui si trova la località, che a sua volta si trova nel paese. Modello: [https://schema.org/addressRegion](https://schema.org/addressRegion)
21+
- `district[string]`: Una circoscrizione è un tipo di divisione amministrativa che, in alcuni paesi, è gestita dal governo locale
22+
- `postOfficeBoxNumber[string]`: Il numero della casella postale per gli indirizzi con 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 stradale. 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
27+
- `areaServed[string]`: L'area geografica in cui viene fornito un servizio o un elemento offerto. Modello: [https://schema.org/Text](https://schema.org/Text)
28+
- `bridge[boolean]`: Indica se questo segmento ferroviario passa su un ponte. Modello: [https://wiki.openstreetmap.org/wiki/Key:bridge](https://wiki.openstreetmap.org/wiki/Key:bridge)
29+
- `dataProvider[string]`: Una sequenza di caratteri che identifica il fornitore dell'entità dati armonizzata
30+
- `dateCreated[date-time]`: Timestamp di creazione dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione
31+
- `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione
32+
- `description[string]`: Una descrizione di questo elemento
33+
- `electrified[string]`: Metodo di elettrificazione della ferrovia. Modello: [https://wiki.openstreetmap.org/wiki/Key:electrified](https://wiki.openstreetmap.org/wiki/Key:electrified)
34+
- `frequency[number]`: Frequenza elettrica della corrente di trazione in Hertz. Modello: [https://wiki.openstreetmap.org/wiki/Key:frequency](https://wiki.openstreetmap.org/wiki/Key:frequency)
35+
- `gauge[number]`: Scartamento dei binari in millimetri (distanza tra i due binari). Modello: [https://wiki.openstreetmap.org/wiki/Key:gauge](https://wiki.openstreetmap.org/wiki/Key:gauge)
36+
- `id[*]`: Identificatore univoco dell'entità
37+
- `layer[number]`: Livello verticale rispetto ad altre entità nella stessa posizione. Modello: [https://wiki.openstreetmap.org/wiki/Key:layer](https://wiki.openstreetmap.org/wiki/Key:layer)
38+
- `location[*]`: Riferimento Geojson all'elemento. Può essere Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon
39+
- `maxSpeed[number]`: Velocità massima consentita su questo binario in chilometri orari. Modello: [https://wiki.openstreetmap.org/wiki/Key:maxspeed](https://wiki.openstreetmap.org/wiki/Key:maxspeed)
40+
- `name[string]`: Il nome di questo elemento
41+
- `operator[string]`: Nome dell'operatore ferroviario o dell'azienda. Modello: [https://wiki.openstreetmap.org/wiki/Key:operator](https://wiki.openstreetmap.org/wiki/Key:operator)
42+
- `osmId[number]`: L'identificatore intero originale dell'elemento OpenStreetMap. Modello: [https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)
43+
- `osmLastModified[date-time]`: Timestamp dell'ultima modifica dell'elemento OSM.
44+
- `osmType[string]`: Il tipo dell'elemento originale OpenStreetMap. Modello: [https://wiki.openstreetmap.org/wiki/Elements](https://wiki.openstreetmap.org/wiki/Elements)
45+
- `owner[array]`: Un elenco contenente una sequenza JSON codificata che fa riferimento agli ID univoci del/dei proprietario/i
46+
- `railwayType[string]`: Il valore del tag railway di OSM che classifica il tipo di infrastruttura ferroviaria. Enum: 'rail, subway, tram, light_rail, narrow_gauge, monorail, funicular, miniature, preserved, disused, abandoned, construction, proposed'. Modello: [https://wiki.openstreetmap.org/wiki/Key:railway](https://wiki.openstreetmap.org/wiki/Key:railway)
47+
- `ref[string]`: Numero o codice di riferimento ufficiale della linea. Modello: [https://wiki.openstreetmap.org/wiki/Key:ref](https://wiki.openstreetmap.org/wiki/Key:ref)
48+
- `seeAlso[*]`: Elenco di URI che puntano a risorse aggiuntive su questo elemento.
49+
- `service[string]`: Tipo di binario di servizio, se non fa parte della linea principale. Modello: [https://wiki.openstreetmap.org/wiki/Key:service](https://wiki.openstreetmap.org/wiki/Key:service)
50+
- `source[string]`: Una sequenza di caratteri che fornisce la fonte originale dei dati dell'entità come URL. Consigliato essere il nome di dominio completamente qualificato del fornitore della fonte o l'URL dell'oggetto sorgente
51+
- `tracks[number]`: Numero di binari paralleli. Modello: [https://wiki.openstreetmap.org/wiki/Key:tracks](https://wiki.openstreetmap.org/wiki/Key:tracks)
52+
- `tunnel[boolean]`: Indica se questo segmento ferroviario passa attraverso una galleria. Modello: [https://wiki.openstreetmap.org/wiki/Key:tunnel](https://wiki.openstreetmap.org/wiki/Key:tunnel)
53+
- `type[string]`: Tipo di entità NGSI. Deve essere OSMRailway
54+
- `usage[string]`: Uso previsto della linea ferroviaria. Modello: [https://wiki.openstreetmap.org/wiki/Key:usage](https://wiki.openstreetmap.org/wiki/Key:usage)
55+
- `voltage[number]`: Tensione elettrica utilizzata per la trazione in Volt. Modello: [https://wiki.openstreetmap.org/wiki/Key:voltage](https://wiki.openstreetmap.org/wiki/Key:voltage)
56+
<!-- /30-PropertiesList -->
57+
<!-- 35-RequiredProperties -->
58+
59+
Proprietà obbligatorie
60+
- `id`
61+
- `location`
62+
- `osmId`
63+
- `osmType`
64+
- `railwayType`
65+
- `type`
66+
<!-- /35-RequiredProperties -->
67+
<!-- 40-NotesYaml -->
68+
<!-- /40-NotesYaml -->
69+
<!-- 50-DataModelHeader -->
70+
71+
## Descrizione del modello dati delle proprietà
72+
Ordinate alfabeticamente (fare clic per i dettagli)
73+
<!-- /50-DataModelHeader -->
74+
<!-- 60-ModelYaml -->
75+
<details><summary><strong>dettagli yaml completi</strong></summary>
3876
```yaml
3977
OSMRailway:
4078
description: A railway track or infrastructure element from OpenStreetMap tagged with the railway key. Covers all types of rail infrastructure, from mainline heavy rail to trams, subways and funiculars.
@@ -553,16 +591,17 @@ OSMRailway:
553591
x-model-schema: https://smart-data-models.github.io/dataModel.OpenStreetMap/OSMRailway/schema.json
554592
x-model-tags: OSM OpenStreetMap Transportation Railway
555593
x-version: 0.0.1
556-
```
557-
</details>
558-
<!-- /60-ModelYaml -->
559-
<!-- 70-MiddleNotes -->
560-
<!-- /70-MiddleNotes -->
561-
<!-- 80-Examples -->
562-
## Esempi di payload
563-
#### Esempio di OSMRailway NGSI-v2 key-values
564-
Ecco un esempio di OSMRailway in formato JSON come key-values. Questo è compatibile con NGSI-v2 quando si usa `options=keyValues` e restituisce i dati di contesto di una singola entità.
565-
<details><summary><strong>show/hide example</strong></summary>
594+
```
595+
</details>
596+
<!-- /60-ModelYaml -->
597+
<!-- 70-MiddleNotes -->
598+
<!-- /70-MiddleNotes -->
599+
<!-- 80-Examples -->
600+
601+
## Esempi di payload
602+
#### Esempio OSMRailway NGSI-v2 con coppie chiave-valore
603+
Ecco un esempio di OSMRailway in formato JSON come coppie chiave-valore. Questo è compatibile con NGSI-v2 quando si utilizza `options=keyValues` e restituisce i dati contestuali di un'entità singola.
604+
<details><summary><strong>mostra/nascondi esempio</strong></summary>
566605
```json
567606
{
568607
"id": "urn:ngsi-ld:OSMRailway:way:2903182",
@@ -604,11 +643,12 @@ Ecco un esempio di OSMRailway in formato JSON come key-values. Questo è compati
604643
"https://www.openstreetmap.org/way/2903182"
605644
]
606645
}
607-
```
608-
</details>
609-
#### Esempio di OSMRailway NGSI-v2 normalizzato
610-
Ecco un esempio di OSMRailway 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à.
611-
<details><summary><strong>show/hide example</strong></summary>
646+
```
647+
</details>
648+
649+
#### Esempio OSMRailway NGSI-v2 normalizzato
650+
Ecco un esempio di OSMRailway in formato JSON normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano opzioni e restituisce i dati contestuali di un'entità singola.
651+
<details><summary><strong>mostra/nascondi esempio</strong></summary>
612652
```json
613653
{
614654
"id": "urn:ngsi-ld:OSMRailway:way:2903182",
@@ -728,11 +768,12 @@ Ecco un esempio di OSMRailway in formato JSON come normalizzato. Questo è compa
728768
]
729769
}
730770
}
731-
```
732-
</details>
733-
#### Esempio di OSMRailway NGSI-LD key-values
734-
Ecco un esempio di OSMRailway in formato JSON-LD come key-values. Questo è compatibile con NGSI-LD quando si usa `options=keyValues` e restituisce i dati di contesto di una singola entità.
735-
<details><summary><strong>show/hide example</strong></summary>
771+
```
772+
</details>
773+
774+
#### Esempio OSMRailway NGSI-LD con coppie chiave-valore
775+
Ecco un esempio di OSMRailway in formato JSON-LD come coppie chiave-valore. Questo è compatibile con NGSI-LD quando si utilizza `options=keyValues` e restituisce i dati contestuali di un'entità singola.
776+
<details><summary><strong>mostra/nascondi esempio</strong></summary>
736777
```json
737778
{
738779
"id": "urn:ngsi-ld:OSMRailway:way:2903182",
@@ -777,11 +818,12 @@ Ecco un esempio di OSMRailway in formato JSON-LD come key-values. Questo è comp
777818
"https://raw.githubusercontent.com/smart-data-models/dataModel.OpenStreetMap/refs/heads/master/context.jsonld"
778819
]
779820
}
780-
```
781-
</details>
782-
#### Esempio di OSMRailway NGSI-LD normalizzato
783-
Ecco un esempio di OSMRailway 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à.
784-
<details><summary><strong>show/hide example</strong></summary>
821+
```
822+
</details>
823+
824+
#### Esempio OSMRailway NGSI-LD normalizzato
825+
Ecco un esempio di OSMRailway in formato JSON-LD normalizzato. Questo è compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati contestuali di un'entità singola.
826+
<details><summary><strong>mostra/nascondi esempio</strong></summary>
785827
```json
786828
{
787829
"id": "urn:ngsi-ld:OSMRailway:way:2903182",
@@ -887,13 +929,15 @@ Ecco un esempio di OSMRailway in formato JSON-LD come normalizzato. Questo è co
887929
"https://raw.githubusercontent.com/smart-data-models/dataModel.OpenStreetMap/refs/heads/master/context.jsonld"
888930
]
889931
}
890-
```
891-
</details><!-- /80-Examples -->
892-
<!-- 90-FooterNotes -->
893-
<!-- /90-FooterNotes -->
894-
<!-- 95-Units -->
895-
Vedi [FAQ 10](https://smartdatamodels.org/index.php/faqs/) per una risposta su come gestire le unità di misura
896-
<!-- /95-Units -->
897-
<!-- 97-LastFooter -->
898-
---
932+
```
933+
</details><!-- /80-Examples -->
934+
<!-- 90-FooterNotes -->
935+
<!-- /90-FooterNotes -->
936+
<!-- 95-Units -->
937+
938+
Per informazioni su come gestire le unità di misura, vedere [FAQ 10](https://smartdatamodels.org/index.php/faqs/)
939+
<!-- /95-Units -->
940+
<!-- 97-LastFooter -->
941+
942+
---
899943
[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)