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 2025-12-13 08:48
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.)