Descrizione semantica dell´UrbanDataset Transits della SCP Ontology 2.0

Questo documento fornisce una documentazione human-friendly dell´UrbanDataset Transits la cui semantica è definita formalmente dalla SCP Ontology 2.0, parte delle "Specifiche Smart City Platform (SCPS) - Livello semantico" realizzate nell´ambito del Progetto di Ricerca di Sistema Elettrico.

Data di creazione di questo documento 2024-05-13 22:34
Link alle SCPS https://smartcityplatform.enea.it/#/it/index.html

Indice

Introduzione

  1. Come leggere questo documento
  2. Strumenti per creare un messaggio UrbanDataset

PARTE I: UrbanDataset

  1. Transits

PARTE II: Liste di codici

  1. ADRCode.gc
  2. EuroClassCode.gc
  3. MonitoringPointCode.gc
  4. PeriodValueQualifierCode.gc
  5. PhysicalUnitCategoryCode.gc
  6. TransportMeansCode.gc
  7. TransportScopeCode.gc
  8. CountryCode.gc
  9. FormatCode.gc
  10. LanguageCode.gc
  11. TimezoneCode.gc

Introduzione

1. Come leggere questo documento

Questo documento fornisce una rappresentazione human-friendly della definizione semantica di uno o più UrbanDataset dell´ontologia SCPS.

Ogni UrbanDataset è descritto attraverso una tabella costituita da tre sezioni principali:

2. Strumenti per creare un messaggio UrbanDataset

I riferimenti normativi per la conformità sintattica e semantica degli UrbanDataset alle SCPS sono:

Inoltre, nella UDWebLibrary, tra le risorse disponibili nella scheda di ogni UrbanDataset, è possibile scaricare i template dei messaggi in sintassi JSON e XML, conformi alle specifiche. Un template costituisce un esempio di istanza UrbanDataset avente tutte le proprietà (obbligatorie e opzionali) che lo compongono (per le eventuali proprietà con unità di misura alternative e/o metodo di calcolo vengono usati i valori di default).

PARTE I: UrbanDataset

  1. Transits-2.0
  2. Identificazione UrbanDataset
    Scopo Fornire informazioni relative ai transiti di persone o di mezzi di trasporto (anche con categorizzazione per fascia di età, genere, provenienza, tipologia mezzo di trasporto, ecc.), dando loro una collocazione spaziale e temporale. I transiti possono essere relativi a una tratta specificata tramite punto di partenza, punto di arrivo ed eventuale ulteriore punti di monitoraggio oppure a un singolo punto, nel qual caso esso corrisponderà al punto di partenza
    Categoria / Sottocategoria Transportation / TrafficManagement
    Identificatore Transits-2.0
    Nome Transits
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#Transits
    Contestualizzazione UrbanDataset
    Descrizione Formato/Lista di Codici
    coordinates Riferimento geografico

    Proprietà aggregata
    subProperty: format Formato wgs84 in cui sono espresse le coordinate (attributo opzionale) string

    FormatCode.gc
    subProperty: height Altitudine (proprietà opzionale) double

    subProperty: latitude Latitudine double

    subProperty: longitude Longitudine double

    language Lingua in cui sono espressi i campi testo dell'istanza

    string

    LanguageCode.gc
    timestamp Marca temporale

    dateTime

    timezone Fuso orario delle marche temporali espresso come offset, ovvero come + oppure - il numero di ore e minuti di distanza dall'ora UTC: +/-hh:mm (ISO 8601)

    string

    TimezoneCode.gc
    Proprietà UrbanDataset

    * le proprietà marcate con asterisco sono proprietà per le quali è necessario indicare, a livello di istanza, il metodo di calcolo adottato (ad es. "average", "total", "instantaneous",...)
    Nome Descrizione Obbligatoria Formato/Lista di Codici Unità di misura
    StartLocationID Identificatore del luogo di partenza nel caso di una tratta, o del luogo di rilevamento nel caso di un unico punto di transito

    string

    TransitCount * Numero di transiti rilevati

    integer

    coordinates Coordinate dello StartLocationID (punto di inizio della tratta o singolo punto di monitoraggio, nel caso in cui transiti siano monitorati in un unico punto)

    Proprietà aggregata
    subProperty: format Formato wgs84 in cui sono espresse le coordinate (attributo opzionale) no string

    FormatCode.gc
    subProperty: height Altitudine (proprietà opzionale) no double

    subProperty: latitude Latitudine double

    subProperty: longitude Longitudine double

    period Periodo durante il quale sono stati rilevati i dati riportati nella riga

    Proprietà aggregata
    subProperty: end_ts Marca temporale indicante la fine del periodo dateTime

    subProperty: start_ts Marca temporale indicante l'inizio del periodo dateTime

    ADRCode Codice identificativo delle merci pericolose

    no string

    ADRCode.gc
    AnomalousTransitCount * Numero di transiti anomali rilevati (per es transiti in senso contrario a quello di marcia)

    no integer

    CarrierName Nome del vettore che effettua il trasporto

    no string

    EndLocationID Identificatore della località di arrivo della tratta

    no string

    EndLocationName Nome del luogo di arrivo

    no string

    EndTimeSlot Ora di fine di una fascia oraria

    no

    EuroClassCode Codice che identifica la classe EURO del veicolo

    no string

    EuroClassCode.gc
    LocationID Identificativo del luogo osservato

    no string

    LocationName Denominazione luogo

    no string

    MonitoringPointCode Codice che indica in quali dei luoghi di un percorso sono presenti i sensori per il rilevamento del transito

    no string

    MonitoringPointCode.gc
    PeriodQualifierCode Qualificatore che descrive il periodo

    no string

    PeriodValueQualifierCode.gc
    PeriodValue Periodo espresso come valore testuale (es. "martedì", "mercoledì", "2022", ecc.)

    no string

    PhysicalUnitCategoryCode Codice indicante a quale categoria (persone, veicoli) si riferisce il numero di transiti indicato nel campo TransitCount

    no string

    PhysicalUnitCategoryCode.gc
    SchemeID Schema di identificazione degli ID delle Location

    no string

    StartLocationName Nome del luogo di partenza

    no string

    StartTimeSlot Ora di inizio di una fascia oraria

    no

    TimeSlotDescription Fascia oraria espressa come valore. Valori suggeriti "diurna", "notturna", dove, se non diversamente specificato tramite "Ora inizio" e "Ora fine", si assume che: - diurna: dalle 07:00 alle 18:59 - notturna: dalle 19:00 alle 06:59

    no string

    TotalCountFlag Indica se il numero di transiti indicato è un totale (true) o un parziale (false) per il periodo indicato

    no boolean

    TransportMeansCode Codice che indica la macrocategoria a cui appartiene il mezzo di trasporto

    no string

    TransportMeansCode.gc
    TransportScopeCode Codice che specifica il tipo di carico del mezzo di trasporto (persone, merci, animali, ecc.)

    no string

    TransportScopeCode.gc
    VehicleRegistrationCountryCode Codice della nazione di registrazione del veicolo

    no string

    CountryCode.gc
    WorkingDayFlag Indica se i dati contenuti nella riga sono riferiti a giorni feriali o festivi

    no boolean

