From 1ed29cdb528b32ac78f08739033fd2441be17b0b Mon Sep 17 00:00:00 2001 From: Alberto Abella Date: Fri, 17 Nov 2023 19:50:15 +0100 Subject: [PATCH] updated ParkingSpot/doc/spec_IT.md --- ParkingSpot/doc/spec_IT.md | 1121 ++++++++++++++++++------------------ 1 file changed, 566 insertions(+), 555 deletions(-) diff --git a/ParkingSpot/doc/spec_IT.md b/ParkingSpot/doc/spec_IT.md index 93045c2..bb71ee7 100644 --- a/ParkingSpot/doc/spec_IT.md +++ b/ParkingSpot/doc/spec_IT.md @@ -1,507 +1,505 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entità: ParcheggioSpot -====================== - - [Licenza aperta](https://github.com/smart-data-models//dataModel.Parking/blob/master/ParkingSpot/LICENSE.md) - [documento generato automaticamente](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) - - - Descrizione globale: **Un posto auto è un'area ben delimitata dove può essere parcheggiato un veicolo **. - versione: 0.1.0 - - - - ## Elenco delle proprietà - - [*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o diversi formati/modelli. -- `address[object]`: L'indirizzo postale . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Il paese. Ad esempio, la Spagna . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: La località in cui si trova l'indirizzo civico e che si trova nella regione . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: La regione in cui si trova la località, e che si trova nel paese . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: Un distretto è un tipo di divisione amministrativa che, in alcuni paesi, è gestita dal governo locale. - - `postOfficeBoxNumber[string]`: Il numero di casella postale per gli indirizzi di casella postale. Ad esempio, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: Il codice postale. Ad esempio, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: L'indirizzo stradale . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: Un nome alternativo per questa voce - `annotations[array]`: Annotazioni sull'elemento . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: L'area geografica in cui viene fornito il servizio o l'articolo offerto. . Model: [https://schema.org/Text](https://schema.org/Text) - `category[array]`: Categoria/e del parcheggio. `onStreet` : Il posto auto appartiene a un parcheggio onStreet. `offStreet` : Il posto auto appartiene a un parcheggio offStreet. - `color[string]`: Il colore del prodotto . Model: [https://schema.org/color](https://schema.org/color) - `dataProvider[string]`: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzata - `dateCreated[date-time]`: Timestamp di creazione dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `description[string]`: Descrizione dell'articolo - `id[*]`: Identificatore univoco dell'entità - `image[uri]`: Un'immagine dell'articolo . Model: [https://schema.org/URL](https://schema.org/URL) - `length[number]`: Lunghezza del posto auto . Model: [https://schema.org/length](https://schema.org/length) - `location[*]`: Riferimento geojson all'elemento. Può essere un punto, una stringa di linea, un poligono, un multi-punto, una stringa di linea o un poligono multiplo. - `name[string]`: Il nome di questo elemento - `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `refDevice[array]`: Il dispositivo che rappresenta il sensore fisico utilizzato per monitorare questo posto auto - `refParkingGroup[*]`: Gruppo a cui appartiene il posto auto. Per semplificare il modello, è consentito un solo gruppo per ogni posto auto. - `refParkingSite[*]`: Sito di parcheggio a cui appartiene il posto auto - `seeAlso[*]`: elenco di uri che puntano a risorse aggiuntive sull'elemento - `source[string]`: Una sequenza di caratteri che indica la fonte originale dei dati dell'entità come URL. Si consiglia di utilizzare il nome di dominio completamente qualificato del provider di origine o l'URL dell'oggetto di origine. - `status[string]`: Stato del posto auto dal punto di vista dell'occupazione. Enum:'chiuso, libero, occupato, sconosciuto'. . Model: [https://schema.org/Text](https://schema.org/Text) - `timeInstant[date-time]`: Timestamp del payload . Possono esistere ambienti di produzione in cui il tipo di attributo è uguale alla stringa `ISO8601`. In tal caso, deve essere considerato come un sinonimo di `DateTime`. Questo attributo viene mantenuto per la compatibilità con le vecchie implementazioni di riferimento FIWARE. . Model: [https://schema.org/Datetime](https://schema.org/Datetime) - `type[string]`: Tipo di entità NGSI. Deve essere ParkingSpot - `width[number]`: Larghezza del posto auto . Model: [https://schema.org/width](https://schema.org/width) - - Proprietà richieste -- `category` - `id` - `location` - `refParkingSite` - `status` - `type` - - Lo scopo di questo tipo di entità è monitorare lo stato dei posti auto individualmente. Pertanto, un'entità di tipo ParkingSpot non può esistere senza un'entità contenente di tipo (OnStreetParking, OffStreetParking). Un posto auto può appartenere a un gruppo. - - - ## Modello di dati descrizione delle proprietà - Ordinati in ordine alfabetico (clicca per i dettagli) - - -
full yaml details - ```yaml -ParkingSpot: - description: A parking spot is an area well delimited where one vehicle can be parked. - properties: - address: - description: The mailing address - properties: - addressCountry: - description: 'The country. For example, Spain' - type: string - x-ngsi: - model: https://schema.org/addressCountry - type: Property - addressLocality: - description: 'The locality in which the street address is, and which is in the region' - type: string - x-ngsi: - model: https://schema.org/addressLocality - type: Property - addressRegion: - description: 'The region in which the locality is, and which is in the country' - type: string - x-ngsi: - model: https://schema.org/addressRegion - type: Property - district: - description: 'A district is a type of administrative division that, in some countries, is managed by the local government' - type: string - x-ngsi: - type: Property - postOfficeBoxNumber: - description: 'The post office box number for PO box addresses. For example, 03578' - type: string - x-ngsi: - model: https://schema.org/postOfficeBoxNumber - type: Property - postalCode: - description: 'The postal code. For example, 24004' - type: string - x-ngsi: - model: https://schema.org/https://schema.org/postalCode - type: Property - streetAddress: - description: The street address - type: string - x-ngsi: - model: https://schema.org/streetAddress - type: Property - streetNr: - description: Number identifying a specific property on a public street - type: string - x-ngsi: - type: Property - type: object - x-ngsi: - model: https://schema.org/address - type: Property - alternateName: - description: An alternative name for this item - type: string - x-ngsi: - type: Property - annotations: - description: Annotations about the item - items: - type: string - type: array - x-ngsi: - model: https://schema.org/Text - type: Property - areaServed: - description: The geographic area where a service or offered item is provided - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - category: - description: 'Category(ies) of the parking spot. `onStreet` : The parking spot belongs to an onStreet parking site. `offStreet` : The parking spot belongs to an offStreet parking site' - items: - enum: - - onStreet - - offStreet - type: string - minItems: 1 - type: array - uniqueItems: true - x-ngsi: - type: Property - color: - description: The color of the product - type: string - x-ngsi: - model: https://schema.org/color - type: Property - dataProvider: - description: A sequence of characters identifying the provider of the harmonised data entity - type: string - x-ngsi: - type: Property - dateCreated: - description: Entity creation timestamp. This will usually be allocated by the storage platform - format: date-time - type: string - x-ngsi: - type: Property - dateModified: - description: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform - format: date-time - type: string - x-ngsi: - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - id: - anyOf: - - description: Identifier format of any NGSI entity - maxLength: 256 - minLength: 1 - pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ - type: string - x-ngsi: - type: Property - - description: Identifier format of any NGSI entity - format: uri - type: string - x-ngsi: - type: Property - description: Unique identifier of the entity - x-ngsi: - type: Property - image: - description: An image of the item - format: uri - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - length: - description: Length of the parking spot - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/length - type: Property - location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' - oneOf: - - description: Geojson reference to the item. Point - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - type: number - minItems: 2 - type: array - type: - enum: - - Point - type: string - required: - - type - - coordinates - title: GeoJSON Point - type: object - x-ngsi: - type: GeoProperty - - description: Geojson reference to the item. LineString - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - items: - type: number - minItems: 2 - type: array - minItems: 2 - type: array - type: - enum: - - LineString - type: string - required: - - type - - coordinates - title: GeoJSON LineString - type: object - x-ngsi: - type: GeoProperty - - description: Geojson reference to the item. Polygon - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - items: - items: - type: number - minItems: 2 - type: array - minItems: 4 - type: array - type: array - type: - enum: - - Polygon - type: string - required: - - type - - coordinates - title: GeoJSON Polygon - type: object - x-ngsi: - type: GeoProperty - - description: Geojson reference to the item. MultiPoint - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - items: - type: number - minItems: 2 - type: array - type: array - type: - enum: - - MultiPoint - type: string - required: - - type - - coordinates - title: GeoJSON MultiPoint - type: object - x-ngsi: - type: GeoProperty - - description: Geojson reference to the item. MultiLineString - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - items: - items: - type: number - minItems: 2 - type: array - minItems: 2 - type: array - type: array - type: - enum: - - MultiLineString - type: string - required: - - type - - coordinates - title: GeoJSON MultiLineString - type: object - x-ngsi: - type: GeoProperty - - description: Geojson reference to the item. MultiLineString - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - items: - items: - items: - type: number - minItems: 2 - type: array - minItems: 4 - type: array - type: array - type: array - type: - enum: - - MultiPolygon - type: string - required: - - type - - coordinates - title: GeoJSON MultiPolygon - type: object - x-ngsi: - type: GeoProperty - x-ngsi: - type: GeoProperty - name: - description: The name of this item - type: string - x-ngsi: - type: Property - owner: - description: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) - items: - anyOf: - - description: Identifier format of any NGSI entity - maxLength: 256 - minLength: 1 - pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ - type: string - x-ngsi: - type: Property - - description: Identifier format of any NGSI entity - format: uri - type: string - x-ngsi: - type: Property - description: Unique identifier of the entity - x-ngsi: - type: Property - type: array - x-ngsi: - type: Property - refDevice: - description: The device representing the physical sensor used to monitor this parking spot - items: - anyOf: - - description: Identifier format of any NGSI entity - maxLength: 256 - minLength: 1 - pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ - type: string - x-ngsi: - type: Property - - description: Identifier format of any NGSI entity - format: uri - type: string - x-ngsi: - type: Property - minItems: 1 - type: array - uniqueItems: true - x-ngsi: - type: Relationship - refParkingGroup: - anyOf: - - description: Identifier format of any NGSI entity - maxLength: 256 - minLength: 1 - pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ - type: string - x-ngsi: - type: Property - - description: Identifier format of any NGSI entity - format: uri - type: string - x-ngsi: - type: Property - description: Group to which the parking spot belongs to. For model simplification purposes only one group is allowed per parking spot - x-ngsi: - type: Relationship - refParkingSite: - anyOf: - - description: Identifier format of any NGSI entity - maxLength: 256 - minLength: 1 - pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ - type: string - x-ngsi: - type: Property - - description: Identifier format of any NGSI entity - format: uri - type: string - x-ngsi: - type: Property - description: Parking site to which the parking spot belongs to - x-ngsi: - type: Relationship - seeAlso: - description: list of uri pointing to additional resources about the item - oneOf: - - items: - format: uri - type: string - minItems: 1 - type: array - - format: uri - type: string - x-ngsi: - type: Property - source: - description: 'A sequence of characters giving the original source of the entity data as a URL. Recommended to be the fully qualified domain name of the source provider, or the URL to the source object' - type: string - x-ngsi: - type: Property - status: - description: 'Status of the parking spot from the point of view of occupancy. Enum:''closed, free, occupied, unknown''' - enum: - - closed - - free - - occupied - - unknown - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - timeInstant: - description: 'Timestamp of the payload . There can be production environments where the attribute type is equal to the `ISO8601` string. If so, it must be considered as a synonym of `DateTime`. This attribute is kept for backwards compatibility with old FIWARE reference implementations' - format: date-time - type: string - x-ngsi: - model: https://schema.org/Datetime - type: Property - type: - description: NGSI Entity type. It has to be ParkingSpot - enum: - - ParkingSpot - type: string - x-ngsi: - type: Property - width: - description: Width of the parking spot - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/width - type: Property - required: - - id - - location - - type - - status - - category - - refParkingSite - type: object - x-derived-from: "" - x-disclaimer: 'Redistribution and use in source and binary forms, with or without modification, are permitted provided that the license conditions are met. Copyleft (c) 2022 Contributors to Smart Data Models Program' - x-license-url: https://github.com/smart-data-models/dataModel.Parking/blob/master/ParkingSpot/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Parking/ParkingSpot/schema.json - x-model-tags: "" - x-version: 0.1.0 -``` -
- - - - - ## Esempi di payload - #### ParkingSpot NGSI-v2 Esempio di valori chiave - Ecco un esempio di ParkingSpot in formato JSON-LD come valori-chiave. Questo è compatibile con NGSI-v2 quando si usa `options=keyValues` e restituisce i dati di contesto di una singola entità. -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + Entità: ParcheggioSpot +====================== + + [Licenza aperta](https://github.com/smart-data-models//dataModel.Parking/blob/master/ParkingSpot/LICENSE.md) + [documento generato automaticamente](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) + + + Descrizione globale: **Un posto auto è un'area ben delimitata dove può essere parcheggiato un veicolo **. + versione: 0.1.0 + + + ## Elenco delle proprietà + [*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o diversi formati/modelli. +- `address[object]`: L'indirizzo postale . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Il paese. Ad esempio, la Spagna . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La località in cui si trova l'indirizzo civico e che si trova nella regione . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La regione in cui si trova la località, e che si trova nel paese . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un distretto è un tipo di divisione amministrativa che, in alcuni paesi, è gestita dal governo locale. + - `postOfficeBoxNumber[string]`: Il numero di casella postale per gli indirizzi di casella postale. Ad esempio, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Il codice postale. Ad esempio, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: L'indirizzo stradale . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) +- `alternateName[string]`: Un nome alternativo per questa voce - `annotations[array]`: Annotazioni sull'elemento . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: L'area geografica in cui viene fornito il servizio o l'articolo offerto. . Model: [https://schema.org/Text](https://schema.org/Text) - `category[array]`: Categoria/e del parcheggio. `onStreet` : Il posto auto appartiene a un parcheggio onStreet. `offStreet` : Il posto auto appartiene a un parcheggio offStreet. - `color[string]`: Il colore del prodotto . Model: [https://schema.org/color](https://schema.org/color) - `dataProvider[string]`: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzata - `dateCreated[date-time]`: Timestamp di creazione dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `description[string]`: Descrizione dell'articolo - `id[*]`: Identificatore univoco dell'entità - `image[uri]`: Un'immagine dell'articolo . Model: [https://schema.org/URL](https://schema.org/URL) - `length[number]`: Lunghezza del posto auto . Model: [https://schema.org/length](https://schema.org/length) - `location[*]`: Riferimento geojson all'elemento. Può essere un punto, una stringa di linea, un poligono, un multi-punto, una stringa di linea o un poligono multiplo. - `name[string]`: Il nome di questo elemento - `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `refDevice[array]`: Il dispositivo che rappresenta il sensore fisico utilizzato per monitorare questo posto auto - `refParkingGroup[*]`: Gruppo a cui appartiene il posto auto. Per semplificare il modello, è consentito un solo gruppo per ogni posto auto. - `refParkingSite[*]`: Sito di parcheggio a cui appartiene il posto auto - `seeAlso[*]`: elenco di uri che puntano a risorse aggiuntive sull'elemento - `source[string]`: Una sequenza di caratteri che indica la fonte originale dei dati dell'entità come URL. Si consiglia di utilizzare il nome di dominio completamente qualificato del provider di origine o l'URL dell'oggetto di origine. - `status[string]`: Stato del posto auto dal punto di vista dell'occupazione. Enum:'chiuso, libero, occupato, sconosciuto'. . Model: [https://schema.org/Text](https://schema.org/Text) - `timeInstant[date-time]`: Timestamp del payload . Possono esistere ambienti di produzione in cui il tipo di attributo è uguale alla stringa `ISO8601`. In tal caso, deve essere considerato come un sinonimo di `DateTime`. Questo attributo viene mantenuto per la compatibilità con le vecchie implementazioni di riferimento FIWARE. . Model: [https://schema.org/Datetime](https://schema.org/Datetime) - `type[string]`: Tipo di entità NGSI. Deve essere ParkingSpot - `width[number]`: Larghezza del posto auto . Model: [https://schema.org/width](https://schema.org/width) + + Proprietà richieste +- `category` - `id` - `location` - `refParkingSite` - `status` - `type` + + Lo scopo di questo tipo di entità è monitorare lo stato dei posti auto individualmente. Pertanto, un'entità di tipo ParkingSpot non può esistere senza un'entità contenente di tipo (OnStreetParking, OffStreetParking). Un posto auto può appartenere a un gruppo. + + + ## Modello di dati descrizione delle proprietà + Ordinati in ordine alfabetico (clicca per i dettagli) + + +
full yaml details + ```yaml +ParkingSpot: + description: A parking spot is an area well delimited where one vehicle can be parked. + properties: + address: + description: The mailing address + properties: + addressCountry: + description: 'The country. For example, Spain' + type: string + x-ngsi: + model: https://schema.org/addressCountry + type: Property + addressLocality: + description: 'The locality in which the street address is, and which is in the region' + type: string + x-ngsi: + model: https://schema.org/addressLocality + type: Property + addressRegion: + description: 'The region in which the locality is, and which is in the country' + type: string + x-ngsi: + model: https://schema.org/addressRegion + type: Property + district: + description: 'A district is a type of administrative division that, in some countries, is managed by the local government' + type: string + x-ngsi: + type: Property + postOfficeBoxNumber: + description: 'The post office box number for PO box addresses. For example, 03578' + type: string + x-ngsi: + model: https://schema.org/postOfficeBoxNumber + type: Property + postalCode: + description: 'The postal code. For example, 24004' + type: string + x-ngsi: + model: https://schema.org/https://schema.org/postalCode + type: Property + streetAddress: + description: The street address + type: string + x-ngsi: + model: https://schema.org/streetAddress + type: Property + streetNr: + description: Number identifying a specific property on a public street + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + model: https://schema.org/address + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + type: Property + annotations: + description: Annotations about the item + items: + type: string + type: array + x-ngsi: + model: https://schema.org/Text + type: Property + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + category: + description: 'Category(ies) of the parking spot. `onStreet` : The parking spot belongs to an onStreet parking site. `offStreet` : The parking spot belongs to an offStreet parking site' + items: + enum: + - onStreet + - offStreet + type: string + minItems: 1 + type: array + uniqueItems: true + x-ngsi: + type: Property + color: + description: The color of the product + type: string + x-ngsi: + model: https://schema.org/color + type: Property + dataProvider: + description: A sequence of characters identifying the provider of the harmonised data entity + type: string + x-ngsi: + type: Property + dateCreated: + description: Entity creation timestamp. This will usually be allocated by the storage platform + format: date-time + type: string + x-ngsi: + type: Property + dateModified: + description: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform + format: date-time + type: string + x-ngsi: + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + id: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Unique identifier of the entity + x-ngsi: + type: Property + image: + description: An image of the item + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + length: + description: Length of the parking spot + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/length + type: Property + location: + description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + oneOf: + - description: Geojson reference to the item. Point + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + type: number + minItems: 2 + type: array + type: + enum: + - Point + type: string + required: + - type + - coordinates + title: GeoJSON Point + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. LineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: + enum: + - LineString + type: string + required: + - type + - coordinates + title: GeoJSON LineString + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. Polygon + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: + enum: + - Polygon + type: string + required: + - type + - coordinates + title: GeoJSON Polygon + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiPoint + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + type: number + minItems: 2 + type: array + type: array + type: + enum: + - MultiPoint + type: string + required: + - type + - coordinates + title: GeoJSON MultiPoint + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiLineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + type: + enum: + - MultiLineString + type: string + required: + - type + - coordinates + title: GeoJSON MultiLineString + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiLineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + name: + description: The name of this item + type: string + x-ngsi: + type: Property + owner: + description: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) + items: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Unique identifier of the entity + x-ngsi: + type: Property + type: array + x-ngsi: + type: Property + refDevice: + description: The device representing the physical sensor used to monitor this parking spot + items: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + minItems: 1 + type: array + uniqueItems: true + x-ngsi: + type: Relationship + refParkingGroup: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Group to which the parking spot belongs to. For model simplification purposes only one group is allowed per parking spot + x-ngsi: + type: Relationship + refParkingSite: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Parking site to which the parking spot belongs to + x-ngsi: + type: Relationship + seeAlso: + description: list of uri pointing to additional resources about the item + oneOf: + - items: + format: uri + type: string + minItems: 1 + type: array + - format: uri + type: string + x-ngsi: + type: Property + source: + description: 'A sequence of characters giving the original source of the entity data as a URL. Recommended to be the fully qualified domain name of the source provider, or the URL to the source object' + type: string + x-ngsi: + type: Property + status: + description: 'Status of the parking spot from the point of view of occupancy. Enum:''closed, free, occupied, unknown''' + enum: + - closed + - free + - occupied + - unknown + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + timeInstant: + description: 'Timestamp of the payload . There can be production environments where the attribute type is equal to the `ISO8601` string. If so, it must be considered as a synonym of `DateTime`. This attribute is kept for backwards compatibility with old FIWARE reference implementations' + format: date-time + type: string + x-ngsi: + model: https://schema.org/Datetime + type: Property + type: + description: NGSI Entity type. It has to be ParkingSpot + enum: + - ParkingSpot + type: string + x-ngsi: + type: Property + width: + description: Width of the parking spot + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/width + type: Property + required: + - id + - location + - type + - status + - category + - refParkingSite + type: object + x-derived-from: "" + x-disclaimer: 'Redistribution and use in source and binary forms, with or without modification, are permitted provided that the license conditions are met. Copyleft (c) 2022 Contributors to Smart Data Models Program' + x-license-url: https://github.com/smart-data-models/dataModel.Parking/blob/master/ParkingSpot/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Parking/ParkingSpot/schema.json + x-model-tags: "" + x-version: 0.1.0 +``` +
+ + + + + ## Esempi di payload + #### ParkingSpot NGSI-v2 Esempio di valori chiave + Ecco un esempio di ParkingSpot in formato JSON-LD come valori-chiave. Questo è compatibile con NGSI-v2 quando si usa `options=keyValues` e restituisce i dati di contesto di una singola entità. +
show/hide example ```json { "id": "santander:daoiz_velarde_1_5:3", @@ -509,22 +507,28 @@ ParkingSpot: "name": "A-13", "location": { "type": "Point", - "coordinates": [-3.80356167695194, 43.46296641666926] + "coordinates": [ + -3.80356167695194, + 43.46296641666926 + ] }, "status": "free", - "category": ["onStreet"], + "category": [ + "onStreet" + ], "refParkingSite": "santander:daoiz_velarde_1_5" } ``` -
- #### ParkingSpot NGSI-v2 normalizzato Esempio - Ecco un esempio di ParkingSpot in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano le opzioni e restituisce i dati di contesto di una singola entità. -
show/hide example +
+ #### ParkingSpot NGSI-v2 normalizzato Esempio + Ecco un esempio di ParkingSpot in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano le opzioni e restituisce i dati di contesto di una singola entità. +
show/hide example ```json { "id": "santander:daoiz_velarde_1_5:3", "type": "ParkingSpot", "status": { + "type": "Text", "value": "free", "metadata": { "timestamp": { @@ -532,34 +536,68 @@ ParkingSpot: "value": "2018-09-21T12:00:00" }, "parkingPermit": { - "type": "Property", + "type": "Text", "value": "yes" } } }, "category": { - "value": ["onStreet"] + "type": "StructuredValue", + "value": [ + "onStreet" + ] }, "refParkingSite": { - "type": "Relationship", - "object": "santander:daoiz_velarde_1_5" + "type": "Text", + "value": "santander:daoiz_velarde_1_5" }, "name": { + "type": "Text", "value": "A-13" }, "location": { "type": "geo:json", "value": { "type": "Point", - "coordinates": [-3.80356167695194, 43.46296641666926] + "coordinates": [ + -3.80356167695194, + 43.46296641666926 + ] } } } ``` -
- #### ParkingSpot Valori chiave NGSI-LD Esempio - Ecco un esempio di ParkingSpot 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à. -
show/hide example +
+ #### ParkingSpot Valori chiave NGSI-LD Esempio + Ecco un esempio di ParkingSpot 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à. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:ParkingSpot:santander:daoiz_velarde_1_5:3", + "type": "ParkingSpot", + "category": [ + "onStreet" + ], + "location": { + "coordinates": [ + -3.80356167695194, + 43.46296641666926 + ], + "type": "Point" + }, + "name": "A-13", + "refParkingSite": "urn:ngsi-ld:ParkingSite:santander:daoiz_velarde_1_5", + "status": "free", + "@context": [ + "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld", + "https://raw.githubusercontent.com/smart-data-models/dataModel.Parking/master/context.jsonld" + ] +} +``` +
+ #### ParkingSpot NGSI-LD normalizzato Esempio + Ecco un esempio di ParkingSpot in formato JSON-LD normalizzato. Questo è compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati di contesto di una singola entità. +
show/hide example ```json { "id": "urn:ngsi-ld:ParkingSpot:santander:daoiz_velarde_1_5:3", @@ -603,39 +641,12 @@ ParkingSpot: ] } ``` -
- #### ParkingSpot NGSI-LD normalizzato Esempio - Ecco un esempio di ParkingSpot in formato JSON-LD normalizzato. Questo è compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati di contesto di una singola entità. -
show/hide example - ```json - { - "id": "urn:ngsi-ld:ParkingSpot:santander:daoiz_velarde_1_5:3", - "type": "ParkingSpot", - "category": [ - "onStreet" - ], - "location": { - "coordinates": [ - -3.80356167695194, - 43.46296641666926 - ], - "type": "Point" - }, - "name": "A-13", - "refParkingSite": "urn:ngsi-ld:ParkingSite:santander:daoiz_velarde_1_5", - "status": "free", - "@context": [ - "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld", - "https://raw.githubusercontent.com/smart-data-models/dataModel.Parking/master/context.jsonld" - ] -} -``` -
- - - - Vedere [FAQ 10](https://smartdatamodels.org/index.php/faqs/) per ottenere una risposta su come gestire le unità di grandezza. - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + Vedere [FAQ 10](https://smartdatamodels.org/index.php/faqs/) per ottenere una risposta su come gestire le unità di grandezza. + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM)