Descrizione semantica dell´UrbanDataset Events della SCP Ontology 2.0

Questo documento fornisce una documentazione human-friendly dell´UrbanDataset Events 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-07 13:19
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. Events

PARTE II: Liste di codici

  1. EventAccessCode.gc
  2. EventCategoryCode.gc
  3. EventCoverageCode.gc
  4. EventFrequencyCode.gc
  5. EventQualifierCode.gc
  6. EventScopeCode.gc
  7. LocationCapacityCode.gc
  8. OrganizerTypeCode.gc
  9. TargetAudienceCode.gc
  10. FormatCode.gc
  11. LanguageCode.gc
  12. 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. Events-2.0
  2. Identificazione UrbanDataset
    Scopo Fornisce il set di informazioni che rappresenta un Evento inteso come manifestazione organizzata (ad es. concerto, partita di calcio, fiera,...), ricorrenza (ad es. Natale, patrono,...) o circostanza (ad es. chiusura scuole)
    Categoria / Sottocategoria SocioEconomicDevelopment / E-Governance
    Identificatore Events-2.0
    Nome Events
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#Events
    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
    EventID Identificativo univoco assegnato all'evento

    string

    EventName Titolo o nome dell'evento

    string

    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

    EventAccessCode Codice indicante se l'accesso è gratuito o a pagamento

    no string

    EventAccessCode.gc
    EventCategoryCode Codice indicante la categoria dell'evento, intesa come tipo di organizzazione dell'evento (fiera, mercato, ...)

    no string

    EventCategoryCode.gc
    EventCoverageCode Copertura e rilevanza territoriale dell'evento (locale, regionale, nazionale, internazionale)

    no string

    EventCoverageCode.gc
    EventDescription Descrizione estesa dell'evento

    no string

    EventFrequencyCode Codice indicate la cadenza con cui si verifica l'evento (ad es., annuale, settimanale, ecc.)

    no string

    EventFrequencyCode.gc
    EventQualifierCode Codice indicante se l'evento è una manifestazione organizzata (ad es. concerto, partita di calcio, fiera, ecc.), una ricorrenza (ad es. Natale, patrono, ecc.) o una circostanza (ad es. chiusura scuole, covid)

    no string

    EventQualifierCode.gc
    EventRecurrenceDescription Descrizione testuale della periodicità dell'evento

    no string

    EventScopeCode Codice indicante il tema o l'ambito dell'evento (sport, cultura, musica,...)

    no string

    EventScopeCode.gc
    EventSecondaryCategoryCode Categoria ulteriore a cui può essere riferito l'evento, intesa come tipo di organizzazione dell'evento (fiera, mercato, ...)

    no string

    EventCategoryCode.gc
    EventSecondaryScopeCode Codice indicante un tema o ambito ulteriore a cui può essere riferito l'evento (calcio, jazz,...)

    no string

    EventScopeCode.gc
    EventSourceName Nome della sorgente da cui sono stati acquisiti i dati dell'evento

    no string

    EventSourceURL URL della pagina web della sorgente da cui sono stati acquisiti i dati dell'evento

    no string

    EventTag Parole chiave che caratterizzano l'evento

    no string

    EventWebPageURL URL della pagina web dedicata all'evento

    no string

    LocationCapacityCode Codice indicante la dimensione dell'evento in termini di presenze (numero di partecipati atteso, espresso come ordine di grandezza). Può anche corrispondere alla capacità del luogo ospitante l'evento. Consente anche di dare una dimensione all'evento

    no string

    LocationCapacityCode.gc
    LocationID Identificativo univoco del luogo di svolgimento dell'evento

    no string

    LocationName Nome del luogo di svolgimento dell'evento

    no string

    OrganizerName Denominazione del soggetto che organizza l'evento

    no string

    OrganizerTypeCode Codice che specifica il tipo di un soggetto (PA, privato, associazione culturale, ecc.)

    no string

    OrganizerTypeCode.gc
    SchemeID Indica lo schema di codifica a cui appartengono gli identificativi forniti nei campi LocationID e SecondaryLocationID (ad es. 'ISTAT' se la città dell'evento è identificata tramite i codici ISTAT delle città)

    no string

    SecondaryLocationID Identificativo univoco di un secondo luogo di svolgimento dell'evento

    no string

    SecondaryLocationName Nome di un secondo luogo di svolgimento dell'evento

    no string

    SecondaryTargetAudienceCode Codice indicante una ulteriore categoria di utenti a cui è rivolto l'evento

    no string

    TargetAudienceCode.gc