PARTE II: Liste di codici

  1. ADRCode.gc
  2. Nome sintetico ADRCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/ADRCode.gc
    Agency ENEA
    Codice Valore
    NoADR Nessun carico Pericoloso
    DG1 Danger Class 1 - Sostanze esplosive
    DG2 Danger Class 2 - Gas
    DG3 Danger Class 3 - Liquidi infiammabili
    DG4.1 Danger Class 4.1 - Solidi infiammabili, materie autoreattive, materie che polimerizzano e esplosivi solidi desensibilizzati
    DG4.2 Danger Class 4.2 - Materie soggette ad accensione spontanea
    DG4.3 Danger Class 4.3 - Materie che, a contatto con l'acqua, sviluppano gas infiammabili
    DG5.1 Danger Class 5.1 - Materie comburenti
    DG5.2 Danger Class 5.2 - Materie Perossidi organici
    DG6.1 Danger Class 6.1 - Materie tossiche
    DG6.2 Danger Class 6.2 - Materie infettanti
    DG7 Danger Class 7 - Materiali radioattivi
    DG8 Danger Class 8 - Materie corrosive
    DG9 Danger Class 9 - Materie ed oggetti pericolosi diversi

  3. EuroClassCode.gc
  4. Nome sintetico EuroClassCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EuroClassCode.gc
    Agency ENEA
    Codice Valore
    Euro0 Veicoli Euro 0 - immatricolazione precedente al 31-12-1991
    Euro1 Veicoli Euro 1 - con immatricolazione dal 1-01-1993
    Euro2 Veicoli Euro 2 - con immatricolazione dal 1-01-1997
    Euro3 Veicoli Euro 3 - con immatricolazione dal 1-01-2001
    Euro4 Veicoli Euro 4 - con immatricolazione dal 1-01-2006
    Euro5 Veicoli Euro 5 - con immatricolazione dal 1-01-2011
    Euro6 Veicoli Euro 6 - con immatricolazione dal 1-09-2015

  5. MonitoringPointCode.gc
  6. Nome sintetico MonitoringPointCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/MonitoringPointCode.gc
    Agency ENEA
    Codice Valore
    STR Sensore presente solo nel luogo di inizio tratta.
    END Sensore presente solo nel luogo di fine tratta.
    OTH Sensore presente solo in luogo lungo la tratta.
    ALL Sensore presente nei luoghi di inizio e fine tratta e lungo la tratta.
    ST-EN Sensore presente solo nei luoghi di inizio e fine tratta.
    ST-OT Sensore presente nel luogo di inizio tratta e lungo la tratta.
    EN-OT Sensore presente nel luogo di fine tratta e lungo la tratta.

  7. PeriodValueQualifierCode.gc
  8. Nome sintetico PeriodValueQualifierCodeCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/PeriodValueQualifierCode.gc
    Agency ENEA
    Codice Valore
    day giorno
    month mese
    year anno

  9. PhysicalUnitCategoryCode.gc
  10. Nome sintetico PhysicalUnitCategoryCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/PhysicalUnitCategoryCode.gc
    Agency ENEA
    Codice Valore
    NULL NULL
    PER Persona
    TRM Mezzo di trasporto non meglio specificato
    VEL Velocipede
    CIC Ciclomotore
    MOT Motoveicolo
    LV0 Mezzi leggeri
    LV1 Auto e monovolume
    LV2 Auto e monovolume con rimorchio
    LV3 Furgoncini e camioncini
    HV0 Mezzi pesanti
    HV1 Camion medi (fino a 7,5 m) o veicoli commerciali leggeri
    HV2 Camion grandi o veicoli commerciali pesanti
    HV3 Autotreni (autocarri con rimorchio)
    HV4 Autoarticolati (trattori con semirimorchio)
    HV5 Autobus
    HV6 Altri (mezzi speciali, trasporti eccezionali, mezzi agricoli, macchine operatrici,….)

  11. TransportMeansCode.gc
  12. Nome sintetico TransportMeansCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/TransportMeansCode.gc
    Agency ENEA
    Codice Valore
    VEL Velocipedi
    MOT Motoveicoli
    MEL Mezzi leggeri
    MEP Mezzi pesanti
    MEP-05 Autobus
    AIR Aeromobile
    SHP Nave
    TRN Treno

  13. TransportScopeCode.gc
  14. Nome sintetico TransportScopeCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/TransportScopeCode.gc
    Agency ENEA
    Codice Valore
    PER Persone
    GOO Merci
    PET Animali

  15. CountryCode.gc
  16. Nome sintetico CountryCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/CountryCode.gc
    Agency ENEA
    Codice Valore
    IT Italia
    AL Albania
    AD Andorra
    AT Austria
    BE Belgio
    BG Bulgaria
    DK Danimarca
    FI Finlandia
    FR Francia
    DE Germania
    UK Regno Unito
    GR Grecia
    IE Irlanda
    IS Islanda
    LI Liechtenstein
    LU Lussemburgo
    MT Malta
    MC Monaco
    NO Norvegia
    NL Paesi Bassi
    PL Polonia
    PT Portogallo
    RO Romania
    SM San Marino
    ES Spagna
    SE Svezia
    CH Svizzera
    UA Ucraina
    HU Ungheria
    RU Federazione russa
    VA Stato della Città del Vaticano
    EE Estonia
    LV Lettonia
    LT Lituania
    HR Croazia
    SI Slovenia
    BA Bosnia-Erzegovina
    MK Macedonia del Nord
    MD Moldavia
    SK Slovacchia
    BY Bielorussia
    CZ Repubblica ceca
    ME Montenegro
    RS Serbia
    n.d. Kosovo
    AF Afghanistan
    SA Arabia Saudita
    BH Bahrein
    BD Bangladesh
    BT Bhutan
    MM Myanmar/Birmania
    BN Brunei Darussalam
    KH Cambogia
    LK Sri Lanka
    CN Cina
    CY Cipro
    KP Corea del Nord
    KR Corea del Sud
    AE Emirati Arabi Uniti
    PH Filippine
    PS Palestina
    JP Giappone
    JO Giordania
    IN India
    ID Indonesia
    IR Iran
    IQ Iraq
    IL Israele
    KW Kuwait
    LA Laos
    LB Libano
    TL Timor Leste
    MV Maldive
    MY Malaysia
    MN Mongolia
    NP Nepal
    OM Oman
    PK Pakistan
    QA Qatar
    SG Singapore
    SY Siria
    TH Thailandia
    TR Turchia
    VN Vietnam
    YE Yemen
    KZ Kazakistan
    UZ Uzbekistan
    AM Armenia
    AZ Azerbaigian
    GE Georgia
    KG Kirghizistan
    TJ Tagikistan
    TW Taiwan
    TM Turkmenistan
    DZ Algeria
    AO Angola
    CI Costa d'Avorio
    BJ Benin
    BW Botswana
    BF Burkina Faso
    BI Burundi
    CM Camerun
    CV Capo Verde
    CF Repubblica Centrafricana
    TD Ciad
    KM Comore
    CG Congo
    EG Egitto
    ET Etiopia
    GA Gabon
    GM Gambia
    GH Ghana
    DJ Gibuti
    GN Guinea
    GW Guinea-Bissau
    GQ Guinea equatoriale
    KE Kenya
    LS Lesotho
    LR Liberia
    LY Libia
    MG Madagascar
    MW Malawi
    ML Mali
    MA Marocco
    MR Mauritania
    MU Maurizio
    MZ Mozambico
    NA Namibia
    NE Niger
    NG Nigeria
    RW Ruanda
    ST Sao Tomé e Principe
    SC Seychelles
    SN Senegal
    SL Sierra Leone
    SO Somalia
    ZA Sudafrica
    SD Sudan
    SZ Eswatini
    TZ Tanzania
    TG Togo
    TN Tunisia
    UG Uganda
    CD Repubblica Democratica del Congo
    ZM Zambia
    ZW Zimbabwe
    ER Eritrea
    SS Sud Sudan
    AG Antigua e Barbuda
    BS Bahamas
    BB Barbados
    BZ Belize
    CA Canada
    CR Costa Rica
    CU Cuba
    DM Dominica
    DO Repubblica Dominicana
    SV El Salvador
    JM Giamaica
    GD Grenada
    GT Guatemala
    HT Haiti
    HN Honduras
    MX Messico
    NI Nicaragua
    PA Panama
    LC Santa Lucia
    VC Saint Vincent e Grenadine
    KN Saint Kitts e Nevis
    US Stati Uniti d'America
    AR Argentina
    BO Bolivia
    BR Brasile
    CL Cile
    CO Colombia
    EC Ecuador
    GY Guyana
    PY Paraguay
    PE Perù
    SR Suriname
    TT Trinidad e Tobago
    UY Uruguay
    VE Venezuela
    AU Australia
    FJ Figi
    KI Kiribati
    MH Isole Marshall
    FM Stati Federati di Micronesia
    NR Nauru
    NZ Nuova Zelanda
    PW Palau
    PG Papua Nuova Guinea
    SB Isole Salomone
    WS Samoa
    TO Tonga
    TV Tuvalu
    VU Vanuatu
    NC Nuova Caledonia
    MF Saint-Martin (FR)
    EH Sahara occidentale
    BL Saint-Barthélemy
    BM Bermuda
    CK Isole Cook (NZ)
    GI Gibilterra
    KY Isole Cayman
    AI Anguilla
    PF Polinesia francese
    FO Isole Fær Øer
    JE Jersey
    AW Aruba
    SX Sint Maarten (NL)
    GL Groenlandia
    n.d. Sark
    GG Guernsey
    FK Isole Falkland (Malvine)
    IM Isola di Man
    MS Montserrat
    CW Curaçao
    PN Isole Pitcairn
    PM Saint Pierre e Miquelon
    SH Sant'Elena
    TF Terre australi e antartiche francesi
    TC Isole Turks e Caicos
    VG Isole Vergini britanniche
    WF Wallis e Futuna

  17. FormatCode.gc
  18. Nome sintetico FormatCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/FormatCode.gc
    Agency ENEA
    Codice Valore
    WGS84-DMS WGS84 - Formato Gradi, Minuti, Secondi
    WGS84-DD WGS84 - Formato Gradi Decimali

  19. LanguageCode.gc
  20. Nome sintetico LanguageCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/LanguageCode.gc
    Agency ENEA
    Codice Valore
    IT Italiano
    EN Inglese

  21. TimezoneCode.gc
  22. Nome sintetico TimezoneCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/TimezoneCode.gc
    Agency ENEA
    Codice Valore
    UTC-12 −12:00
    UTC-11 −11:00
    UTC-10 −10:00
    UTC-9:30 −09:30
    UTC-9 −09:00
    UTC-8 −08:00
    UTC-7 −07:00
    UTC-6 −06:00
    UTC-5 −05:00
    UTC-4 −04:00
    UTC-3:30 −03:30
    UTC-3 −03:00
    UTC-2 −02:00
    UTC-1 −01:00
    UTC +00:00
    UTC+1 +01:00
    UTC+2 +02:00
    UTC+3 +03:00
    UTC+3:30 +03:30
    UTC+4 +04:00
    UTC+4:30 +04:30
    UTC+5 +05:00
    UTC+5:30 +05:30
    UTC+5:45 +05:45
    UTC+6 +06:00
    UTC+6:30 +06:30
    UTC+7 +07:00
    UTC+8 +08:00
    UTC+8:30 +08:30
    UTC+8:45 +08:45
    UTC+9 +09:00
    UTC+9:30 +09:30
    UTC+10 +10:00
    UTC+10:30 +10:30
    UTC+11 +11:00
    UTC+12 +12:00
    UTC+12:45 +12:45
    UTC+13 +13:00
    UTC+14 +14:00