diff --git a/APDSObservation/ADOPTERS.yaml b/APDSObservation/ADOPTERS.yaml index b0b6ab680..002645e54 100644 --- a/APDSObservation/ADOPTERS.yaml +++ b/APDSObservation/ADOPTERS.yaml @@ -1,27 +1,27 @@ description: This is a compilation list of the current adopters of the data model APDSObservation of the Subject Transportation. currentAdopters: - - adopter: Davy Van Deun - description: Project manager - mail: davy.vandeun@antwerpen.be - organization: Stad Antwerpen - project: MPA ANPR scanwagens - comments: A project to acquire vehicles equipped with ANPR cameras for automated parking enforcement for the city of Antwerp. The project scope included the standardisation of information flow from vehicle to backend. - startDate: 1/1/2022 - - adopter: Robert De Beukeulaer - description: Domain Specialist - mail: robert.debeukelaer@digipolis.be - organization: Digipolis Antwerpen - project: MPA ANPR scanwagens - comments: Project to set up the neccesary integration components to facilitate information flow from the ALPR scanning vehicle to the parking enforcement software. - startDate: 1/10/2022 - - adopter: Martijn Oostdam - description: Project Manager - mail: m.oostdam@arvoo.com - organization: ARVOO - project: MPA ANPR Scanwagens - comments: ANPR Scanning equipment for Scancars - startDate: 1/10/2022 + adopter: Davy Van Deun + description: Project manager + mail: davy.vandeun@antwerpen.be + organization: Stad Antwerpen + project: MPA ANPR scanwagens + comments: A project to acquire vehicles equipped with ANPR cameras for automated parking enforcement for the city of Antwerp. The project scope included the standardisation of information flow from vehicle to backend. + startDate: 1/1/2022 +- + adopter: Robert De Beukeulaer + description: Domain Specialist + mail: robert.debeukelaer@digipolis.be + organization: Digipolis Antwerpen + project: MPA ANPR scanwagens + comments: Project to set up the necessary integration components to facilitate information flow from the ALPR scanning vehicle to the parking enforcement software. + startDate: 1/10/2022 +- + adopter: Martijn Oostdam + description: Project Manager + mail: m.oostdam@arvoo.com + organization: ARVOO + project: MPA ANPR Scanwagens + comments: ANPR Scanning equipment for Scancars + startDate: 1/10/2022 diff --git a/AnprFlowObserved/ADOPTERS.yaml b/AnprFlowObserved/ADOPTERS.yaml index 710f0d5d9..13aa5176b 100644 --- a/AnprFlowObserved/ADOPTERS.yaml +++ b/AnprFlowObserved/ADOPTERS.yaml @@ -1,5 +1,5 @@ description: This is a compilation list of the current adopters of the data model [Data model] of the Subject [Subject]. All fields are non mandatory. More info at https://smart-data-models.github.io/data-models/templates/dataModel/CURRENT_ADOPTERS.yaml -currentAdopters: +currentAdopters: - adopter: Ruud Reunis description: Describes the registration of vehicles by an ANPR camera @@ -8,3 +8,11 @@ currentAdopters: project: comments: startDate: +- + adopter: SIOT INGENIERIA + description: Field mapping for Milesight, Hanwha, and Vivotek ANPR cameras + mail: siot@siot-ingenieria.com.co + organization: SIOT INGENIERIA + project: CINTEL Duitama Inteligente + comments: + startDate: diff --git a/AnprFlowObserved/README.md b/AnprFlowObserved/README.md index 8bf6abfe6..ea1d33c2c 100644 --- a/AnprFlowObserved/README.md +++ b/AnprFlowObserved/README.md @@ -1,6 +1,6 @@ [![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) # AnprFlowObserved -Version: 0.0.2 +Version: 0.0.3 ## Description diff --git a/AnprFlowObserved/doc/spec.md b/AnprFlowObserved/doc/spec.md index fde4ee002..07eb50e4f 100644 --- a/AnprFlowObserved/doc/spec.md +++ b/AnprFlowObserved/doc/spec.md @@ -8,7 +8,7 @@ Global description: **The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images.** - version: 0.0.1 + version: 0.0.2 @@ -45,42 +45,42 @@
full yaml details ```yaml AnprFlowObserved: - description: 'The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images.' + description: The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -161,27 +161,33 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship laneId: description: Lane identifier. Lane identification provided by the observer type: string x-ngsi: type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -196,11 +202,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -208,6 +218,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -222,11 +234,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -236,6 +252,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -250,17 +268,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -275,11 +299,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -289,6 +317,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -308,6 +338,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -319,6 +350,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -430,20 +463,26 @@ AnprFlowObserved: x-ngsi: type: Property coordinates: - description: 'Sequence of position points describing this location, expressed in coordinate system' + description: Sequence of position points describing this location, expressed in coordinate system oneOf: - description: Geojson reference to the item. Point properties: bbox: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -458,11 +497,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -470,6 +513,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -484,11 +529,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -498,6 +547,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -512,17 +563,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -537,11 +594,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -551,6 +612,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -570,6 +633,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -581,6 +645,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -620,6 +686,24 @@ AnprFlowObserved: type: object x-ngsi: type: Property + plateColor: + description: Detected plate color of the observed vehicle + properties: + confidence: + description: Confidence level of the detection + maximum: 1 + minimum: 0 + type: number + x-ngsi: + type: Property + name: + description: Color name + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + type: Property speed: description: Detected speed of the observed vehicle minimum: 0 @@ -647,7 +731,7 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -692,7 +776,7 @@ AnprFlowObserved: 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' + 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 @@ -721,12 +805,12 @@ AnprFlowObserved: - location - dateObserved 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) 2024 Contributors to Smart Data Models Program' + 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) 2025 Contributors to Smart Data Models Program x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/AnprFlowObserved/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/AnprFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 + x-model-tags: '' + x-version: 0.0.3 ```
@@ -777,6 +861,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -857,6 +945,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } } }, @@ -926,6 +1018,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -1000,7 +1096,8 @@ AnprFlowObserved: "model": "A3", "color": "black", "country": "BE", - "licensePlate": "1-ABC-123" + "licensePlate": "1-ABC-123", + "plateColor": "white" } }, "refImages": { diff --git a/AnprFlowObserved/doc/spec_DE.md b/AnprFlowObserved/doc/spec_DE.md index 57fedd035..e70f274ae 100644 --- a/AnprFlowObserved/doc/spec_DE.md +++ b/AnprFlowObserved/doc/spec_DE.md @@ -8,13 +8,13 @@ Globale Beschreibung: **Das Datenmodell stellt eine Beobachtung dar, die mit dem Vorbeifahren eines Fahrzeugs an einem bestimmten Ort und zu einer bestimmten Zeit verbunden ist. Dieses Datenmodell basiert auf dem [dataModel.Transportation/ItemFlowObserved], erweitert um ANPR-spezifische Eigenschaften und Links zu den Beobachtungsbildern.** - Version: 0.0.1 + Version: 0.0.2 ## Liste der Eigenschaften - [*] Wenn es für ein Attribut keinen Typ gibt, kann es mehrere Typen oder verschiedene Formate/Muster haben. + [*] Wenn es für ein Attribut keinen Typ gibt, liegt das daran, dass es mehrere Typen oder unterschiedliche Formate/Muster haben kann. - `address[object]`: Die Postanschrift . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Das Land. Zum Beispiel, Spanien . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - `addressLocality[string]`: Die Ortschaft, in der sich die Adresse befindet, und die in der Region liegt . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - `addressRegion[string]`: Die Region, in der sich der Ort befindet, und die auf dem Land liegt . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) @@ -30,7 +30,7 @@ - `licensePlate[object]`: Erkanntes Nummernschild des beobachteten Fahrzeugs - `model[object]`: Erkanntes Markenmodell des beobachteten Fahrzeugs - `speed[number]`: Ermittelte Geschwindigkeit des beobachteten Fahrzeugs -- `owner[array]`: Eine Liste mit einer JSON-kodierten Zeichenfolge, die auf die eindeutigen Kennungen der Eigentümer verweist - `refImages[array]`: Array mit mehreren Objekten, die auf Bilder verweisen - `seeAlso[*]`: Liste von URLs, die auf zusätzliche Ressourcen zu dem Artikel verweisen - `source[string]`: Eine Folge von Zeichen, die die ursprüngliche Quelle der Entitätsdaten als URL angibt. Empfohlen wird der voll qualifizierte Domänenname des Quellanbieters oder die URL des Quellobjekts. - `type[string]`: NGSI-Entitätstyp. Es muss AnprFlowObserved sein - `vehiclePlateNotRead[boolean]`: Zeigt an, ob eine Lizenz nicht gelesen werden konnte - `zonesServed[array]`: Reihe von Zonen, die die Beobachtungen empfangen oder lesen können +- `owner[array]`: Eine Liste mit einer JSON-kodierten Zeichenfolge, die auf die eindeutigen Kennungen der Eigentümer verweist - `refImages[array]`: Array mit mehreren Objekten, die auf Bilder verweisen - `seeAlso[*]`: Liste von URLs, die auf zusätzliche Ressourcen zu dem Artikel verweisen - `source[string]`: Eine Folge von Zeichen, die die ursprüngliche Quelle der Entitätsdaten als URL angibt. Empfohlen wird der vollständig qualifizierte Domänenname des Quellanbieters oder die URL des Quellobjekts. - `type[string]`: NGSI-Entitätstyp. Es muss AnprFlowObserved sein - `vehiclePlateNotRead[boolean]`: Zeigt an, ob eine Lizenz nicht gelesen werden konnte - `zonesServed[array]`: Array von Zonen, die die Beobachtungen empfangen oder lesen können Erforderliche Eigenschaften - `dateObserved` - `id` - `location` - `type` @@ -45,42 +45,42 @@
full yaml details ```yaml AnprFlowObserved: - description: 'The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images.' + description: The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -161,27 +161,33 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship laneId: description: Lane identifier. Lane identification provided by the observer type: string x-ngsi: type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -196,11 +202,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -208,6 +218,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -222,11 +234,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -236,6 +252,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -250,17 +268,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -275,11 +299,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -289,6 +317,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -308,6 +338,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -319,6 +350,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -430,20 +463,26 @@ AnprFlowObserved: x-ngsi: type: Property coordinates: - description: 'Sequence of position points describing this location, expressed in coordinate system' + description: Sequence of position points describing this location, expressed in coordinate system oneOf: - description: Geojson reference to the item. Point properties: bbox: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -458,11 +497,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -470,6 +513,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -484,11 +529,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -498,6 +547,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -512,17 +563,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -537,11 +594,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -551,6 +612,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -570,6 +633,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -581,6 +645,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -620,6 +686,24 @@ AnprFlowObserved: type: object x-ngsi: type: Property + plateColor: + description: Detected plate color of the observed vehicle + properties: + confidence: + description: Confidence level of the detection + maximum: 1 + minimum: 0 + type: number + x-ngsi: + type: Property + name: + description: Color name + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + type: Property speed: description: Detected speed of the observed vehicle minimum: 0 @@ -647,7 +731,7 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -692,7 +776,7 @@ AnprFlowObserved: 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' + 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 @@ -721,12 +805,12 @@ AnprFlowObserved: - location - dateObserved 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) 2024 Contributors to Smart Data Models Program' + 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) 2025 Contributors to Smart Data Models Program x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/AnprFlowObserved/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/AnprFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 + x-model-tags: '' + x-version: 0.0.3 ```
@@ -777,6 +861,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -857,6 +945,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } } }, @@ -884,7 +976,7 @@ AnprFlowObserved: ``` #### AnprFlowObserved NGSI-LD key-values Beispiel - Hier ist ein Beispiel für einen AnprFlowObserved im JSON-LD Format als Key-Values. Dies ist mit NGSI-LD kompatibel, wenn `options=keyValues` verwendet wird und liefert die Kontextdaten einer einzelnen Entität. + Hier ist ein Beispiel für einen AnprFlowObserved im JSON-LD-Format als Schlüsselwerte. Dies ist mit NGSI-LD kompatibel, wenn `options=keyValues` verwendet wird und liefert die Kontextdaten einer einzelnen Entität.
show/hide example ```json { @@ -926,6 +1018,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -1000,7 +1096,8 @@ AnprFlowObserved: "model": "A3", "color": "black", "country": "BE", - "licensePlate": "1-ABC-123" + "licensePlate": "1-ABC-123", + "plateColor": "white" } }, "refImages": { diff --git a/AnprFlowObserved/doc/spec_ES.md b/AnprFlowObserved/doc/spec_ES.md index 14e008e1d..caa4f458e 100644 --- a/AnprFlowObserved/doc/spec_ES.md +++ b/AnprFlowObserved/doc/spec_ES.md @@ -7,8 +7,8 @@ [documento generado automáticamente](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) - Descripción global: **El modelo de datos representa una observación vinculada al paso de un vehículo en un lugar y momento determinados. Este modelo de datos se basa en el [dataModel.Transportation/ItemFlowObserved], ampliado con propiedades específicas ANPR y enlaces a las imágenes de observación.**. - versión: 0.0.1 + Descripción global: **El modelo de datos representa una observación vinculada al paso de un vehículo por un lugar determinado y en un momento dado. Este modelo de datos se basa en el [dataModel.Transportation/ItemFlowObserved], ampliado con propiedades específicas ANPR y enlaces a las imágenes de observación.**. + versión: 0.0.2 @@ -23,7 +23,7 @@ - `postalCode[string]`: El código postal. Por ejemplo, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - `streetAddress[string]`: La dirección . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) - `streetNr[string]`: Número que identifica una propiedad específica en una vía pública -- `alternateName[string]`: Un nombre alternativo para este artículo - `areaServed[string]`: La zona geográfica en la que se presta un servicio o se ofrece un artículo . Model: [https://schema.org/Text](https://schema.org/Text) - `dataProvider[string]`: Una secuencia de caracteres que identifica al proveedor de la entidad de datos armonizada - `dateCreated[date-time]`: Fecha de creación de la entidad. Normalmente será asignada por la plataforma de almacenamiento - `dateModified[date-time]`: Marca de tiempo de la última modificación de la entidad. Suele ser asignada por la plataforma de almacenamiento - `dateObserved[date-time]`: Fecha de la entidad observada definida por el usuario - `dateReceived[date-time]`: Fecha y hora en que la plataforma ha recibido la observación - `description[string]`: Descripción de este artículo - `id[*]`: Identificador único de la entidad - `laneId[string]`: Identificador de carril. Identificación de carril proporcionada por el observador - `location[*]`: Referencia Geojson al elemento. Puede ser Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon. - `name[string]`: El nombre de este artículo - `observedBy[*]`: La entidad o dispositivo que ha notificado esta observación - `observedVehicle[object]`: Información sobre el vehículo observado - `brand[object]`: Marca detectada del vehículo observado +- `alternateName[string]`: Un nombre alternativo para este artículo - `areaServed[string]`: La zona geográfica en la que se presta un servicio o se ofrece un artículo . Model: [https://schema.org/Text](https://schema.org/Text) - `dataProvider[string]`: Una secuencia de caracteres que identifica al proveedor de la entidad de datos armonizada - `dateCreated[date-time]`: Fecha de creación de la entidad. Normalmente será asignada por la plataforma de almacenamiento - `dateModified[date-time]`: Marca de tiempo de la última modificación de la entidad. Suele ser asignada por la plataforma de almacenamiento - `dateObserved[date-time]`: Fecha de la entidad observada definida por el usuario - `dateReceived[date-time]`: Fecha y hora en que la plataforma ha recibido la observación - `description[string]`: Descripción de este artículo - `id[*]`: Identificador único de la entidad - `laneId[string]`: Identificador de carril. Identificación de carril proporcionada por el observador - `location[*]`: Referencia Geojson al elemento. Puede ser Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon. - `name[string]`: El nombre de este artículo - `observedBy[*]`: La entidad o el dispositivo que ha notificado esta observación - `observedVehicle[object]`: Información sobre el vehículo observado - `brand[object]`: Marca detectada del vehículo observado - `color[object]`: Color detectado del vehículo observado - `country[object]`: País detectado del vehículo observado - `direction[string]`: Dirección detectada del vehículo observado @@ -45,42 +45,42 @@
full yaml details ```yaml AnprFlowObserved: - description: 'The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images.' + description: The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -161,27 +161,33 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship laneId: description: Lane identifier. Lane identification provided by the observer type: string x-ngsi: type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -196,11 +202,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -208,6 +218,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -222,11 +234,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -236,6 +252,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -250,17 +268,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -275,11 +299,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -289,6 +317,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -308,6 +338,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -319,6 +350,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -430,20 +463,26 @@ AnprFlowObserved: x-ngsi: type: Property coordinates: - description: 'Sequence of position points describing this location, expressed in coordinate system' + description: Sequence of position points describing this location, expressed in coordinate system oneOf: - description: Geojson reference to the item. Point properties: bbox: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -458,11 +497,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -470,6 +513,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -484,11 +529,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -498,6 +547,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -512,17 +563,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -537,11 +594,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -551,6 +612,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -570,6 +633,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -581,6 +645,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -620,6 +686,24 @@ AnprFlowObserved: type: object x-ngsi: type: Property + plateColor: + description: Detected plate color of the observed vehicle + properties: + confidence: + description: Confidence level of the detection + maximum: 1 + minimum: 0 + type: number + x-ngsi: + type: Property + name: + description: Color name + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + type: Property speed: description: Detected speed of the observed vehicle minimum: 0 @@ -647,7 +731,7 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -692,7 +776,7 @@ AnprFlowObserved: 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' + 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 @@ -721,12 +805,12 @@ AnprFlowObserved: - location - dateObserved 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) 2024 Contributors to Smart Data Models Program' + 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) 2025 Contributors to Smart Data Models Program x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/AnprFlowObserved/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/AnprFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 + x-model-tags: '' + x-version: 0.0.3 ```
@@ -777,6 +861,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -857,6 +945,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } } }, @@ -926,6 +1018,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -1000,7 +1096,8 @@ AnprFlowObserved: "model": "A3", "color": "black", "country": "BE", - "licensePlate": "1-ABC-123" + "licensePlate": "1-ABC-123", + "plateColor": "white" } }, "refImages": { diff --git a/AnprFlowObserved/doc/spec_FR.md b/AnprFlowObserved/doc/spec_FR.md index 128ea1342..2ec7bd2e9 100644 --- a/AnprFlowObserved/doc/spec_FR.md +++ b/AnprFlowObserved/doc/spec_FR.md @@ -8,7 +8,7 @@ Description globale : **Le modèle de données représente une observation liée au passage d'un véhicule à un endroit et à un moment donnés. Ce modèle de données est basé sur le [dataModel.Transportation/ItemFlowObserved], complété par des propriétés spécifiques à l'ANPR et des liens vers les images d'observation**. - version : 0.0.1 + version : 0.0.2 @@ -23,7 +23,7 @@ - `postalCode[string]`: Le code postal. Par exemple, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - `streetAddress[string]`: L'adresse de la rue . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) - `streetNr[string]`: Numéro identifiant une propriété spécifique sur une voie publique -- `alternateName[string]`: Un nom alternatif pour ce poste - `areaServed[string]`: La zone géographique où un service ou un article est offert . Model: [https://schema.org/Text](https://schema.org/Text) - `dataProvider[string]`: Une séquence de caractères identifiant le fournisseur de l'entité de données harmonisées - `dateCreated[date-time]`: Horodatage de la création de l'entité. Celle-ci est généralement attribuée par la plate-forme de stockage - `dateModified[date-time]`: Date de la dernière modification de l'entité. Cette date est généralement attribuée par la plate-forme de stockage - `dateObserved[date-time]`: Date de l'entité observée définie par l'utilisateur - `dateReceived[date-time]`: Date à laquelle l'observation a été reçue par la plate-forme - `description[string]`: Une description de l'article - `id[*]`: Identifiant unique de l'entité - `laneId[string]`: Identifiant de couloir. Identification de la voie fournie par l'observateur - `location[*]`: Référence Geojson à l'élément. Il peut s'agir d'un point, d'une chaîne de ligne, d'un polygone, d'un point multiple, d'une chaîne de ligne multiple ou d'un polygone multiple. - `name[string]`: Le nom de cet élément - `observedBy[*]`: L'entité ou le dispositif qui a signalé cette observation - `observedVehicle[object]`: Informations sur le véhicule observé - `brand[object]`: Marque détectée du véhicule observé +- `alternateName[string]`: Un nom alternatif pour ce poste - `areaServed[string]`: La zone géographique où un service ou un article est offert . Model: [https://schema.org/Text](https://schema.org/Text) - `dataProvider[string]`: Une séquence de caractères identifiant le fournisseur de l'entité de données harmonisées - `dateCreated[date-time]`: Horodatage de la création de l'entité. Celle-ci est généralement attribuée par la plate-forme de stockage - `dateModified[date-time]`: Date de la dernière modification de l'entité. Cette date est généralement attribuée par la plate-forme de stockage - `dateObserved[date-time]`: Date de l'entité observée définie par l'utilisateur - `dateReceived[date-time]`: Date à laquelle l'observation a été reçue par la plate-forme - `description[string]`: Une description de l'article - `id[*]`: Identifiant unique de l'entité - `laneId[string]`: Identificateur de couloir. Identification de la voie fournie par l'observateur - `location[*]`: Référence Geojson à l'élément. Il peut s'agir d'un point, d'une chaîne de ligne, d'un polygone, d'un point multiple, d'une chaîne de ligne multiple ou d'un polygone multiple. - `name[string]`: Le nom de cet élément - `observedBy[*]`: L'entité ou le dispositif qui a signalé cette observation - `observedVehicle[object]`: Informations sur le véhicule observé - `brand[object]`: Marque détectée du véhicule observé - `color[object]`: Couleur détectée du véhicule observé - `country[object]`: Pays détecté du véhicule observé - `direction[string]`: Direction détectée du véhicule observé @@ -45,42 +45,42 @@
full yaml details ```yaml AnprFlowObserved: - description: 'The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images.' + description: The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -161,27 +161,33 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship laneId: description: Lane identifier. Lane identification provided by the observer type: string x-ngsi: type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -196,11 +202,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -208,6 +218,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -222,11 +234,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -236,6 +252,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -250,17 +268,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -275,11 +299,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -289,6 +317,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -308,6 +338,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -319,6 +350,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -430,20 +463,26 @@ AnprFlowObserved: x-ngsi: type: Property coordinates: - description: 'Sequence of position points describing this location, expressed in coordinate system' + description: Sequence of position points describing this location, expressed in coordinate system oneOf: - description: Geojson reference to the item. Point properties: bbox: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -458,11 +497,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -470,6 +513,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -484,11 +529,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -498,6 +547,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -512,17 +563,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -537,11 +594,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -551,6 +612,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -570,6 +633,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -581,6 +645,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -620,6 +686,24 @@ AnprFlowObserved: type: object x-ngsi: type: Property + plateColor: + description: Detected plate color of the observed vehicle + properties: + confidence: + description: Confidence level of the detection + maximum: 1 + minimum: 0 + type: number + x-ngsi: + type: Property + name: + description: Color name + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + type: Property speed: description: Detected speed of the observed vehicle minimum: 0 @@ -647,7 +731,7 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -692,7 +776,7 @@ AnprFlowObserved: 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' + 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 @@ -721,12 +805,12 @@ AnprFlowObserved: - location - dateObserved 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) 2024 Contributors to Smart Data Models Program' + 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) 2025 Contributors to Smart Data Models Program x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/AnprFlowObserved/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/AnprFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 + x-model-tags: '' + x-version: 0.0.3 ```
@@ -777,6 +861,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -857,6 +945,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } } }, @@ -926,6 +1018,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -1000,7 +1096,8 @@ AnprFlowObserved: "model": "A3", "color": "black", "country": "BE", - "licensePlate": "1-ABC-123" + "licensePlate": "1-ABC-123", + "plateColor": "white" } }, "refImages": { diff --git a/AnprFlowObserved/doc/spec_IT.md b/AnprFlowObserved/doc/spec_IT.md index 3aa4b7fcf..cf8f10db4 100644 --- a/AnprFlowObserved/doc/spec_IT.md +++ b/AnprFlowObserved/doc/spec_IT.md @@ -7,8 +7,8 @@ [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: **Il modello di dati rappresenta un'osservazione legata al passaggio di un veicolo in un determinato luogo e in un determinato momento. Questo modello di dati si basa sul [dataModel.Transportation/ItemFlowObserved], ampliato con proprietà specifiche dell'ANPR e collegamenti alle immagini dell'osservazione.** - versione: 0.0.1 + Descrizione globale: **Il modello di dati rappresenta un'osservazione legata al passaggio di un veicolo in un determinato luogo e in un determinato momento. Questo modello di dati si basa sul [dataModel.Transportation/ItemFlowObserved], ampliato con proprietà specifiche dell'ANPR e con collegamenti alle immagini dell'osservazione **. + versione: 0.0.2 @@ -23,14 +23,14 @@ - `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) - `streetNr[string]`: Numero che identifica una proprietà specifica su una strada pubblica -- `alternateName[string]`: Un nome alternativo per questa voce - `areaServed[string]`: L'area geografica in cui viene fornito il servizio o l'articolo offerto. . Model: [https://schema.org/Text](https://schema.org/Text) - `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 - `dateObserved[date-time]`: Data dell'entità osservata definita dall'utente - `dateReceived[date-time]`: Data e ora in cui l'osservazione è stata ricevuta dalla piattaforma. - `description[string]`: Descrizione dell'articolo - `id[*]`: Identificatore univoco dell'entità - `laneId[string]`: Identificatore di corsia. Identificazione della corsia fornita dall'osservatore - `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 - `observedBy[*]`: L'entità o il dispositivo che ha segnalato l'osservazione - `observedVehicle[object]`: Informazioni sul veicolo osservato - `brand[object]`: Marca rilevata del veicolo osservato +- `alternateName[string]`: Un nome alternativo per questa voce - `areaServed[string]`: L'area geografica in cui viene fornito il servizio o l'articolo offerto. . Model: [https://schema.org/Text](https://schema.org/Text) - `dataProvider[string]`: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzati - `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 - `dateObserved[date-time]`: Data dell'entità osservata definita dall'utente - `dateReceived[date-time]`: Data e ora in cui l'osservazione è stata ricevuta dalla piattaforma. - `description[string]`: Descrizione dell'articolo - `id[*]`: Identificatore univoco dell'entità - `laneId[string]`: Identificatore di corsia. Identificazione della corsia fornita dall'osservatore - `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 - `observedBy[*]`: L'entità o il dispositivo che ha segnalato l'osservazione - `observedVehicle[object]`: Informazioni sul veicolo osservato - `brand[object]`: Marca rilevata del veicolo osservato - `color[object]`: Colore rilevato del veicolo osservato - `country[object]`: Paese rilevato del veicolo osservato - `direction[string]`: Direzione rilevata del veicolo osservato - `licensePlate[object]`: Targa rilevata del veicolo osservato - `model[object]`: Modello di marca rilevato del veicolo osservato - `speed[number]`: Velocità rilevata del veicolo osservato -- `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `refImages[array]`: Array di oggetti multipli che fanno riferimento alle immagini - `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. - `type[string]`: Tipo di entità NGSI. Deve essere AnprFlowObserved - `vehiclePlateNotRead[boolean]`: Indica se non è stato possibile leggere una licenza - `zonesServed[array]`: Array di zone che sono in grado di ricevere o leggere le osservazioni +- `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `refImages[array]`: Array di oggetti multipli che fanno riferimento alle immagini - `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. - `type[string]`: Tipo di entità NGSI. Deve essere AnprFlowObserved - `vehiclePlateNotRead[boolean]`: Indica se non è stato possibile leggere una licenza - `zonesServed[array]`: Schiera di zone in grado di ricevere o leggere le osservazioni Proprietà richieste - `dateObserved` - `id` - `location` - `type` @@ -45,42 +45,42 @@
full yaml details ```yaml AnprFlowObserved: - description: 'The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images.' + description: The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -161,27 +161,33 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship laneId: description: Lane identifier. Lane identification provided by the observer type: string x-ngsi: type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -196,11 +202,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -208,6 +218,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -222,11 +234,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -236,6 +252,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -250,17 +268,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -275,11 +299,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -289,6 +317,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -308,6 +338,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -319,6 +350,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -430,20 +463,26 @@ AnprFlowObserved: x-ngsi: type: Property coordinates: - description: 'Sequence of position points describing this location, expressed in coordinate system' + description: Sequence of position points describing this location, expressed in coordinate system oneOf: - description: Geojson reference to the item. Point properties: bbox: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -458,11 +497,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -470,6 +513,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -484,11 +529,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -498,6 +547,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -512,17 +563,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -537,11 +594,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -551,6 +612,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -570,6 +633,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -581,6 +645,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -620,6 +686,24 @@ AnprFlowObserved: type: object x-ngsi: type: Property + plateColor: + description: Detected plate color of the observed vehicle + properties: + confidence: + description: Confidence level of the detection + maximum: 1 + minimum: 0 + type: number + x-ngsi: + type: Property + name: + description: Color name + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + type: Property speed: description: Detected speed of the observed vehicle minimum: 0 @@ -647,7 +731,7 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -692,7 +776,7 @@ AnprFlowObserved: 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' + 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 @@ -721,12 +805,12 @@ AnprFlowObserved: - location - dateObserved 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) 2024 Contributors to Smart Data Models Program' + 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) 2025 Contributors to Smart Data Models Program x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/AnprFlowObserved/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/AnprFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 + x-model-tags: '' + x-version: 0.0.3 ```
@@ -777,6 +861,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -857,6 +945,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } } }, @@ -926,6 +1018,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -1000,7 +1096,8 @@ AnprFlowObserved: "model": "A3", "color": "black", "country": "BE", - "licensePlate": "1-ABC-123" + "licensePlate": "1-ABC-123", + "plateColor": "white" } }, "refImages": { diff --git a/AnprFlowObserved/doc/spec_JA.md b/AnprFlowObserved/doc/spec_JA.md index 43b3358fe..40eb0256b 100644 --- a/AnprFlowObserved/doc/spec_JA.md +++ b/AnprFlowObserved/doc/spec_JA.md @@ -4,11 +4,11 @@ ====================== [オープン・ライセンス](https://github.com/smart-data-models//dataModel.Transportation/blob/master/AnprFlowObserved/LICENSE.md) - [文書は自動的に生成される](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) + [文書が自動的に生成される](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) グローバルな記述：**このデータモデルは、特定の場所と時間における車両の通過にリンクされた観測を表す。このデータモデルは[dataModel.Transportation/ItemFlowObserved]に基づいており、ANPR固有のプロパティと観測画像へのリンクで拡張されている**。 - バージョン: 0.0.1 + バージョン: 0.0.2 @@ -45,42 +45,42 @@
full yaml details ```yaml AnprFlowObserved: - description: 'The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images.' + description: The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -161,27 +161,33 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship laneId: description: Lane identifier. Lane identification provided by the observer type: string x-ngsi: type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -196,11 +202,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -208,6 +218,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -222,11 +234,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -236,6 +252,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -250,17 +268,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -275,11 +299,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -289,6 +317,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -308,6 +338,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -319,6 +350,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -430,20 +463,26 @@ AnprFlowObserved: x-ngsi: type: Property coordinates: - description: 'Sequence of position points describing this location, expressed in coordinate system' + description: Sequence of position points describing this location, expressed in coordinate system oneOf: - description: Geojson reference to the item. Point properties: bbox: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -458,11 +497,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -470,6 +513,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -484,11 +529,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -498,6 +547,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -512,17 +563,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -537,11 +594,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -551,6 +612,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -570,6 +633,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -581,6 +645,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -620,6 +686,24 @@ AnprFlowObserved: type: object x-ngsi: type: Property + plateColor: + description: Detected plate color of the observed vehicle + properties: + confidence: + description: Confidence level of the detection + maximum: 1 + minimum: 0 + type: number + x-ngsi: + type: Property + name: + description: Color name + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + type: Property speed: description: Detected speed of the observed vehicle minimum: 0 @@ -647,7 +731,7 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -692,7 +776,7 @@ AnprFlowObserved: 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' + 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 @@ -721,12 +805,12 @@ AnprFlowObserved: - location - dateObserved 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) 2024 Contributors to Smart Data Models Program' + 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) 2025 Contributors to Smart Data Models Program x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/AnprFlowObserved/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/AnprFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 + x-model-tags: '' + x-version: 0.0.3 ```
@@ -777,6 +861,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -857,6 +945,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } } }, @@ -926,6 +1018,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -1000,7 +1096,8 @@ AnprFlowObserved: "model": "A3", "color": "black", "country": "BE", - "licensePlate": "1-ABC-123" + "licensePlate": "1-ABC-123", + "plateColor": "white" } }, "refImages": { diff --git a/AnprFlowObserved/doc/spec_KO.md b/AnprFlowObserved/doc/spec_KO.md index 11349573f..9fce0a201 100644 --- a/AnprFlowObserved/doc/spec_KO.md +++ b/AnprFlowObserved/doc/spec_KO.md @@ -8,7 +8,7 @@ 글로벌 설명: **데이터 모델은 특정 위치 및 특정 시간에 차량의 통과와 관련된 관측을 나타냅니다. 이 데이터 모델은 ANPR 관련 속성 및 관측 이미지에 대한 링크로 확장된 [dataModel.Transportation/ItemFlowObserved]를 기반으로 합니다**. - 버전: 0.0.1 + 버전: 0.0.2 @@ -16,14 +16,14 @@ [*] 속성에 유형이 없는 것은 여러 유형 또는 다른 형식/패턴을 가질 수 있기 때문입니다. - `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 국가. 예를 들어, 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 도로명 주소가 있는 지역 및 해당 지역 내 지역 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressLocality[string]`: 도로명 주소가 있는 지역 및 지역 내 지역 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - `addressRegion[string]`: 해당 지역이 위치한 지역과 해당 국가의 지역 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - `district[string]`: 지구는 일부 국가에서는 지방 정부에서 관리하는 행정 구역의 일종입니다. - `postOfficeBoxNumber[string]`: 사서함 주소의 우체국 사서함 번호입니다. 예: 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - `postalCode[string]`: 우편 번호입니다. 예: 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - `streetAddress[string]`: 거리 주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) - `streetNr[string]`: 공공 도로의 특정 건물을 식별하는 번호 -- `alternateName[string]`: 이 항목의 대체 이름 - `areaServed[string]`: 서비스 또는 제공 품목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) - `dataProvider[string]`: 조화된 데이터 엔티티의 공급자를 식별하는 일련의 문자 - `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateModified[date-time]`: 엔티티의 마지막 수정 타임스탬프입니다. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateObserved[date-time]`: 사용자가 정의한 관찰된 엔티티의 날짜 - `dateReceived[date-time]`: 플랫폼에서 관측을 수신한 타임스탬프 - `description[string]`: 이 항목에 대한 설명 - `id[*]`: 엔티티의 고유 식별자 - `laneId[string]`: 차선 식별자. 관찰자가 제공한 차선 식별 - `location[*]`: 항목에 대한 지오숀 참조입니다. 포인트, 라인스트링, 다각형, 멀티포인트, 멀티라인스트링 또는 멀티폴리곤일 수 있습니다. - `name[string]`: 이 항목의 이름 - `observedBy[*]`: 이 관찰을 보고한 주체 또는 장치 - `observedVehicle[object]`: 관찰된 차량에 대한 정보 - `brand[object]`: 관측된 차량의 브랜드 감지 +- `alternateName[string]`: 이 항목의 대체 이름 - `areaServed[string]`: 서비스 또는 제공 품목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) - `dataProvider[string]`: 조화된 데이터 엔티티의 공급자를 식별하는 일련의 문자 - `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateModified[date-time]`: 엔티티의 마지막 수정 타임스탬프입니다. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateObserved[date-time]`: 사용자가 정의한 관찰된 엔티티의 날짜 - `dateReceived[date-time]`: 관측이 플랫폼에 수신된 타임스탬프 - `description[string]`: 이 항목에 대한 설명 - `id[*]`: 엔티티의 고유 식별자 - `laneId[string]`: 차선 식별자. 관찰자가 제공한 차선 식별 - `location[*]`: 항목에 대한 지오숀 참조입니다. 포인트, 라인스트링, 다각형, 멀티포인트, 멀티라인스트링 또는 멀티폴리곤일 수 있습니다. - `name[string]`: 이 항목의 이름 - `observedBy[*]`: 이 관찰을 보고한 주체 또는 장치 - `observedVehicle[object]`: 관찰된 차량에 대한 정보 - `brand[object]`: 관측된 차량의 브랜드 감지 - `color[object]`: 관찰된 차량의 감지된 색상 - `country[object]`: 관측된 차량의 감지 국가 - `direction[string]`: 관측된 차량의 감지된 방향 @@ -45,42 +45,42 @@
full yaml details ```yaml AnprFlowObserved: - description: 'The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images.' + description: The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -161,27 +161,33 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship laneId: description: Lane identifier. Lane identification provided by the observer type: string x-ngsi: type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -196,11 +202,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -208,6 +218,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -222,11 +234,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -236,6 +252,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -250,17 +268,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -275,11 +299,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -289,6 +317,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -308,6 +338,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -319,6 +350,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -430,20 +463,26 @@ AnprFlowObserved: x-ngsi: type: Property coordinates: - description: 'Sequence of position points describing this location, expressed in coordinate system' + description: Sequence of position points describing this location, expressed in coordinate system oneOf: - description: Geojson reference to the item. Point properties: bbox: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -458,11 +497,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -470,6 +513,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -484,11 +529,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -498,6 +547,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -512,17 +563,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -537,11 +594,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -551,6 +612,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -570,6 +633,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -581,6 +645,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -620,6 +686,24 @@ AnprFlowObserved: type: object x-ngsi: type: Property + plateColor: + description: Detected plate color of the observed vehicle + properties: + confidence: + description: Confidence level of the detection + maximum: 1 + minimum: 0 + type: number + x-ngsi: + type: Property + name: + description: Color name + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + type: Property speed: description: Detected speed of the observed vehicle minimum: 0 @@ -647,7 +731,7 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -692,7 +776,7 @@ AnprFlowObserved: 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' + 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 @@ -721,12 +805,12 @@ AnprFlowObserved: - location - dateObserved 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) 2024 Contributors to Smart Data Models Program' + 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) 2025 Contributors to Smart Data Models Program x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/AnprFlowObserved/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/AnprFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 + x-model-tags: '' + x-version: 0.0.3 ```
@@ -734,7 +818,7 @@ AnprFlowObserved: ## 페이로드 예시 - #### AnprFlowObserved NGSI-v2 키 값 예시 + #### AnprFlowObserved NGSI-v2 키 값 예제 다음은 키 값으로 JSON-LD 형식의 AnprFlowObserved의 예입니다. 이는 `옵션=키값`을 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다.
show/hide example ```json @@ -777,6 +861,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -857,6 +945,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } } }, @@ -926,6 +1018,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -1000,7 +1096,8 @@ AnprFlowObserved: "model": "A3", "color": "black", "country": "BE", - "licensePlate": "1-ABC-123" + "licensePlate": "1-ABC-123", + "plateColor": "white" } }, "refImages": { diff --git a/AnprFlowObserved/doc/spec_ZH.md b/AnprFlowObserved/doc/spec_ZH.md index 6e6e1a62f..faf114b3b 100644 --- a/AnprFlowObserved/doc/spec_ZH.md +++ b/AnprFlowObserved/doc/spec_ZH.md @@ -8,7 +8,7 @@ 全局描述：**该数据模型表示与特定地点和特定时间内通过的车辆相关联的观察结果。该数据模型基于 [dataModel.Transportation/ItemFlowObserved]，并扩展了 ANPR 特定属性和观测图像链接。 - 版本： 0.0.1 + 版本： 0.0.2 @@ -30,7 +30,7 @@ - `licensePlate[object]`: 检测到被观察车辆的车牌 - `model[object]`: 检测到的被观测车辆品牌型号 - `speed[number]`: 检测到的被观测车辆速度 -- `owner[array]`: 包含一个 JSON 编码字符序列的列表，其中引用了所有者的唯一 Ids - `refImages[array]`: 指向图像的多个对象的数组 - `seeAlso[*]`: 指向有关该项目的其他资源的 uri 列表 - `source[string]`: 以 URL 形式给出实体数据原始来源的字符串。建议使用源提供者的完全合格域名或源对象的 URL - `type[string]`: NGSI 实体类型。必须是 AnprFlowObserved - `vehiclePlateNotRead[boolean]`: 表示是否无法读取许可证 - `zonesServed[array]`: 能够接收或读取观测数据的区域阵列 +- `owner[array]`: 包含一个 JSON 编码字符序列的列表，其中引用了所有者的唯一标识 - `refImages[array]`: 指向图像的多个对象的数组 - `seeAlso[*]`: 指向有关该项目的其他资源的 uri 列表 - `source[string]`: 以 URL 形式给出实体数据原始来源的字符串。建议使用源提供者的完全合格域名或源对象的 URL - `type[string]`: NGSI 实体类型。必须是 AnprFlowObserved - `vehiclePlateNotRead[boolean]`: 表示是否无法读取许可证 - `zonesServed[array]`: 能够接收或读取观测数据的区域阵列 所需属性 - `dateObserved` - `id` - `location` - `type` @@ -45,42 +45,42 @@
full yaml details ```yaml AnprFlowObserved: - description: 'The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images.' + description: The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -161,27 +161,33 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship laneId: description: Lane identifier. Lane identification provided by the observer type: string x-ngsi: type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -196,11 +202,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -208,6 +218,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -222,11 +234,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -236,6 +252,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -250,17 +268,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -275,11 +299,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -289,6 +317,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -308,6 +338,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -319,6 +350,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -430,20 +463,26 @@ AnprFlowObserved: x-ngsi: type: Property coordinates: - description: 'Sequence of position points describing this location, expressed in coordinate system' + description: Sequence of position points describing this location, expressed in coordinate system oneOf: - description: Geojson reference to the item. Point properties: bbox: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -458,11 +497,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -470,6 +513,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -484,11 +529,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -498,6 +547,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -512,17 +563,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -537,11 +594,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -551,6 +612,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -570,6 +633,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -581,6 +645,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -620,6 +686,24 @@ AnprFlowObserved: type: object x-ngsi: type: Property + plateColor: + description: Detected plate color of the observed vehicle + properties: + confidence: + description: Confidence level of the detection + maximum: 1 + minimum: 0 + type: number + x-ngsi: + type: Property + name: + description: Color name + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + type: Property speed: description: Detected speed of the observed vehicle minimum: 0 @@ -647,7 +731,7 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -692,7 +776,7 @@ AnprFlowObserved: 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' + 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 @@ -721,12 +805,12 @@ AnprFlowObserved: - location - dateObserved 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) 2024 Contributors to Smart Data Models Program' + 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) 2025 Contributors to Smart Data Models Program x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/AnprFlowObserved/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/AnprFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 + x-model-tags: '' + x-version: 0.0.3 ```
@@ -777,6 +861,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -857,6 +945,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } } }, @@ -926,6 +1018,10 @@ AnprFlowObserved: "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -1000,7 +1096,8 @@ AnprFlowObserved: "model": "A3", "color": "black", "country": "BE", - "licensePlate": "1-ABC-123" + "licensePlate": "1-ABC-123", + "plateColor": "white" } }, "refImages": { diff --git a/AnprFlowObserved/examples/example-normalized.json b/AnprFlowObserved/examples/example-normalized.json index e6fd4ce9b..26a90165d 100644 --- a/AnprFlowObserved/examples/example-normalized.json +++ b/AnprFlowObserved/examples/example-normalized.json @@ -55,6 +55,10 @@ "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } } }, @@ -78,4 +82,4 @@ "type": "Point" } } -} \ No newline at end of file +} diff --git a/AnprFlowObserved/examples/example-normalized.json.csv b/AnprFlowObserved/examples/example-normalized.json.csv index 354e56ff3..2699f4fc2 100644 --- a/AnprFlowObserved/examples/example-normalized.json.csv +++ b/AnprFlowObserved/examples/example-normalized.json.csv @@ -1,2 +1,2 @@ -"id_", "type_", "address__type_", "address__value__addressCountry_", "address__value__addressLocality_", "address__value__streetAddress_", "dateObserved__type_", "dateObserved__value_", "laneId__type_", "laneId__value_", "areaServed__type_", "areaServed__value_", "zonesServed__type_", "zonesServed__value__0_", "vehiclePlateNotRead__type_", "vehiclePlateNotRead__value_", "observedVehicle__type_", "observedVehicle__value__direction_", "observedVehicle__value__speed_", "observedVehicle__value__brand__name_", "observedVehicle__value__brand__confidence_", "observedVehicle__value__model__name_", "observedVehicle__value__model__confidence_", "observedVehicle__value__color__name_", "observedVehicle__value__color__confidence_", "observedVehicle__value__country__code_", "observedVehicle__value__country__confidence_", "observedVehicle__value__licensePlate__identifier_", "observedVehicle__value__licensePlate__confidence_", "refImages__type_", "refImages__value__0__url_", "refImages__value__0__contentType_", "refImages__value__0__imageType_", "location__type_", "location__value__coordinates__0_", "location__value__coordinates__1_", "location__value__type_" -"anprFlowObserved:LEZ-Noorderlaan", "AnprFlowObserved", "StructuredValue", "BE", "Antwerp", "Noorderlaan", "DateTime", "2022-09-01T16:30:00Z", "Text", "ABC123", "Text", "Antwerp", "StructuredValue", "Antwerp", "Boolean", "False", "StructuredValue", "towards", "50", "Audi", "0.97", "A3", "0.98", "black", "0.95", "BE", "0.95", "1-ABC-123", "0.96", "StructuredValue", "s3://bucket/object-xxx-plate", "image/jpg", "anpr", "geo:json", "-56.6404505", "168.370658", "Point" \ No newline at end of file +"id_", "type_", "address__type_", "address__value__addressCountry_", "address__value__addressLocality_", "address__value__streetAddress_", "dateObserved__type_", "dateObserved__value_", "laneId__type_", "laneId__value_", "areaServed__type_", "areaServed__value_", "zonesServed__type_", "zonesServed__value__0_", "vehiclePlateNotRead__type_", "vehiclePlateNotRead__value_", "observedVehicle__type_", "observedVehicle__value__direction_", "observedVehicle__value__speed_", "observedVehicle__value__brand__name_", "observedVehicle__value__brand__confidence_", "observedVehicle__value__model__name_", "observedVehicle__value__model__confidence_", "observedVehicle__value__color__name_", "observedVehicle__value__color__confidence_", "observedVehicle__value__country__code_", "observedVehicle__value__country__confidence_", "observedVehicle__value__licensePlate__identifier_", "observedVehicle__value__licensePlate__confidence_", "observedVehicle__value__plateColor__name_", "observedVehicle__value__plateColor__confidence_", "refImages__type_", "refImages__value__0__url_", "refImages__value__0__contentType_", "refImages__value__0__imageType_", "location__type_", "location__value__coordinates__0_", "location__value__coordinates__1_", "location__value__type_" +"anprFlowObserved:LEZ-Noorderlaan", "AnprFlowObserved", "StructuredValue", "BE", "Antwerp", "Noorderlaan", "DateTime", "2022-09-01T16:30:00Z", "Text", "ABC123", "Text", "Antwerp", "StructuredValue", "Antwerp", "Boolean", "False", "StructuredValue", "towards", "50", "Audi", "0.97", "A3", "0.98", "black", "0.95", "BE", "0.95", "1-ABC-123", "0.96", "white", "0.95", "StructuredValue", "s3://bucket/object-xxx-plate", "image/jpg", "anpr", "geo:json", "-56.6404505", "168.370658", "Point" \ No newline at end of file diff --git a/AnprFlowObserved/examples/example-normalized.jsonld b/AnprFlowObserved/examples/example-normalized.jsonld index c3b4b4513..7e77e3adb 100644 --- a/AnprFlowObserved/examples/example-normalized.jsonld +++ b/AnprFlowObserved/examples/example-normalized.jsonld @@ -46,7 +46,8 @@ "model": "A3", "color": "black", "country": "BE", - "licensePlate": "1-ABC-123" + "licensePlate": "1-ABC-123", + "plateColor": "white" } }, "refImages": { diff --git a/AnprFlowObserved/examples/example-normalized.jsonld.csv b/AnprFlowObserved/examples/example-normalized.jsonld.csv index c17b5494b..1cbe112fa 100644 --- a/AnprFlowObserved/examples/example-normalized.jsonld.csv +++ b/AnprFlowObserved/examples/example-normalized.jsonld.csv @@ -1,2 +1,2 @@ -"id_", "type_", "address__type_", "address__value__addressCountry_", "address__value__addressLocality_", "address__value__streetAddress_", "dateObserved__type_", "dateObserved__value__@type_", "dateObserved__value__@value_", "laneId__type_", "laneId__value_", "areaServed__type_", "areaServed__value_", "zonesServed__type_", "zonesServed__value__type_", "zonesServed__value__coordinates__0_", "vehiclePlateNotRead__type_", "vehiclePlateNotRead__value_", "observedVehicle__type_", "observedVehicle__value__direction_", "observedVehicle__value__speed_", "observedVehicle__value__brand_", "observedVehicle__value__model_", "observedVehicle__value__color_", "observedVehicle__value__country_", "observedVehicle__value__licensePlate_", "refImages__type_", "refImages__value__0__type_", "refImages__value__0__contentType_", "refImages__value__0__imageType_", "@context__0_" -"anprFlowObserved:LEZ-Noorderlaan", "AnprFlowObserved", "Property", "BE", "Antwerp", "Noorderlaan", "Property", "DateTime", "2022-09-01T16:30:00Z", "Property", "ABC123", "Property", "Antwerp", "Property", "string", "Antwerp", "Property", "False", "Property", "towards", "50", "Audi", "A3", "black", "BE", "1-ABC-123", "Property", "s3://bucket/object-xxx-plate", "image/jpg", "anpr", "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" \ No newline at end of file +"id_", "type_", "address__type_", "address__value__addressCountry_", "address__value__addressLocality_", "address__value__streetAddress_", "dateObserved__type_", "dateObserved__value__@type_", "dateObserved__value__@value_", "laneId__type_", "laneId__value_", "areaServed__type_", "areaServed__value_", "zonesServed__type_", "zonesServed__value__type_", "zonesServed__value__coordinates__0_", "vehiclePlateNotRead__type_", "vehiclePlateNotRead__value_", "observedVehicle__type_", "observedVehicle__value__direction_", "observedVehicle__value__speed_", "observedVehicle__value__brand_", "observedVehicle__value__model_", "observedVehicle__value__color_", "observedVehicle__value__country_", "observedVehicle__value__licensePlate_", "observedVehicle__value__plateColor_", "refImages__type_", "refImages__value__0__type_", "refImages__value__0__contentType_", "refImages__value__0__imageType_", "@context__0_" +"anprFlowObserved:LEZ-Noorderlaan", "AnprFlowObserved", "Property", "BE", "Antwerp", "Noorderlaan", "Property", "DateTime", "2022-09-01T16:30:00Z", "Property", "ABC123", "Property", "Antwerp", "Property", "string", "Antwerp", "Property", "False", "Property", "towards", "50", "Audi", "A3", "black", "BE", "1-ABC-123", "white", "Property", "s3://bucket/object-xxx-plate", "image/jpg", "anpr", "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" \ No newline at end of file diff --git a/AnprFlowObserved/examples/example.json b/AnprFlowObserved/examples/example.json index dd25236b0..0893ebcd9 100644 --- a/AnprFlowObserved/examples/example.json +++ b/AnprFlowObserved/examples/example.json @@ -37,6 +37,10 @@ "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -53,4 +57,4 @@ "url": "urn:ngsi-ld:ANPR:items:123" } ] -} \ No newline at end of file +} diff --git a/AnprFlowObserved/examples/example.json.csv b/AnprFlowObserved/examples/example.json.csv index e4a61a187..e45f952b8 100644 --- a/AnprFlowObserved/examples/example.json.csv +++ b/AnprFlowObserved/examples/example.json.csv @@ -1,2 +1,2 @@ -"id_", "type_", "address__addressCountry_", "address__addressLocality_", "address__streetAddress_", "dateObserved_", "dateReceived_", "observedBy_", "laneId_", "areaServed_", "zonesServed__0_", "vehiclePlateNotRead_", "observedVehicle__direction_", "observedVehicle__speed_", "observedVehicle__brand__name_", "observedVehicle__brand__confidence_", "observedVehicle__model__name_", "observedVehicle__model__confidence_", "observedVehicle__color__name_", "observedVehicle__color__confidence_", "observedVehicle__country__code_", "observedVehicle__country__confidence_", "observedVehicle__licensePlate__identifier_", "observedVehicle__licensePlate__confidence_", "location__type_", "location__coordinates__0_", "location__coordinates__1_", "refImages__0__contentType_", "refImages__0__imageType_", "refImages__0__url_" -"anprFlowObserved:LEZ-Noorderlaan", "AnprFlowObserved", "BE", "Antwerp", "Noorderlaan", "2022-09-01T16:30:00Z", "2022-09-01T16:35:00Z", "ANPR1_Noorderlaan", "ABC123", "Antwerp", "Antwerp", "False", "towards", "50", "Audi", "0.97", "A3", "0.98", "black", "0.95", "BE", "0.95", "1-ABC-123", "0.96", "Point", "-56.6404505", "168.370658", "image/jpg", "anpr", "urn:ngsi-ld:ANPR:items:123" \ No newline at end of file +"id_", "type_", "address__addressCountry_", "address__addressLocality_", "address__streetAddress_", "dateObserved_", "dateReceived_", "observedBy_", "laneId_", "areaServed_", "zonesServed__0_", "vehiclePlateNotRead_", "observedVehicle__direction_", "observedVehicle__speed_", "observedVehicle__brand__name_", "observedVehicle__brand__confidence_", "observedVehicle__model__name_", "observedVehicle__model__confidence_", "observedVehicle__color__name_", "observedVehicle__color__confidence_", "observedVehicle__country__code_", "observedVehicle__country__confidence_", "observedVehicle__licensePlate__identifier_", "observedVehicle__licensePlate__confidence_", "observedVehicle__plateColor__name_", "observedVehicle__plateColor__confidence_", "location__type_", "location__coordinates__0_", "location__coordinates__1_", "refImages__0__contentType_", "refImages__0__imageType_", "refImages__0__url_" +"anprFlowObserved:LEZ-Noorderlaan", "AnprFlowObserved", "BE", "Antwerp", "Noorderlaan", "2022-09-01T16:30:00Z", "2022-09-01T16:35:00Z", "ANPR1_Noorderlaan", "ABC123", "Antwerp", "Antwerp", "False", "towards", "50", "Audi", "0.97", "A3", "0.98", "black", "0.95", "BE", "0.95", "1-ABC-123", "0.96", "white", "0.95", "Point", "-56.6404505", "168.370658", "image/jpg", "anpr", "urn:ngsi-ld:ANPR:items:123" \ No newline at end of file diff --git a/AnprFlowObserved/examples/example.jsonld b/AnprFlowObserved/examples/example.jsonld index 20de7ff85..dcef32fe8 100644 --- a/AnprFlowObserved/examples/example.jsonld +++ b/AnprFlowObserved/examples/example.jsonld @@ -37,6 +37,10 @@ "licensePlate": { "identifier": "1-ABC-123", "confidence": 0.96 + }, + "plateColor": { + "name": "white", + "confidence": 0.95 } }, "location": { @@ -56,4 +60,4 @@ "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] -} \ No newline at end of file +} diff --git a/AnprFlowObserved/examples/example.jsonld.csv b/AnprFlowObserved/examples/example.jsonld.csv index 71127afa8..365282a02 100644 --- a/AnprFlowObserved/examples/example.jsonld.csv +++ b/AnprFlowObserved/examples/example.jsonld.csv @@ -1,2 +1,2 @@ -"id_", "type_", "address__addressCountry_", "address__addressLocality_", "address__streetAddress_", "dateObserved_", "dateReceived_", "observedBy_", "laneId_", "areaServed_", "zonesServed__0_", "vehiclePlateNotRead_", "observedVehicle__direction_", "observedVehicle__speed_", "observedVehicle__brand__name_", "observedVehicle__brand__confidence_", "observedVehicle__model__name_", "observedVehicle__model__confidence_", "observedVehicle__color__name_", "observedVehicle__color__confidence_", "observedVehicle__country__code_", "observedVehicle__country__confidence_", "observedVehicle__licensePlate__identifier_", "observedVehicle__licensePlate__confidence_", "location__type_", "location__coordinates__0_", "location__coordinates__1_", "refImages__0__contentType_", "refImages__0__imageType_", "refImages__0__url_", "@context__0_" -"anprFlowObserved:LEZ-Noorderlaan", "AnprFlowObserved", "BE", "Antwerp", "Noorderlaan", "2022-09-01T16:30:00Z", "2022-09-01T16:35:00Z", "ANPR1_Noorderlaan", "ABC123", "Antwerp", "Antwerp", "False", "towards", "50", "Audi", "0.97", "A3", "0.98", "black", "0.95", "BE", "0.95", "1-ABC-123", "0.96", "Point", "-56.6404505", "168.370658", "image/jpg", "anpr", "urn:ngsi-ld:ANPR:items:123", "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" \ No newline at end of file +"id_", "type_", "address__addressCountry_", "address__addressLocality_", "address__streetAddress_", "dateObserved_", "dateReceived_", "observedBy_", "laneId_", "areaServed_", "zonesServed__0_", "vehiclePlateNotRead_", "observedVehicle__direction_", "observedVehicle__speed_", "observedVehicle__brand__name_", "observedVehicle__brand__confidence_", "observedVehicle__model__name_", "observedVehicle__model__confidence_", "observedVehicle__color__name_", "observedVehicle__color__confidence_", "observedVehicle__country__code_", "observedVehicle__country__confidence_", "observedVehicle__licensePlate__identifier_", "observedVehicle__licensePlate__confidence_", "observedVehicle__plateColor__name_", "observedVehicle__plateColor__confidence_", "location__type_", "location__coordinates__0_", "location__coordinates__1_", "refImages__0__contentType_", "refImages__0__imageType_", "refImages__0__url_", "@context__0_" +"anprFlowObserved:LEZ-Noorderlaan", "AnprFlowObserved", "BE", "Antwerp", "Noorderlaan", "2022-09-01T16:30:00Z", "2022-09-01T16:35:00Z", "ANPR1_Noorderlaan", "ABC123", "Antwerp", "Antwerp", "False", "towards", "50", "Audi", "0.97", "A3", "0.98", "black", "0.95", "BE", "0.95", "1-ABC-123", "0.96", "white", "0.95", "Point", "-56.6404505", "168.370658", "image/jpg", "anpr", "urn:ngsi-ld:ANPR:items:123", "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" \ No newline at end of file diff --git a/AnprFlowObserved/model.yaml b/AnprFlowObserved/model.yaml index 0287c3abc..dc49119a0 100644 --- a/AnprFlowObserved/model.yaml +++ b/AnprFlowObserved/model.yaml @@ -1,40 +1,40 @@ AnprFlowObserved: - description: 'The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images.' + description: The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -115,27 +115,33 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship laneId: description: Lane identifier. Lane identification provided by the observer type: string x-ngsi: type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -150,11 +156,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -162,6 +172,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -176,11 +188,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -190,6 +206,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -204,17 +222,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -229,11 +253,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -243,6 +271,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -262,6 +292,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -273,6 +304,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -384,20 +417,26 @@ AnprFlowObserved: x-ngsi: type: Property coordinates: - description: 'Sequence of position points describing this location, expressed in coordinate system' + description: Sequence of position points describing this location, expressed in coordinate system oneOf: - description: Geojson reference to the item. Point properties: bbox: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -412,11 +451,15 @@ AnprFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -424,6 +467,8 @@ AnprFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -438,11 +483,15 @@ AnprFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -452,6 +501,8 @@ AnprFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -466,17 +517,23 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -491,11 +548,15 @@ AnprFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -505,6 +566,8 @@ AnprFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -524,6 +587,7 @@ AnprFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -535,6 +599,8 @@ AnprFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -574,6 +640,24 @@ AnprFlowObserved: type: object x-ngsi: type: Property + plateColor: + description: Detected plate color of the observed vehicle + properties: + confidence: + description: Confidence level of the detection + maximum: 1 + minimum: 0 + type: number + x-ngsi: + type: Property + name: + description: Color name + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + type: Property speed: description: Detected speed of the observed vehicle minimum: 0 @@ -601,7 +685,7 @@ AnprFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -646,7 +730,7 @@ AnprFlowObserved: 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' + 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 @@ -675,9 +759,9 @@ AnprFlowObserved: - location - dateObserved 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) 2024 Contributors to Smart Data Models Program' + 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) 2025 Contributors to Smart Data Models Program x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/AnprFlowObserved/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/AnprFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 + x-model-tags: '' + x-version: 0.0.3 \ No newline at end of file diff --git a/AnprFlowObserved/schema.json b/AnprFlowObserved/schema.json index 0386d5efd..cbfafd405 100644 --- a/AnprFlowObserved/schema.json +++ b/AnprFlowObserved/schema.json @@ -1,6 +1,6 @@ { "$schema": "https://json-schema.org/draft/2020-12/schema", - "$schemaVersion": "0.0.2", + "$schemaVersion": "0.0.3", "modelTags": "", "$id": "https://smart-data-models.github.io/dataModel.Transportation/AnprFlowObserved/schema.json", "title": "ANPR Flow Observed schema", @@ -162,6 +162,22 @@ "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/Location-Commons/properties/location" } } + }, + "plateColor": { + "description": "Property. Detected plate color of the observed vehicle", + "type": "object", + "properties": { + "name": { + "description": "Property. Color name", + "type": "string" + }, + "confidence": { + "description": "Property. Confidence level of the detection", + "type": "number", + "minimum": 0, + "maximum": 1 + } + } } } }, @@ -201,4 +217,4 @@ "location", "dateObserved" ] -} \ No newline at end of file +} diff --git a/AnprFlowObserved/schemaDTDL.json b/AnprFlowObserved/schemaDTDL.json index 7228168ea..4d34555f7 100644 --- a/AnprFlowObserved/schemaDTDL.json +++ b/AnprFlowObserved/schemaDTDL.json @@ -78,11 +78,6 @@ "schema": "string", "comment": "Lane identifier. Lane identification provided by the observer" }, - { - "name": "location", - "writable": true, - "displayName": "location" - }, { "name": "name", "writable": true, @@ -217,11 +212,45 @@ "name": "model", "schema": "object" }, + { + "name": "plateColor", + "schema": "object" + }, { "name": "speed", "schema": "long" } ] + }, + { + "@type": "Telemetry", + "name": "location_Point", + "schema": "point" + }, + { + "@type": "Telemetry", + "name": "location_LineString", + "schema": "lineString" + }, + { + "@type": "Telemetry", + "name": "location_Polygon", + "schema": "polygon" + }, + { + "@type": "Telemetry", + "name": "location_MultiPoint", + "schema": "multiPoint" + }, + { + "@type": "Telemetry", + "name": "location_MultiLineString", + "schema": "multiLineString" + }, + { + "@type": "Telemetry", + "name": "location_MultiPolygon", + "schema": "multiPolygon" } ] } \ No newline at end of file diff --git a/AnprFlowObserved/swagger.yaml b/AnprFlowObserved/swagger.yaml index 914b9f571..4d524a98f 100644 --- a/AnprFlowObserved/swagger.yaml +++ b/AnprFlowObserved/swagger.yaml @@ -11,7 +11,7 @@ info: description: | The data model represents an observation linked to the passing of a vehicle at a certain location and at a given time. This Data Model is based on the [dataModel.Transportation/ItemFlowObserved], extended with ANPR specific properties and links to the observation images. title: AnprFlowObserved - version: "0.0.2" + version: "0.0.3" openapi: "3.0.0" paths: diff --git a/CONTRIBUTORS.yaml b/CONTRIBUTORS.yaml index a62fd878a..4ebec6ed7 100644 --- a/CONTRIBUTORS.yaml +++ b/CONTRIBUTORS.yaml @@ -1,5 +1,12 @@ description: This is a compilation list of all CONTRIBUTORS across different objects (data models) alphabetically ordered. All fields are non mandatory contributors: + - name: + surname: + mail: os2fleetoptimiser@os2.eu + organization: OS2.eu + project: OS2 GPS-Connector + comments: Project funded by OS2 for danish municipalities. + year: 2025 - name: Piet surname: Bikker mail: piet@arvoo.com @@ -140,5 +147,12 @@ contributors: project: comments: year: 2023 + - name: Joao + surname: Viegas + mail: jviegas@ubiwhere.com + organization: ubiwhere + project: + comments: + year: 2025 diff --git a/CrowdFlowObserved/ADOPTERS.yaml b/CrowdFlowObserved/ADOPTERS.yaml index 822f89486..aa462e608 100644 --- a/CrowdFlowObserved/ADOPTERS.yaml +++ b/CrowdFlowObserved/ADOPTERS.yaml @@ -8,3 +8,11 @@ currentAdopters: project: https://lasrozasinnova.es/cosmos-plataforma-de-ciudad-inteligente-de-las-rozas/ comments: startDate: 1-1-2022 +- + adopter: SIOT INGENIERIA + description: Field mapping for Milesight, Hanwha, and Vivotek people counting cameras + mail: siot@siot-ingenieria.com.co + organization: SIOT INGENIERIA + project: CINTEL Duitama Inteligente + comments: + startDate: diff --git a/CrowdFlowObserved/README.md b/CrowdFlowObserved/README.md index 5af872661..ab401a838 100644 --- a/CrowdFlowObserved/README.md +++ b/CrowdFlowObserved/README.md @@ -1,6 +1,6 @@ [![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) # CrowdFlowObserved -Version: 0.0.2 +Version: 0.0.3 ## Description @@ -33,6 +33,14 @@ Link to the [example](https://smart-data-models.github.io/dataModel.Transportati Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/examples/example-normalized.json) (normalized) for NGSI-V2 Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/examples/example-normalized.jsonld) (normalized) for NGSI-LD + +Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/examples/example.json.csv) (keyvalues) for NGSI v2 in CSV format + +Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/examples/example.jsonld.csv) (keyvalues) for NGSI-LD in CSV format + +Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/examples/example-normalized.json.csv) (normalized) for NGSI-V2 in CSV format + +Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/examples/example-normalized.jsonld.csv) (normalized) for NGSI-LD in CSV format ### Dynamic Examples generation Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/CrowdFlowObserved/schema.json&email=info@smartdatamodels.org) of NGSI-LD normalized payloads compliant with this data model. Refresh for new values diff --git a/CrowdFlowObserved/code/code_for_using_dataModel.Transportation_CrowdFlowObserved.py b/CrowdFlowObserved/code/code_for_using_dataModel.Transportation_CrowdFlowObserved.py index 1f79e5417..6fe8f2aad 100644 --- a/CrowdFlowObserved/code/code_for_using_dataModel.Transportation_CrowdFlowObserved.py +++ b/CrowdFlowObserved/code/code_for_using_dataModel.Transportation_CrowdFlowObserved.py @@ -1,9 +1,33 @@ -# # The code for installing different versions of context brokers are located after the code +# # This code allows you to install a orion-ld broker in a linux system +# # The manuals are here https://github.com/FIWARE/context.Orion-LD/tree/develop/doc/manuals-ld +# +# # INSTALL NGSI LD broker (OrionLD) +# sudo docker pull mongo:3.6 +# sudo docker pull fiware/orion-ld +# sudo docker network create fiware_default +# sudo docker run -d --name=mongo-db --network=fiware_default --expose=27017 mongo:3.6 --bind_ip_all --smallfiles +# sudo docker run -d --name fiware-orionld -h orion --network=fiware_default -p 1026:1026 fiware/orion-ld -dbhost mongo-db +# +# # TO RELAUNCH (only if you have already installed a broker in the same machine) +# sudo docker stop fiware-orionld +# sudo docker rm fiware-orionld +# sudo docker stop mongo-db +# sudo docker rm mongo-db +# sudo docker network rm fiware_default +# +# # CHECK INSTANCES +# # Check the broker is running +# curl -X GET 'http://localhost:1026/version' +# +# # Check what entities are in the broker +# curl -X GET http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000 +# +# # now the python code you can use to insert some value in the context broker according to the data model # from pysmartdatamodels import pysmartdatamodels as sdm import subprocess -serverUrl = "http://localhost:1026" # supposed that your broker is installed in localhost with 1026 as default port. Edit to match your configuration +serverUrl = "http://localhost:1026" # supposed that your broker is installed in localhost. Edit to match your configuration dataModel = "CrowdFlowObserved" subject = "dataModel.Transportation" averageHeadwayTime = 5 @@ -30,84 +54,8 @@ # The next line creates the query for inserting this attribute in a NGSI-LD context broker if the attribute does not exist it creates it print(sdm.update_broker(dataModel, subject, attribute, value, serverUrl=serverUrl, updateThenCreate=True)) -print(" In case you have installed the a cntext broker (see comments below )") +print(" In case you have installed the orion-ld broker (see comments on the header of this program)") print(" Execute this instruction to check that the entities has been inserted") command = ['curl', '-X', 'GET', 'http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000'] result = subprocess.run(command, capture_output=True, text=True) print(result.stdout) - -# This code allows you to install different context brokers in a linux system -# -# # ORION-LD -# # The manuals are here https://github.com/FIWARE/context.Orion-LD/tree/develop/doc/manuals-ld -# -# # INSTALL NGSI LD broker (OrionLD) -# sudo docker pull mongo:3.6 -# sudo docker pull fiware/orion-ld -# sudo docker network create fiware_default -# sudo docker run -d --name=mongo-db --network=fiware_default --expose=27017 mongo:3.6 --bind_ip_all --smallfiles -# sudo docker run -d --name fiware-orionld -h orion --network=fiware_default -p 1026:1026 fiware/orion-ld -dbhost mongo-db -# -# # TO RELAUNCH (only if you have already installed a broker in the same machine) -# sudo docker stop fiware-orionld -# sudo docker rm fiware-orionld -# sudo docker stop mongo-db -# sudo docker rm mongo-db -# sudo docker network rm fiware_default -# -# # CHECK INSTANCES -# # Check the broker is running -# curl -X GET 'http://localhost:1026/version' -# -# # Check what entities are in the broker -# curl -X GET http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000 -# -# # STELLIO -# -# # INSTALL NGSI LD broker (Stellio) -# curl -O https://raw.githubusercontent.com/stellio-hub/stellio-context-broker/develop/docker-compose.yml -O https://raw.githubusercontent.com/stellio-hub/stellio-context-broker/develop/.env -# curl -o config/kafka/update_run.sh --create-dirs https://raw.githubusercontent.com/stellio-hub/stellio-context-broker/develop/config/kafka/update_run.sh && chmod u+x config/kafka/update_run.sh -# docker compose up -d -# # wait for some seconds for services to be up and running -# -# # TO RELAUNCH (only if you have already installed a broker in the same machine) -# docker compose down -# -# # CHECK INSTANCES -# curl -X GET 'http://localhost:8080/actuator/health' -# curl -X GET 'http://localhost:8080/search-service/actuator/health' -# -# # view the logs -# docker-compose logs -f --tail=100 -# -# # SCORPIO -# sudo docker pull postgis/postgis -# sudo docker pull scorpiobroker/all-in-one-runner:java-latest -# sudo docker network create fiware_default -# sudo docker run -d --name postgres --network=fiware_default -h postgres -p 5432 -e POSTGRES_USER=ngb -e POSTGRES_PASSWORD=ngb -e POSTGRES_DB=ngb postgis/postgis -# sudo docker run -d --name scorpio -h scorpio --network=fiware_default -e DBHOST=postgres -p 9090:9090 scorpiobroker/all-in-one-runner:java-latest -# -# # TO RELAUNCH (only if you have already installed a broker in the same machine) -# sudo docker stop scorpio -# sudo docker rm scorpio -# sudo docker stop postgres -# sudo docker rm postgres -# sudo docker network rm fiware_default -# -# # CHECK INSTANCES -# # Check the broker is running -# # Release Info -# curl -X GET 'http://localhost:9090/q/info' -# # Health status of the broker -# curl -X GET 'http://localhost:9090/q/health' -# -# # Check what entities are in the broker -# curl -X GET http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000 -# -# -# # now the python code you can use to insert some value in the context broker according to the data model -# # Version Warning! -# # This code is designed to work with the version 0.8.0.1 of pysmartdatamodels or later -# -# -# \ No newline at end of file diff --git a/CrowdFlowObserved/doc/spec.md b/CrowdFlowObserved/doc/spec.md index bc222b4f9..550b350e0 100644 --- a/CrowdFlowObserved/doc/spec.md +++ b/CrowdFlowObserved/doc/spec.md @@ -1,468 +1,516 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entity: CrowdFlowObserved -========================= - - [Open License](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) - [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) - - - Global description: **CrowdFlowObserved** - version: 0.0.2 - - - ## List of properties - [*] If there is not a type in an attribute is because it could have several types or different formats/patterns -- `address[object]`: The mailing address . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: The country. For example, Spain . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: The locality in which the street address is, and which is in the region . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: The region in which the locality is, and which is in the country . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: A district is a type of administrative division that, in some countries, is managed by the local government - - `postOfficeBoxNumber[string]`: The post office box number for PO box addresses. For example, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: The postal code. For example, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: The street address . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: An alternative name for this item - `areaServed[string]`: The geographic area where a service or offered item is provided . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: Average speed of the crowd transiting during the observation period . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: Average headway time. Headway time is the time - elapsed between two consecutive persons . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: A sequence of characters identifying the provider of the harmonised data entity - `dateCreated[date-time]`: Entity creation timestamp. This will usually be allocated by the storage platform - `dateModified[date-time]`: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform - `dateObserved[string]`: The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo` . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: Observation period start date and time. See `dateObserved` . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Observation period end date and time. See `dateObserved`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: A description of this item - `direction[string]`: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Unique identifier of the entity - `location[*]`: Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon - `name[string]`: The name of this item - `occupancy[number]`: Fraction of the observation time where a person has been occupying the observed walkway . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) - `peopleCount[number]`: Total number of people detected during this observation - `refRoadSegment[*]`: Concerned road segment on which the observation has been made . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: list of uri pointing to additional resources about the item - `source[string]`: 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]`: NGSI Entity type. It has to be CrowdFlowObserved - - Required properties -- `dateObserved` - `id` - `type` - - An observation related to the movement of people at a certain place and time. - - - ## Data Model description of properties - Sorted alphabetically (click for details) - - -
full yaml details - ```yaml -CrowdFlowObserved: - description: CrowdFlowObserved - 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 - areaServed: - description: The geographic area where a service or offered item is provided - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - averageCrowdSpeed: - description: Average speed of the crowd transiting during the observation period - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Kilometer per hour (Km/h). - averageHeadwayTime: - description: |- - Average headway time. Headway time is the time - elapsed between two consecutive persons - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: second (s) - congested: - description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion - type: boolean - x-ngsi: - model: https://schema.org/Boolean - 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 - dateObserved: - description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - dateObservedFrom: - description: Observation period start date and time. See `dateObserved` - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - dateObservedTo: - description: Observation period end date and time. See `dateObserved`. - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - direction: - description: 'Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:''inbound, outbound''' - enum: - - inbound - - outbound - type: string - x-ngsi: - model: https://schema.org/Text - 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 - 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 - occupancy: - description: Fraction of the observation time where a person has been occupying the observed walkway - maximum: 1 - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number) - 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 - peopleCount: - description: Total number of people detected during this observation - minimum: 0 - type: number - x-ngsi: - type: Property - refRoadSegment: - 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: Concerned road segment on which the observation has been made - x-ngsi: - model: https://schema.org/URL - 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 - type: - description: NGSI Entity type. It has to be CrowdFlowObserved - enum: - - CrowdFlowObserved - type: string - x-ngsi: - type: Property - required: - - id - - type - - dateObserved - 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.Transportation/blob/master/CrowdFlowObserved/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 -``` -
- - - - - ## Example payloads - #### CrowdFlowObserved NGSI-v2 key-values Example - Here is an example of a CrowdFlowObserved in JSON-LD format as key-values. This is compatible with NGSI-v2 when using `options=keyValues` and returns the context data of an individual entity. -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + Entity: CrowdFlowObserved +========================= + + [Open License](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) + [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) + + + Global description: **CrowdFlowObserved** + version: 0.0.2 + + + + ## List of properties + + [*] If there is not a type in an attribute is because it could have several types or different formats/patterns +- `address[object]`: The mailing address . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: The country. For example, Spain . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: The locality in which the street address is, and which is in the region . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: The region in which the locality is, and which is in the country . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: A district is a type of administrative division that, in some countries, is managed by the local government + - `postOfficeBoxNumber[string]`: The post office box number for PO box addresses. For example, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: The postal code. For example, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: The street address . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Number identifying a specific property on a public street +- `alternateName[string]`: An alternative name for this item - `areaServed[string]`: The geographic area where a service or offered item is provided . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: Average speed of the crowd transiting during the observation period . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: Average headway time. Headway time is the time + elapsed between two consecutive persons . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: A sequence of characters identifying the provider of the harmonised data entity - `dateCreated[date-time]`: Entity creation timestamp. This will usually be allocated by the storage platform - `dateModified[date-time]`: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform - `dateObserved[string]`: The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo` . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: Observation period start date and time. See `dateObserved` . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Observation period end date and time. See `dateObserved`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: A description of this item - `direction[string]`: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Unique identifier of the entity - `location[*]`: Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon - `name[string]`: The name of this item - `occupancy[number]`: Fraction of the observation time where a person has been occupying the observed walkway . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) - `peopleCount[number]`: Total number of people detected during this observation - `refRoadSegment[*]`: Concerned road segment on which the observation has been made . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: list of uri pointing to additional resources about the item - `source[string]`: 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]`: NGSI Entity type. It has to be CrowdFlowObserved + + Required properties +- `dateObserved` - `id` - `type` + + An observation related to the movement of people at a certain place and time. + + + ## Data Model description of properties + Sorted alphabetically (click for details) + + +
full yaml details + ```yaml +CrowdFlowObserved: + description: CrowdFlowObserved + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageCrowdSpeed: + description: Average speed of the crowd transiting during the observation period + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Kilometer per hour (Km/h). + averageHeadwayTime: + description: |- + Average headway time. Headway time is the time + elapsed between two consecutive persons + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: second (s) + congested: + description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion + type: boolean + x-ngsi: + model: https://schema.org/Boolean + 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 + dateObserved: + description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + dateObservedFrom: + description: Observation period start date and time. See `dateObserved` + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + dateObservedTo: + description: Observation period end date and time. See `dateObserved`. + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + direction: + description: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' + enum: + - inbound + - outbound + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + occupancy: + description: Fraction of the observation time where a person has been occupying the observed walkway + maximum: 1 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number) + 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: Relationship + type: array + x-ngsi: + type: Property + peopleCount: + description: Total number of people detected during this observation + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountAway: + description: Total number of people detected during this observation away direction + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountTowards: + description: Total number of people detected during this observation towards direction + minimum: 0 + type: number + x-ngsi: + type: Property + refRoadSegment: + 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: Concerned road segment on which the observation has been made + x-ngsi: + model: https://schema.org/URL + 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 + type: + description: NGSI Entity type. It has to be CrowdFlowObserved + enum: + - CrowdFlowObserved + type: string + x-ngsi: + type: Property + required: + - id + - type + - dateObserved + 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) 2025 Contributors to Smart Data Models Program + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json + x-model-tags: '' + x-version: 0.0.3 +``` +
+ + + + + ## Example payloads + #### CrowdFlowObserved NGSI-v2 key-values Example + Here is an example of a CrowdFlowObserved in JSON-LD format as key-values. This is compatible with NGSI-v2 when using `options=keyValues` and returns the context data of an individual entity. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -471,6 +519,8 @@ CrowdFlowObserved: "dateObservedFrom": "2018-08-07T11:10:00Z", "dateObservedTo": "2018-08-07T11:15:00Z", "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "averageHeadwayTime": 5, "congested": false, "direction": "inbound", @@ -493,10 +543,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-v2 normalized Example - Here is an example of a CrowdFlowObserved in JSON-LD format as normalized. This is compatible with NGSI-v2 when not using options and returns the context data of an individual entity. -
show/hide example +
+ #### CrowdFlowObserved NGSI-v2 normalized Example + Here is an example of a CrowdFlowObserved in JSON-LD format as normalized. This is compatible with NGSI-v2 when not using options and returns the context data of an individual entity. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -517,6 +567,14 @@ CrowdFlowObserved: "type": "Number", "value": 100 }, + "peopleCountTowards": { + "type": "Number", + "value": 50 + }, + "peopleCountAway": { + "type": "Number", + "value": 50 + }, "averageHeadwayTime": { "type": "Number", "value": 5 @@ -551,10 +609,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-LD key-values Example - Here is an example of a CrowdFlowObserved in JSON-LD format as key-values. This is compatible with NGSI-LD when using `options=keyValues` and returns the context data of an individual entity. -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD key-values Example + Here is an example of a CrowdFlowObserved in JSON-LD format as key-values. This is compatible with NGSI-LD when using `options=keyValues` and returns the context data of an individual entity. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -583,15 +641,17 @@ CrowdFlowObserved: "type": "LineString" }, "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- #### CrowdFlowObserved NGSI-LD normalized Example - Here is an example of a CrowdFlowObserved in JSON-LD format as normalized. This is compatible with NGSI-LD when not using options and returns the context data of an individual entity. -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD normalized Example + Here is an example of a CrowdFlowObserved in JSON-LD format as normalized. This is compatible with NGSI-LD when not using options and returns the context data of an individual entity. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -653,17 +713,25 @@ CrowdFlowObserved: "type": "Property", "value": 100 }, + "peopleCountTowards": { + "type": "Property", + "value": 50 + }, + "peopleCountAway": { + "type": "Property", + "value": 50 + }, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- - - - See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) diff --git a/CrowdFlowObserved/doc/spec_DE.md b/CrowdFlowObserved/doc/spec_DE.md index 8a4e3e88d..049111db0 100644 --- a/CrowdFlowObserved/doc/spec_DE.md +++ b/CrowdFlowObserved/doc/spec_DE.md @@ -1,468 +1,516 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entität: CrowdFlowObserved -========================== - - [Offene Lizenz](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) - [Dokument automatisch generiert](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) - - - Globale Beschreibung: **CrowdFlowObserved** - Version: 0.0.2 - - - ## Liste der Eigenschaften - [*] Wenn es für ein Attribut keinen Typ gibt, kann es mehrere Typen oder verschiedene Formate/Muster haben. -- `address[object]`: Die Postanschrift . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Das Land. Zum Beispiel, Spanien . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: Die Ortschaft, in der sich die Adresse befindet, und die in der Region liegt . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: Die Region, in der sich der Ort befindet, und die auf dem Land liegt . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: Ein Bezirk ist eine Art von Verwaltungseinheit, die in einigen Ländern von der lokalen Regierung verwaltet wird. - - `postOfficeBoxNumber[string]`: Die Postfachnummer für Postfachadressen. Zum Beispiel, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: Die Postleitzahl. Zum Beispiel, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: Die Straßenanschrift . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: Ein alternativer Name für diesen Artikel - `areaServed[string]`: Das geografische Gebiet, in dem eine Dienstleistung oder ein angebotener Artikel erbracht wird . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: Durchschnittliche Geschwindigkeit der Menschenmenge, die sich während des Beobachtungszeitraums bewegt . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: Durchschnittliche Fahrtzeit. Die Vorbeifahrtzeit ist die Zeit - die zwischen zwei aufeinanderfolgenden Personen verstreicht . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: Zeigt an, ob während des Beobachtungszeitraums auf dem betreffenden Gehweg ein Menschenauflauf stattgefunden hat. Das Fehlen dieses Attributs bedeutet, dass keine Menschenansammlung vorlag. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: Eine Folge von Zeichen zur Identifizierung des Anbieters der harmonisierten Dateneinheit - `dateCreated[date-time]`: Zeitstempel der Entitätserstellung. Dieser wird normalerweise von der Speicherplattform zugewiesen - `dateModified[date-time]`: Zeitstempel der letzten Änderung der Entität. Dieser wird in der Regel von der Speicherplattform vergeben - `dateObserved[string]`: Das Datum und die Uhrzeit dieser Beobachtung im ISO8601 UTC-Format. Sie können durch einen bestimmten Zeitpunkt oder durch ein ISO8601-Intervall dargestellt werden. Als Abhilfe für die fehlende Unterstützung des Orion Context Brokers für Datumsintervalle können zwei separate Attribute verwendet werden: `dateObservedFrom`, `dateObservedTo` . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: Datum und Uhrzeit des Beginns des Beobachtungszeitraums. Siehe `dateObserved` . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Datum und Uhrzeit des Endes des Beobachtungszeitraums. Siehe `dateObserved`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: Eine Beschreibung dieses Artikels - `direction[string]`: Übliche Fahrtrichtung in dem von dieser Beobachtung betroffenen Gehweg in Bezug auf das Stadtzentrum. Enum:'einfahrend, ausfahrend' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Eindeutiger Bezeichner der Entität - `location[*]`: Geojson-Referenz auf das Element. Es kann Punkt, LineString, Polygon, MultiPoint, MultiLineString oder MultiPolygon sein - `name[string]`: Der Name dieses Artikels - `occupancy[number]`: Anteil der Beobachtungszeit, in der sich eine Person auf dem beobachteten Gehweg aufgehalten hat . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: Eine Liste mit einer JSON-kodierten Zeichenfolge, die auf die eindeutigen Kennungen der Eigentümer verweist - `peopleCount[number]`: Gesamtzahl der während dieser Beobachtung festgestellten Personen - `refRoadSegment[*]`: Betroffener Straßenabschnitt, auf dem die Beobachtung gemacht wurde . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: Liste von URLs, die auf zusätzliche Ressourcen zu dem Artikel verweisen - `source[string]`: Eine Folge von Zeichen, die die ursprüngliche Quelle der Entitätsdaten als URL angibt. Empfohlen wird der voll qualifizierte Domänenname des Quellanbieters oder die URL des Quellobjekts. - `type[string]`: NGSI-Entitätstyp. Es muss CrowdFlowObserved sein - - Erforderliche Eigenschaften -- `dateObserved` - `id` - `type` - - Eine Beobachtung im Zusammenhang mit der Bewegung von Menschen an einem bestimmten Ort und zu einer bestimmten Zeit. - - - ## Datenmodell Beschreibung der Eigenschaften - Alphabetisch sortiert (für Details anklicken) - - -
full yaml details - ```yaml -CrowdFlowObserved: - description: CrowdFlowObserved - 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 - areaServed: - description: The geographic area where a service or offered item is provided - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - averageCrowdSpeed: - description: Average speed of the crowd transiting during the observation period - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Kilometer per hour (Km/h). - averageHeadwayTime: - description: |- - Average headway time. Headway time is the time - elapsed between two consecutive persons - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: second (s) - congested: - description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion - type: boolean - x-ngsi: - model: https://schema.org/Boolean - 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 - dateObserved: - description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - dateObservedFrom: - description: Observation period start date and time. See `dateObserved` - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - dateObservedTo: - description: Observation period end date and time. See `dateObserved`. - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - direction: - description: 'Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:''inbound, outbound''' - enum: - - inbound - - outbound - type: string - x-ngsi: - model: https://schema.org/Text - 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 - 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 - occupancy: - description: Fraction of the observation time where a person has been occupying the observed walkway - maximum: 1 - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number) - 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 - peopleCount: - description: Total number of people detected during this observation - minimum: 0 - type: number - x-ngsi: - type: Property - refRoadSegment: - 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: Concerned road segment on which the observation has been made - x-ngsi: - model: https://schema.org/URL - 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 - type: - description: NGSI Entity type. It has to be CrowdFlowObserved - enum: - - CrowdFlowObserved - type: string - x-ngsi: - type: Property - required: - - id - - type - - dateObserved - 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.Transportation/blob/master/CrowdFlowObserved/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 -``` -
- - - - - ## Beispiel-Nutzlasten - #### CrowdFlowObserved NGSI-v2 key-values Beispiel - Hier ist ein Beispiel für einen CrowdFlowObserved im JSON-LD-Format als Schlüsselwerte. Dies ist mit NGSI-v2 kompatibel, wenn `options=keyValues` verwendet wird und liefert die Kontextdaten einer einzelnen Entität. -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + Entität: CrowdFlowObserved +========================== + + [Offene Lizenz](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) + [Dokument automatisch generiert](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) + + + Globale Beschreibung: **CrowdFlowObserved** + Version: 0.0.2 + + + + ## Liste der Eigenschaften + + [*] Wenn es für ein Attribut keinen Typ gibt, liegt das daran, dass es mehrere Typen oder unterschiedliche Formate/Muster haben kann. +- `address[object]`: Die Postanschrift . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Das Land. Zum Beispiel, Spanien . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: Die Ortschaft, in der sich die Adresse befindet, und die in der Region liegt . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: Die Region, in der sich der Ort befindet, und die auf dem Land liegt . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Ein Bezirk ist eine Art von Verwaltungseinheit, die in einigen Ländern von der lokalen Regierung verwaltet wird. + - `postOfficeBoxNumber[string]`: Die Postfachnummer für Postfachadressen. Zum Beispiel, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Die Postleitzahl. Zum Beispiel, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: Die Straßenanschrift . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Nummer zur Identifizierung eines bestimmten Grundstücks an einer öffentlichen Straße +- `alternateName[string]`: Ein alternativer Name für diesen Artikel - `areaServed[string]`: Das geografische Gebiet, in dem eine Dienstleistung oder ein angebotener Artikel erbracht wird . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: Durchschnittliche Geschwindigkeit der Menschenmenge, die sich während des Beobachtungszeitraums bewegt . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: Durchschnittliche Fahrtzeit. Die Vorbeifahrtzeit ist die Zeit + die zwischen zwei aufeinanderfolgenden Personen verstreicht . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: Zeigt an, ob während des Beobachtungszeitraums auf dem betreffenden Gehweg ein Menschenauflauf stattgefunden hat. Das Fehlen dieses Attributs bedeutet, dass keine Menschenansammlung vorlag. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: Eine Folge von Zeichen zur Identifizierung des Anbieters der harmonisierten Dateneinheit - `dateCreated[date-time]`: Zeitstempel der Entitätserstellung. Dieser wird normalerweise von der Speicherplattform zugewiesen - `dateModified[date-time]`: Zeitstempel der letzten Änderung der Entität. Dieser wird in der Regel von der Speicherplattform vergeben - `dateObserved[string]`: Das Datum und die Uhrzeit dieser Beobachtung im ISO8601 UTC-Format. Sie können durch einen bestimmten Zeitpunkt oder durch ein ISO8601-Intervall dargestellt werden. Als Abhilfe für die fehlende Unterstützung des Orion Context Brokers für Datumsintervalle können zwei separate Attribute verwendet werden: `dateObservedFrom`, `dateObservedTo` . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: Datum und Uhrzeit des Beginns des Beobachtungszeitraums. Siehe `dateObserved` . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Datum und Uhrzeit des Endes des Beobachtungszeitraums. Siehe `dateObserved`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: Eine Beschreibung dieses Artikels - `direction[string]`: Übliche Fahrtrichtung in dem von dieser Beobachtung betroffenen Gehweg in Bezug auf das Stadtzentrum. Enum:'einfahrend, ausfahrend' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Eindeutiger Bezeichner der Entität - `location[*]`: Geojson-Referenz auf das Element. Es kann Punkt, LineString, Polygon, MultiPoint, MultiLineString oder MultiPolygon sein - `name[string]`: Der Name dieses Artikels - `occupancy[number]`: Anteil der Beobachtungszeit, in der sich eine Person auf dem beobachteten Gehweg aufgehalten hat . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: Eine Liste mit einer JSON-kodierten Zeichenfolge, die auf die eindeutigen Kennungen der Eigentümer verweist - `peopleCount[number]`: Gesamtzahl der während dieser Beobachtung festgestellten Personen - `refRoadSegment[*]`: Betroffener Straßenabschnitt, auf dem die Beobachtung gemacht wurde . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: Liste von URLs, die auf zusätzliche Ressourcen zu dem Artikel verweisen - `source[string]`: Eine Folge von Zeichen, die die ursprüngliche Quelle der Entitätsdaten als URL angibt. Empfohlen wird der vollständig qualifizierte Domänenname des Quellanbieters oder die URL des Quellobjekts. - `type[string]`: NGSI-Entitätstyp. Es muss CrowdFlowObserved sein + + Erforderliche Eigenschaften +- `dateObserved` - `id` - `type` + + Eine Beobachtung im Zusammenhang mit der Bewegung von Menschen an einem bestimmten Ort und zu einer bestimmten Zeit. + + + ## Datenmodell Beschreibung der Eigenschaften + Alphabetisch sortiert (für Details anklicken) + + +
full yaml details + ```yaml +CrowdFlowObserved: + description: CrowdFlowObserved + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageCrowdSpeed: + description: Average speed of the crowd transiting during the observation period + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Kilometer per hour (Km/h). + averageHeadwayTime: + description: |- + Average headway time. Headway time is the time + elapsed between two consecutive persons + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: second (s) + congested: + description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion + type: boolean + x-ngsi: + model: https://schema.org/Boolean + 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 + dateObserved: + description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + dateObservedFrom: + description: Observation period start date and time. See `dateObserved` + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + dateObservedTo: + description: Observation period end date and time. See `dateObserved`. + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + direction: + description: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' + enum: + - inbound + - outbound + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + occupancy: + description: Fraction of the observation time where a person has been occupying the observed walkway + maximum: 1 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number) + 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: Relationship + type: array + x-ngsi: + type: Property + peopleCount: + description: Total number of people detected during this observation + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountAway: + description: Total number of people detected during this observation away direction + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountTowards: + description: Total number of people detected during this observation towards direction + minimum: 0 + type: number + x-ngsi: + type: Property + refRoadSegment: + 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: Concerned road segment on which the observation has been made + x-ngsi: + model: https://schema.org/URL + 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 + type: + description: NGSI Entity type. It has to be CrowdFlowObserved + enum: + - CrowdFlowObserved + type: string + x-ngsi: + type: Property + required: + - id + - type + - dateObserved + 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) 2025 Contributors to Smart Data Models Program + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json + x-model-tags: '' + x-version: 0.0.3 +``` +
+ + + + + ## Beispiel-Nutzlasten + #### CrowdFlowObserved NGSI-v2 key-values Beispiel + Hier ist ein Beispiel für einen CrowdFlowObserved im JSON-LD-Format als Schlüsselwerte. Dies ist mit NGSI-v2 kompatibel, wenn `options=keyValues` verwendet wird und liefert die Kontextdaten einer einzelnen Entität. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -471,6 +519,8 @@ CrowdFlowObserved: "dateObservedFrom": "2018-08-07T11:10:00Z", "dateObservedTo": "2018-08-07T11:15:00Z", "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "averageHeadwayTime": 5, "congested": false, "direction": "inbound", @@ -493,10 +543,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-v2 normalisiert Beispiel - Hier ist ein Beispiel für einen CrowdFlowObserved im JSON-LD-Format in normalisierter Form. Dies ist kompatibel mit NGSI-v2, wenn keine Optionen verwendet werden, und liefert die Kontextdaten einer einzelnen Entität. -
show/hide example +
+ #### CrowdFlowObserved NGSI-v2 normalisiert Beispiel + Hier ist ein Beispiel für einen CrowdFlowObserved im JSON-LD-Format in normalisierter Form. Dies ist kompatibel mit NGSI-v2, wenn keine Optionen verwendet werden, und liefert die Kontextdaten einer einzelnen Entität. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -517,6 +567,14 @@ CrowdFlowObserved: "type": "Number", "value": 100 }, + "peopleCountTowards": { + "type": "Number", + "value": 50 + }, + "peopleCountAway": { + "type": "Number", + "value": 50 + }, "averageHeadwayTime": { "type": "Number", "value": 5 @@ -551,10 +609,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-LD key-values Beispiel - Hier ist ein Beispiel für einen CrowdFlowObserved im JSON-LD-Format als Schlüsselwerte. Dies ist mit NGSI-LD kompatibel, wenn `options=keyValues` verwendet wird und liefert die Kontextdaten einer einzelnen Entität. -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD key-values Beispiel + Hier ist ein Beispiel für einen CrowdFlowObserved im JSON-LD-Format als Schlüsselwerte. Dies ist mit NGSI-LD kompatibel, wenn `options=keyValues` verwendet wird und liefert die Kontextdaten einer einzelnen Entität. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -583,15 +641,17 @@ CrowdFlowObserved: "type": "LineString" }, "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- #### CrowdFlowObserved NGSI-LD normalisiert Beispiel - Hier ist ein Beispiel für einen CrowdFlowObserved im JSON-LD-Format in normalisierter Form. Dies ist mit NGSI-LD kompatibel, wenn keine Optionen verwendet werden, und liefert die Kontextdaten einer einzelnen Entität. -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD normalisiert Beispiel + Hier ist ein Beispiel für einen CrowdFlowObserved im JSON-LD-Format in normalisierter Form. Dies ist mit NGSI-LD kompatibel, wenn keine Optionen verwendet werden, und liefert die Kontextdaten einer einzelnen Entität. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -653,17 +713,25 @@ CrowdFlowObserved: "type": "Property", "value": 100 }, + "peopleCountTowards": { + "type": "Property", + "value": 50 + }, + "peopleCountAway": { + "type": "Property", + "value": 50 + }, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- - - - Siehe [FAQ 10] (https://smartdatamodels.org/index.php/faqs/), um eine Antwort auf die Frage zu erhalten, wie man mit Größeneinheiten umgeht - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + Siehe [FAQ 10] (https://smartdatamodels.org/index.php/faqs/), um eine Antwort auf die Frage zu erhalten, wie man mit Größeneinheiten umgeht + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) diff --git a/CrowdFlowObserved/doc/spec_ES.md b/CrowdFlowObserved/doc/spec_ES.md index eebee2b83..3b5f1aa16 100644 --- a/CrowdFlowObserved/doc/spec_ES.md +++ b/CrowdFlowObserved/doc/spec_ES.md @@ -1,468 +1,516 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entidad: CrowdFlowObserved -========================== - - [Licencia abierta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) - [documento generado automáticamente](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) - - - Descripción global: **FlujoObservado** - versión: 0.0.2 - - - ## Lista de propiedades - [*] Si no hay un tipo en un atributo es porque puede tener varios tipos o diferentes formatos/patrones. -- `address[object]`: La dirección postal . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: El país. Por ejemplo, España . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: La localidad en la que se encuentra la dirección postal, y que está en la región . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: La región en la que se encuentra la localidad, y que está en el país . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: Un distrito es un tipo de división administrativa que, en algunos países, gestiona el gobierno local - - `postOfficeBoxNumber[string]`: El número del apartado de correos para las direcciones de apartados postales. Por ejemplo, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: El código postal. Por ejemplo, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: La dirección . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: Un nombre alternativo para este artículo - `areaServed[string]`: La zona geográfica en la que se presta un servicio o se ofrece un artículo . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: Velocidad media de la multitud en tránsito durante el periodo de observación . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: Tiempo medio de recorrido. El tiempo de recorrido es el tiempo - transcurrido entre dos personas consecutivas . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: Indica si ha habido aglomeraciones durante el periodo de observación en el pasillo en cuestión. La ausencia de este atributo significa que no hubo aglomeraciones. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: Una secuencia de caracteres que identifica al proveedor de la entidad de datos armonizada - `dateCreated[date-time]`: Fecha de creación de la entidad. Normalmente será asignada por la plataforma de almacenamiento - `dateModified[date-time]`: Marca de tiempo de la última modificación de la entidad. Suele ser asignada por la plataforma de almacenamiento - `dateObserved[string]`: La fecha y hora de esta observación en formato ISO8601 UTC. Puede representarse mediante un instante de tiempo específico o mediante un intervalo ISO8601. Como solución a la falta de soporte de Orion Context Broker para los intervalos de fecha y hora, se pueden utilizar dos atributos separados: `dateObservedFrom`, `dateObservedTo`. . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: Fecha y hora de inicio del periodo de observación. Véase `dateObserved`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Fecha y hora de finalización del periodo de observación. Véase `dateObserved`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: Descripción de este artículo - `direction[string]`: Sentido habitual de circulación en el paseo al que se refiere esta observación con respecto al centro de la ciudad. Enum:'entrada, salida' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Identificador único de la entidad - `location[*]`: Referencia Geojson al elemento. Puede ser Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon. - `name[string]`: El nombre de este artículo - `occupancy[number]`: Fracción del tiempo de observación en la que una persona ha ocupado el pasillo observado . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: Una lista que contiene una secuencia de caracteres codificada en JSON que hace referencia a los identificadores únicos de los propietarios. - `peopleCount[number]`: Número total de personas detectadas durante esta observación - `refRoadSegment[*]`: Tramo de carretera afectado en el que se ha realizado la observación . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: lista de uri que apuntan a recursos adicionales sobre el artículo - `source[string]`: Secuencia de caracteres que indica la fuente original de los datos de la entidad en forma de URL. Se recomienda que sea el nombre de dominio completo del proveedor de origen o la URL del objeto de origen. - `type[string]`: Tipo de entidad NGSI. Tiene que ser CrowdFlowObserved - - Propiedades requeridas -- `dateObserved` - `id` - `type` - - Una observación relacionada con el movimiento de personas en un lugar y momento determinados. - - - ## Descripción de las propiedades del modelo de datos - Ordenados alfabéticamente (pulse para más detalles) - - -
full yaml details - ```yaml -CrowdFlowObserved: - description: CrowdFlowObserved - 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 - areaServed: - description: The geographic area where a service or offered item is provided - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - averageCrowdSpeed: - description: Average speed of the crowd transiting during the observation period - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Kilometer per hour (Km/h). - averageHeadwayTime: - description: |- - Average headway time. Headway time is the time - elapsed between two consecutive persons - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: second (s) - congested: - description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion - type: boolean - x-ngsi: - model: https://schema.org/Boolean - 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 - dateObserved: - description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - dateObservedFrom: - description: Observation period start date and time. See `dateObserved` - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - dateObservedTo: - description: Observation period end date and time. See `dateObserved`. - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - direction: - description: 'Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:''inbound, outbound''' - enum: - - inbound - - outbound - type: string - x-ngsi: - model: https://schema.org/Text - 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 - 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 - occupancy: - description: Fraction of the observation time where a person has been occupying the observed walkway - maximum: 1 - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number) - 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 - peopleCount: - description: Total number of people detected during this observation - minimum: 0 - type: number - x-ngsi: - type: Property - refRoadSegment: - 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: Concerned road segment on which the observation has been made - x-ngsi: - model: https://schema.org/URL - 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 - type: - description: NGSI Entity type. It has to be CrowdFlowObserved - enum: - - CrowdFlowObserved - type: string - x-ngsi: - type: Property - required: - - id - - type - - dateObserved - 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.Transportation/blob/master/CrowdFlowObserved/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 -``` -
- - - - - ## Ejemplo de carga útil - #### CrowdFlowObserved NGSI-v2 key-values Ejemplo - He aquí un ejemplo de un CrowdFlowObserved en formato JSON-LD como key-values. Esto es compatible con NGSI-v2 cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + Entidad: CrowdFlowObserved +========================== + + [Licencia abierta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) + [documento generado automáticamente](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) + + + Descripción global: **FlujoObservado** + versión: 0.0.2 + + + + ## Lista de propiedades + + [*] Si no hay un tipo en un atributo es porque puede tener varios tipos o diferentes formatos/patrones. +- `address[object]`: La dirección postal . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: El país. Por ejemplo, España . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La localidad en la que se encuentra la dirección postal, y que está en la región . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La región en la que se encuentra la localidad, y que está en el país . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un distrito es un tipo de división administrativa que, en algunos países, gestiona el gobierno local + - `postOfficeBoxNumber[string]`: El número del apartado de correos para las direcciones de apartados postales. Por ejemplo, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: El código postal. Por ejemplo, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: La dirección . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Número que identifica una propiedad específica en una vía pública +- `alternateName[string]`: Un nombre alternativo para este artículo - `areaServed[string]`: La zona geográfica en la que se presta un servicio o se ofrece un artículo . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: Velocidad media de la multitud en tránsito durante el periodo de observación . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: Tiempo medio de recorrido. El tiempo de recorrido es el tiempo + transcurrido entre dos personas consecutivas . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: Indica si ha habido aglomeraciones durante el periodo de observación en el pasillo en cuestión. La ausencia de este atributo significa que no hubo aglomeraciones. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: Una secuencia de caracteres que identifica al proveedor de la entidad de datos armonizada - `dateCreated[date-time]`: Fecha de creación de la entidad. Normalmente será asignada por la plataforma de almacenamiento - `dateModified[date-time]`: Marca de tiempo de la última modificación de la entidad. Suele ser asignada por la plataforma de almacenamiento - `dateObserved[string]`: La fecha y hora de esta observación en formato ISO8601 UTC. Puede representarse mediante un instante de tiempo específico o mediante un intervalo ISO8601. Como solución a la falta de soporte de Orion Context Broker para los intervalos de fecha y hora, se pueden utilizar dos atributos separados: `dateObservedFrom`, `dateObservedTo`. . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: Fecha y hora de inicio del periodo de observación. Véase `dateObserved`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Fecha y hora de finalización del periodo de observación. Véase `dateObserved`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: Descripción de este artículo - `direction[string]`: Sentido habitual de circulación en el paseo al que se refiere esta observación con respecto al centro de la ciudad. Enum:'entrada, salida' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Identificador único de la entidad - `location[*]`: Referencia Geojson al elemento. Puede ser Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon. - `name[string]`: El nombre de este artículo - `occupancy[number]`: Fracción del tiempo de observación en la que una persona ha ocupado el pasillo observado . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: Una lista que contiene una secuencia de caracteres codificada en JSON que hace referencia a los identificadores únicos de los propietarios. - `peopleCount[number]`: Número total de personas detectadas durante esta observación - `refRoadSegment[*]`: Tramo de carretera afectado en el que se ha realizado la observación . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: lista de uri que apuntan a recursos adicionales sobre el artículo - `source[string]`: Secuencia de caracteres que indica la fuente original de los datos de la entidad en forma de URL. Se recomienda que sea el nombre de dominio completo del proveedor de origen o la URL del objeto de origen. - `type[string]`: Tipo de entidad NGSI. Tiene que ser CrowdFlowObserved + + Propiedades requeridas +- `dateObserved` - `id` - `type` + + Una observación relacionada con el movimiento de personas en un lugar y momento determinados. + + + ## Descripción de las propiedades del modelo de datos + Ordenados alfabéticamente (pulse para más detalles) + + +
full yaml details + ```yaml +CrowdFlowObserved: + description: CrowdFlowObserved + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageCrowdSpeed: + description: Average speed of the crowd transiting during the observation period + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Kilometer per hour (Km/h). + averageHeadwayTime: + description: |- + Average headway time. Headway time is the time + elapsed between two consecutive persons + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: second (s) + congested: + description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion + type: boolean + x-ngsi: + model: https://schema.org/Boolean + 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 + dateObserved: + description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + dateObservedFrom: + description: Observation period start date and time. See `dateObserved` + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + dateObservedTo: + description: Observation period end date and time. See `dateObserved`. + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + direction: + description: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' + enum: + - inbound + - outbound + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + occupancy: + description: Fraction of the observation time where a person has been occupying the observed walkway + maximum: 1 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number) + 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: Relationship + type: array + x-ngsi: + type: Property + peopleCount: + description: Total number of people detected during this observation + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountAway: + description: Total number of people detected during this observation away direction + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountTowards: + description: Total number of people detected during this observation towards direction + minimum: 0 + type: number + x-ngsi: + type: Property + refRoadSegment: + 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: Concerned road segment on which the observation has been made + x-ngsi: + model: https://schema.org/URL + 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 + type: + description: NGSI Entity type. It has to be CrowdFlowObserved + enum: + - CrowdFlowObserved + type: string + x-ngsi: + type: Property + required: + - id + - type + - dateObserved + 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) 2025 Contributors to Smart Data Models Program + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json + x-model-tags: '' + x-version: 0.0.3 +``` +
+ + + + + ## Ejemplo de carga útil + #### CrowdFlowObserved NGSI-v2 key-values Ejemplo + He aquí un ejemplo de un CrowdFlowObserved en formato JSON-LD como key-values. Esto es compatible con NGSI-v2 cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -471,6 +519,8 @@ CrowdFlowObserved: "dateObservedFrom": "2018-08-07T11:10:00Z", "dateObservedTo": "2018-08-07T11:15:00Z", "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "averageHeadwayTime": 5, "congested": false, "direction": "inbound", @@ -493,10 +543,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-v2 normalizado Ejemplo - He aquí un ejemplo de un CrowdFlowObserved en formato JSON-LD normalizado. Esto es compatible con NGSI-v2 cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. -
show/hide example +
+ #### CrowdFlowObserved NGSI-v2 normalizado Ejemplo + He aquí un ejemplo de un CrowdFlowObserved en formato JSON-LD normalizado. Esto es compatible con NGSI-v2 cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -517,6 +567,14 @@ CrowdFlowObserved: "type": "Number", "value": 100 }, + "peopleCountTowards": { + "type": "Number", + "value": 50 + }, + "peopleCountAway": { + "type": "Number", + "value": 50 + }, "averageHeadwayTime": { "type": "Number", "value": 5 @@ -551,10 +609,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-LD key-values Ejemplo - He aquí un ejemplo de un CrowdFlowObserved en formato JSON-LD como key-values. Esto es compatible con NGSI-LD cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD key-values Ejemplo + He aquí un ejemplo de un CrowdFlowObserved en formato JSON-LD como key-values. Esto es compatible con NGSI-LD cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -583,15 +641,17 @@ CrowdFlowObserved: "type": "LineString" }, "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- #### CrowdFlowObserved NGSI-LD normalizado Ejemplo - He aquí un ejemplo de un CrowdFlowObserved en formato JSON-LD normalizado. Esto es compatible con NGSI-LD cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD normalizado Ejemplo + He aquí un ejemplo de un CrowdFlowObserved en formato JSON-LD normalizado. Esto es compatible con NGSI-LD cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -653,17 +713,25 @@ CrowdFlowObserved: "type": "Property", "value": 100 }, + "peopleCountTowards": { + "type": "Property", + "value": 50 + }, + "peopleCountAway": { + "type": "Property", + "value": 50 + }, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- - - - Consulte [FAQ 10](https://smartdatamodels.org/index.php/faqs/) para obtener una respuesta sobre cómo tratar las unidades de magnitud. - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + Consulte [FAQ 10](https://smartdatamodels.org/index.php/faqs/) para obtener una respuesta sobre cómo tratar las unidades de magnitud. + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) diff --git a/CrowdFlowObserved/doc/spec_FR.md b/CrowdFlowObserved/doc/spec_FR.md index b2118ca99..6f4005027 100644 --- a/CrowdFlowObserved/doc/spec_FR.md +++ b/CrowdFlowObserved/doc/spec_FR.md @@ -1,468 +1,516 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entité : CrowdFlowObserved -========================== - - [Licence ouverte] (https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) - [document généré automatiquement] (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) - - - Description globale : **CrowdFlowObserved** - version : 0.0.2 - - - ## Liste des propriétés - [*] S'il n'y a pas de type dans un attribut, c'est parce qu'il peut avoir plusieurs types ou différents formats/modèles. -- `address[object]`: L'adresse postale . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Le pays. Par exemple, l'Espagne . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: La localité dans laquelle se trouve l'adresse postale et qui se trouve dans la région . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: La région dans laquelle se trouve la localité et qui se trouve dans le pays . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: Un district est un type de division administrative qui, dans certains pays, est géré par le gouvernement local. - - `postOfficeBoxNumber[string]`: Le numéro de la boîte postale pour les adresses de boîtes postales. Par exemple, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: Le code postal. Par exemple, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: L'adresse de la rue . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: Un nom alternatif pour ce poste - `areaServed[string]`: La zone géographique où un service ou un article est offert . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: Vitesse moyenne de la foule transitant pendant la période d'observation . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: Durée moyenne du trajet. Le temps d'attente est le temps - écoulé entre deux personnes consécutives . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: Indique s'il y a eu une congestion de la foule au cours de la période d'observation dans le couloir en question. L'absence de cet attribut signifie qu'il n'y a pas eu d'encombrement. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: Une séquence de caractères identifiant le fournisseur de l'entité de données harmonisées - `dateCreated[date-time]`: Horodatage de la création de l'entité. Celle-ci est généralement attribuée par la plate-forme de stockage - `dateModified[date-time]`: Date de la dernière modification de l'entité. Cette date est généralement attribuée par la plate-forme de stockage - `dateObserved[string]`: La date et l'heure de cette observation au format ISO8601 UTC. Elle peut être représentée par un instant spécifique ou par un intervalle ISO8601. Pour pallier le manque de support du Context Broker d'Orion pour les intervalles de temps, il est possible d'utiliser deux attributs distincts : `dateObservedFrom`, `dateObservedTo`. . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: Date et heure de début de la période d'observation. Voir `dateObserved` . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Date et heure de fin de la période d'observation. Voir `dateObserved`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: Une description de l'article - `direction[string]`: Sens habituel de la circulation dans la voie piétonne visée par cette observation par rapport au centre ville. Enum : "entrant, sortant . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Identifiant unique de l'entité - `location[*]`: Référence Geojson à l'élément. Il peut s'agir d'un point, d'une chaîne de ligne, d'un polygone, d'un point multiple, d'une chaîne de ligne multiple ou d'un polygone multiple. - `name[string]`: Le nom de cet élément - `occupancy[number]`: Fraction du temps d'observation pendant laquelle une personne a occupé le passage observé . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: Une liste contenant une séquence de caractères encodés JSON référençant les identifiants uniques du ou des propriétaires. - `peopleCount[number]`: Nombre total de personnes détectées au cours de cette observation - `refRoadSegment[*]`: Segment de route concerné sur lequel l'observation a été faite . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: liste d'uri pointant vers des ressources supplémentaires concernant l'élément - `source[string]`: Séquence de caractères indiquant la source originale des données de l'entité sous forme d'URL. Il est recommandé d'utiliser le nom de domaine complet du fournisseur de la source ou l'URL de l'objet source. - `type[string]`: Type d'entité NGSI. Il doit s'agir de CrowdFlowObserved - - Propriétés requises -- `dateObserved` - `id` - `type` - - Une observation liée au mouvement des personnes à un certain endroit et à un certain moment. - - - ## Modèle de données description des propriétés - Classés par ordre alphabétique (cliquez pour plus de détails) - - -
full yaml details - ```yaml -CrowdFlowObserved: - description: CrowdFlowObserved - 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 - areaServed: - description: The geographic area where a service or offered item is provided - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - averageCrowdSpeed: - description: Average speed of the crowd transiting during the observation period - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Kilometer per hour (Km/h). - averageHeadwayTime: - description: |- - Average headway time. Headway time is the time - elapsed between two consecutive persons - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: second (s) - congested: - description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion - type: boolean - x-ngsi: - model: https://schema.org/Boolean - 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 - dateObserved: - description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - dateObservedFrom: - description: Observation period start date and time. See `dateObserved` - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - dateObservedTo: - description: Observation period end date and time. See `dateObserved`. - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - direction: - description: 'Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:''inbound, outbound''' - enum: - - inbound - - outbound - type: string - x-ngsi: - model: https://schema.org/Text - 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 - 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 - occupancy: - description: Fraction of the observation time where a person has been occupying the observed walkway - maximum: 1 - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number) - 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 - peopleCount: - description: Total number of people detected during this observation - minimum: 0 - type: number - x-ngsi: - type: Property - refRoadSegment: - 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: Concerned road segment on which the observation has been made - x-ngsi: - model: https://schema.org/URL - 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 - type: - description: NGSI Entity type. It has to be CrowdFlowObserved - enum: - - CrowdFlowObserved - type: string - x-ngsi: - type: Property - required: - - id - - type - - dateObserved - 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.Transportation/blob/master/CrowdFlowObserved/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 -``` -
- - - - - ## Exemples de charges utiles - #### CrowdFlowObserved NGSI-v2 key-values Exemple - Voici un exemple de CrowdFlowObserved au format JSON-LD sous forme de valeurs-clés. Ceci est compatible avec NGSI-v2 lorsque l'on utilise `options=keyValues` et renvoie les données de contexte d'une entité individuelle. -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + Entité : CrowdFlowObserved +========================== + + [Licence ouverte] (https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) + [document généré automatiquement] (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) + + + Description globale : **CrowdFlowObserved** + version : 0.0.2 + + + + ## Liste des propriétés + + [*] S'il n'y a pas de type dans un attribut, c'est parce qu'il peut avoir plusieurs types ou différents formats/modèles. +- `address[object]`: L'adresse postale . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Le pays. Par exemple, l'Espagne . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La localité dans laquelle se trouve l'adresse postale et qui se trouve dans la région . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La région dans laquelle se trouve la localité et qui se trouve dans le pays . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un district est un type de division administrative qui, dans certains pays, est géré par le gouvernement local. + - `postOfficeBoxNumber[string]`: Le numéro de la boîte postale pour les adresses de boîtes postales. Par exemple, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Le code postal. Par exemple, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: L'adresse de la rue . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Numéro identifiant une propriété spécifique sur une voie publique +- `alternateName[string]`: Un nom alternatif pour ce poste - `areaServed[string]`: La zone géographique où un service ou un article est offert . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: Vitesse moyenne de la foule transitant pendant la période d'observation . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: Durée moyenne du trajet. Le temps d'attente est le temps + écoulé entre deux personnes consécutives . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: Indique s'il y a eu une congestion de la foule au cours de la période d'observation dans le couloir en question. L'absence de cet attribut signifie qu'il n'y a pas eu d'encombrement. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: Une séquence de caractères identifiant le fournisseur de l'entité de données harmonisées - `dateCreated[date-time]`: Horodatage de la création de l'entité. Celle-ci est généralement attribuée par la plate-forme de stockage - `dateModified[date-time]`: Date de la dernière modification de l'entité. Cette date est généralement attribuée par la plate-forme de stockage - `dateObserved[string]`: La date et l'heure de cette observation au format ISO8601 UTC. Elle peut être représentée par un instant spécifique ou par un intervalle ISO8601. Pour pallier le manque de support du Context Broker d'Orion pour les intervalles de temps, il est possible d'utiliser deux attributs distincts : `dateObservedFrom`, `dateObservedTo`. . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: Date et heure de début de la période d'observation. Voir `dateObserved` . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Date et heure de fin de la période d'observation. Voir `dateObserved`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: Une description de l'article - `direction[string]`: Sens habituel du déplacement dans la voie piétonne visée par cette observation par rapport au centre ville. Enum : "entrant, sortant . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Identifiant unique de l'entité - `location[*]`: Référence Geojson à l'élément. Il peut s'agir d'un point, d'une chaîne de ligne, d'un polygone, d'un point multiple, d'une chaîne de ligne multiple ou d'un polygone multiple. - `name[string]`: Le nom de cet élément - `occupancy[number]`: Fraction du temps d'observation pendant laquelle une personne a occupé le passage observé . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: Une liste contenant une séquence de caractères encodés JSON référençant les identifiants uniques du ou des propriétaires. - `peopleCount[number]`: Nombre total de personnes détectées au cours de cette observation - `refRoadSegment[*]`: Segment de route concerné sur lequel l'observation a été faite . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: liste d'uri pointant vers des ressources supplémentaires concernant l'élément - `source[string]`: Séquence de caractères indiquant la source originale des données de l'entité sous forme d'URL. Il est recommandé d'utiliser le nom de domaine complet du fournisseur de la source ou l'URL de l'objet source. - `type[string]`: Type d'entité NGSI. Il doit s'agir de CrowdFlowObserved + + Propriétés requises +- `dateObserved` - `id` - `type` + + Une observation liée au mouvement des personnes à un certain endroit et à un certain moment. + + + ## Modèle de données description des propriétés + Classés par ordre alphabétique (cliquez pour plus de détails) + + +
full yaml details + ```yaml +CrowdFlowObserved: + description: CrowdFlowObserved + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageCrowdSpeed: + description: Average speed of the crowd transiting during the observation period + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Kilometer per hour (Km/h). + averageHeadwayTime: + description: |- + Average headway time. Headway time is the time + elapsed between two consecutive persons + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: second (s) + congested: + description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion + type: boolean + x-ngsi: + model: https://schema.org/Boolean + 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 + dateObserved: + description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + dateObservedFrom: + description: Observation period start date and time. See `dateObserved` + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + dateObservedTo: + description: Observation period end date and time. See `dateObserved`. + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + direction: + description: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' + enum: + - inbound + - outbound + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + occupancy: + description: Fraction of the observation time where a person has been occupying the observed walkway + maximum: 1 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number) + 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: Relationship + type: array + x-ngsi: + type: Property + peopleCount: + description: Total number of people detected during this observation + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountAway: + description: Total number of people detected during this observation away direction + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountTowards: + description: Total number of people detected during this observation towards direction + minimum: 0 + type: number + x-ngsi: + type: Property + refRoadSegment: + 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: Concerned road segment on which the observation has been made + x-ngsi: + model: https://schema.org/URL + 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 + type: + description: NGSI Entity type. It has to be CrowdFlowObserved + enum: + - CrowdFlowObserved + type: string + x-ngsi: + type: Property + required: + - id + - type + - dateObserved + 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) 2025 Contributors to Smart Data Models Program + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json + x-model-tags: '' + x-version: 0.0.3 +``` +
+ + + + + ## Exemples de charges utiles + #### CrowdFlowObserved NGSI-v2 key-values Exemple + Voici un exemple de CrowdFlowObserved au format JSON-LD sous forme de valeurs-clés. Ceci est compatible avec NGSI-v2 lorsque l'on utilise `options=keyValues` et renvoie les données de contexte d'une entité individuelle. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -471,6 +519,8 @@ CrowdFlowObserved: "dateObservedFrom": "2018-08-07T11:10:00Z", "dateObservedTo": "2018-08-07T11:15:00Z", "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "averageHeadwayTime": 5, "congested": false, "direction": "inbound", @@ -493,10 +543,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-v2 normalisé Exemple - Voici un exemple de CrowdFlowObserved au format JSON-LD tel que normalisé. Ce format est compatible avec la NGSI-v2 lorsqu'il n'utilise pas d'options et renvoie les données contextuelles d'une entité individuelle. -
show/hide example +
+ #### CrowdFlowObserved NGSI-v2 normalisé Exemple + Voici un exemple de CrowdFlowObserved au format JSON-LD tel que normalisé. Ce format est compatible avec NGSI-v2 lorsqu'il n'utilise pas d'options et renvoie les données contextuelles d'une entité individuelle. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -517,6 +567,14 @@ CrowdFlowObserved: "type": "Number", "value": 100 }, + "peopleCountTowards": { + "type": "Number", + "value": 50 + }, + "peopleCountAway": { + "type": "Number", + "value": 50 + }, "averageHeadwayTime": { "type": "Number", "value": 5 @@ -551,10 +609,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-LD key-values Exemple - Voici un exemple de CrowdFlowObserved au format JSON-LD sous forme de valeurs-clés. Ceci est compatible avec NGSI-LD lorsque l'on utilise `options=keyValues` et renvoie les données de contexte d'une entité individuelle. -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD key-values Exemple + Voici un exemple de CrowdFlowObserved au format JSON-LD sous forme de valeurs-clés. Ceci est compatible avec NGSI-LD lorsque l'on utilise `options=keyValues` et renvoie les données de contexte d'une entité individuelle. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -583,15 +641,17 @@ CrowdFlowObserved: "type": "LineString" }, "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- #### CrowdFlowObserved NGSI-LD normalisé Exemple - Voici un exemple de CrowdFlowObserved au format JSON-LD tel que normalisé. Ce format est compatible avec NGSI-LD lorsqu'il n'utilise pas d'options et renvoie les données contextuelles d'une entité individuelle. -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD normalisé Exemple + Voici un exemple de CrowdFlowObserved au format JSON-LD tel que normalisé. Ce format est compatible avec NGSI-LD lorsqu'il n'utilise pas d'options et renvoie les données contextuelles d'une entité individuelle. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -653,17 +713,25 @@ CrowdFlowObserved: "type": "Property", "value": 100 }, + "peopleCountTowards": { + "type": "Property", + "value": 50 + }, + "peopleCountAway": { + "type": "Property", + "value": 50 + }, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- - - - Voir [FAQ 10] (https://smartdatamodels.org/index.php/faqs/) pour obtenir une réponse à la question de savoir comment traiter les unités de magnitude. - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + Voir [FAQ 10] (https://smartdatamodels.org/index.php/faqs/) pour obtenir une réponse à la question de savoir comment traiter les unités de magnitude. + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) diff --git a/CrowdFlowObserved/doc/spec_IT.md b/CrowdFlowObserved/doc/spec_IT.md index 6f106518b..1f6c23c0c 100644 --- a/CrowdFlowObserved/doc/spec_IT.md +++ b/CrowdFlowObserved/doc/spec_IT.md @@ -1,468 +1,516 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entità: CrowdFlowObserved -========================= - - [Licenza aperta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/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: **Flusso di folla osservato** - versione: 0.0.2 - - - ## 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 - `areaServed[string]`: L'area geografica in cui viene fornito il servizio o l'articolo offerto. . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: Velocità media della folla in transito durante il periodo di osservazione . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: Tempo medio di percorrenza. Il tempo di percorrenza è il tempo - tra due persone consecutive . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: Indica se durante il periodo di osservazione si è verificata una congestione di folla nel passaggio pedonale in questione. L'assenza di questo attributo significa che non c'è stata congestione di folla. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzati - `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 - `dateObserved[string]`: La data e l'ora di questa osservazione nel formato ISO8601 UTC. Può essere rappresentata da un istante temporale specifico o da un intervallo ISO8601. Come soluzione per la mancanza di supporto di Orion Context Broker per gli intervalli di tempo, si possono usare due attributi separati: `dateObservedFrom`, `dateObservedTo`. . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: Data e ora di inizio del periodo di osservazione. Vedere `dataOsservata`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Data e ora di fine del periodo di osservazione. Vedere `dataOsservata`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: Descrizione dell'articolo - `direction[string]`: Direzione di marcia abituale del passaggio pedonale a cui si riferisce l'osservazione rispetto al centro città. Enum:'in entrata, in uscita' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Identificatore univoco dell'entità - `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 - `occupancy[number]`: Frazione del tempo di osservazione in cui una persona ha occupato il passaggio pedonale osservato . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `peopleCount[number]`: Numero totale di persone rilevate durante l'osservazione - `refRoadSegment[*]`: Segmento stradale interessato su cui è stata effettuata l'osservazione . Model: [https://schema.org/URL](https://schema.org/URL) - `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. - `type[string]`: Tipo di entità NGSI. Deve essere CrowdFlowObserved - - Proprietà richieste -- `dateObserved` - `id` - `type` - - Un'osservazione relativa al movimento delle persone in un determinato luogo e momento. - - - ## Modello di dati descrizione delle proprietà - Ordinati in ordine alfabetico (clicca per i dettagli) - - -
full yaml details - ```yaml -CrowdFlowObserved: - description: CrowdFlowObserved - 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 - areaServed: - description: The geographic area where a service or offered item is provided - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - averageCrowdSpeed: - description: Average speed of the crowd transiting during the observation period - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Kilometer per hour (Km/h). - averageHeadwayTime: - description: |- - Average headway time. Headway time is the time - elapsed between two consecutive persons - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: second (s) - congested: - description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion - type: boolean - x-ngsi: - model: https://schema.org/Boolean - 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 - dateObserved: - description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - dateObservedFrom: - description: Observation period start date and time. See `dateObserved` - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - dateObservedTo: - description: Observation period end date and time. See `dateObserved`. - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - direction: - description: 'Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:''inbound, outbound''' - enum: - - inbound - - outbound - type: string - x-ngsi: - model: https://schema.org/Text - 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 - 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 - occupancy: - description: Fraction of the observation time where a person has been occupying the observed walkway - maximum: 1 - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number) - 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 - peopleCount: - description: Total number of people detected during this observation - minimum: 0 - type: number - x-ngsi: - type: Property - refRoadSegment: - 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: Concerned road segment on which the observation has been made - x-ngsi: - model: https://schema.org/URL - 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 - type: - description: NGSI Entity type. It has to be CrowdFlowObserved - enum: - - CrowdFlowObserved - type: string - x-ngsi: - type: Property - required: - - id - - type - - dateObserved - 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.Transportation/blob/master/CrowdFlowObserved/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 -``` -
- - - - - ## Esempi di payload - #### Esempio di valori chiave NGSI-v2 osservati da CrowdFlow - Ecco un esempio di CrowdFlowObserved 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à: CrowdFlowObserved +========================= + + [Licenza aperta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/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: **Flusso di folla osservato** + versione: 0.0.2 + + + + ## 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) + - `streetNr[string]`: Numero che identifica una proprietà specifica su una strada pubblica +- `alternateName[string]`: Un nome alternativo per questa voce - `areaServed[string]`: L'area geografica in cui viene fornito il servizio o l'articolo offerto. . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: Velocità media della folla in transito durante il periodo di osservazione . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: Tempo medio di percorrenza. Il tempo di percorrenza è il tempo + tra due persone consecutive . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: Indica se durante il periodo di osservazione si è verificata una congestione di folla nel passaggio pedonale in questione. L'assenza di questo attributo significa che non c'è stata congestione di folla. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzati - `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 - `dateObserved[string]`: La data e l'ora di questa osservazione nel formato ISO8601 UTC. Può essere rappresentata da un istante temporale specifico o da un intervallo ISO8601. Come soluzione per la mancanza di supporto di Orion Context Broker per gli intervalli di tempo, si possono usare due attributi separati: `dateObservedFrom`, `dateObservedTo`. . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: Data e ora di inizio del periodo di osservazione. Vedere `dataOsservata`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Data e ora di fine del periodo di osservazione. Vedere `dataOsservata`. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: Descrizione dell'articolo - `direction[string]`: Direzione di marcia abituale del passaggio pedonale a cui si riferisce l'osservazione rispetto al centro città. Enum:'in entrata, in uscita' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Identificatore univoco dell'entità - `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 - `occupancy[number]`: Frazione del tempo di osservazione in cui una persona ha occupato il passaggio pedonale osservato . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `peopleCount[number]`: Numero totale di persone rilevate durante l'osservazione - `refRoadSegment[*]`: Segmento stradale interessato su cui è stata effettuata l'osservazione . Model: [https://schema.org/URL](https://schema.org/URL) - `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. - `type[string]`: Tipo di entità NGSI. Deve essere CrowdFlowObserved + + Proprietà richieste +- `dateObserved` - `id` - `type` + + Un'osservazione relativa al movimento delle persone in un determinato luogo e momento. + + + ## Modello di dati descrizione delle proprietà + Ordinati in ordine alfabetico (clicca per i dettagli) + + +
full yaml details + ```yaml +CrowdFlowObserved: + description: CrowdFlowObserved + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageCrowdSpeed: + description: Average speed of the crowd transiting during the observation period + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Kilometer per hour (Km/h). + averageHeadwayTime: + description: |- + Average headway time. Headway time is the time + elapsed between two consecutive persons + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: second (s) + congested: + description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion + type: boolean + x-ngsi: + model: https://schema.org/Boolean + 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 + dateObserved: + description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + dateObservedFrom: + description: Observation period start date and time. See `dateObserved` + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + dateObservedTo: + description: Observation period end date and time. See `dateObserved`. + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + direction: + description: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' + enum: + - inbound + - outbound + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + occupancy: + description: Fraction of the observation time where a person has been occupying the observed walkway + maximum: 1 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number) + 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: Relationship + type: array + x-ngsi: + type: Property + peopleCount: + description: Total number of people detected during this observation + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountAway: + description: Total number of people detected during this observation away direction + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountTowards: + description: Total number of people detected during this observation towards direction + minimum: 0 + type: number + x-ngsi: + type: Property + refRoadSegment: + 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: Concerned road segment on which the observation has been made + x-ngsi: + model: https://schema.org/URL + 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 + type: + description: NGSI Entity type. It has to be CrowdFlowObserved + enum: + - CrowdFlowObserved + type: string + x-ngsi: + type: Property + required: + - id + - type + - dateObserved + 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) 2025 Contributors to Smart Data Models Program + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json + x-model-tags: '' + x-version: 0.0.3 +``` +
+ + + + + ## Esempi di payload + #### Esempio di valori chiave NGSI-v2 osservati da CrowdFlow + Ecco un esempio di CrowdFlowObserved 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": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -471,6 +519,8 @@ CrowdFlowObserved: "dateObservedFrom": "2018-08-07T11:10:00Z", "dateObservedTo": "2018-08-07T11:15:00Z", "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "averageHeadwayTime": 5, "congested": false, "direction": "inbound", @@ -493,10 +543,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-v2 normalizzato Esempio - Ecco un esempio di CrowdFlowObserved in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano opzioni e restituisce i dati di contesto di una singola entità. -
show/hide example +
+ #### CrowdFlowObserved NGSI-v2 normalizzato Esempio + Ecco un esempio di CrowdFlowObserved in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano opzioni e restituisce i dati di contesto di una singola entità. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -517,6 +567,14 @@ CrowdFlowObserved: "type": "Number", "value": 100 }, + "peopleCountTowards": { + "type": "Number", + "value": 50 + }, + "peopleCountAway": { + "type": "Number", + "value": 50 + }, "averageHeadwayTime": { "type": "Number", "value": 5 @@ -551,10 +609,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-LD valori chiave Esempio - Ecco un esempio di CrowdFlowObserved 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 +
+ #### CrowdFlowObserved NGSI-LD valori chiave Esempio + Ecco un esempio di CrowdFlowObserved 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:CrowdFlowObserved:Valladolid_1", @@ -583,15 +641,17 @@ CrowdFlowObserved: "type": "LineString" }, "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- #### CrowdFlowOsservato NGSI-LD normalizzato Esempio - Ecco un esempio di CrowdFlowObserved 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 +
+ #### CrowdFlowOsservato NGSI-LD normalizzato Esempio + Ecco un esempio di CrowdFlowObserved 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:CrowdFlowObserved:Valladolid_1", @@ -653,17 +713,25 @@ CrowdFlowObserved: "type": "Property", "value": 100 }, + "peopleCountTowards": { + "type": "Property", + "value": 50 + }, + "peopleCountAway": { + "type": "Property", + "value": 50 + }, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/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) diff --git a/CrowdFlowObserved/doc/spec_JA.md b/CrowdFlowObserved/doc/spec_JA.md index 1b808cc19..fdca92eba 100644 --- a/CrowdFlowObserved/doc/spec_JA.md +++ b/CrowdFlowObserved/doc/spec_JA.md @@ -1,468 +1,516 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - エンティティCrowdFlowObserved -======================= - - [オープン・ライセンス](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) - [文書は自動的に生成される](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) - - - グローバルな説明CrowdFlowObserved**（クラウドフロー観察済み）**。 - バージョン: 0.0.2 - - - ## プロパティのリスト - [*] 属性に型がない場合は、複数の型があるか、異なるフォーマット/パターンがある可能性があるためです。 -- `address[object]`: 郵送先住所 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国。例えば、スペイン . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 番地がある地域と、その地域に含まれる地域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: その地域がある地域、またその国がある地域 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: 地区とは行政区画の一種で、国によっては地方自治体によって管理されている。 - - `postOfficeBoxNumber[string]`: 私書箱の住所のための私書箱番号。例：03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: 郵便番号。例：24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: 番地 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: この項目の別名 - `areaServed[string]`: サービスまたは提供品が提供される地理的地域 . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: 観測期間中に通過する群衆の平均速度 . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: 平均ヘッドウェイ時間。ヘッドウェイタイムとは - 連続する2人の間の経過時間 . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: 参照された歩道において、観察期間中に混雑があったかどうかを示すフラグ。この属性がない場合は、混雑がなかったことを意味する。 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: ハーモナイズされたデータ・エンティティの提供者を識別する一連の文字。 - `dateCreated[date-time]`: エンティティの作成タイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられます。 - `dateModified[date-time]`: エンティティの最終変更のタイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられる。 - `dateObserved[string]`: ISO8601 UTCフォーマットでの観測日時。特定の時間インスタンスまたはISO8601インターバルで表すことができます。Orion Context Broker が datetime interval をサポートしていない場合の回避策として、2つの属性を使用することができます：dateObservedFrom`、`dateObservedTo`。 . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: 観測期間の開始日時。dateObserved`を参照。 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: 観測期間終了日時。dateObserved`を参照。 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: この商品の説明 - `direction[string]`: このオブザベーションで参照される歩道における、市街地を基準とした通常の進行方向。列挙:'インバウンド、アウトバウンド' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: エンティティの一意識別子 - `location[*]`: アイテムへの Geojson 参照。Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon のいずれか。 - `name[string]`: このアイテムの名前 - `occupancy[number]`: 人が観察された通路を占有していた観察時間の割合 . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: 所有者の固有IDを参照するJSONエンコードされた文字列を含むリスト。 - `peopleCount[number]`: この観測中に検出された人の総数 - `refRoadSegment[*]`: 観測が行われた道路区間 . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: アイテムに関する追加リソースを指すURIのリスト - `source[string]`: エンティティ・データの元のソースを URL として示す一連の文字。ソース・プロバイダの完全修飾ドメイン名、またはソース・オブジェクトの URL を推奨する。 - `type[string]`: NGSIエンティティタイプ。CrowdFlowObserved でなければならない。 - - 必須プロパティ -- `dateObserved` - `id` - `type` - - ある場所と時間における人々の動きに関する観察。 - - - ## プロパティのデータモデル記述 - アルファベット順（クリックで詳細表示） - - -
full yaml details - ```yaml -CrowdFlowObserved: - description: CrowdFlowObserved - 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 - areaServed: - description: The geographic area where a service or offered item is provided - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - averageCrowdSpeed: - description: Average speed of the crowd transiting during the observation period - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Kilometer per hour (Km/h). - averageHeadwayTime: - description: |- - Average headway time. Headway time is the time - elapsed between two consecutive persons - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: second (s) - congested: - description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion - type: boolean - x-ngsi: - model: https://schema.org/Boolean - 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 - dateObserved: - description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - dateObservedFrom: - description: Observation period start date and time. See `dateObserved` - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - dateObservedTo: - description: Observation period end date and time. See `dateObserved`. - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - direction: - description: 'Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:''inbound, outbound''' - enum: - - inbound - - outbound - type: string - x-ngsi: - model: https://schema.org/Text - 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 - 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 - occupancy: - description: Fraction of the observation time where a person has been occupying the observed walkway - maximum: 1 - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number) - 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 - peopleCount: - description: Total number of people detected during this observation - minimum: 0 - type: number - x-ngsi: - type: Property - refRoadSegment: - 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: Concerned road segment on which the observation has been made - x-ngsi: - model: https://schema.org/URL - 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 - type: - description: NGSI Entity type. It has to be CrowdFlowObserved - enum: - - CrowdFlowObserved - type: string - x-ngsi: - type: Property - required: - - id - - type - - dateObserved - 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.Transportation/blob/master/CrowdFlowObserved/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 -``` -
- - - - - ## ペイロードの例 - #### CrowdFlowObserved NGSI-v2 キー値の例 - 以下は CrowdFlowObserved を JSON-LD フォーマットの key-values で表した例です。これは NGSI-v2 と互換性があり、`options=keyValues` を使用すると個々のエンティティのコンテキストデータを返す。 -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + エンティティCrowdFlowObserved +======================= + + [オープン・ライセンス](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) + [文書が自動的に生成される](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) + + + グローバルな説明CrowdFlowObserved**（クラウドフロー観察済み）**。 + バージョン: 0.0.2 + + + + ## プロパティのリスト + + [*] 属性に型がない場合は、複数の型があるか、異なるフォーマット/パターンがある可能性があるためです。 +- `address[object]`: 郵送先住所 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国。例えば、スペイン . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 番地がある地域と、その地域に含まれる地域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: その地域がある地域、またその国がある地域 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 地区とは行政区画の一種で、国によっては地方自治体によって管理されている。 + - `postOfficeBoxNumber[string]`: 私書箱の住所のための私書箱番号。例：03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 郵便番号。例：24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 番地 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 公道上の特定の物件を特定する番号 +- `alternateName[string]`: この項目の別名 - `areaServed[string]`: サービスまたは提供品が提供される地理的地域 . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: 観測期間中に通過する群衆の平均速度 . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: 平均ヘッドウェイ時間。ヘッドウェイタイムとは + 連続する2人の間の経過時間 . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: 参照された歩道において、観察期間中に混雑があったかどうかを示すフラグ。この属性がない場合は、混雑がなかったことを意味する。 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: ハーモナイズされたデータ・エンティティの提供者を識別する一連の文字。 - `dateCreated[date-time]`: エンティティの作成タイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられます。 - `dateModified[date-time]`: エンティティの最終変更のタイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられる。 - `dateObserved[string]`: ISO8601 UTCフォーマットでの観測日時。特定の時間インスタンスまたはISO8601インターバルで表すことができます。Orion Context Broker が datetime interval をサポートしていない場合の回避策として、2つの属性を使用することができます：dateObservedFrom`、`dateObservedTo`。 . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: 観測期間の開始日時。dateObserved`を参照。 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: 観測期間終了日時。dateObserved`を参照。 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: この商品の説明 - `direction[string]`: このオブザベーションで参照される歩道における、市街地を基準とした通常の進行方向。列挙:'インバウンド、アウトバウンド' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: エンティティの一意識別子 - `location[*]`: アイテムへの Geojson 参照。Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon のいずれか。 - `name[string]`: このアイテムの名前 - `occupancy[number]`: 人が観察された通路を占有していた観察時間の割合 . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: 所有者の固有IDを参照するJSONエンコードされた文字列を含むリスト。 - `peopleCount[number]`: この観測中に検出された人の総数 - `refRoadSegment[*]`: 観測が行われた道路区間 . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: アイテムに関する追加リソースを指すURIのリスト - `source[string]`: エンティティ・データの元のソースを URL として示す一連の文字。ソース・プロバイダの完全修飾ドメイン名、またはソース・オブジェクトの URL を推奨する。 - `type[string]`: NGSIエンティティタイプ。CrowdFlowObserved でなければならない。 + + 必須プロパティ +- `dateObserved` - `id` - `type` + + ある場所と時間における人々の動きに関する観察。 + + + ## プロパティのデータモデル記述 + アルファベット順（クリックで詳細表示） + + +
full yaml details + ```yaml +CrowdFlowObserved: + description: CrowdFlowObserved + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageCrowdSpeed: + description: Average speed of the crowd transiting during the observation period + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Kilometer per hour (Km/h). + averageHeadwayTime: + description: |- + Average headway time. Headway time is the time + elapsed between two consecutive persons + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: second (s) + congested: + description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion + type: boolean + x-ngsi: + model: https://schema.org/Boolean + 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 + dateObserved: + description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + dateObservedFrom: + description: Observation period start date and time. See `dateObserved` + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + dateObservedTo: + description: Observation period end date and time. See `dateObserved`. + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + direction: + description: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' + enum: + - inbound + - outbound + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + occupancy: + description: Fraction of the observation time where a person has been occupying the observed walkway + maximum: 1 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number) + 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: Relationship + type: array + x-ngsi: + type: Property + peopleCount: + description: Total number of people detected during this observation + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountAway: + description: Total number of people detected during this observation away direction + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountTowards: + description: Total number of people detected during this observation towards direction + minimum: 0 + type: number + x-ngsi: + type: Property + refRoadSegment: + 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: Concerned road segment on which the observation has been made + x-ngsi: + model: https://schema.org/URL + 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 + type: + description: NGSI Entity type. It has to be CrowdFlowObserved + enum: + - CrowdFlowObserved + type: string + x-ngsi: + type: Property + required: + - id + - type + - dateObserved + 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) 2025 Contributors to Smart Data Models Program + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json + x-model-tags: '' + x-version: 0.0.3 +``` +
+ + + + + ## ペイロードの例 + #### CrowdFlowObserved NGSI-v2 キー値の例 + 以下は CrowdFlowObserved を JSON-LD フォーマットの key-values で表した例です。これは NGSI-v2 と互換性があり、`options=keyValues` を使用すると個々のエンティティのコンテキストデータを返す。 +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -471,6 +519,8 @@ CrowdFlowObserved: "dateObservedFrom": "2018-08-07T11:10:00Z", "dateObservedTo": "2018-08-07T11:15:00Z", "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "averageHeadwayTime": 5, "congested": false, "direction": "inbound", @@ -493,10 +543,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-v2 正規化例 - 以下は、正規化された JSON-LD 形式の CrowdFlowObserved の例です。これは、オプションを使用しない場合、NGSI-v2 と互換性があり、個々のエンティティのコンテキストデータを返します。 -
show/hide example +
+ #### CrowdFlowObserved NGSI-v2 正規化例 + 以下は、正規化された JSON-LD 形式の CrowdFlowObserved の例です。これは、オプションを使用しない場合、NGSI-v2 と互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -517,6 +567,14 @@ CrowdFlowObserved: "type": "Number", "value": 100 }, + "peopleCountTowards": { + "type": "Number", + "value": 50 + }, + "peopleCountAway": { + "type": "Number", + "value": 50 + }, "averageHeadwayTime": { "type": "Number", "value": 5 @@ -551,10 +609,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-LD キー値の例 - 以下は CrowdFlowObserved を JSON-LD フォーマットの key-values で表した例です。これは NGSI-LD と互換性があり、`options=keyValues` を使用すると、個々のエンティティのコンテキストデータを返します。 -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD キー値の例 + 以下は CrowdFlowObserved を JSON-LD フォーマットの key-values で表した例です。これは NGSI-LD と互換性があり、`options=keyValues` を使用すると、個々のエンティティのコンテキストデータを返します。 +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -583,15 +641,17 @@ CrowdFlowObserved: "type": "LineString" }, "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- #### CrowdFlowObserved NGSI-LD 正規化例 - 以下は、正規化された JSON-LD 形式の CrowdFlowObserved の例です。これは、オプションを使用しない場合、NGSI-LD と互換性があり、個々のエンティティのコンテキストデータを返します。 -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD 正規化例 + 以下は、正規化された JSON-LD 形式の CrowdFlowObserved の例です。これは、オプションを使用しない場合の NGSI-LD と互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -653,17 +713,25 @@ CrowdFlowObserved: "type": "Property", "value": 100 }, + "peopleCountTowards": { + "type": "Property", + "value": 50 + }, + "peopleCountAway": { + "type": "Property", + "value": 50 + }, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- - - - マグニチュード単位の扱い方については、[FAQ 10](https://smartdatamodels.org/index.php/faqs/)を参照のこと。 - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + マグニチュード単位の扱い方については、[FAQ 10](https://smartdatamodels.org/index.php/faqs/)を参照のこと。 + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) diff --git a/CrowdFlowObserved/doc/spec_KO.md b/CrowdFlowObserved/doc/spec_KO.md index d305ef986..505f20ce3 100644 --- a/CrowdFlowObserved/doc/spec_KO.md +++ b/CrowdFlowObserved/doc/spec_KO.md @@ -1,469 +1,516 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - 엔티티: CrowdFlowObserved -====================== - - [오픈 라이선스](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) - [문서 자동 생성](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) - - - 글로벌 설명: **CrowdFlowObserved** - 버전: 0.0.2 - - - ## 속성 목록 - [*] 속성에 유형이 없는 것은 여러 유형 또는 다른 형식/패턴을 가질 수 있기 때문입니다. -- `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 국가. 예를 들어, 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 도로명 주소가 있는 지역 및 해당 지역에 속한 지역 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: 해당 지역이 위치한 지역과 해당 국가의 지역 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: 지구는 일부 국가에서는 지방 정부에서 관리하는 행정 구역의 일종입니다. - - `postOfficeBoxNumber[string]`: 사서함 주소의 우체국 사서함 번호입니다. 예: 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: 우편 번호입니다. 예: 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: 거리 주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) - - `streetNr[string]`: 공공 도로의 특정 건물을 식별하는 번호 -- `alternateName[string]`: 이 항목의 대체 이름 - `areaServed[string]`: 서비스 또는 제공 품목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: 관찰 기간 동안 군중이 이동하는 평균 속도 . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: 평균 진행 시간. 진행 시간은 연속된 두 사람 사이에 - 연속된 두 사람 사이에 경과한 시간 . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: 참조된 산책로에서 관찰 기간 동안 군중 혼잡이 있었는지 여부를 표시합니다. 이 속성이 없으면 군중 혼잡이 없음을 의미합니다. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: 조화된 데이터 엔티티의 공급자를 식별하는 일련의 문자 - `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateModified[date-time]`: 엔티티의 마지막 수정 타임스탬프입니다. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateObserved[string]`: ISO8601 UTC 형식의 관측 날짜 및 시간입니다. 특정 시간 순간 또는 ISO8601 간격으로 나타낼 수 있습니다. 날짜/시간 간격에 대한 Orion 컨텍스트 브로커의 지원 부족에 대한 해결 방법으로, 두 개의 별도 속성을 사용할 수 있습니다: 날짜 관찰된 날짜`, `날짜 관찰된 날짜`. . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: 관찰 기간 시작 날짜 및 시간입니다. 날짜 관찰됨` 참조 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: 관찰 기간 종료 날짜 및 시간. 관찰된 날짜`를 참조하세요. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: 이 항목에 대한 설명 - `direction[string]`: 도심을 기준으로 이 관측치가 참조하는 산책로의 일반적인 이동 방향입니다. Enum:'인바운드, 아웃바운드' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: 엔티티의 고유 식별자 - `location[*]`: 항목에 대한 지오숀 참조입니다. 포인트, 라인 문자열, 다각형, 멀티포인트, 멀티라인 문자열 또는 멀티폴리곤일 수 있습니다. - `name[string]`: 이 항목의 이름 - `occupancy[number]`: 사람이 관찰된 통로를 점유하고 있는 관찰 시간 비율 . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: 소유자의 고유 ID를 참조하는 JSON 인코딩된 문자 시퀀스가 포함된 목록입니다. - `peopleCount[number]`: 이 관찰 기간 동안 감지된 총 인원 수 - `refRoadSegment[*]`: 관측이 이루어진 우려되는 도로 구간 . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: 항목에 대한 추가 리소스를 가리키는 URL 목록 - `source[string]`: 엔티티 데이터의 원본 소스를 URL로 제공하는 문자 시퀀스입니다. 소스 공급자의 정규화된 도메인 이름 또는 소스 개체에 대한 URL을 사용하는 것이 좋습니다. - `type[string]`: NGSI 엔티티 유형. CrowdFlowObserved여야 합니다. - - 필수 속성 -- `dateObserved` - `id` - `type` - - 특정 장소 및 시간에 사람들의 움직임과 관련된 관찰입니다. - - - ## 속성에 대한 데이터 모델 설명 - 알파벳순으로 정렬(자세한 내용을 보려면 클릭) - - -
full yaml details - ```yaml -CrowdFlowObserved: - description: CrowdFlowObserved - 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 - areaServed: - description: The geographic area where a service or offered item is provided - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - averageCrowdSpeed: - description: Average speed of the crowd transiting during the observation period - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Kilometer per hour (Km/h). - averageHeadwayTime: - description: |- - Average headway time. Headway time is the time - elapsed between two consecutive persons - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: second (s) - congested: - description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion - type: boolean - x-ngsi: - model: https://schema.org/Boolean - 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 - dateObserved: - description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - dateObservedFrom: - description: Observation period start date and time. See `dateObserved` - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - dateObservedTo: - description: Observation period end date and time. See `dateObserved`. - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - direction: - description: 'Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:''inbound, outbound''' - enum: - - inbound - - outbound - type: string - x-ngsi: - model: https://schema.org/Text - 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 - 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 - occupancy: - description: Fraction of the observation time where a person has been occupying the observed walkway - maximum: 1 - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number) - 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 - peopleCount: - description: Total number of people detected during this observation - minimum: 0 - type: number - x-ngsi: - type: Property - refRoadSegment: - 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: Concerned road segment on which the observation has been made - x-ngsi: - model: https://schema.org/URL - 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 - type: - description: NGSI Entity type. It has to be CrowdFlowObserved - enum: - - CrowdFlowObserved - type: string - x-ngsi: - type: Property - required: - - id - - type - - dateObserved - 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.Transportation/blob/master/CrowdFlowObserved/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 -``` -
- - - - - ## 페이로드 예시 - #### CrowdFlowObserved NGSI-v2 키-값 예시 - 다음은 키-값으로 JSON-LD 형식의 CrowdFlowObserved의 예입니다. 이는 `옵션=키값`을 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + Entity: CrowdFlowObserved +========================= + + [오픈 라이선스](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) + [문서 자동 생성](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) + + + 글로벌 설명: **크라우드 플로우 관찰됨** + 버전: 0.0.2 + + + + ## 속성 목록 + + [*] 속성에 유형이 없는 것은 여러 유형 또는 다른 형식/패턴을 가질 수 있기 때문입니다. +- `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 국가. 예를 들어, 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 도로명 주소가 있는 지역 및 지역 내 지역 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 해당 지역이 위치한 지역과 해당 국가의 지역 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 지구는 일부 국가에서는 지방 정부에서 관리하는 행정 구역의 일종입니다. + - `postOfficeBoxNumber[string]`: 사서함 주소의 우체국 사서함 번호입니다. 예: 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 우편 번호입니다. 예: 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 거리 주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 공공 도로의 특정 건물을 식별하는 번호 +- `alternateName[string]`: 이 항목의 대체 이름 - `areaServed[string]`: 서비스 또는 제공 품목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: 관찰 기간 동안 군중이 이동하는 평균 속도 . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: 평균 진행 시간. 진행 시간은 두 사람 사이에 + 연속된 두 사람 사이에 경과된 시간 . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: 참조된 통로에서 관찰 기간 동안 군중 혼잡이 있었는지 여부를 표시합니다. 이 속성이 없으면 군중 혼잡이 없음을 의미합니다. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: 조화된 데이터 엔티티의 공급자를 식별하는 일련의 문자 - `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateModified[date-time]`: 엔티티의 마지막 수정 타임스탬프입니다. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateObserved[string]`: 이 관측의 날짜와 시간을 ISO8601 UTC 형식으로 표시합니다. 특정 시간 순간 또는 ISO8601 간격으로 나타낼 수 있습니다. 날짜 시간 간격에 대한 Orion 컨텍스트 브로커의 지원 부족에 대한 해결 방법으로, 두 개의 별도 속성을 사용할 수 있습니다: 날짜 관찰된 날짜`, `날짜 관찰된 날짜`. . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: 관찰 기간 시작 날짜 및 시간입니다. 관찰된 날짜` 참조 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: 관찰 기간 종료 날짜 및 시간입니다. 관찰된 날짜`를 참조하세요. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: 이 항목에 대한 설명 - `direction[string]`: 도심을 기준으로 이 관측이 참조하는 통로의 일반적인 이동 방향입니다. Enum:'인바운드, 아웃바운드' . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: 엔티티의 고유 식별자 - `location[*]`: 항목에 대한 지오숀 참조입니다. 포인트, 라인스트링, 다각형, 멀티포인트, 멀티라인스트링 또는 멀티폴리곤일 수 있습니다. - `name[string]`: 이 항목의 이름 - `occupancy[number]`: 사람이 관찰된 통로를 점유하고 있었던 관찰 시간 비율 . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: 소유자의 고유 ID를 참조하는 JSON 인코딩된 문자 시퀀스가 포함된 목록입니다. - `peopleCount[number]`: 이 관찰 기간 동안 감지된 총 인원 수 - `refRoadSegment[*]`: 관측이 이루어진 우려되는 도로 구간 . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: 항목에 대한 추가 리소스를 가리키는 URL 목록 - `source[string]`: 엔티티 데이터의 원본 소스를 URL로 제공하는 문자 시퀀스입니다. 소스 공급자의 정규화된 도메인 이름 또는 소스 개체에 대한 URL을 사용하는 것이 좋습니다. - `type[string]`: NGSI 엔티티 유형. CrowdFlowObserved여야 합니다. + + 필수 속성 +- `dateObserved` - `id` - `type` + + 특정 장소 및 시간에 사람들의 움직임과 관련된 관찰입니다. + + + ## 속성에 대한 데이터 모델 설명 + 알파벳순으로 정렬(자세한 내용을 보려면 클릭) + + +
full yaml details + ```yaml +CrowdFlowObserved: + description: CrowdFlowObserved + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageCrowdSpeed: + description: Average speed of the crowd transiting during the observation period + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Kilometer per hour (Km/h). + averageHeadwayTime: + description: |- + Average headway time. Headway time is the time + elapsed between two consecutive persons + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: second (s) + congested: + description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion + type: boolean + x-ngsi: + model: https://schema.org/Boolean + 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 + dateObserved: + description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + dateObservedFrom: + description: Observation period start date and time. See `dateObserved` + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + dateObservedTo: + description: Observation period end date and time. See `dateObserved`. + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + direction: + description: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' + enum: + - inbound + - outbound + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + occupancy: + description: Fraction of the observation time where a person has been occupying the observed walkway + maximum: 1 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number) + 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: Relationship + type: array + x-ngsi: + type: Property + peopleCount: + description: Total number of people detected during this observation + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountAway: + description: Total number of people detected during this observation away direction + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountTowards: + description: Total number of people detected during this observation towards direction + minimum: 0 + type: number + x-ngsi: + type: Property + refRoadSegment: + 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: Concerned road segment on which the observation has been made + x-ngsi: + model: https://schema.org/URL + 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 + type: + description: NGSI Entity type. It has to be CrowdFlowObserved + enum: + - CrowdFlowObserved + type: string + x-ngsi: + type: Property + required: + - id + - type + - dateObserved + 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) 2025 Contributors to Smart Data Models Program + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json + x-model-tags: '' + x-version: 0.0.3 +``` +
+ + + + + ## 페이로드 예시 + #### CrowdFlowObserved NGSI-v2 키 값 예시 + 다음은 키 값으로 JSON-LD 형식의 CrowdFlowObserved의 예시입니다. 이것은 `옵션=키값`을 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -472,6 +519,8 @@ CrowdFlowObserved: "dateObservedFrom": "2018-08-07T11:10:00Z", "dateObservedTo": "2018-08-07T11:15:00Z", "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "averageHeadwayTime": 5, "congested": false, "direction": "inbound", @@ -494,10 +543,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-v2 정규화 예제 - 다음은 정규화된 JSON-LD 형식의 CrowdFlowObserved의 예입니다. 이는 옵션을 사용하지 않을 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. -
show/hide example +
+ #### CrowdFlowObserved NGSI-v2 정규화 예제 + 다음은 정규화된 JSON-LD 형식의 CrowdFlowObserved의 예시입니다. 이는 옵션을 사용하지 않을 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -518,6 +567,14 @@ CrowdFlowObserved: "type": "Number", "value": 100 }, + "peopleCountTowards": { + "type": "Number", + "value": 50 + }, + "peopleCountAway": { + "type": "Number", + "value": 50 + }, "averageHeadwayTime": { "type": "Number", "value": 5 @@ -552,10 +609,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-LD 키-값 예시 - 다음은 키-값으로 JSON-LD 형식의 CrowdFlowObserved의 예입니다. 이는 `옵션=키값`을 사용할 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD 키 값 예시 + 다음은 키 값으로 JSON-LD 형식의 CrowdFlowObserved의 예시입니다. 이는 `옵션=키값`을 사용할 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -584,15 +641,17 @@ CrowdFlowObserved: "type": "LineString" }, "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- #### CrowdFlowObserved NGSI-LD 정규화 예제 - 다음은 정규화된 JSON-LD 형식의 CrowdFlowObserved의 예입니다. 이는 옵션을 사용하지 않을 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD 정규화 예제 + 다음은 정규화된 JSON-LD 형식의 CrowdFlowObserved의 예시입니다. 이는 옵션을 사용하지 않을 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -654,17 +713,25 @@ CrowdFlowObserved: "type": "Property", "value": 100 }, + "peopleCountTowards": { + "type": "Property", + "value": 50 + }, + "peopleCountAway": { + "type": "Property", + "value": 50 + }, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- - - - [FAQ 10](https://smartdatamodels.org/index.php/faqs/)을 참조하여 규모 단위를 다루는 방법에 대한 답변을 확인하세요. - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + 규모 단위를 다루는 방법에 대한 답변은 [FAQ 10](https://smartdatamodels.org/index.php/faqs/)을 참조하세요. + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) diff --git a/CrowdFlowObserved/doc/spec_ZH.md b/CrowdFlowObserved/doc/spec_ZH.md index ecbaab6be..1bf4d3464 100644 --- a/CrowdFlowObserved/doc/spec_ZH.md +++ b/CrowdFlowObserved/doc/spec_ZH.md @@ -1,468 +1,516 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - 实体：CrowdFlowObserved -==================== - - [开放许可](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) - [文件自动生成](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) - - - 全局描述：**观察到的人群流量** - 版本： 0.0.2 - - - ## 属性列表 - [*] 如果属性中没有类型，是因为它可能有多个类型或不同的格式/模式。 -- `address[object]`: 邮寄地址 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国家。例如，西班牙 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 街道地址所在的地点，以及该地点所在的区域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: 地点所在的地区，以及该地区位于哪个国家 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: 地区是一种行政区划，在一些国家由地方政府管理 - - `postOfficeBoxNumber[string]`: 用于邮政信箱地址的邮政信箱号码。例如：03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: 邮政编码。例如：24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: 街道地址 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: 该项目的替代名称 - `areaServed[string]`: 提供服务或提供物品的地理区域 . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: 观测期间过境人群的平均速度 . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: 平均航程时间。前行时间是指 - 是指两个连续的人 . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: 标志着在观察期间，所指人行道上是否有人群拥挤现象。没有该属性表示没有人群拥堵 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: 标识统一数据实体提供者的字符序列 - `dateCreated[date-time]`: 实体创建时间戳。通常由存储平台分配 - `dateModified[date-time]`: 实体最后一次修改的时间戳。通常由存储平台分配 - `dateObserved[string]`: 以 ISO8601 UTC 格式表示的观测日期和时间。它可以用一个特定的时间瞬间或一个 ISO8601 时间间隔来表示。由于 Orion Context Broker 不支持日期时间间隔，因此可以使用两个不同的属性：日期观测自 "和 "日期观测至 . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: 观察期开始日期和时间。参见 `dateObserved` 。 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: 观察期结束日期和时间。请参阅 "观察日期"。 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: 项目描述 - `direction[string]`: 该观测点所指人行道相对于市中心的通常行进方向。枚举："入境、出境 . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: 实体的唯一标识符 - `location[*]`: 项目的 Geojson 引用。它可以是点、线条字符串、多边形、多点、多线条字符串或多多边形 - `name[string]`: 该项目的名称 - `occupancy[number]`: 有人占用被观测人行道的观测时间比例 . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: 包含一个 JSON 编码字符序列的列表，其中引用了所有者的唯一 Ids - `peopleCount[number]`: 本次观测中发现的总人数 - `refRoadSegment[*]`: 观测所涉及的路段 . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: 指向有关该项目的其他资源的 uri 列表 - `source[string]`: 以 URL 形式给出实体数据原始来源的字符串。建议使用源提供者的完全合格域名或源对象的 URL - `type[string]`: NGSI 实体类型。必须是 CrowdFlowObserved - - 所需属性 -- `dateObserved` - `id` - `type` - - 与某一地点和时间的人员流动有关的观察。 - - - ## 属性的数据模型描述 - 按字母顺序排列（点击查看详情） - - -
full yaml details - ```yaml -CrowdFlowObserved: - description: CrowdFlowObserved - 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 - areaServed: - description: The geographic area where a service or offered item is provided - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - averageCrowdSpeed: - description: Average speed of the crowd transiting during the observation period - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Kilometer per hour (Km/h). - averageHeadwayTime: - description: |- - Average headway time. Headway time is the time - elapsed between two consecutive persons - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: second (s) - congested: - description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion - type: boolean - x-ngsi: - model: https://schema.org/Boolean - 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 - dateObserved: - description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - dateObservedFrom: - description: Observation period start date and time. See `dateObserved` - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - dateObservedTo: - description: Observation period end date and time. See `dateObserved`. - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - direction: - description: 'Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:''inbound, outbound''' - enum: - - inbound - - outbound - type: string - x-ngsi: - model: https://schema.org/Text - 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 - 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 - occupancy: - description: Fraction of the observation time where a person has been occupying the observed walkway - maximum: 1 - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number) - 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 - peopleCount: - description: Total number of people detected during this observation - minimum: 0 - type: number - x-ngsi: - type: Property - refRoadSegment: - 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: Concerned road segment on which the observation has been made - x-ngsi: - model: https://schema.org/URL - 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 - type: - description: NGSI Entity type. It has to be CrowdFlowObserved - enum: - - CrowdFlowObserved - type: string - x-ngsi: - type: Property - required: - - id - - type - - dateObserved - 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.Transportation/blob/master/CrowdFlowObserved/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 -``` -
- - - - - ## 有效载荷示例 - #### CrowdFlowObserved NGSI-v2 key-values 示例 - 下面是一个以 JSON-LD 格式作为键值的 CrowdFlowObserved 示例。当使用 `options=keyValues` 时，它与 NGSI-v2 兼容，并返回单个实体的上下文数据。 -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + 实体：CrowdFlowObserved +==================== + + [开放许可](https://github.com/smart-data-models//dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md) + [文件自动生成](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) + + + 全局描述：**观察到的人群流量** + 版本： 0.0.2 + + + + ## 属性列表 + + [*] 如果属性中没有类型，是因为它可能有多个类型或不同的格式/模式。 +- `address[object]`: 邮寄地址 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国家。例如，西班牙 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 街道地址所在的地点，以及该地点所在的区域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 地点所在的地区，以及该地区位于哪个国家 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 地区是一种行政区划，在一些国家由地方政府管理 + - `postOfficeBoxNumber[string]`: 用于邮政信箱地址的邮政信箱号码。例如：03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 邮政编码。例如：24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 街道地址 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 标识公共街道上特定房产的编号 +- `alternateName[string]`: 该项目的替代名称 - `areaServed[string]`: 提供服务或提供物品的地理区域 . Model: [https://schema.org/Text](https://schema.org/Text) - `averageCrowdSpeed[number]`: 观测期间过境人群的平均速度 . Model: [https://schema.org/Number](https://schema.org/Number) - `averageHeadwayTime[number]`: 平均航程时间。前行时间是指 + 是指两个连续的人 . Model: [https://schema.org/Number](https://schema.org/Number) - `congested[boolean]`: 标志着在观察期间，所指人行道上是否有人群拥挤现象。没有该属性表示没有人群拥堵 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `dataProvider[string]`: 标识统一数据实体提供者的字符序列 - `dateCreated[date-time]`: 实体创建时间戳。通常由存储平台分配 - `dateModified[date-time]`: 实体最后一次修改的时间戳。通常由存储平台分配 - `dateObserved[string]`: 以 ISO8601 UTC 格式表示的观测日期和时间。它可以用一个特定的时间瞬间或一个 ISO8601 时间间隔来表示。由于 Orion Context Broker 不支持日期时间间隔，因此可以使用两个不同的属性：日期观测自 "和 "日期观测至 . Model: [https://schema.org/URL](https://schema.org/URL) - `dateObservedFrom[date-time]`: 观察期开始日期和时间。参见 `dateObserved` 。 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: 观察期结束日期和时间。请参阅 "观察日期"。 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: 项目描述 - `direction[string]`: 该观测点所指人行道相对于市中心的通常行进方向。枚举："入境、出境 . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: 实体的唯一标识符 - `location[*]`: 项目的 Geojson 引用。它可以是点、线条字符串、多边形、多点、多线条字符串或多多边形 - `name[string]`: 该项目的名称 - `occupancy[number]`: 有人占用被观测人行道的观测时间比例 . Model: [https://schema.org/Number)](https://schema.org/Number)) - `owner[array]`: 包含一个 JSON 编码字符序列的列表，其中引用了所有者的唯一标识 - `peopleCount[number]`: 本次观测中发现的总人数 - `refRoadSegment[*]`: 观测所涉及的路段 . Model: [https://schema.org/URL](https://schema.org/URL) - `seeAlso[*]`: 指向有关该项目的其他资源的 uri 列表 - `source[string]`: 以 URL 形式给出实体数据原始来源的字符串。建议使用源提供者的完全合格域名或源对象的 URL - `type[string]`: NGSI 实体类型。必须是 CrowdFlowObserved + + 所需属性 +- `dateObserved` - `id` - `type` + + 与某一地点和时间的人员流动有关的观察。 + + + ## 属性的数据模型描述 + 按字母顺序排列（点击查看详情） + + +
full yaml details + ```yaml +CrowdFlowObserved: + description: CrowdFlowObserved + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageCrowdSpeed: + description: Average speed of the crowd transiting during the observation period + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Kilometer per hour (Km/h). + averageHeadwayTime: + description: |- + Average headway time. Headway time is the time + elapsed between two consecutive persons + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: second (s) + congested: + description: Flags whether there was a crowd congestion during the observation period in the referred walkway. The absence of this attribute means no crowd congestion + type: boolean + x-ngsi: + model: https://schema.org/Boolean + 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 + dateObserved: + description: 'The date and time of this observation in ISO8601 UTC format. It can be represented by an specific time instant or by an ISO8601 interval. As a workaround for the lack of support of Orion Context Broker for datetime intervals, it can be used two separate attributes: `dateObservedFrom`, `dateObservedTo`' + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + dateObservedFrom: + description: Observation period start date and time. See `dateObserved` + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + dateObservedTo: + description: Observation period end date and time. See `dateObserved`. + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + direction: + description: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' + enum: + - inbound + - outbound + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + occupancy: + description: Fraction of the observation time where a person has been occupying the observed walkway + maximum: 1 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number) + 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: Relationship + type: array + x-ngsi: + type: Property + peopleCount: + description: Total number of people detected during this observation + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountAway: + description: Total number of people detected during this observation away direction + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountTowards: + description: Total number of people detected during this observation towards direction + minimum: 0 + type: number + x-ngsi: + type: Property + refRoadSegment: + 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: Concerned road segment on which the observation has been made + x-ngsi: + model: https://schema.org/URL + 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 + type: + description: NGSI Entity type. It has to be CrowdFlowObserved + enum: + - CrowdFlowObserved + type: string + x-ngsi: + type: Property + required: + - id + - type + - dateObserved + 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) 2025 Contributors to Smart Data Models Program + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json + x-model-tags: '' + x-version: 0.0.3 +``` +
+ + + + + ## 有效载荷示例 + #### CrowdFlowObserved NGSI-v2 key-values 示例 + 下面是一个以 JSON-LD 格式作为键值的 CrowdFlowObserved 示例。当使用 `options=keyValues` 时，它与 NGSI-v2 兼容，并返回单个实体的上下文数据。 +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -471,6 +519,8 @@ CrowdFlowObserved: "dateObservedFrom": "2018-08-07T11:10:00Z", "dateObservedTo": "2018-08-07T11:15:00Z", "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "averageHeadwayTime": 5, "congested": false, "direction": "inbound", @@ -493,10 +543,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-v2 归一化示例 - 下面是一个 CrowdFlowObserved 的示例，格式为规范化的 JSON-LD。当不使用选项时，它与 NGSI-v2 兼容，并返回单个实体的上下文数据。 -
show/hide example +
+ #### CrowdFlowObserved NGSI-v2 归一化示例 + 下面是一个 CrowdFlowObserved 的示例，格式为规范化的 JSON-LD。当不使用选项时，它与 NGSI-v2 兼容，并返回单个实体的上下文数据。 +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -517,6 +567,14 @@ CrowdFlowObserved: "type": "Number", "value": 100 }, + "peopleCountTowards": { + "type": "Number", + "value": 50 + }, + "peopleCountAway": { + "type": "Number", + "value": 50 + }, "averageHeadwayTime": { "type": "Number", "value": 5 @@ -551,10 +609,10 @@ CrowdFlowObserved: } } ``` -
- #### CrowdFlowObserved NGSI-LD key-values 示例 - 下面是一个以 JSON-LD 格式作为键值的 CrowdFlowObserved 示例。当使用 `options=keyValues` 时，它与 NGSI-LD 兼容，并返回单个实体的上下文数据。 -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD key-values 示例 + 下面是一个以 JSON-LD 格式作为键值的 CrowdFlowObserved 示例。当使用 `options=keyValues` 时，它与 NGSI-LD 兼容，并返回单个实体的上下文数据。 +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -583,15 +641,17 @@ CrowdFlowObserved: "type": "LineString" }, "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- #### CrowdFlowObserved NGSI-LD normalized 示例 - 下面是一个 CrowdFlowObserved 的示例，格式为规范化的 JSON-LD。在不使用选项时，它与 NGSI-LD 兼容，并返回单个实体的上下文数据。 -
show/hide example +
+ #### CrowdFlowObserved NGSI-LD normalized 示例 + 下面是一个 CrowdFlowObserved 的示例，格式为规范化的 JSON-LD。在不使用选项时，它与 NGSI-LD 兼容，并返回单个实体的上下文数据。 +
show/hide example ```json { "id": "urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", @@ -653,17 +713,25 @@ CrowdFlowObserved: "type": "Property", "value": 100 }, + "peopleCountTowards": { + "type": "Property", + "value": 50 + }, + "peopleCountAway": { + "type": "Property", + "value": 50 + }, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] } ``` -
- - - - 请参阅 [FAQ 10](https://smartdatamodels.org/index.php/faqs/)，获取如何处理幅度单位的答案。 - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + 请参阅 [FAQ 10](https://smartdatamodels.org/index.php/faqs/)，获取如何处理幅度单位的答案。 + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) diff --git a/CrowdFlowObserved/examples/example-normalized.json b/CrowdFlowObserved/examples/example-normalized.json index 51f185699..4fb5c36a4 100644 --- a/CrowdFlowObserved/examples/example-normalized.json +++ b/CrowdFlowObserved/examples/example-normalized.json @@ -17,6 +17,14 @@ "type": "Number", "value": 100 }, + "peopleCountTowards": { + "type": "Number", + "value": 50 + }, + "peopleCountAway": { + "type": "Number", + "value": 50 + }, "averageHeadwayTime": { "type": "Number", "value": 5 @@ -49,4 +57,4 @@ "type": "Boolean", "value": false } -} \ No newline at end of file +} diff --git a/CrowdFlowObserved/examples/example-normalized.json.csv b/CrowdFlowObserved/examples/example-normalized.json.csv index 6d3c95500..59ed06d50 100644 --- a/CrowdFlowObserved/examples/example-normalized.json.csv +++ b/CrowdFlowObserved/examples/example-normalized.json.csv @@ -1,2 +1,2 @@ -"id_", "type_", "dateObserved__type_", "dateObserved__value_", "direction__type_", "direction__value_", "dateObservedFrom__type_", "dateObservedFrom__value_", "peopleCount__type_", "peopleCount__value_", "averageHeadwayTime__type_", "averageHeadwayTime__value_", "dateObservedTo__type_", "dateObservedTo__value_", "location__type_", "location__value__type_", "location__value__coordinates__0__0_", "location__value__coordinates__0__1_", "location__value__coordinates__1__0_", "location__value__coordinates__1__1_", "location__value__coordinates__2__0_", "location__value__coordinates__2__1_", "congested__type_", "congested__value_" -"urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", "CrowdFlowObserved", "DateTime", "2018-08-07T11:10:00", "Text", "inbound", "DateTime", "2018-08-07T11:10:00Z", "Number", "100", "Number", "5", "DateTime", "2018-08-07T11:15:00Z", "geo:json", "LineString", "-4.73735395519672", "41.6538181849672", "-4.73414858659993", "41.6600594193478", "-4.73447575302641", "41.659585195093", "Boolean", "False" \ No newline at end of file +"id_", "type_", "dateObserved__type_", "dateObserved__value_", "direction__type_", "direction__value_", "dateObservedFrom__type_", "dateObservedFrom__value_", "peopleCount__type_", "peopleCount__value_", "peopleCountTowards__type_", "peopleCountTowards__value_", "peopleCountAway__type_", "peopleCountAway__value_", "averageHeadwayTime__type_", "averageHeadwayTime__value_", "dateObservedTo__type_", "dateObservedTo__value_", "location__type_", "location__value__type_", "location__value__coordinates__0__0_", "location__value__coordinates__0__1_", "location__value__coordinates__1__0_", "location__value__coordinates__1__1_", "location__value__coordinates__2__0_", "location__value__coordinates__2__1_", "congested__type_", "congested__value_" +"urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", "CrowdFlowObserved", "DateTime", "2018-08-07T11:10:00", "Text", "inbound", "DateTime", "2018-08-07T11:10:00Z", "Number", "100", "Number", "50", "Number", "50", "Number", "5", "DateTime", "2018-08-07T11:15:00Z", "geo:json", "LineString", "-4.73735395519672", "41.6538181849672", "-4.73414858659993", "41.6600594193478", "-4.73447575302641", "41.659585195093", "Boolean", "False" \ No newline at end of file diff --git a/CrowdFlowObserved/examples/example-normalized.jsonld b/CrowdFlowObserved/examples/example-normalized.jsonld index 82aa40ebb..881ed79f8 100644 --- a/CrowdFlowObserved/examples/example-normalized.jsonld +++ b/CrowdFlowObserved/examples/example-normalized.jsonld @@ -58,6 +58,14 @@ "type": "Property", "value": 100 }, + "peopleCountTowards": { + "type": "Property", + "value": 50 + }, + "peopleCountAway": { + "type": "Property", + "value": 50 + }, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] diff --git a/CrowdFlowObserved/examples/example-normalized.jsonld.csv b/CrowdFlowObserved/examples/example-normalized.jsonld.csv index 4b49ebe8b..c835ea1cc 100644 --- a/CrowdFlowObserved/examples/example-normalized.jsonld.csv +++ b/CrowdFlowObserved/examples/example-normalized.jsonld.csv @@ -1,2 +1,2 @@ -"id_", "type_", "averageHeadwayTime__type_", "averageHeadwayTime__value_", "congested__type_", "congested__value_", "dateObserved__type_", "dateObserved__value__@type_", "dateObserved__value__@value_", "dateObservedFrom__type_", "dateObservedFrom__value__@type_", "dateObservedFrom__value__@value_", "dateObservedTo__type_", "dateObservedTo__value__@type_", "dateObservedTo__value__@value_", "direction__type_", "direction__value_", "location__type_", "location__value__type_", "location__value__coordinates__0__0_", "location__value__coordinates__0__1_", "location__value__coordinates__1__0_", "location__value__coordinates__1__1_", "location__value__coordinates__2__0_", "location__value__coordinates__2__1_", "peopleCount__type_", "peopleCount__value_", "@context__0_" -"urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", "CrowdFlowObserved", "Property", "5", "Property", "False", "Property", "DateTime", "2018-08-07T11:10:00", "Property", "DateTime", "2018-08-07T11:10:00Z", "Property", "DateTime", "2018-08-07T11:15:00Z", "Property", "inbound", "GeoProperty", "LineString", "-4.73735395519672", "41.6538181849672", "-4.73414858659993", "41.6600594193478", "-4.73447575302641", "41.659585195093", "Property", "100", "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" \ No newline at end of file +"id_", "type_", "averageHeadwayTime__type_", "averageHeadwayTime__value_", "congested__type_", "congested__value_", "dateObserved__type_", "dateObserved__value__@type_", "dateObserved__value__@value_", "dateObservedFrom__type_", "dateObservedFrom__value__@type_", "dateObservedFrom__value__@value_", "dateObservedTo__type_", "dateObservedTo__value__@type_", "dateObservedTo__value__@value_", "direction__type_", "direction__value_", "location__type_", "location__value__type_", "location__value__coordinates__0__0_", "location__value__coordinates__0__1_", "location__value__coordinates__1__0_", "location__value__coordinates__1__1_", "location__value__coordinates__2__0_", "location__value__coordinates__2__1_", "peopleCount__type_", "peopleCount__value_", "peopleCountTowards__type_", "peopleCountTowards__value_", "peopleCountAway__type_", "peopleCountAway__value_", "@context__0_" +"urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", "CrowdFlowObserved", "Property", "5", "Property", "False", "Property", "DateTime", "2018-08-07T11:10:00", "Property", "DateTime", "2018-08-07T11:10:00Z", "Property", "DateTime", "2018-08-07T11:15:00Z", "Property", "inbound", "GeoProperty", "LineString", "-4.73735395519672", "41.6538181849672", "-4.73414858659993", "41.6600594193478", "-4.73447575302641", "41.659585195093", "Property", "100", "Property", "50", "Property", "50", "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" \ No newline at end of file diff --git a/CrowdFlowObserved/examples/example.json b/CrowdFlowObserved/examples/example.json index 11a77fc72..214d775c7 100644 --- a/CrowdFlowObserved/examples/example.json +++ b/CrowdFlowObserved/examples/example.json @@ -5,6 +5,8 @@ "dateObservedFrom": "2018-08-07T11:10:00Z", "dateObservedTo": "2018-08-07T11:15:00Z", "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "averageHeadwayTime": 5, "congested": false, "direction": "inbound", @@ -25,4 +27,4 @@ ] ] } -} \ No newline at end of file +} diff --git a/CrowdFlowObserved/examples/example.json.csv b/CrowdFlowObserved/examples/example.json.csv index 0775f1e17..d231a2f8f 100644 --- a/CrowdFlowObserved/examples/example.json.csv +++ b/CrowdFlowObserved/examples/example.json.csv @@ -1,2 +1,2 @@ -"id_", "type_", "dateObserved_", "dateObservedFrom_", "dateObservedTo_", "peopleCount_", "averageHeadwayTime_", "congested_", "direction_", "location__type_", "location__coordinates__0__0_", "location__coordinates__0__1_", "location__coordinates__1__0_", "location__coordinates__1__1_", "location__coordinates__2__0_", "location__coordinates__2__1_" -"urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", "CrowdFlowObserved", "2018-08-07T11:10:00/2018-08-07T11:15:00", "2018-08-07T11:10:00Z", "2018-08-07T11:15:00Z", "100", "5", "False", "inbound", "LineString", "-4.73735395519672", "41.6538181849672", "-4.73414858659993", "41.6600594193478", "-4.73447575302641", "41.659585195093" \ No newline at end of file +"id_", "type_", "dateObserved_", "dateObservedFrom_", "dateObservedTo_", "peopleCount_", "peopleCountTowards_", "peopleCountAway_", "averageHeadwayTime_", "congested_", "direction_", "location__type_", "location__coordinates__0__0_", "location__coordinates__0__1_", "location__coordinates__1__0_", "location__coordinates__1__1_", "location__coordinates__2__0_", "location__coordinates__2__1_" +"urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", "CrowdFlowObserved", "2018-08-07T11:10:00/2018-08-07T11:15:00", "2018-08-07T11:10:00Z", "2018-08-07T11:15:00Z", "100", "50", "50", "5", "False", "inbound", "LineString", "-4.73735395519672", "41.6538181849672", "-4.73414858659993", "41.6600594193478", "-4.73447575302641", "41.659585195093" \ No newline at end of file diff --git a/CrowdFlowObserved/examples/example.jsonld b/CrowdFlowObserved/examples/example.jsonld index 34a867491..fc7a3f9e8 100644 --- a/CrowdFlowObserved/examples/example.jsonld +++ b/CrowdFlowObserved/examples/example.jsonld @@ -25,7 +25,9 @@ "type": "LineString" }, "peopleCount": 100, + "peopleCountTowards": 50, + "peopleCountAway": 50, "@context": [ "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" ] -} \ No newline at end of file +} diff --git a/CrowdFlowObserved/examples/example.jsonld.csv b/CrowdFlowObserved/examples/example.jsonld.csv index b56eb6808..0e51cb78d 100644 --- a/CrowdFlowObserved/examples/example.jsonld.csv +++ b/CrowdFlowObserved/examples/example.jsonld.csv @@ -1,2 +1,2 @@ -"id_", "type_", "averageHeadwayTime_", "congested_", "dateObserved_", "dateObservedFrom_", "dateObservedTo_", "direction_", "location__coordinates__0__0_", "location__coordinates__0__1_", "location__coordinates__1__0_", "location__coordinates__1__1_", "location__coordinates__2__0_", "location__coordinates__2__1_", "location__type_", "peopleCount_", "@context__0_" -"urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", "CrowdFlowObserved", "5", "False", "2018-08-07T11:10:00/2018-08-07T11:15:00", "2018-08-07T11:10:00Z", "2018-08-07T11:15:00Z", "inbound", "-4.73735395519672", "41.6538181849672", "-4.73414858659993", "41.6600594193478", "-4.73447575302641", "41.659585195093", "LineString", "100", "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" \ No newline at end of file +"id_", "type_", "averageHeadwayTime_", "congested_", "dateObserved_", "dateObservedFrom_", "dateObservedTo_", "direction_", "location__coordinates__0__0_", "location__coordinates__0__1_", "location__coordinates__1__0_", "location__coordinates__1__1_", "location__coordinates__2__0_", "location__coordinates__2__1_", "location__type_", "peopleCount_", "peopleCountTowards_", "peopleCountAway_", "@context__0_" +"urn:ngsi-ld:CrowdFlowObserved:Valladolid_1", "CrowdFlowObserved", "5", "False", "2018-08-07T11:10:00/2018-08-07T11:15:00", "2018-08-07T11:10:00Z", "2018-08-07T11:15:00Z", "inbound", "-4.73735395519672", "41.6538181849672", "-4.73414858659993", "41.6600594193478", "-4.73447575302641", "41.659585195093", "LineString", "100", "50", "50", "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" \ No newline at end of file diff --git a/CrowdFlowObserved/model.yaml b/CrowdFlowObserved/model.yaml index 5da479c3c..6f131db81 100644 --- a/CrowdFlowObserved/model.yaml +++ b/CrowdFlowObserved/model.yaml @@ -5,36 +5,36 @@ CrowdFlowObserved: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -132,7 +132,7 @@ CrowdFlowObserved: x-ngsi: type: Property direction: - description: 'Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:''inbound, outbound''' + description: Usual direction of travel in the walkway referred by this observation with respect to the city center. Enum:'inbound, outbound' enum: - inbound - outbound @@ -156,22 +156,28 @@ CrowdFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -186,11 +192,15 @@ CrowdFlowObserved: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -198,6 +208,8 @@ CrowdFlowObserved: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -212,11 +224,15 @@ CrowdFlowObserved: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -226,6 +242,8 @@ CrowdFlowObserved: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -240,17 +258,23 @@ CrowdFlowObserved: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -265,11 +289,15 @@ CrowdFlowObserved: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -279,6 +307,8 @@ CrowdFlowObserved: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -298,6 +328,7 @@ CrowdFlowObserved: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -309,6 +340,8 @@ CrowdFlowObserved: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -353,7 +386,7 @@ CrowdFlowObserved: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -363,6 +396,18 @@ CrowdFlowObserved: type: number x-ngsi: type: Property + peopleCountAway: + description: Total number of people detected during this observation away direction + minimum: 0 + type: number + x-ngsi: + type: Property + peopleCountTowards: + description: Total number of people detected during this observation towards direction + minimum: 0 + type: number + x-ngsi: + type: Property refRoadSegment: anyOf: - description: Identifier format of any NGSI entity @@ -394,7 +439,7 @@ CrowdFlowObserved: 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' + 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 @@ -410,9 +455,9 @@ CrowdFlowObserved: - type - dateObserved 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-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) 2025 Contributors to Smart Data Models Program x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json - x-model-tags: "" - x-version: 0.0.2 + x-model-tags: '' + x-version: 0.0.3 \ No newline at end of file diff --git a/CrowdFlowObserved/schema.json b/CrowdFlowObserved/schema.json index 801f6968e..fa26bba03 100644 --- a/CrowdFlowObserved/schema.json +++ b/CrowdFlowObserved/schema.json @@ -1,6 +1,6 @@ { "$schema": "https://json-schema.org/draft/2020-12/schema", - "$schemaVersion": "0.0.2", + "$schemaVersion": "0.0.3", "modelTags": "", "$id": "https://smart-data-models.github.io/dataModel.Transportation/CrowdFlowObserved/schema.json", "title": " - SynchroniCity - Transportation / CrowdFlowObserved", @@ -57,6 +57,16 @@ "type": "integer", "minimum": 0, "description": "Property. Total number of people detected during this observation" + }, + "peopleCountTowards": { + "type": "integer", + "minimum": 0, + "description": "Property. Total number of people detected during this observation towards direction" + }, + "peopleCountAway": { + "type": "integer", + "minimum": 0, + "description": "Property. Total number of people detected during this observation away direction" }, "occupancy": { "type": "number", @@ -94,4 +104,4 @@ "type", "dateObserved" ] -} \ No newline at end of file +} diff --git a/CrowdFlowObserved/schema.sql b/CrowdFlowObserved/schema.sql index d44bbec2e..4ccb7839b 100644 --- a/CrowdFlowObserved/schema.sql +++ b/CrowdFlowObserved/schema.sql @@ -1,3 +1,3 @@ /* (Beta) Export of data model CrowdFlowObserved of the subject dataModel.Transportation for a PostgreSQL database. Pending translation of enumerations and multityped attributes */ CREATE TYPE direction_type AS ENUM ('inbound','outbound');CREATE TYPE CrowdFlowObserved_type AS ENUM ('CrowdFlowObserved'); -CREATE TABLE CrowdFlowObserved (address JSON, alternateName TEXT, areaServed TEXT, averageCrowdSpeed NUMERIC, averageHeadwayTime NUMERIC, congested BOOLEAN, dataProvider TEXT, dateCreated TIMESTAMP, dateModified TIMESTAMP, dateObserved TEXT, dateObservedFrom TIMESTAMP, dateObservedTo TIMESTAMP, description TEXT, direction direction_type, id TEXT PRIMARY KEY, location JSON, name TEXT, occupancy NUMERIC, owner JSON, peopleCount NUMERIC, seeAlso JSON, source TEXT, type CrowdFlowObserved_type); \ No newline at end of file +CREATE TABLE CrowdFlowObserved (address JSON, alternateName TEXT, areaServed TEXT, averageCrowdSpeed NUMERIC, averageHeadwayTime NUMERIC, congested BOOLEAN, dataProvider TEXT, dateCreated TIMESTAMP, dateModified TIMESTAMP, dateObserved TEXT, dateObservedFrom TIMESTAMP, dateObservedTo TIMESTAMP, description TEXT, direction direction_type, id TEXT PRIMARY KEY, location JSON, name TEXT, occupancy NUMERIC, owner JSON, peopleCount NUMERIC, peopleCountAway NUMERIC, peopleCountTowards NUMERIC, seeAlso JSON, source TEXT, type CrowdFlowObserved_type); \ No newline at end of file diff --git a/CrowdFlowObserved/schemaDTDL.json b/CrowdFlowObserved/schemaDTDL.json index b5ac8bbad..a50a3c1bc 100644 --- a/CrowdFlowObserved/schemaDTDL.json +++ b/CrowdFlowObserved/schemaDTDL.json @@ -52,7 +52,7 @@ "displayName": "dataProvider", "@type": "Property", "schema": "string", - "comment": "A sequence of characters identifying the provider of the harmonised data entity." + "comment": "A sequence of characters identifying the provider of the harmonised data entity" }, { "name": "dateCreated", @@ -60,7 +60,7 @@ "displayName": "dateCreated", "@type": "Property", "schema": "dateTime", - "comment": "Entity creation timestamp. This will usually be allocated by the storage platform." + "comment": "Entity creation timestamp. This will usually be allocated by the storage platform" }, { "name": "dateModified", @@ -68,7 +68,7 @@ "displayName": "dateModified", "@type": "Property", "schema": "dateTime", - "comment": "Timestamp of the last modification of the entity. This will usually be allocated by the storage platform." + "comment": "Timestamp of the last modification of the entity. This will usually be allocated by the storage platform" }, { "name": "dateObserved", @@ -84,7 +84,7 @@ "displayName": "dateObservedFrom", "@type": "Property", "schema": "dateTime", - "comment": "Observation period start date and time. See `dateObserved`." + "comment": "Observation period start date and time. See `dateObserved`" }, { "name": "dateObservedTo", @@ -108,7 +108,7 @@ "displayName": "name", "@type": "Property", "schema": "string", - "comment": "The name of this item." + "comment": "The name of this item" }, { "name": "occupancy", @@ -123,8 +123,24 @@ "writable": true, "displayName": "peopleCount", "@type": "Property", - "schema": "integer", - "comment": "Total number of people detected during this observation." + "schema": "long", + "comment": "Total number of people detected during this observation" + }, + { + "name": "peopleCountAway", + "writable": true, + "displayName": "peopleCountAway", + "@type": "Property", + "schema": "long", + "comment": "Total number of people detected during this observation away direction" + }, + { + "name": "peopleCountTowards", + "writable": true, + "displayName": "peopleCountTowards", + "@type": "Property", + "schema": "long", + "comment": "Total number of people detected during this observation towards direction" }, { "name": "refRoadSegment", @@ -142,7 +158,7 @@ "displayName": "source", "@type": "Property", "schema": "string", - "comment": "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." + "comment": "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": "Telemetry", @@ -172,6 +188,10 @@ "name": "addressRegion", "schema": "string" }, + { + "name": "district", + "schema": "string" + }, { "name": "postOfficeBoxNumber", "schema": "string" @@ -183,6 +203,10 @@ { "name": "streetAddress", "schema": "string" + }, + { + "name": "streetNr", + "schema": "string" } ] }, diff --git a/CrowdFlowObserved/swagger.yaml b/CrowdFlowObserved/swagger.yaml index 42df51e2c..bf82988a3 100644 --- a/CrowdFlowObserved/swagger.yaml +++ b/CrowdFlowObserved/swagger.yaml @@ -11,7 +11,7 @@ info: description: | CrowdFlowObserved title: CrowdFlowObserved - version: "0.0.2" + version: "0.0.3" openapi: "3.0.0" paths: diff --git a/ElectricVehicleMobility/ADOPTERS.yaml b/ElectricVehicleMobility/ADOPTERS.yaml new file mode 100644 index 000000000..94edf378c --- /dev/null +++ b/ElectricVehicleMobility/ADOPTERS.yaml @@ -0,0 +1,10 @@ +description: This is a compilation list of the current adopters of the data model [Data model] of the Subject [Subject]. All fields are non mandatory. More info at https://smart-data-models.github.io/data-models/templates/dataModel/CURRENT_ADOPTERS.yaml +currentAdopters: + - +adopter: + description: + mail: + organization: ubiwhere + project: + comments: + startDate: diff --git a/ElectricVehicleMobility/README.md b/ElectricVehicleMobility/README.md new file mode 100644 index 000000000..54e61f3a1 --- /dev/null +++ b/ElectricVehicleMobility/README.md @@ -0,0 +1,55 @@ +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) +# ElectricVehicleMobility +Version: 0.0.1 + +## Description + +Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + +### Specification + +Link to the [interactive specification](https://swagger.lab.fiware.org/?url=https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/swagger.yaml) + +Link to the [specification](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/doc/spec.md) + +Enlace a la [Especificación en español](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/doc/spec_ES.md) + +Lien vers le [spécification en français](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/doc/spec_FR.md) + +Link zur [deutschen Spezifikation](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/doc/spec_DE.md) + +Link alla [specifica](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/doc/spec_IT.md) + +[仕様へのリンク](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/doc/spec_JA.md) + +[链接到规范](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/doc/spec_ZH.md) + +[사양 링크](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/doc/spec_KO.md) + +### Examples + +Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/examples/example.json) (keyvalues) for NGSI v2 + +Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/examples/example.jsonld) (keyvalues) for NGSI-LD + +Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/examples/example-normalized.json) (normalized) for NGSI-V2 + +Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/examples/example-normalized.jsonld) (normalized) for NGSI-LD + +### Dynamic Examples generation + +Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/ElectricVehicleMobility/schema.json&email=info@smartdatamodels.org) of NGSI-LD normalized payloads compliant with this data model. Refresh for new values + +Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator_keyvalues.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/ElectricVehicleMobility/schema.json&email=info@smartdatamodels.org) of NGSI-LD keyvalues payloads compliant with this data model. Refresh for new values + +Link to the [Generator](https://smartdatamodels.org/extra/geojson_features_generator.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/ElectricVehicleMobility/schema.json&email=info@smartdatamodels.org) of geojson feature format payloads compliant with this data model. Refresh for new values + +### PostgreSQL schema + +### Contribution + + If you have any issue on this data model you can raise an [issue](https://github.com/smart-data-models/dataModel.Transportation/issues) or contribute with a [PR](https://github.com/smart-data-models/dataModel.Transportation/pulls) + + If you wish to develop your own data model you can start from [contribution manual](https://bit.ly/contribution_manual). Several services have been developed to help with: + - [Test data model repository](https://smartdatamodels.org/index.php/data-models-contribution-api/) including the schema and example payloads, etc + - [Generate PostgreSQL schema](https://smartdatamodels.org/index.php/sql-service/) to help create a table, create type, etc \ No newline at end of file diff --git a/ElectricVehicleMobility/code/README.md b/ElectricVehicleMobility/code/README.md new file mode 100644 index 000000000..abc2dc611 --- /dev/null +++ b/ElectricVehicleMobility/code/README.md @@ -0,0 +1,14 @@ +# ElectricVehicleMobility + +### List of code samples + + + + +[code_for_using_dataModel.Transportation_ElectricVehicleMobility.py](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/code/code_for_using_dataModel.Transportation_ElectricVehicleMobility.py) + + + + +### Contribution +You can raise an [issue](https://github.com/smart-data-models/dataModel.Transportation/issues) or submit your [PR](https://github.com/smart-data-models/dataModel.Transportation/pulls) on existing data models diff --git a/ElectricVehicleMobility/code/code_for_using_dataModel.Transportation_ElectricVehicleMobility.py b/ElectricVehicleMobility/code/code_for_using_dataModel.Transportation_ElectricVehicleMobility.py new file mode 100644 index 000000000..56c8ee828 --- /dev/null +++ b/ElectricVehicleMobility/code/code_for_using_dataModel.Transportation_ElectricVehicleMobility.py @@ -0,0 +1,61 @@ + +# # This code allows you to install a orion-ld broker in a linux system +# # The manuals are here https://github.com/FIWARE/context.Orion-LD/tree/develop/doc/manuals-ld +# +# # INSTALL NGSI LD broker (OrionLD) +# sudo docker pull mongo:3.6 +# sudo docker pull fiware/orion-ld +# sudo docker network create fiware_default +# sudo docker run -d --name=mongo-db --network=fiware_default --expose=27017 mongo:3.6 --bind_ip_all --smallfiles +# sudo docker run -d --name fiware-orionld -h orion --network=fiware_default -p 1026:1026 fiware/orion-ld -dbhost mongo-db +# +# # TO RELAUNCH (only if you have already installed a broker in the same machine) +# sudo docker stop fiware-orionld +# sudo docker rm fiware-orionld +# sudo docker stop mongo-db +# sudo docker rm mongo-db +# sudo docker network rm fiware_default +# +# # CHECK INSTANCES +# # Check the broker is running +# curl -X GET 'http://localhost:1026/version' +# +# # Check what entities are in the broker +# curl -X GET http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000 +# +# # now the python code you can use to insert some value in the context broker according to the data model +# +from pysmartdatamodels import pysmartdatamodels as sdm +import subprocess +serverUrl = "http://localhost:1026" # supposed that your broker is installed in localhost. Edit to match your configuration +dataModel = "ElectricVehicleMobility" +subject = "dataModel.Transportation" +dateObserved = "2025-12-15" +attribute = "dateObserved" +value = dateObserved +# The next line creates the query for inserting this attribute in a NGSI-LD context broker if the attribute does not exist it creates it +print(sdm.update_broker(dataModel, subject, attribute, value, serverUrl=serverUrl, updateThenCreate=True)) + +region = "Outros - GDPR" +attribute = "region" +value = region +# The next line creates the query for inserting this attribute in a NGSI-LD context broker if the attribute does not exist it creates it +print(sdm.update_broker(dataModel, subject, attribute, value, serverUrl=serverUrl, updateThenCreate=True)) + +district = "Outros - GDPR" +attribute = "district" +value = district +# The next line creates the query for inserting this attribute in a NGSI-LD context broker if the attribute does not exist it creates it +print(sdm.update_broker(dataModel, subject, attribute, value, serverUrl=serverUrl, updateThenCreate=True)) + +municipality = "Outros - GDPR" +attribute = "municipality" +value = municipality +# The next line creates the query for inserting this attribute in a NGSI-LD context broker if the attribute does not exist it creates it +print(sdm.update_broker(dataModel, subject, attribute, value, serverUrl=serverUrl, updateThenCreate=True)) + +print(" In case you have installed the orion-ld broker (see comments on the header of this program)") +print(" Execute this instruction to check that the entities has been inserted") +command = ['curl', '-X', 'GET', 'http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000'] +result = subprocess.run(command, capture_output=True, text=True) +print(result.stdout) diff --git a/ElectricVehicleMobility/doc/spec.md b/ElectricVehicleMobility/doc/spec.md new file mode 100644 index 000000000..9c734d867 --- /dev/null +++ b/ElectricVehicleMobility/doc/spec.md @@ -0,0 +1,618 @@ + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + Entity: ElectricVehicleMobility +=============================== + + [Open License](https://github.com/smart-data-models//dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md) + [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) + + + Global description: **Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region.** + version: 0.0.1 + + + + ## List of properties + + [*] If there is not a type in an attribute is because it could have several types or different formats/patterns +- `address[object]`: The mailing address . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: The country. For example, Spain . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: The locality in which the street address is, and which is in the region . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: The region in which the locality is, and which is in the country . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: A district is a type of administrative division that, in some countries, is managed by the local government + - `postOfficeBoxNumber[string]`: The post office box number for PO box addresses. For example, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: The postal code. For example, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: The street address . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Number identifying a specific property on a public street +- `alternateName[string]`: An alternative name for this item - `areaServed[string]`: The geographic area where a service or offered item is provided . Model: [https://schema.org/Text](https://schema.org/Text) - `averageDistanceKm[number]`: Average distance traveled in kilometers . Model: [https://schema.org/Number](https://schema.org/Number) - `dataProvider[string]`: Provider of the harmonised data entity . Model: [https://schema.org/Text](https://schema.org/Text) - `dateCreated[date-time]`: Entity creation timestamp. This will usually be allocated by the storage platform - `dateModified[date-time]`: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform - `dateObserved[date]`: Date of the observation (YYYY-MM-DD) . Model: [https://schema.org/Date](https://schema.org/Date) - `description[string]`: A description of this item - `deviceBrand[string]`: Brand or manufacturer of the electric vehicle . Model: [https://schema.org/Text](https://schema.org/Text) - `district[string]`: District where the observation was made . Model: [https://schema.org/Text](https://schema.org/Text) - `id[*]`: Unique identifier of the entity - `location[*]`: Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon - `locationCode[string]`: Official municipality code . Model: [https://schema.org/Text](https://schema.org/Text) - `municipality[string]`: Municipality where the observation was made . Model: [https://schema.org/Text](https://schema.org/Text) - `n[number]`: Number of observations used to calculate the average distance . Model: [https://schema.org/Number](https://schema.org/Number) - `name[string]`: The name of this item - `owner[array]`: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) - `region[string]`: Region where the observation was made . Model: [https://schema.org/Text](https://schema.org/Text) - `seeAlso[*]`: list of uri pointing to additional resources about the item - `source[string]`: Original source of the data as a URL . Model: [https://schema.org/Text](https://schema.org/Text) - `type[string]`: NGSI entity type. It has to be ElectricVehicleMobility - `vehicleType[string]`: Type of electric vehicle . Model: [https://schema.org/Text](https://schema.org/Text) + + Required properties +- `id` - `type` + + + + ## Data Model description of properties + Sorted alphabetically (click for details) + + +
full yaml details + ```yaml +ElectricVehicleMobility: + description: Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageDistanceKm: + description: Average distance traveled in kilometers + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: kilometers + dataProvider: + description: Provider of the harmonised data entity + type: string + x-ngsi: + model: https://schema.org/Text + 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 + dateObserved: + description: Date of the observation (YYYY-MM-DD) + format: date + type: string + x-ngsi: + model: https://schema.org/Date + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + deviceBrand: + description: Brand or manufacturer of the electric vehicle + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + district: + description: District where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + locationCode: + description: Official municipality code + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + municipality: + description: Municipality where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + n: + description: Number of observations used to calculate the average distance + minimum: 1 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + region: + description: Region where the observation was made + enum: + - CONTINENTE + - AÇORES + - MADEIRA + - Outros - GDPR + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + 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: Original source of the data as a URL + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + type: + description: NGSI entity type. It has to be ElectricVehicleMobility + enum: + - ElectricVehicleMobility + type: string + x-ngsi: + type: Property + vehicleType: + description: Type of electric vehicle + enum: + - BEV + - PHEV + - HEV + - FCEV + - unknown + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/schema.json + x-model-tags: transportation,electricVehicle,mobility,statistics + x-version: 0.0.1 +``` +
+ + + + + ## Example payloads + #### ElectricVehicleMobility NGSI-v2 key-values Example + Here is an example of a ElectricVehicleMobility in JSON-LD format as key-values. This is compatible with NGSI-v2 when using `options=keyValues` and returns the context data of an individual entity. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26 +} +``` +
+ #### ElectricVehicleMobility NGSI-v2 normalized Example + Here is an example of a ElectricVehicleMobility in JSON-LD format as normalized. This is compatible with NGSI-v2 when not using options and returns the context data of an individual entity. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Date-Time", + "value": "2025-12-15" + }, + "region": { + "type": "Text", + "value": "Outros - GDPR" + }, + "district": { + "type": "Text", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Text", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Text", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Text", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Text", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + } +} +``` +
+ #### ElectricVehicleMobility NGSI-LD key-values Example + Here is an example of a ElectricVehicleMobility in JSON-LD format as key-values. This is compatible with NGSI-LD when using `options=keyValues` and returns the context data of an individual entity. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ #### ElectricVehicleMobility NGSI-LD normalized Example + Here is an example of a ElectricVehicleMobility in JSON-LD format as normalized. This is compatible with NGSI-LD when not using options and returns the context data of an individual entity. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Property", + "value": { + "@type": "Date", + "@value": "2025-12-15" + } + }, + "region": { + "type": "Property", + "value": "Outros - GDPR" + }, + "district": { + "type": "Property", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Property", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Property", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Property", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Property", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + }, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ + + + See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) diff --git a/ElectricVehicleMobility/doc/spec_DE.md b/ElectricVehicleMobility/doc/spec_DE.md new file mode 100644 index 000000000..540f20290 --- /dev/null +++ b/ElectricVehicleMobility/doc/spec_DE.md @@ -0,0 +1,700 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entität: ElectricVehicleMobility +=============================== + + + + + +[Offene Lizenz](https://github.com/smart-data-models//dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md) + +[automatisch generiertes Dokument](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) + + + + + +Global description: **Tägliche Beobachtung von Mobilitätsmustern von Elektrofahrzeugen, aggregiert nach Standort, Fahrzeugmarke und geografischer Region.** + +version: 0.0.1 + + + + + + +## Liste der Eigenschaften + + +[*] Wenn in einem Attribut kein Typ vorhanden ist, liegt dies daran, dass es mehrere Typen oder unterschiedliche Formate/Muster haben kann. +- `address[object]`: Die Postanschrift . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: Das Land. Zum Beispiel Spanien. . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: Die Ortschaft, in der sich die Straßenadresse befindet und die sich in der Region befindet . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: Die Region, in der sich der Ort befindet, und die sich im Land befindet . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Ein Bezirk ist eine Art administrative Untergliederung, die in einigen Ländern von der lokalen Regierung verwaltet wird. + - `postOfficeBoxNumber[string]`: Die Postfachnummer für Postfachadressen. Zum Beispiel 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Die Postleitzahl. Zum Beispiel 24004. . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: Die Straßenadresse . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Straßenhausnummer +- `alternateName[string]`: Ein alternativer Name für diesen Artikel +- `areaServed[string]`: Das geografische Gebiet, in dem eine Dienstleistung oder ein angebotenes Produkt bereitgestellt wird . Model: [https://schema.org/Text](https://schema.org/Text) +- `averageDistanceKm[number]`: Durchschnittlich zurückgelegte Strecke in Kilometern . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: Anbieter der harmonisierten Datenentität . Model: [https://schema.org/Text](https://schema.org/Text) +- `dateCreated[date-time]`: Zeitstempel der Entitätserstellung. Dies wird normalerweise von der Speicherplattform zugewiesen +- `dateModified[date-time]`: Zeitstempel der letzten Änderung der Entität. Dieser wird in der Regel von der Speicherplattform zugewiesen. +- `dateObserved[date]`: Datum der Beobachtung (JJJJ-MM-TT) . Model: [https://schema.org/Date](https://schema.org/Date) +- `description[string]`: Eine Beschreibung dieses Artikels +- `deviceBrand[string]`: Marke oder Hersteller des Elektrofahrzeugs . Model: [https://schema.org/Text](https://schema.org/Text) +- `district[string]`: Bezirk, in dem die Beobachtung gemacht wurde . Model: [https://schema.org/Text](https://schema.org/Text) +- `id[*]`: Eindeutiger Identifikator der Entität +- `location[*]`: Geojson-Referenz auf das Element. Es kann ein Punkt, eine Linie, ein Polygon, ein Mehrfachpunkt, eine Mehrfachlinie oder ein Mehrfachpolygon sein. +- `locationCode[string]`: Amtlicher Gemeindeschlüssel . Model: [https://schema.org/Text](https://schema.org/Text) +- `municipality[string]`: Gemeinde, in der die Beobachtung gemacht wurde . Model: [https://schema.org/Text](https://schema.org/Text) +- `n[number]`: Anzahl der Beobachtungen, die zur Berechnung der durchschnittlichen Entfernung verwendet wurden . Model: [https://schema.org/Number](https://schema.org/Number) +- `name[string]`: Der Name dieses Artikels +- `owner[array]`: Eine Liste, die eine JSON-kodierte Sequenz von Zeichen enthält, die auf die eindeutigen IDs des/der Besitzer(s) verweist +- `region[string]`: Region, in der die Beobachtung gemacht wurde . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: Liste von URIs, die auf zusätzliche Ressourcen zum Element verweisen +- `source[string]`: Ursprüngliche Datenquelle als URL . Model: [https://schema.org/Text](https://schema.org/Text) +- `type[string]`: NGSI-Entitätstyp. Er muss ElectricVehicleMobility sein +- `vehicleType[string]`: Typ des Elektrofahrzeugs . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +Erforderliche Eigenschaften +- `id` +- `type` + + + + + + + + + +## Beschreibung der Eigenschaften des Datenmodells + +Alphabetisch sortiert (Klicken für Details) + + + + +
vollständige YAML-Details + +```yaml +ElectricVehicleMobility: + description: Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageDistanceKm: + description: Average distance traveled in kilometers + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: kilometers + dataProvider: + description: Provider of the harmonised data entity + type: string + x-ngsi: + model: https://schema.org/Text + 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 + dateObserved: + description: Date of the observation (YYYY-MM-DD) + format: date + type: string + x-ngsi: + model: https://schema.org/Date + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + deviceBrand: + description: Brand or manufacturer of the electric vehicle + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + district: + description: District where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + locationCode: + description: Official municipality code + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + municipality: + description: Municipality where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + n: + description: Number of observations used to calculate the average distance + minimum: 1 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + region: + description: Region where the observation was made + enum: + - CONTINENTE + - AÇORES + - MADEIRA + - Outros - GDPR + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + 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: Original source of the data as a URL + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + type: + description: NGSI entity type. It has to be ElectricVehicleMobility + enum: + - ElectricVehicleMobility + type: string + x-ngsi: + type: Property + vehicleType: + description: Type of electric vehicle + enum: + - BEV + - PHEV + - HEV + - FCEV + - unknown + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/schema.json + x-model-tags: transportation,electricVehicle,mobility,statistics + x-version: 0.0.1 +``` +
+ + + + + + + + + +## Beispiel-Payloads + +#### Beispiel für Schlüsselwerte von ElectricVehicleMobility NGSI-v2 + +Hier ist ein Beispiel für eine ElectricVehicleMobility im JSON-LD-Format als Schlüssel-Werte. Dies ist kompatibel mit NGSI-v2, wenn `options=keyValues` verwendet wird, und gibt die Kontextdaten einer einzelnen Entität zurück. +
Beispiel ein/ausblenden + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26 +} +``` +
+ +#### Beispiel für ElectricVehicleMobility NGSI-v2 normalisiert + +Hier ist ein Beispiel für eine ElectricVehicleMobility im JSON-LD-Format als normalisiert. Dies ist kompatibel mit NGSI-v2, wenn keine Optionen verwendet werden, und gibt die Kontextdaten einer einzelnen Entität zurück. +
Beispiel anzeigen/ausblenden + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Date-Time", + "value": "2025-12-15" + }, + "region": { + "type": "Text", + "value": "Outros - GDPR" + }, + "district": { + "type": "Text", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Text", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Text", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Text", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Text", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + } +} +``` +
+ +#### Beispiel für Schlüsselwerte von ElectricVehicleMobility NGSI-LD + +Hier ist ein Beispiel für eine ElectricVehicleMobility im JSON-LD-Format als Schlüssel-Werte. Dies ist kompatibel mit NGSI-LD, wenn `options=keyValues` verwendet wird, und gibt die Kontextdaten einer einzelnen Entität zurück. +
Beispiel ein-/ausblenden + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ +#### Elektrische Fahrzeugmobilität NGSI-LD normalisiertes Beispiel + +Hier ist ein Beispiel für eine ElectricVehicleMobility im JSON-LD-Format als normalisiert. Dies ist kompatibel mit NGSI-LD, wenn keine Optionen verwendet werden, und gibt die Kontextdaten einer einzelnen Entität zurück. +
Beispiel anzeigen/ausblenden + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Property", + "value": { + "@type": "Date", + "@value": "2025-12-15" + } + }, + "region": { + "type": "Property", + "value": "Outros - GDPR" + }, + "district": { + "type": "Property", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Property", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Property", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Property", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Property", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + }, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ + + + + + + + +Siehe [FAQ 10](https://smartdatamodels.org/index.php/faqs/), um eine Antwort auf die Behandlung von Einheiten der Größe zu erhalten + + + + +--- + +[Intelligente Datenmodelle](https://smartdatamodels.org) +++ [Beitrags-Handbuch](https://bit.ly/contribution_manual) + diff --git a/ElectricVehicleMobility/doc/spec_ES.md b/ElectricVehicleMobility/doc/spec_ES.md new file mode 100644 index 000000000..870c404e3 --- /dev/null +++ b/ElectricVehicleMobility/doc/spec_ES.md @@ -0,0 +1,700 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entidad: ElectricVehicleMobility +=============================== + + + + + +[Licencia Abierta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md) + +[documento generado automáticamente](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) + + + + + +Global description: **Observación diaria de patrones de movilidad de vehículos eléctricos agregados por ubicación, marca de vehículo y región geográfica.** + +version: 0.0.1 + + + + + + +## Lista de propiedades + + +Si no hay un tipo en un atributo es porque podría tener varios tipos o diferentes formatos/patrones +- `address[object]`: La dirección postal . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: El país. Por ejemplo, España . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La localidad en la que se encuentra la dirección de la calle, y que está en la región . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La región en la que se encuentra la localidad, y que está en el país. . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un distrito es un tipo de división administrativa que, en algunos países, es gestionada por el gobierno local. + - `postOfficeBoxNumber[string]`: El número de casilla postal para direcciones de casilla postal. Por ejemplo, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: El código postal. Por ejemplo, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: La dirección de la calle . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Número que identifica una propiedad específica en una calle pública +- `alternateName[string]`: Un nombre alternativo para este artículo +- `areaServed[string]`: Área geográfica donde se presta un servicio o se ofrece un artículo . Model: [https://schema.org/Text](https://schema.org/Text) +- `averageDistanceKm[number]`: Distancia media recorrida en kilómetros . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: Proveedor de la entidad de datos armonizada . Model: [https://schema.org/Text](https://schema.org/Text) +- `dateCreated[date-time]`: Marca de tiempo de creación de entidad. Normalmente será asignada por la plataforma de almacenamiento. +- `dateModified[date-time]`: Marca de tiempo de la última modificación de la entidad. Normalmente será asignada por la plataforma de almacenamiento. +- `dateObserved[date]`: Fecha de la observación (AAAA-MM-DD) . Model: [https://schema.org/Date](https://schema.org/Date) +- `description[string]`: Una descripción de este artículo +- `deviceBrand[string]`: Marca o fabricante del vehículo eléctrico . Model: [https://schema.org/Text](https://schema.org/Text) +- `district[string]`: Distrito donde se realizó la observación . Model: [https://schema.org/Text](https://schema.org/Text) +- `id[*]`: Identificador único de la entidad +- `location[*]`: Referencia Geojson del elemento. Puede ser Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon +- `locationCode[string]`: Código oficial de municipio . Model: [https://schema.org/Text](https://schema.org/Text) +- `municipality[string]`: Municipio donde se realizó la observación . Model: [https://schema.org/Text](https://schema.org/Text) +- `n[number]`: Número de observaciones utilizadas para calcular la distancia media . Model: [https://schema.org/Number](https://schema.org/Number) +- `name[string]`: El nombre de este elemento +- `owner[array]`: Una lista que contiene una secuencia de caracteres codificados en JSON que hacen referencia a los identificadores únicos del propietario (los propietarios) +- `region[string]`: Región donde se realizó la observación . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: lista de uri que apuntan a recursos adicionales sobre el elemento +- `source[string]`: Fuente original de los datos como una URL . Model: [https://schema.org/Text](https://schema.org/Text) +- `type[string]`: Tipo de entidad NGSI. Tiene que ser ElectricVehicleMobility +- `vehicleType[string]`: Tipo de vehículo eléctrico . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +Propiedades requeridas +- `id` +- `type` + + + + + + + + + +## Descripción del modelo de datos de las propiedades + +Ordenados alfabéticamente (hacer clic para obtener detalles) + + + + +
detalles completos de yaml + +```yaml +ElectricVehicleMobility: + description: Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageDistanceKm: + description: Average distance traveled in kilometers + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: kilometers + dataProvider: + description: Provider of the harmonised data entity + type: string + x-ngsi: + model: https://schema.org/Text + 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 + dateObserved: + description: Date of the observation (YYYY-MM-DD) + format: date + type: string + x-ngsi: + model: https://schema.org/Date + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + deviceBrand: + description: Brand or manufacturer of the electric vehicle + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + district: + description: District where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + locationCode: + description: Official municipality code + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + municipality: + description: Municipality where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + n: + description: Number of observations used to calculate the average distance + minimum: 1 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + region: + description: Region where the observation was made + enum: + - CONTINENTE + - AÇORES + - MADEIRA + - Outros - GDPR + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + 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: Original source of the data as a URL + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + type: + description: NGSI entity type. It has to be ElectricVehicleMobility + enum: + - ElectricVehicleMobility + type: string + x-ngsi: + type: Property + vehicleType: + description: Type of electric vehicle + enum: + - BEV + - PHEV + - HEV + - FCEV + - unknown + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/schema.json + x-model-tags: transportation,electricVehicle,mobility,statistics + x-version: 0.0.1 +``` +
+ + + + + + + + + +## Cargas de ejemplo + +#### VehículoEléctricoMovilidad NGSI-v2 valores-clave Ejemplo + +Aquí hay un ejemplo de ElectricVehicleMobility en formato JSON-LD como pares clave-valor. Esto es compatible con NGSI-v2 cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. +
mostrar/ocultar ejemplo + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26 +} +``` +
+ +#### Ejemplo normalizado de ElectricVehicleMobility NGSI-v2 + +Aquí hay un ejemplo de ElectricVehicleMobility en formato JSON-LD normalizado. Esto es compatible con NGSI-v2 cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. +
mostrar/ocultar ejemplo + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Date-Time", + "value": "2025-12-15" + }, + "region": { + "type": "Text", + "value": "Outros - GDPR" + }, + "district": { + "type": "Text", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Text", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Text", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Text", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Text", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + } +} +``` +
+ +#### Ejemplo de valores clave de NGSI-LD de movilidad de vehículo eléctrico + +Aquí hay un ejemplo de ElectricVehicleMobility en formato JSON-LD como pares clave-valor. Esto es compatible con NGSI-LD cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. +
mostrar/ocultar ejemplo + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ +#### Ejemplo normalizado de ElectricVehicleMobility NGSI-LD + +Aquí hay un ejemplo de ElectricVehicleMobility en formato JSON-LD normalizado. Esto es compatible con NGSI-LD cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. +
mostrar/ocultar ejemplo + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Property", + "value": { + "@type": "Date", + "@value": "2025-12-15" + } + }, + "region": { + "type": "Property", + "value": "Outros - GDPR" + }, + "district": { + "type": "Property", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Property", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Property", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Property", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Property", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + }, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ + + + + + + + +Consulte [FAQ 10](https://smartdatamodels.org/index.php/faqs/) para obtener una respuesta sobre cómo tratar las unidades de magnitud. + + + + +--- + +[Modelos de datos inteligentes](https://smartdatamodels.org) +++ [Manual de Contribuciones](https://bit.ly/contribution_manual) + diff --git a/ElectricVehicleMobility/doc/spec_FR.md b/ElectricVehicleMobility/doc/spec_FR.md new file mode 100644 index 000000000..9fee895a2 --- /dev/null +++ b/ElectricVehicleMobility/doc/spec_FR.md @@ -0,0 +1,700 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entité: ElectricVehicleMobility +=============================== + + + + + +[Licence ouverte](https://github.com/smart-data-models//dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md) + +[document généré automatiquement](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) + + + + + +Global description: **Observation quotidienne des modèles de mobilité des véhicules électriques agrégés par emplacement, marque de véhicule et région géographique.** + +version: 0.0.1 + + + + + + +## Liste de propriétés + + +[*] S'il n'y a pas de type dans un attribut, c'est parce qu'il pourrait avoir plusieurs types ou des formats/motifs différents +- `address[object]`: L'adresse postale . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: Le pays. Par exemple, l'Espagne . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La localité dans laquelle se trouve l'adresse de rue, et qui se trouve dans la région . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La région dans laquelle se trouve la localité, et qui est dans le pays . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un district est un type de division administrative qui, dans certains pays, est géré par les autorités locales. + - `postOfficeBoxNumber[string]`: Le numéro de boîte postale pour les adresses de boîte postale. Par exemple, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Le code postal. Par exemple, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: L'adresse de la rue . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Numéro identifiant une propriété spécifique dans une rue publique +- `alternateName[string]`: Un nom alternatif pour cet élément +- `areaServed[string]`: Zone géographique où un service ou un article offert est fourni . Model: [https://schema.org/Text](https://schema.org/Text) +- `averageDistanceKm[number]`: Distance moyenne parcourue en kilomètres . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: Fournisseur de l'entité de données harmonisée . Model: [https://schema.org/Text](https://schema.org/Text) +- `dateCreated[date-time]`: Horodatage de création de l'entité. Celui-ci sera généralement attribué par la plate-forme de stockage +- `dateModified[date-time]`: Heure de la dernière modification de l'entité. Ceci est généralement attribué par la plate-forme de stockage +- `dateObserved[date]`: Date de l'observation (YYYY-MM-DD) . Model: [https://schema.org/Date](https://schema.org/Date) +- `description[string]`: Une description de cet article +- `deviceBrand[string]`: Marque ou fabricant du véhicule électrique . Model: [https://schema.org/Text](https://schema.org/Text) +- `district[string]`: Lieu où l'observation a été faite . Model: [https://schema.org/Text](https://schema.org/Text) +- `id[*]`: Identifiant unique de l'entité +- `location[*]`: Référence Geojson de l'élément. Il peut s'agir d'un Point, LineString, Polygon, MultiPoint, MultiLineString ou MultiPolygon +- `locationCode[string]`: Code officiel de la commune . Model: [https://schema.org/Text](https://schema.org/Text) +- `municipality[string]`: Commune où l'observation a été faite . Model: [https://schema.org/Text](https://schema.org/Text) +- `n[number]`: Nombre d'observations utilisées pour calculer la distance moyenne . Model: [https://schema.org/Number](https://schema.org/Number) +- `name[string]`: Le nom de cet article +- `owner[array]`: Une liste contenant une séquence de caractères codés en JSON faisant référence aux ID uniques du ou des propriétaires +- `region[string]`: Région où l'observation a été faite . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: liste d'URI pointant vers des ressources supplémentaires concernant l'élément +- `source[string]`: Source d'origine des données sous forme d'URL . Model: [https://schema.org/Text](https://schema.org/Text) +- `type[string]`: Type d'entité NGSI. Il doit être ElectricVehicleMobility +- `vehicleType[string]`: Type de véhicule électrique . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +Propriétés requises +- `id` +- `type` + + + + + + + + + +## Description du modèle de données des propriétés + +Trié par ordre alphabétique (cliquez pour plus de détails) + + + + +
détails complets de yaml + +```yaml +ElectricVehicleMobility: + description: Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageDistanceKm: + description: Average distance traveled in kilometers + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: kilometers + dataProvider: + description: Provider of the harmonised data entity + type: string + x-ngsi: + model: https://schema.org/Text + 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 + dateObserved: + description: Date of the observation (YYYY-MM-DD) + format: date + type: string + x-ngsi: + model: https://schema.org/Date + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + deviceBrand: + description: Brand or manufacturer of the electric vehicle + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + district: + description: District where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + locationCode: + description: Official municipality code + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + municipality: + description: Municipality where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + n: + description: Number of observations used to calculate the average distance + minimum: 1 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + region: + description: Region where the observation was made + enum: + - CONTINENTE + - AÇORES + - MADEIRA + - Outros - GDPR + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + 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: Original source of the data as a URL + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + type: + description: NGSI entity type. It has to be ElectricVehicleMobility + enum: + - ElectricVehicleMobility + type: string + x-ngsi: + type: Property + vehicleType: + description: Type of electric vehicle + enum: + - BEV + - PHEV + - HEV + - FCEV + - unknown + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/schema.json + x-model-tags: transportation,electricVehicle,mobility,statistics + x-version: 0.0.1 +``` +
+ + + + + + + + + +## Exemples de charges utiles + +#### Exemple de valeurs clés NGSI-v2 de ElectricVehicleMobility + +Voici un exemple de ElectricVehicleMobility au format JSON-LD en tant que valeurs clés. Ceci est compatible avec NGSI-v2 lors de l'utilisation de `options=keyValues` et retourne les données contextuelles d'une entité individuelle. +
afficher/masquer l'exemple + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26 +} +``` +
+ +#### Exemple normalisé ElectricVehicleMobility NGSI-v2 + +Voici un exemple de ElectricVehicleMobility au format JSON-LD normalisé. Ceci est compatible avec NGSI-v2 lorsqu'on n'utilise pas d'options et retourne les données de contexte d'une entité individuelle. +
afficher/cacher l'exemple + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Date-Time", + "value": "2025-12-15" + }, + "region": { + "type": "Text", + "value": "Outros - GDPR" + }, + "district": { + "type": "Text", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Text", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Text", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Text", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Text", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + } +} +``` +
+ +#### Exemple de valeurs clés NGSI-LD pour la mobilité des véhicules électriques + +Voici un exemple de ElectricVehicleMobility au format JSON-LD en tant que valeurs clés. Ceci est compatible avec NGSI-LD lors de l'utilisation de `options=keyValues` et retourne les données contextuelles d'une entité individuelle. +
afficher/masquer l'exemple + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ +#### Exemple normalisé ElectricVehicleMobility NGSI-LD + +Voici un exemple de ElectricVehicleMobility au format JSON-LD normalisé. Ceci est compatible avec NGSI-LD lorsqu'on n'utilise pas d'options et retourne les données de contexte d'une entité individuelle. +
afficher/cacher l'exemple + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Property", + "value": { + "@type": "Date", + "@value": "2025-12-15" + } + }, + "region": { + "type": "Property", + "value": "Outros - GDPR" + }, + "district": { + "type": "Property", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Property", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Property", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Property", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Property", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + }, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ + + + + + + + +Voir [FAQ 10](https://smartdatamodels.org/index.php/faqs/) pour obtenir une réponse sur la façon de gérer les unités de magnitude + + + + +--- + +[Modèles de données intelligents](https://smartdatamodels.org) +++ [Manuel de contribution](https://bit.ly/contribution_manual) + diff --git a/ElectricVehicleMobility/doc/spec_IT.md b/ElectricVehicleMobility/doc/spec_IT.md new file mode 100644 index 000000000..a1509ab61 --- /dev/null +++ b/ElectricVehicleMobility/doc/spec_IT.md @@ -0,0 +1,700 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entità: ElectricVehicleMobility +=============================== + + + + + +[Licenza aperta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/ElectricVehicleMobility/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) + + + + + +Global description: **Osservazione quotidiana dei modelli di mobilità dei veicoli elettrici aggregati per posizione, marca del veicolo e regione geografica.** + +version: 0.0.1 + + + + + + +## Elenco delle proprietà + + +[*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o formati/pattern diversi +- `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 stradale 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) + - `streetNr[string]`: Numero civico +- `alternateName[string]`: Un nome alternativo per questo articolo +- `areaServed[string]`: L'area geografica in cui viene fornito un servizio o un articolo offerto . Model: [https://schema.org/Text](https://schema.org/Text) +- `averageDistanceKm[number]`: Distanza media percorsa in chilometri . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: Fornitore dell'entità di dati armonizzati . Model: [https://schema.org/Text](https://schema.org/Text) +- `dateCreated[date-time]`: Timestamp di creazione dell'entità. Questo di solito viene allocato dalla piattaforma di archiviazione +- `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Questo di solito verrà allocato dalla piattaforma di archiviazione +- `dateObserved[date]`: Data dell'osservazione (YYYY-MM-DD) . Model: [https://schema.org/Date](https://schema.org/Date) +- `description[string]`: Una descrizione di questo articolo +- `deviceBrand[string]`: Marca o produttore del veicolo elettrico . Model: [https://schema.org/Text](https://schema.org/Text) +- `district[string]`: Distretto in cui è stata effettuata l'osservazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `id[*]`: Identificatore univoco dell'entità +- `location[*]`: Riferimento Geojson dell'elemento. Può essere Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon +- `locationCode[string]`: Codice ufficiale del comune . Model: [https://schema.org/Text](https://schema.org/Text) +- `municipality[string]`: Comune dove è stata effettuata l'osservazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `n[number]`: Numero di osservazioni utilizzate per calcolare la distanza media . Model: [https://schema.org/Number](https://schema.org/Number) +- `name[string]`: Il nome di questo articolo +- `owner[array]`: Un elenco contenente una sequenza di caratteri codificati JSON che fanno riferimento agli ID univoci del proprietario/i +- `region[string]`: Regione in cui è stata effettuata l'osservazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: elenco di uri che puntano a risorse aggiuntive sull'elemento +- `source[string]`: Fonte originale dei dati come URL . Model: [https://schema.org/Text](https://schema.org/Text) +- `type[string]`: Tipo di entità NGSI. Deve essere ElectricVehicleMobility +- `vehicleType[string]`: Tipo di veicolo elettrico . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +Proprietà richieste +- `id` +- `type` + + + + + + + + + +## Descrizione del modello di dati delle proprietà + +Ordinati alfabeticamente (clicca per i dettagli) + + + + +
dettagli yaml completi + +```yaml +ElectricVehicleMobility: + description: Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageDistanceKm: + description: Average distance traveled in kilometers + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: kilometers + dataProvider: + description: Provider of the harmonised data entity + type: string + x-ngsi: + model: https://schema.org/Text + 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 + dateObserved: + description: Date of the observation (YYYY-MM-DD) + format: date + type: string + x-ngsi: + model: https://schema.org/Date + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + deviceBrand: + description: Brand or manufacturer of the electric vehicle + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + district: + description: District where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + locationCode: + description: Official municipality code + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + municipality: + description: Municipality where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + n: + description: Number of observations used to calculate the average distance + minimum: 1 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + region: + description: Region where the observation was made + enum: + - CONTINENTE + - AÇORES + - MADEIRA + - Outros - GDPR + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + 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: Original source of the data as a URL + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + type: + description: NGSI entity type. It has to be ElectricVehicleMobility + enum: + - ElectricVehicleMobility + type: string + x-ngsi: + type: Property + vehicleType: + description: Type of electric vehicle + enum: + - BEV + - PHEV + - HEV + - FCEV + - unknown + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/schema.json + x-model-tags: transportation,electricVehicle,mobility,statistics + x-version: 0.0.1 +``` +
+ + + + + + + + + +## Esempi di payload + +#### Esempio di valori chiave ElectricVehicleMobility NGSI-v2 + +Ecco un esempio di ElectricVehicleMobility in formato JSON-LD come valori chiave. Questo è compatibile con NGSI-v2 quando si utilizza `options=keyValues` e restituisce i dati di contesto di un'entità individuale. +
mostra/nascondi esempio + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26 +} +``` +
+ +#### Esempio normalizzato ElectricVehicleMobility NGSI-v2 + +Ecco un esempio di ElectricVehicleMobility in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano opzioni e restituisce i dati di contesto di un'entità individuale. +
mostra/nascondi esempio + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Date-Time", + "value": "2025-12-15" + }, + "region": { + "type": "Text", + "value": "Outros - GDPR" + }, + "district": { + "type": "Text", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Text", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Text", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Text", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Text", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + } +} +``` +
+ +#### Esempio di valori chiave NGSI-LD per la mobilità dei veicoli elettrici + +Ecco un esempio di ElectricVehicleMobility in formato JSON-LD come valori-chiave. Ciò è compatibile con NGSI-LD quando si utilizza `options=keyValues` e restituisce i dati di contesto di un'entità individuale. +
mostra/nascondi esempio + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ +#### Esempio normalizzato ElectricVehicleMobility NGSI-LD + +Ecco un esempio di ElectricVehicleMobility in formato JSON-LD normalizzato. Questo è compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati di contesto di un'entità individuale. +
mostra/nascondi esempio + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Property", + "value": { + "@type": "Date", + "@value": "2025-12-15" + } + }, + "region": { + "type": "Property", + "value": "Outros - GDPR" + }, + "district": { + "type": "Property", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Property", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Property", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Property", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Property", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + }, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ + + + + + + + +Vedi [FAQ 10](https://smartdatamodels.org/index.php/faqs/) per ottenere una risposta su come gestire le unità di misura della grandezza + + + + +--- + +[Modelli di dati intelligenti](https://smartdatamodels.org) +++ [Manuale dei contributi](https://bit.ly/contribution_manual) + diff --git a/ElectricVehicleMobility/doc/spec_JA.md b/ElectricVehicleMobility/doc/spec_JA.md new file mode 100644 index 000000000..b8d9c4afb --- /dev/null +++ b/ElectricVehicleMobility/doc/spec_JA.md @@ -0,0 +1,700 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +エンティティ: ElectricVehicleMobility +=============================== + + + + + +[オープンレース](https://github.com/smart-data-models//dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md) + +[自動生成されたドキュメント](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) + + + + + +Global description: **場所、車両ブランド、地理的地域別に集約された電気自動車のモビリティパターンの日々の観察** + +version: 0.0.1 + + + + + + +## プロパティ一覧 + + +属性に型がない場合、複数の型や異なるフォーマット/パターンがあり得るためである +- `address[object]`: 郵送先住所 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: 国。例えば、スペイン . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: その通り住所がある地域であり、かつ当該地域内にある地方自治体 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: その地方のある地域、およびその地域がある国 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 地区とは、ある国において地方自治体によって管理される行政区分の一種である。 + - `postOfficeBoxNumber[string]`: 郵便受けの住所に使用する郵便箱番号（例：03578） . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 郵便番号。例：24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 番地 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 公道上の特定の物件を識別する番号 +- `alternateName[string]`: このアイテムの別名 +- `areaServed[string]`: サービスまたは提供品目の提供が行われる地理的エリア . Model: [https://schema.org/Text](https://schema.org/Text) +- `averageDistanceKm[number]`: 平均移動距離（キロメートル） . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: 調整されたデータエンティティのプロバイダー . Model: [https://schema.org/Text](https://schema.org/Text) +- `dateCreated[date-time]`: エンティティ作成タイムスタンプ。これは通常、ストレージ プラットフォームによって割り当てられる。 +- `dateModified[date-time]`: エンティティの最後の変更のタイムスタンプ。通常は、ストレージ プラットフォームによって割り当てられる。 +- `dateObserved[date]`: 観測日（YYYY-MM-DD） . Model: [https://schema.org/Date](https://schema.org/Date) +- `description[string]`: このアイテムの説明 +- `deviceBrand[string]`: 電気自動車のブランドまたはメーカー . Model: [https://schema.org/Text](https://schema.org/Text) +- `district[string]`: 観測が行われた地区 . Model: [https://schema.org/Text](https://schema.org/Text) +- `id[*]`: エンティティのユニーク識別子 +- `location[*]`: アイテムへのGeojsonリファレンス。Point、LineString、Polygon、MultiPoint、MultiLineStringまたはMultiPolygonになります。 +- `locationCode[string]`: 公式町村コード . Model: [https://schema.org/Text](https://schema.org/Text) +- `municipality[string]`: 観察が行われた自治体 . Model: [https://schema.org/Text](https://schema.org/Text) +- `n[number]`: 平均距離を計算するために使用される観測数 . Model: [https://schema.org/Number](https://schema.org/Number) +- `name[string]`: このアイテムの名前 +- `owner[array]`: 所有者（一人または複数）のユニークなIDを参照するJSONエンコードされた文字シーケンスを含むリスト +- `region[string]`: 観測が行われた地域 . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: アイテムに関する追加リソースへのURIのリスト +- `source[string]`: データの元の出典先のURL . Model: [https://schema.org/Text](https://schema.org/Text) +- `type[string]`: NGSIエンティティタイプ。 ElectricVehicleMobilityである必要があります。 +- `vehicleType[string]`: 電気自動車の種類 . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +必須プロパティ +- `id` +- `type` + + + + + + + + + +## プロパティのデータモデル記述 + +アルファベット順に並べ替え（詳細はクリック） + + + + +
YAMLの詳細全体 + +```yaml +ElectricVehicleMobility: + description: Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageDistanceKm: + description: Average distance traveled in kilometers + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: kilometers + dataProvider: + description: Provider of the harmonised data entity + type: string + x-ngsi: + model: https://schema.org/Text + 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 + dateObserved: + description: Date of the observation (YYYY-MM-DD) + format: date + type: string + x-ngsi: + model: https://schema.org/Date + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + deviceBrand: + description: Brand or manufacturer of the electric vehicle + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + district: + description: District where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + locationCode: + description: Official municipality code + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + municipality: + description: Municipality where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + n: + description: Number of observations used to calculate the average distance + minimum: 1 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + region: + description: Region where the observation was made + enum: + - CONTINENTE + - AÇORES + - MADEIRA + - Outros - GDPR + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + 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: Original source of the data as a URL + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + type: + description: NGSI entity type. It has to be ElectricVehicleMobility + enum: + - ElectricVehicleMobility + type: string + x-ngsi: + type: Property + vehicleType: + description: Type of electric vehicle + enum: + - BEV + - PHEV + - HEV + - FCEV + - unknown + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/schema.json + x-model-tags: transportation,electricVehicle,mobility,statistics + x-version: 0.0.1 +``` +
+ + + + + + + + + +## 例のペイロード + +#### 電気自動車モビリティ NGSI-v2 キー値の例 + +以下は、JSON-LD形式のElectricVehicleMobilityの例である。これは、`options=keyValues`を使用する場合にNGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返す。 +
表示/非表示例 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26 +} +``` +
+ +#### 電気自動車モビリティ NGSI-v2 正規化例 + +以下は、JSON-LD形式で正規化されたElectricVehicleMobilityの例である。これは、オプションを使用しない場合にNGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返す。 +
表示/非表示の例 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Date-Time", + "value": "2025-12-15" + }, + "region": { + "type": "Text", + "value": "Outros - GDPR" + }, + "district": { + "type": "Text", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Text", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Text", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Text", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Text", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + } +} +``` +
+ +#### 電気自動車モビリティ NGSI-LD キー値の例 + +以下は、JSON-LD形式のElectricVehicleMobilityの例である。これは、`options=keyValues`を使用する場合にNGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返す。 +
表示/非表示 例 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ +#### 電気自動車モビリティ NGSI-LD 正規化例 + +正規化されたJSON-LD形式のElectricVehicleMobilityの例を次に示す。これは、オプションを使用せず、個々のエンティティのコンテキストデータを返す場合のNGSI-LDと互換性がある。 +
表示/非表示例 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Property", + "value": { + "@type": "Date", + "@value": "2025-12-15" + } + }, + "region": { + "type": "Property", + "value": "Outros - GDPR" + }, + "district": { + "type": "Property", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Property", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Property", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Property", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Property", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + }, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ + + + + + + + +大きさの単位の扱い方については、[FAQ 10](https://smartdatamodels.org/index.php/faqs/) を参照してください。 + + + + +--- + +[スマートデータモデル](https://smartdatamodels.org) +++ [コントリビューション・マニュアル](https://bit.ly/contribution_manual) + diff --git a/ElectricVehicleMobility/doc/spec_KO.md b/ElectricVehicleMobility/doc/spec_KO.md new file mode 100644 index 000000000..0a3e7b33a --- /dev/null +++ b/ElectricVehicleMobility/doc/spec_KO.md @@ -0,0 +1,700 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +엔티티: ElectricVehicleMobility +=============================== + + + + + +[오픈 라이선스](https://github.com/smart-data-models//dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md) + +[자동으로 생성된 문서](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) + + + + + +Global description: **위치, 차량 브랜드 및 지리적 영역별로 집계된 전기 자동차 이동 패턴에 대한 일일 관찰** + +version: 0.0.1 + + + + + + +## 속성 목록 + + +[*] 속성에 유형이 없는 경우 여러 유형이 있거나 형식/패턴이 다를 수 있기 때문입니다. +- `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: 국가. 예를 들어, 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 시정촌 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 지방자치단체가 속한 지역 및 국가 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 지구 또는 행정구(地區)는 어떤 나라에서 지방 정부에 의해 관리되는 행정 구역의 한 유형이다. + - `postOfficeBoxNumber[string]`: 우편함 주소의 우편함 번호. 예를 들어, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 우편번호. 예를 들어, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 도로 주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 도로명주소 +- `alternateName[string]`: 이 항목의 다른 이름 +- `areaServed[string]`: 서비스나 제공 품목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) +- `averageDistanceKm[number]`: 평균 이동 거리(킬로미터) . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: 조화로운 데이터 엔티티 제공자 . Model: [https://schema.org/Text](https://schema.org/Text) +- `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이것은 일반적으로 스토리지 플랫폼에 의해 할당된다. +- `dateModified[date-time]`: 엔티티의 마지막 수정 시점 타임스탬프. 이것은 일반적으로 스토리지 플랫폼에 의해 할당된다. +- `dateObserved[date]`: 관측일 (YYYY-MM-DD) . Model: [https://schema.org/Date](https://schema.org/Date) +- `description[string]`: 이 항목에 대한 설명 +- `deviceBrand[string]`: 전기 자동차의 브랜드 또는 제조업체 . Model: [https://schema.org/Text](https://schema.org/Text) +- `district[string]`: 관측이 이루어진 구역 . Model: [https://schema.org/Text](https://schema.org/Text) +- `id[*]`: 엔티티의 고유 식별자 +- `location[*]`: 항목에 대한 GeoJSON 참조입니다. 포인트, 라인스트링, 폴리곤, 멀티포인트, 멀티라인스트링 또는 멀티폴리곤이 될 수 있습니다. +- `locationCode[string]`: 공식 시정촌 코드 . Model: [https://schema.org/Text](https://schema.org/Text) +- `municipality[string]`: 관찰이 이루어진 시정촌 . Model: [https://schema.org/Text](https://schema.org/Text) +- `n[number]`: 평균 거리를 계산하는 데 사용된 관측치 수 . Model: [https://schema.org/Number](https://schema.org/Number) +- `name[string]`: 이 항목의 이름 +- `owner[array]`: 소유자 고유 ID에 대한 참조로 구성된 JSON으로 인코딩된 일련의 문자가 포함된 목록 +- `region[string]`: 관찰이 이루어진 지역 . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: 항목에 대한 추가 리소스를 가리키는 uri 목록 +- `source[string]`: 데이터의 원본 출처 URL . Model: [https://schema.org/Text](https://schema.org/Text) +- `type[string]`: NGSI 엔티티 유형. ElectricVehicleMobility여야 합니다. +- `vehicleType[string]`: 전기 자동차 유형 . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +필수 속성 +- `id` +- `type` + + + + + + + + + +## 속성 데이터 모델 설명 + +가나다순으로 정렬 (자세한 내용은 클릭) + + + + +
전체 YAML 세부 정보 + +```yaml +ElectricVehicleMobility: + description: Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageDistanceKm: + description: Average distance traveled in kilometers + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: kilometers + dataProvider: + description: Provider of the harmonised data entity + type: string + x-ngsi: + model: https://schema.org/Text + 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 + dateObserved: + description: Date of the observation (YYYY-MM-DD) + format: date + type: string + x-ngsi: + model: https://schema.org/Date + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + deviceBrand: + description: Brand or manufacturer of the electric vehicle + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + district: + description: District where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + locationCode: + description: Official municipality code + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + municipality: + description: Municipality where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + n: + description: Number of observations used to calculate the average distance + minimum: 1 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + region: + description: Region where the observation was made + enum: + - CONTINENTE + - AÇORES + - MADEIRA + - Outros - GDPR + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + 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: Original source of the data as a URL + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + type: + description: NGSI entity type. It has to be ElectricVehicleMobility + enum: + - ElectricVehicleMobility + type: string + x-ngsi: + type: Property + vehicleType: + description: Type of electric vehicle + enum: + - BEV + - PHEV + - HEV + - FCEV + - unknown + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/schema.json + x-model-tags: transportation,electricVehicle,mobility,statistics + x-version: 0.0.1 +``` +
+ + + + + + + + + +## 예시 페이로드 + +#### 전기차모빌리티 NGSI-v2 키-값 예시 + +다음은 키-값으로 JSON-LD 형식의 ElectricVehicleMobility 예시입니다. 이것은 `options=keyValues`를 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
보기/숨기기 예시 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26 +} +``` +
+ +#### 전기차이동성 NGSI-v2 정규화 예시 + +다음은 JSON-LD 형식으로 정규화된 ElectricVehicleMobility의 예시입니다. 옵션을 사용하지 않을 경우 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
보기/숨기기 예시 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Date-Time", + "value": "2025-12-15" + }, + "region": { + "type": "Text", + "value": "Outros - GDPR" + }, + "district": { + "type": "Text", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Text", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Text", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Text", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Text", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + } +} +``` +
+ +#### 전기차모빌리티 NGSI-LD 키-값 예시 + +다음은 키-값으로 JSON-LD 형식의 ElectricVehicleMobility 예시입니다. 이것은 `options=keyValues`을 사용할 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
보기/숨기기 예시 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ +#### 전기 자동차 이동성 NGSI-LD 표준화 예시 + +다음은 JSON-LD 형식으로 정규화된 ElectricVehicleMobility의 예시입니다. 옵션을 사용하지 않을 경우 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
예시 보이기/숨기기 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Property", + "value": { + "@type": "Date", + "@value": "2025-12-15" + } + }, + "region": { + "type": "Property", + "value": "Outros - GDPR" + }, + "district": { + "type": "Property", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Property", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Property", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Property", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Property", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + }, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ + + + + + + + +크기 단위 처리에 대한 답변은 [FAQ 10](https://smartdatamodels.org/index.php/faqs/)를 참조하십시오. + + + + +--- + +[스마트 데이터 모델](https://smartdatamodels.org) +++ [기여 안내서](https://bit.ly/contribution_manual) + diff --git a/ElectricVehicleMobility/doc/spec_ZH.md b/ElectricVehicleMobility/doc/spec_ZH.md new file mode 100644 index 000000000..b88fef65f --- /dev/null +++ b/ElectricVehicleMobility/doc/spec_ZH.md @@ -0,0 +1,700 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +实体: ElectricVehicleMobility +=============================== + + + + + +[开放许可](https://github.com/smart-data-models//dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md) + +[自动生成的文档](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) + + + + + +Global description: **按位置、车辆品牌和地理区域汇总的电动汽车出行模式的日常观察。** + +version: 0.0.1 + + + + + + +## 财产清单 + + +[*] 属性中没有类型是因为它可能有多种类型或不同的格式/模式 +- `address[object]`: 邮寄地址 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: 国家。例如，西班牙 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 地点 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 行政區 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 区是一种行政区划，一些国家的区由地方政府管理。 + - `postOfficeBoxNumber[string]`: 邮政信箱地址的邮政信箱号码。例如，03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 邮政编码。例如：24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 街道地址 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 街道编号 +- `alternateName[string]`: 此条目的另一个名称 +- `areaServed[string]`: 提供服务或所提供项目的地理区域 . Model: [https://schema.org/Text](https://schema.org/Text) +- `averageDistanceKm[number]`: 平均旅行距离（公里） . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: 统一数据实体的提供者 . Model: [https://schema.org/Text](https://schema.org/Text) +- `dateCreated[date-time]`: 实体创建时间戳。通常由存储平台分配。 +- `dateModified[date-time]`: 实体上一次修改的时间戳。通常由存储平台分配。 +- `dateObserved[date]`: 观测日期（年-月-日） . Model: [https://schema.org/Date](https://schema.org/Date) +- `description[string]`: 该商品的描述 +- `deviceBrand[string]`: 电动车辆的品牌或制造商 . Model: [https://schema.org/Text](https://schema.org/Text) +- `district[string]`: 进行观测的地区 . Model: [https://schema.org/Text](https://schema.org/Text) +- `id[*]`: 实体的唯一标识符 +- `location[*]`: 与该项目相关的Geojson引用，可以是Point、LineString、Polygon、MultiPoint、MultiLineString或MultiPolygon。 +- `locationCode[string]`: 官方自治市代码 . Model: [https://schema.org/Text](https://schema.org/Text) +- `municipality[string]`: 进行观测的市区町村 . Model: [https://schema.org/Text](https://schema.org/Text) +- `n[number]`: 用于计算平均距离的观测值数量 . Model: [https://schema.org/Number](https://schema.org/Number) +- `name[string]`: 该物品的名称 +- `owner[array]`: 包含一个 JSON 编码的字符序列，引用所有者（owner(s)）的唯一标识符（Id(s)）的列表。 +- `region[string]`: 进行观测的区域 . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: 指向关于该项目其他资源的 URI 列表 +- `source[string]`: 数据来源的原始网址 . Model: [https://schema.org/Text](https://schema.org/Text) +- `type[string]`: NGSI 实体类型. 它必须是 ElectricVehicleMobility +- `vehicleType[string]`: 电动车辆类型 . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +必填属性 +- `id` +- `type` + + + + + + + + + +## 属性的数据模型描述 + +按字母顺序排列（点击了解详情） + + + + +
完整的yaml详情 + +```yaml +ElectricVehicleMobility: + description: Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageDistanceKm: + description: Average distance traveled in kilometers + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: kilometers + dataProvider: + description: Provider of the harmonised data entity + type: string + x-ngsi: + model: https://schema.org/Text + 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 + dateObserved: + description: Date of the observation (YYYY-MM-DD) + format: date + type: string + x-ngsi: + model: https://schema.org/Date + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + deviceBrand: + description: Brand or manufacturer of the electric vehicle + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + district: + description: District where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + locationCode: + description: Official municipality code + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + municipality: + description: Municipality where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + n: + description: Number of observations used to calculate the average distance + minimum: 1 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + region: + description: Region where the observation was made + enum: + - CONTINENTE + - AÇORES + - MADEIRA + - Outros - GDPR + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + 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: Original source of the data as a URL + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + type: + description: NGSI entity type. It has to be ElectricVehicleMobility + enum: + - ElectricVehicleMobility + type: string + x-ngsi: + type: Property + vehicleType: + description: Type of electric vehicle + enum: + - BEV + - PHEV + - HEV + - FCEV + - unknown + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/schema.json + x-model-tags: transportation,electricVehicle,mobility,statistics + x-version: 0.0.1 +``` +
+ + + + + + + + + +## 示例载荷 + +#### 電動車輛移動性NGSI-v2鍵值示例 + +以下是一个以JSON-LD格式表示的 ElectricVehicleMobility 示例，以键值对形式呈现。当使用 `options=keyValues` 时，它与 NGSI-v2 兼容，并返回单个实体的上下文数据。 +
显示/隐藏示例 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26 +} +``` +
+ +#### 电动车辆移动性 NGSI-v2 标准化示例 + +以下是一个归一化的JSON-LD格式的ElectricVehicleMobility示例。当不使用选项时，此示例与NGSI-v2兼容，并返回单个实体的上下文数据。 +
显示/隐藏示例 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Date-Time", + "value": "2025-12-15" + }, + "region": { + "type": "Text", + "value": "Outros - GDPR" + }, + "district": { + "type": "Text", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Text", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Text", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Text", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Text", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + } +} +``` +
+ +#### 电动车辆移动性 NGSI-LD 键值示例 + +以下是一个以JSON-LD格式表示的电动汽车出行的例子，以键值对形式呈现。当使用`options=keyValues`时，它与NGSI-LD兼容，并返回单个实体的上下文数据。 +
显示/隐藏示例 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ +#### 电动车辆移动性 NGSI-LD 标准化示例 + +以下是一个归一化的JSON-LD格式的ElectricVehicleMobility示例。当不使用选项时，此示例与NGSI-LD兼容，并返回单个实体的上下文数据。 +
显示/隐藏示例 + +```json + +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Property", + "value": { + "@type": "Date", + "@value": "2025-12-15" + } + }, + "region": { + "type": "Property", + "value": "Outros - GDPR" + }, + "district": { + "type": "Property", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Property", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Property", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Property", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Property", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + }, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} +``` +
+ + + + + + + + +参见[FAQ 10](https://smartdatamodels.org/index.php/faqs/)以获取有关如何处理量级单位的答案 + + + + +--- + +[智能数据模型](https://smartdatamodels.org) +++ [贡献指南](https://bit.ly/contribution_manual) + diff --git a/ElectricVehicleMobility/examples/example-normalized.json b/ElectricVehicleMobility/examples/example-normalized.json new file mode 100644 index 000000000..ba1e6efce --- /dev/null +++ b/ElectricVehicleMobility/examples/example-normalized.json @@ -0,0 +1,36 @@ +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Date-Time", + "value": "2025-12-15" + }, + "region": { + "type": "Text", + "value": "Outros - GDPR" + }, + "district": { + "type": "Text", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Text", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Text", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Text", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Text", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + } +} diff --git a/ElectricVehicleMobility/examples/example-normalized.json.csv b/ElectricVehicleMobility/examples/example-normalized.json.csv new file mode 100644 index 000000000..aee72955a --- /dev/null +++ b/ElectricVehicleMobility/examples/example-normalized.json.csv @@ -0,0 +1,2 @@ +"id_", "type_", "dateObserved__type_", "dateObserved__value_", "region__type_", "region__value_", "district__type_", "district__value_", "municipality__type_", "municipality__value_", "locationCode__type_", "locationCode__value_", "deviceBrand__type_", "deviceBrand__value_", "averageDistanceKm__type_", "averageDistanceKm__value_", "n__type_", "n__value_" +"urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", "ElectricVehicleMobility", "Date-Time", "2025-12-15", "Text", "Outros - GDPR", "Text", "Outros - GDPR", "Text", "Outros - GDPR", "Text", "Outros - GDPR", "Text", "Outros - GDPR", "Text", "", "Property", "26" \ No newline at end of file diff --git a/ElectricVehicleMobility/examples/example-normalized.jsonld b/ElectricVehicleMobility/examples/example-normalized.jsonld new file mode 100644 index 000000000..ceb105405 --- /dev/null +++ b/ElectricVehicleMobility/examples/example-normalized.jsonld @@ -0,0 +1,42 @@ +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": { + "type": "Property", + "value": { + "@type": "Date", + "@value": "2025-12-15" + } + }, + "region": { + "type": "Property", + "value": "Outros - GDPR" + }, + "district": { + "type": "Property", + "value": "Outros - GDPR" + }, + "municipality": { + "type": "Property", + "value": "Outros - GDPR" + }, + "locationCode": { + "type": "Property", + "value": "Outros - GDPR" + }, + "deviceBrand": { + "type": "Property", + "value": "Outros - GDPR" + }, + "averageDistanceKm": { + "type": "Property", + "value": "" + }, + "n": { + "type": "Property", + "value": 26 + }, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} diff --git a/ElectricVehicleMobility/examples/example-normalized.jsonld.csv b/ElectricVehicleMobility/examples/example-normalized.jsonld.csv new file mode 100644 index 000000000..53fb35f40 --- /dev/null +++ b/ElectricVehicleMobility/examples/example-normalized.jsonld.csv @@ -0,0 +1,2 @@ +"id_", "type_", "dateObserved__type_", "dateObserved__value__@type_", "dateObserved__value__@value_", "region__type_", "region__value_", "district__type_", "district__value_", "municipality__type_", "municipality__value_", "locationCode__type_", "locationCode__value_", "deviceBrand__type_", "deviceBrand__value_", "averageDistanceKm__type_", "averageDistanceKm__value_", "n__type_", "n__value_", "@context__0_" +"urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", "ElectricVehicleMobility", "Property", "Date", "2025-12-15", "Property", "Outros - GDPR", "Property", "Outros - GDPR", "Property", "Outros - GDPR", "Property", "Outros - GDPR", "Property", "Outros - GDPR", "Property", "", "Property", "26", "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" \ No newline at end of file diff --git a/ElectricVehicleMobility/examples/example.json b/ElectricVehicleMobility/examples/example.json new file mode 100644 index 000000000..0c08cb0cc --- /dev/null +++ b/ElectricVehicleMobility/examples/example.json @@ -0,0 +1,12 @@ +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26 +} diff --git a/ElectricVehicleMobility/examples/example.json.csv b/ElectricVehicleMobility/examples/example.json.csv new file mode 100644 index 000000000..29349f662 --- /dev/null +++ b/ElectricVehicleMobility/examples/example.json.csv @@ -0,0 +1,2 @@ +"id_", "type_", "dateObserved_", "region_", "district_", "municipality_", "locationCode_", "deviceBrand_", "averageDistanceKm_", "n_" +"urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", "ElectricVehicleMobility", "2025-12-15", "Outros - GDPR", "Outros - GDPR", "Outros - GDPR", "Outros - GDPR", "Outros - GDPR", "", "26" \ No newline at end of file diff --git a/ElectricVehicleMobility/examples/example.jsonld b/ElectricVehicleMobility/examples/example.jsonld new file mode 100644 index 000000000..4650109a8 --- /dev/null +++ b/ElectricVehicleMobility/examples/example.jsonld @@ -0,0 +1,15 @@ +{ + "id": "urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", + "type": "ElectricVehicleMobility", + "dateObserved": "2025-12-15", + "region": "Outros - GDPR", + "district": "Outros - GDPR", + "municipality": "Outros - GDPR", + "locationCode": "Outros - GDPR", + "deviceBrand": "Outros - GDPR", + "averageDistanceKm": "", + "n": 26, + "@context": [ + "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" + ] +} diff --git a/ElectricVehicleMobility/examples/example.jsonld.csv b/ElectricVehicleMobility/examples/example.jsonld.csv new file mode 100644 index 000000000..989af6f91 --- /dev/null +++ b/ElectricVehicleMobility/examples/example.jsonld.csv @@ -0,0 +1,2 @@ +"id_", "type_", "dateObserved_", "region_", "district_", "municipality_", "locationCode_", "deviceBrand_", "averageDistanceKm_", "n_", "@context__0_" +"urn:ngsi-ld:ElectricVehicleMobility:PT:OUTROS-GDPR:OUTROS-GDPR:20251215", "ElectricVehicleMobility", "2025-12-15", "Outros - GDPR", "Outros - GDPR", "Outros - GDPR", "Outros - GDPR", "Outros - GDPR", "", "26", "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" \ No newline at end of file diff --git a/ElectricVehicleMobility/model.yaml b/ElectricVehicleMobility/model.yaml new file mode 100644 index 000000000..fbba8ef59 --- /dev/null +++ b/ElectricVehicleMobility/model.yaml @@ -0,0 +1,436 @@ +ElectricVehicleMobility: + description: Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + 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 + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + averageDistanceKm: + description: Average distance traveled in kilometers + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: kilometers + dataProvider: + description: Provider of the harmonised data entity + type: string + x-ngsi: + model: https://schema.org/Text + 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 + dateObserved: + description: Date of the observation (YYYY-MM-DD) + format: date + type: string + x-ngsi: + model: https://schema.org/Date + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + deviceBrand: + description: Brand or manufacturer of the electric vehicle + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + district: + description: District where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + locationCode: + description: Official municipality code + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + municipality: + description: Municipality where the observation was made + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + n: + description: Number of observations used to calculate the average distance + minimum: 1 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + region: + description: Region where the observation was made + enum: + - CONTINENTE + - AÇORES + - MADEIRA + - Outros - GDPR + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + 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: Original source of the data as a URL + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + type: + description: NGSI entity type. It has to be ElectricVehicleMobility + enum: + - ElectricVehicleMobility + type: string + x-ngsi: + type: Property + vehicleType: + description: Type of electric vehicle + enum: + - BEV + - PHEV + - HEV + - FCEV + - unknown + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/schema.json + x-model-tags: transportation,electricVehicle,mobility,statistics + x-version: 0.0.1 \ No newline at end of file diff --git a/ElectricVehicleMobility/notes.yaml b/ElectricVehicleMobility/notes.yaml new file mode 100644 index 000000000..e09bc133e --- /dev/null +++ b/ElectricVehicleMobility/notes.yaml @@ -0,0 +1,7 @@ +notesHeader: + +notesMiddle: + +notesFooter: + +notesReadme: diff --git a/ElectricVehicleMobility/schema.json b/ElectricVehicleMobility/schema.json new file mode 100644 index 000000000..100035c35 --- /dev/null +++ b/ElectricVehicleMobility/schema.json @@ -0,0 +1,93 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$schemaVersion": "0.0.1", + "$id": "https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/schema.json", + "title": "Electric Vehicle Mobility", + "modelTags": "transportation,electricVehicle,mobility,statistics", + "description": "Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region.", + "type": "object", + "allOf": [ + { + "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/GSMA-Commons" + }, + { + "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/Location-Commons" + }, + { + "properties": { + "type": { + "type": "string", + "enum": [ + "ElectricVehicleMobility" + ], + "description": "Property. NGSI entity type. It has to be ElectricVehicleMobility" + }, + "dateObserved": { + "type": "string", + "format": "date", + "description": "Property. Date of the observation (YYYY-MM-DD). Model:'https://schema.org/Date'" + }, + "region": { + "type": "string", + "enum": [ + "CONTINENTE", + "AÇORES", + "MADEIRA", + "Outros - GDPR" + ], + "description": "Property. Region where the observation was made. Model:'https://schema.org/Text'" + }, + "district": { + "type": "string", + "description": "Property. District where the observation was made. Model:'https://schema.org/Text'" + }, + "municipality": { + "type": "string", + "description": "Property. Municipality where the observation was made. Model:'https://schema.org/Text'" + }, + "locationCode": { + "type": "string", + "description": "Property. Official municipality code. Model:'https://schema.org/Text'" + }, + "deviceBrand": { + "type": "string", + "description": "Property. Brand or manufacturer of the electric vehicle. Model:'https://schema.org/Text'" + }, + "averageDistanceKm": { + "type": + "number", + "minimum": 0, + "description": "Property. Average distance traveled in kilometers. Units:'kilometers'. Model:'https://schema.org/Number'" + }, + "n": { + "type": "integer", + "minimum": 1, + "description": "Property. Number of observations used to calculate the average distance. Model:'https://schema.org/Number'" + }, + "vehicleType": { + "type": "string", + "enum": [ + "BEV", + "PHEV", + "HEV", + "FCEV", + "unknown" + ], + "description": "Property. Type of electric vehicle. Model:'https://schema.org/Text'" + }, + "dataProvider": { + "type": "string", + "description": "Property. Provider of the harmonised data entity. Model:'https://schema.org/Text'" + }, + "source": { + "type": "string", + "description": "Property. Original source of the data as a URL. Model:'https://schema.org/Text'" + } + } + } + ], + "required": [ + "id", + "type" + ] +} diff --git a/ElectricVehicleMobility/schema.sql b/ElectricVehicleMobility/schema.sql new file mode 100644 index 000000000..137d6a53c --- /dev/null +++ b/ElectricVehicleMobility/schema.sql @@ -0,0 +1,31 @@ +/* (Beta) Export of data model ElectricVehicleMobility of the subject dataModel.Transportation +for a PostgreSQL database. Pending translation of enumerations and multityped attributes */ +CREATE TYPE region_type AS ENUM ('CONTINENTE', 'AÇORES', 'MADEIRA', 'Outros - GDPR'); +CREATE TYPE ElectricVehicleMobility_type AS ENUM ('ElectricVehicleMobility'); +CREATE TYPE vehicleType_type AS ENUM ('BEV', 'PHEV', 'HEV', 'FCEV', 'unknown'); + +CREATE TABLE ElectricVehicleMobility ( + address JSON, + alternateName TEXT, + areaServed TEXT, + averageDistanceKm NUMERIC, + dataProvider TEXT, + dateCreated TIMESTAMP, + dateModified TIMESTAMP, + dateObserved DATE, + description TEXT, + deviceBrand TEXT, + district TEXT, + id TEXT PRIMARY KEY, + location JSON, + locationCode TEXT, + municipality TEXT, + n NUMERIC, + name TEXT, + owner JSON, + region region_type, + seeAlso JSON, + source TEXT, + type ElectricVehicleMobility_type, + vehicleType vehicleType_type +); \ No newline at end of file diff --git a/ElectricVehicleMobility/schemaDTDL.json b/ElectricVehicleMobility/schemaDTDL.json new file mode 100644 index 000000000..98ab60498 --- /dev/null +++ b/ElectricVehicleMobility/schemaDTDL.json @@ -0,0 +1,280 @@ +{ + "@id": "dtmi:com:ngsi-ld:ElectricVehicleMobility;0", + "@type": "Interface", + "@context": "dtmi:dtdl:context;2", + "comment": "Electric Vehicle Mobility adapted to DTDL from smartdatamodels.org. Source: https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/ElectricVehicleMobility/schema.json", + "description": "Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region.", + "displayName": "ElectricVehicleMobility", + "contents": [ + { + "name": "alternateName", + "writable": true, + "displayName": "alternateName", + "@type": "Property", + "schema": "string", + "comment": "An alternative name for this item" + }, + { + "name": "areaServed", + "writable": true, + "displayName": "areaServed", + "@type": "Property", + "schema": "string", + "comment": "The geographic area where a service or offered item is provided" + }, + { + "name": "averageDistanceKm", + "writable": true, + "displayName": "averageDistanceKm", + "@type": "Property", + "schema": "long", + "comment": "Average distance traveled in kilometers" + }, + { + "name": "dataProvider", + "writable": true, + "displayName": "dataProvider", + "@type": "Property", + "schema": "string", + "comment": "Provider of the harmonised data entity" + }, + { + "name": "dateCreated", + "writable": true, + "displayName": "dateCreated", + "@type": "Property", + "schema": "dateTime", + "comment": "Entity creation timestamp. This will usually be allocated by the storage platform" + }, + { + "name": "dateModified", + "writable": true, + "displayName": "dateModified", + "@type": "Property", + "schema": "dateTime", + "comment": "Timestamp of the last modification of the entity. This will usually be allocated by the storage platform" + }, + { + "name": "dateObserved", + "writable": true, + "displayName": "dateObserved", + "@type": "Property", + "schema": "date", + "comment": "Date of the observation (YYYY-MM-DD)" + }, + { + "name": "description", + "writable": true, + "displayName": "description", + "@type": "Property", + "schema": "string", + "comment": "A description of this item" + }, + { + "name": "deviceBrand", + "writable": true, + "displayName": "deviceBrand", + "@type": "Property", + "schema": "string", + "comment": "Brand or manufacturer of the electric vehicle" + }, + { + "name": "district", + "writable": true, + "displayName": "district", + "@type": "Property", + "schema": "string", + "comment": "District where the observation was made" + }, + { + "name": "locationCode", + "writable": true, + "displayName": "locationCode", + "@type": "Property", + "schema": "string", + "comment": "Official municipality code" + }, + { + "name": "municipality", + "writable": true, + "displayName": "municipality", + "@type": "Property", + "schema": "string", + "comment": "Municipality where the observation was made" + }, + { + "name": "n", + "writable": true, + "displayName": "n", + "@type": "Property", + "schema": "long", + "comment": "Number of observations used to calculate the average distance" + }, + { + "name": "name", + "writable": true, + "displayName": "name", + "@type": "Property", + "schema": "string", + "comment": "The name of this item" + }, + { + "name": "seeAlso", + "writable": true, + "displayName": "seeAlso" + }, + { + "name": "source", + "writable": true, + "displayName": "source", + "@type": "Property", + "schema": "string", + "comment": "Original source of the data as a URL" + }, + { + "@type": "Telemetry", + "name": "owner", + "schema": { + "@type": "Array", + "elementSchema": "string" + }, + "comment": "A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s)", + "displayName": "owner" + }, + { + "@type": "object", + "name": "address", + "comment": "The mailing address", + "displayName": "address", + "fields": [ + { + "name": "addressCountry", + "schema": "string" + }, + { + "name": "addressLocality", + "schema": "string" + }, + { + "name": "addressRegion", + "schema": "string" + }, + { + "name": "district", + "schema": "string" + }, + { + "name": "postOfficeBoxNumber", + "schema": "string" + }, + { + "name": "postalCode", + "schema": "string" + }, + { + "name": "streetAddress", + "schema": "string" + }, + { + "name": "streetNr", + "schema": "string" + } + ] + }, + { + "@type": "Telemetry", + "name": "location_Point", + "schema": "point" + }, + { + "@type": "Telemetry", + "name": "location_LineString", + "schema": "lineString" + }, + { + "@type": "Telemetry", + "name": "location_Polygon", + "schema": "polygon" + }, + { + "@type": "Telemetry", + "name": "location_MultiPoint", + "schema": "multiPoint" + }, + { + "@type": "Telemetry", + "name": "location_MultiLineString", + "schema": "multiLineString" + }, + { + "@type": "Telemetry", + "name": "location_MultiPolygon", + "schema": "multiPolygon" + }, + { + "@type": "Telemetry", + "name": "region", + "schema": { + "@type": "Enum", + "valueSchema": "string", + "enumValues": [ + { + "name": "CONTINENTE", + "displayName": "CONTINENTE", + "enumValue": 1 + }, + { + "name": "A\u00c7ORES", + "displayName": "A\u00c7ORES", + "enumValue": 2 + }, + { + "name": "MADEIRA", + "displayName": "MADEIRA", + "enumValue": 3 + }, + { + "name": "Outros - GDPR", + "displayName": "Outros - GDPR", + "enumValue": 4 + } + ] + } + }, + { + "@type": "Telemetry", + "name": "vehicleType", + "schema": { + "@type": "Enum", + "valueSchema": "string", + "enumValues": [ + { + "name": "BEV", + "displayName": "BEV", + "enumValue": 1 + }, + { + "name": "PHEV", + "displayName": "PHEV", + "enumValue": 2 + }, + { + "name": "HEV", + "displayName": "HEV", + "enumValue": 3 + }, + { + "name": "FCEV", + "displayName": "FCEV", + "enumValue": 4 + }, + { + "name": "unknown", + "displayName": "unknown", + "enumValue": 5 + } + ] + } + } + ] +} \ No newline at end of file diff --git a/ElectricVehicleMobility/swagger.yaml b/ElectricVehicleMobility/swagger.yaml new file mode 100644 index 000000000..73d4e4368 --- /dev/null +++ b/ElectricVehicleMobility/swagger.yaml @@ -0,0 +1,52 @@ +--- +# Copyleft (c) 2022 Contributors to Smart Data Models initiative +# + + +components: + schemas: + ElectricVehicleMobility: + $ref: "https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/model.yaml#ElectricVehicleMobility" +info: + description: | + Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + title: ElectricVehicleMobility + version: "0.0.1" +openapi: "3.0.0" + +paths: + /ngsi-ld/v1/entities: + get: + description: "Retrieve a set of entities which matches a specific query from an NGSI-LD system" + parameters: + - + in: query + name: type + required: true + schema: + enum: + - ElectricVehicleMobility + type: string + responses: + ? "200" + : + content: + application/ld+json: + examples: + keyvalues: + summary: "Key-Values Pairs" + value: + - + $ref: "https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/examples/example.json" + normalized: + summary: "Normalized NGSI-LD" + value: + - + $ref: "https://smart-data-models.github.io/dataModel.Transportation/ElectricVehicleMobility/examples/example-normalized.jsonld" + description: OK + tags: + - ngsi-ld +tags: + - + description: "NGSI-LD Linked-data Format" + name: ngsi-ld \ No newline at end of file diff --git a/ItemFlowObserved/examples/example-normalized.json b/ItemFlowObserved/examples/example-normalized.json index 5b8fddaf4..1d77f988e 100644 --- a/ItemFlowObserved/examples/example-normalized.json +++ b/ItemFlowObserved/examples/example-normalized.json @@ -56,8 +56,8 @@ "value": "monoHull" }, "laneId": { - "type": "Boolean", - "value": true + "type": "Number", + "value": 1 }, "laneDirection": { "type": "Text", diff --git a/OriginDestinationFlow/ADOPTERS.yaml b/OriginDestinationFlow/ADOPTERS.yaml new file mode 100644 index 000000000..4284134fd --- /dev/null +++ b/OriginDestinationFlow/ADOPTERS.yaml @@ -0,0 +1,10 @@ +description: This is a compilation list of the current adopters of the data model [Data model] of the Subject [Subject]. All fields are non mandatory. More info at https://smart-data-models.github.io/data-models/templates/dataModel/CURRENT_ADOPTERS.yaml +currentAdopters: +- + adopter: + description: + mail: + organization: ubiwhere + project: + comments: + startDate: \ No newline at end of file diff --git a/OriginDestinationFlow/README.md b/OriginDestinationFlow/README.md new file mode 100644 index 000000000..df7a4458d --- /dev/null +++ b/OriginDestinationFlow/README.md @@ -0,0 +1,65 @@ +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) +# OriginDestinationFlow +Version: 0.0.1 + +## Description + +Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + +### Specification + +Link to the [interactive specification](https://swagger.lab.fiware.org/?url=https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/swagger.yaml) + +Link to the [specification](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/doc/spec.md) + +Enlace a la [Especificación en español](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/doc/spec_ES.md) + +Lien vers le [spécification en français](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/doc/spec_FR.md) + +Link zur [deutschen Spezifikation](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/doc/spec_DE.md) + +Link alla [specifica](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/doc/spec_IT.md) + +[仕様へのリンク](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/doc/spec_JA.md) + +[链接到规范](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/doc/spec_ZH.md) + +[사양 링크](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/doc/spec_KO.md) + +### Examples + +Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/examples/example.json) (keyvalues) for NGSI v2 + +Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/examples/example.jsonld) (keyvalues) for NGSI-LD + +Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/examples/example-normalized.json) (normalized) for NGSI-V2 + +Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/examples/example-normalized.jsonld) (normalized) for NGSI-LD + +Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/examples/example.json.csv) (keyvalues) for NGSI v2 in CSV format + +Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/examples/example.jsonld.csv) (keyvalues) for NGSI-LD in CSV format + +Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/examples/example-normalized.json.csv) (normalized) for NGSI-V2 in CSV format + +Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/examples/example-normalized.jsonld.csv) (normalized) for NGSI-LD in CSV format + +### Dynamic Examples generation + +Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/OriginDestinationFlow/schema.json&email=info@smartdatamodels.org) of NGSI-LD normalized payloads compliant with this data model. Refresh for new values + +Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator_keyvalues.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/OriginDestinationFlow/schema.json&email=info@smartdatamodels.org) of NGSI-LD keyvalues payloads compliant with this data model. Refresh for new values + +Link to the [Generator](https://smartdatamodels.org/extra/geojson_features_generator.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/OriginDestinationFlow/schema.json&email=info@smartdatamodels.org) of geojson feature format payloads compliant with this data model. Refresh for new values + +### PostgreSQL schema + +Link to the [PostgreSQL schema](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/schema.sql) of this data model + +### Contribution + + If you have any issue on this data model you can raise an [issue](https://github.com/smart-data-models/dataModel.Transportation/issues) or contribute with a [PR](https://github.com/smart-data-models/dataModel.Transportation/pulls) + + If you wish to develop your own data model you can start from [contribution manual](https://bit.ly/contribution_manual). Several services have been developed to help with: + - [Test data model repository](https://smartdatamodels.org/index.php/data-models-contribution-api/) including the schema and example payloads, etc + - [Generate PostgreSQL schema](https://smartdatamodels.org/index.php/sql-service/) to help create a table, create type, etc \ No newline at end of file diff --git a/OriginDestinationFlow/code/README.md b/OriginDestinationFlow/code/README.md new file mode 100644 index 000000000..1448fbf17 --- /dev/null +++ b/OriginDestinationFlow/code/README.md @@ -0,0 +1,14 @@ +# OriginDestinationFlow + +### List of code samples + + + + +[code_for_using_dataModel.Transportation_OriginDestinationFlow.py](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/code/code_for_using_dataModel.Transportation_OriginDestinationFlow.py) + + + + +### Contribution +You can raise an [issue](https://github.com/smart-data-models/dataModel.Transportation/issues) or submit your [PR](https://github.com/smart-data-models/dataModel.Transportation/pulls) on existing data models diff --git a/OriginDestinationFlow/code/code_for_using_dataModel.Transportation_OriginDestinationFlow.py b/OriginDestinationFlow/code/code_for_using_dataModel.Transportation_OriginDestinationFlow.py new file mode 100644 index 000000000..7ec7f8d0f --- /dev/null +++ b/OriginDestinationFlow/code/code_for_using_dataModel.Transportation_OriginDestinationFlow.py @@ -0,0 +1,61 @@ + +# # This code allows you to install a orion-ld broker in a linux system +# # The manuals are here https://github.com/FIWARE/context.Orion-LD/tree/develop/doc/manuals-ld +# +# # INSTALL NGSI LD broker (OrionLD) +# sudo docker pull mongo:3.6 +# sudo docker pull fiware/orion-ld +# sudo docker network create fiware_default +# sudo docker run -d --name=mongo-db --network=fiware_default --expose=27017 mongo:3.6 --bind_ip_all --smallfiles +# sudo docker run -d --name fiware-orionld -h orion --network=fiware_default -p 1026:1026 fiware/orion-ld -dbhost mongo-db +# +# # TO RELAUNCH (only if you have already installed a broker in the same machine) +# sudo docker stop fiware-orionld +# sudo docker rm fiware-orionld +# sudo docker stop mongo-db +# sudo docker rm mongo-db +# sudo docker network rm fiware_default +# +# # CHECK INSTANCES +# # Check the broker is running +# curl -X GET 'http://localhost:1026/version' +# +# # Check what entities are in the broker +# curl -X GET http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000 +# +# # now the python code you can use to insert some value in the context broker according to the data model +# +from pysmartdatamodels import pysmartdatamodels as sdm +import subprocess +serverUrl = "http://localhost:1026" # supposed that your broker is installed in localhost. Edit to match your configuration +dataModel = "OriginDestinationFlow" +subject = "dataModel.Transportation" +dateObserved = "2024-12-31T10:00:00.00Z" +attribute = "dateObserved" +value = dateObserved +# The next line creates the query for inserting this attribute in a NGSI-LD context broker if the attribute does not exist it creates it +print(sdm.update_broker(dataModel, subject, attribute, value, serverUrl=serverUrl, updateThenCreate=True)) + +aggregationDateType = "hourly" +attribute = "aggregationDateType" +value = aggregationDateType +# The next line creates the query for inserting this attribute in a NGSI-LD context broker if the attribute does not exist it creates it +print(sdm.update_broker(dataModel, subject, attribute, value, serverUrl=serverUrl, updateThenCreate=True)) + +hour = 10 +attribute = "hour" +value = hour +# The next line creates the query for inserting this attribute in a NGSI-LD context broker if the attribute does not exist it creates it +print(sdm.update_broker(dataModel, subject, attribute, value, serverUrl=serverUrl, updateThenCreate=True)) + +originLocationCode = "0602" +attribute = "originLocationCode" +value = originLocationCode +# The next line creates the query for inserting this attribute in a NGSI-LD context broker if the attribute does not exist it creates it +print(sdm.update_broker(dataModel, subject, attribute, value, serverUrl=serverUrl, updateThenCreate=True)) + +print(" In case you have installed the orion-ld broker (see comments on the header of this program)") +print(" Execute this instruction to check that the entities has been inserted") +command = ['curl', '-X', 'GET', 'http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000'] +result = subprocess.run(command, capture_output=True, text=True) +print(result.stdout) diff --git a/OriginDestinationFlow/doc/spec.md b/OriginDestinationFlow/doc/spec.md new file mode 100644 index 000000000..b9df52fd2 --- /dev/null +++ b/OriginDestinationFlow/doc/spec.md @@ -0,0 +1,1158 @@ + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + Entity: OriginDestinationFlow +============================= + + [Open License](https://github.com/smart-data-models//dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md) + [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) + + + Global description: **Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour.** + version: 0.0.1 + + + + ## List of properties + + [*] If there is not a type in an attribute is because it could have several types or different formats/patterns +- `address[object]`: The mailing address . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: The country. For example, Spain . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: The locality in which the street address is, and which is in the region . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: The region in which the locality is, and which is in the country . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: A district is a type of administrative division that, in some countries, is managed by the local government + - `postOfficeBoxNumber[string]`: The post office box number for PO box addresses. For example, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: The postal code. For example, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: The street address . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Number identifying a specific property on a public street +- `aggregationDateType[string]`: Type of date aggregation (e.g., hourly, daily, monthly) - `alternateName[string]`: An alternative name for this item - `areaServed[string]`: The geographic area where a service or offered item is provided . Model: [https://schema.org/Text](https://schema.org/Text) - `countryCode[string]`: Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc... - `dataProvider[string]`: A sequence of characters identifying the provider of the harmonised data entity - `dateCreated[date-time]`: Entity creation timestamp. This will usually be allocated by the storage platform - `dateModified[date-time]`: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform - `dateObserved[date-time]`: Date and time of the observation in ISO 8601 format . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: A description of this item - `destinationLocation[*]`: Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon - `destinationLocationCode[string]`: Official code of the destination municipality . Model: [https://schema.org/Text](https://schema.org/Text) - `destinationLocationName[string]`: Name of the destination municipality . Model: [https://schema.org/Text](https://schema.org/Text) - `flowCount[number]`: Total number of movements/flows between origin and destination during this hour . Model: [https://schema.org/Number](https://schema.org/Number) - `flowType[string]`: Type of flow. Enum:'tourism, commuting, business, migration, mixed' . Model: [https://schema.org/Text](https://schema.org/Text) - `hour[number]`: Hour of the day (0-23) for this observation . Model: [https://schema.org/Number](https://schema.org/Number) - `id[*]`: Unique identifier of the entity - `location[*]`: Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon - `name[string]`: The name of this item - `nationality[string]`: Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE) . Model: [https://schema.org/Text](https://schema.org/Text) - `nationalityName[string]`: Full name of the nationality country (optional, for human readability) . Model: [https://schema.org/Text](https://schema.org/Text) - `originLocation[*]`: Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon - `originLocationCode[string]`: Official code of the origin municipality . Model: [https://schema.org/Text](https://schema.org/Text) - `originLocationName[string]`: Name of the origin municipality . Model: [https://schema.org/Text](https://schema.org/Text) - `owner[array]`: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) - `seeAlso[*]`: list of uri pointing to additional resources about the item - `source[string]`: 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]`: NGSI entity type. It has to be OriginDestinationFlow + + Required properties +- `id` - `type` + + + + ## Data Model description of properties + Sorted alphabetically (click for details) + + +
full yaml details + ```yaml +OriginDestinationFlow: + description: Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + 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 + aggregationDateType: + description: Type of date aggregation (e.g., hourly, daily, monthly) + type: string + x-ngsi: + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + 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 + countryCode: + description: Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc... + type: string + x-ngsi: + 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 + dateObserved: + description: Date and time of the observation in ISO 8601 format + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + destinationLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + destinationLocationCode: + description: Official code of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + destinationLocationName: + description: Name of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + flowCount: + description: Total number of movements/flows between origin and destination during this hour + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: movements + flowType: + description: Type of flow. Enum:'tourism, commuting, business, migration, mixed' + enum: + - tourism + - commuting + - business + - migration + - mixed + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + hour: + description: Hour of the day (0-23) for this observation + maximum: 23 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + nationality: + description: Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE) + pattern: ^[A-Z]{2}$ + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + nationalityName: + description: Full name of the nationality country (optional, for human readability) + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + originLocationCode: + description: Official code of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocationName: + description: Name of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI entity type. It has to be OriginDestinationFlow + enum: + - OriginDestinationFlow + type: string + x-ngsi: + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/schema.json + x-model-tags: '' + x-version: 0.0.1 +``` +
+ + + + + ## Example payloads + #### OriginDestinationFlow NGSI-v2 key-values Example + Here is an example of a OriginDestinationFlow in JSON format as key-values. This is compatible with NGSI-v2 when using `options=keyValues` and returns the context data of an individual entity. +
show/hide example + ```json + { + "id": "OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:30:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "CO0101", + "originLocationName": "Coimbra", + "destinationLocationCode": "CO0102", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z" +} +``` +
+ #### OriginDestinationFlow NGSI-v2 normalized Example + Here is an example of a OriginDestinationFlow in JSON format as normalized. This is compatible with NGSI-v2 when not using options and returns the context data of an individual entity. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "DateTime", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Text", + "value": "hourly" + }, + "hour": { + "type": "Number", + "value": 10 + }, + "originLocationCode": { + "type": "Text", + "value": "CO0101" + }, + "originLocationName": { + "type": "Text", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Text", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Text", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Text", + "value": "DE" + }, + "nationalityName": { + "type": "Text", + "value": "Germany" + }, + "flowCount": { + "type": "Number", + "value": 145 + }, + "flowType": { + "type": "Text", + "value": "tourism" + }, + "countryCode": { + "type": "Text", + "value": "PT" + }, + "originLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Text", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Text", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + } +} +``` +
+ #### OriginDestinationFlow NGSI-LD key-values Example + Here is an example of a OriginDestinationFlow in JSON-LD format as key-values. This is compatible with NGSI-LD when using `options=keyValues` and returns the context data of an individual entity. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:0602:0406:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:00:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "0602", + "originLocationName": "Coimbra", + "destinationLocationCode": "0406", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z", + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ #### OriginDestinationFlow NGSI-LD normalized Example + Here is an example of a OriginDestinationFlow in JSON-LD format as normalized. This is compatible with NGSI-LD when not using options and returns the context data of an individual entity. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "Property", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Property", + "value": "hourly" + }, + "hour": { + "type": "Property", + "value": 10 + }, + "originLocationCode": { + "type": "Property", + "value": "CO0101" + }, + "originLocationName": { + "type": "Property", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Property", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Property", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Property", + "value": "DE" + }, + "nationalityName": { + "type": "Property", + "value": "Germany" + }, + "flowCount": { + "type": "Property", + "value": 145 + }, + "flowType": { + "type": "Property", + "value": "tourism" + }, + "countryCode": { + "type": "Property", + "value": "PT" + }, + "originLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Property", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Property", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ + + + See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) diff --git a/OriginDestinationFlow/doc/spec_DE.md b/OriginDestinationFlow/doc/spec_DE.md new file mode 100644 index 000000000..2ef061397 --- /dev/null +++ b/OriginDestinationFlow/doc/spec_DE.md @@ -0,0 +1,1245 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entität: OriginDestinationFlow +============================= + + + + + +[Offene Lizenz](https://github.com/smart-data-models//dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md) + +[Dokument automatisch generiert](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) + + + + + +Global description: **Stündliche Beobachtung der Bewegungsflüsse von Besuchern zwischen Herkunfts- und Zielgemeinden, aufgeschlüsselt nach Nationalität. Jede Entität stellt die Flusszahl zwischen zwei Orten während eines bestimmten Stundenintervalls dar.** + +version: 0.0.1 + + + + + + +## Liste der Eigenschaften + + +[*] Wenn es in einem Attribut keinen Typ gibt, liegt das daran, dass es mehrere Typen oder unterschiedliche Formate/Muster haben kann +- `address[object]`: Die Postadresse . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: Das Land. Zum Beispiel Spanien . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: Die Ortschaft, in der die Straßenadresse ist und die in der Region liegt . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: Die Region, in der die Ortschaft liegt und die im Land liegt . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Ein Bezirk ist eine Art von Verwaltungseinheit, die in einigen Ländern von der lokalen Regierung verwaltet wird + - `postOfficeBoxNumber[string]`: Die Postfachnummer für Postfachadressen. Zum Beispiel 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Die Postleitzahl. Zum Beispiel 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: Die Straßenadresse . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Hausnummer, die eine bestimmte Liegenschaft auf einer öffentlichen Straße identifiziert +- `aggregationDateType[string]`: Art der Datum-Aggregation (z. B. stündlich, täglich, monatlich) +- `alternateName[string]`: Ein alternativer Name für diesen Artikel +- `areaServed[string]`: Das geografische Gebiet, in dem ein Dienst oder ein angebotenes Produkt bereitgestellt wird . Model: [https://schema.org/Text](https://schema.org/Text) +- `countryCode[string]`: Ursprungslandcode, der den Personen zugeordnet ist, die mit dem Datenfluss in Verbindung stehen, z. B. ES, IT, FR usw. +- `dataProvider[string]`: Eine Folge von Zeichen, die den Anbieter der harmonisierten Datenentität identifiziert +- `dateCreated[date-time]`: Zeitstempel für die Erstellung der Entität. Dieser wird in der Regel von der Speicherplattform zugewiesen +- `dateModified[date-time]`: Zeitstempel der letzten Änderung der Entität. Dieser wird in der Regel von der Speicherplattform zugewiesen +- `dateObserved[date-time]`: Datum und Uhrzeit der Beobachtung im ISO-8601-Format . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `description[string]`: Eine Beschreibung dieses Artikels +- `destinationLocation[*]`: Geojson-Referenz zum Artikel. Es kann Punkt, Linienzug, Polygon, MultiPunkt, MultiLinienzug oder MultiPolygon sein +- `destinationLocationCode[string]`: Offizieller Code der Zielgemeinde . Model: [https://schema.org/Text](https://schema.org/Text) +- `destinationLocationName[string]`: Name der Zielgemeinde . Model: [https://schema.org/Text](https://schema.org/Text) +- `flowCount[number]`: Gesamtzahl der Bewegungen/Flüsse zwischen Ursprung und Ziel während dieser Stunde . Model: [https://schema.org/Number](https://schema.org/Number) +- `flowType[string]`: Art des Flusses. Enum: 'Tourismus, Pendeln, Geschäft, Migration, gemischt' . Model: [https://schema.org/Text](https://schema.org/Text) +- `hour[number]`: Stunde des Tages (0-23) für diese Beobachtung . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: Eindeutiger Identifikator der Entität +- `location[*]`: Geojson-Verweis auf das Element. Es kann Punkt, Linienzug, Polygon, MultiPunkt, MultiLinienzug oder MultiPolygon sein +- `name[string]`: Der Name dieses Artikels +- `nationality[string]`: Staatsangehörigkeit der Besucher, die die Bewegung ausführen. ISO-3166-1-Alpha-2-Ländercode (z. B. ES, FR, GB, PT, DE) . Model: [https://schema.org/Text](https://schema.org/Text) +- `nationalityName[string]`: Vollständiger Name des Nationalitätslandes (optional, für bessere Lesbarkeit) . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocation[*]`: Geojson-Referenz zum Artikel. Es kann Punkt, Linienzug, Polygon, MultiPunkt, MultiLinienzug oder MultiPolygon sein +- `originLocationCode[string]`: Offizieller Code der Ursprungsgemeinde . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocationName[string]`: Name der Ursprungsgemeinde . Model: [https://schema.org/Text](https://schema.org/Text) +- `owner[array]`: Eine Liste, die eine JSON-kodierte Zeichenfolge enthält, die auf die eindeutigen IDs des/die Eigentümer(s) verweist +- `seeAlso[*]`: Liste von URIs, die auf zusätzliche Ressourcen über das Element verweisen +- `source[string]`: Eine Folge von Zeichen, die die ursprüngliche Quelle der Entitätsdaten als URL angibt. Es wird empfohlen, den voll qualifizierten Domänennamen des Quellanbieters oder die URL zum Quellobjekt zu verwenden. +- `type[string]`: NGSI-Entitätentyp. Es muss OriginDestinationFlow sein + + + + + +Erforderliche Eigenschaften +- `id` +- `Typ` + + + + + + + + + +## Datenmodellbeschreibung von Eigenschaften + +Sortiert alphabetisch (Klicken für Details) + + + + +
full yaml details + +```yaml +OriginDestinationFlow: + description: Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + 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 + aggregationDateType: + description: Type of date aggregation (e.g., hourly, daily, monthly) + type: string + x-ngsi: + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + 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 + countryCode: + description: Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc... + type: string + x-ngsi: + 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 + dateObserved: + description: Date and time of the observation in ISO 8601 format + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + destinationLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + destinationLocationCode: + description: Official code of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + destinationLocationName: + description: Name of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + flowCount: + description: Total number of movements/flows between origin and destination during this hour + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: movements + flowType: + description: Type of flow. Enum:'tourism, commuting, business, migration, mixed' + enum: + - tourism + - commuting + - business + - migration + - mixed + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + hour: + description: Hour of the day (0-23) for this observation + maximum: 23 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + nationality: + description: Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE) + pattern: ^[A-Z]{2}$ + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + nationalityName: + description: Full name of the nationality country (optional, for human readability) + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + originLocationCode: + description: Official code of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocationName: + description: Name of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI entity type. It has to be OriginDestinationFlow + enum: + - OriginDestinationFlow + type: string + x-ngsi: + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/schema.json + x-model-tags: '' + x-version: 0.0.1 +``` +
+ + + + + + + + + +## Beispielnutzlasten + +#### UrsprungZielFluss NGSI-v2 Schlüsselwerte Beispiel + +Hier ist ein Beispiel für einen OriginDestinationFlow im JSON-Format als Schlüssel-Werte. Dies ist kompatibel mit NGSI-v2, wenn `options=keyValues` verwendet wird und die Kontextdaten einer einzelnen Entität zurückgibt. +
show/hide example + +```json + +{ + "id": "OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:30:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "CO0101", + "originLocationName": "Coimbra", + "destinationLocationCode": "CO0102", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z" +} +``` +
+ +#### UrsprungZielFluss NGSI-v2 normalisiertes Beispiel + +Hier ist ein Beispiel für einen OriginDestinationFlow im JSON-Format als normalisiert. Dies ist kompatibel mit NGSI-v2, wenn keine Optionen verwendet werden und gibt die Kontextdaten einer einzelnen Entität zurück. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "DateTime", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Text", + "value": "hourly" + }, + "hour": { + "type": "Number", + "value": 10 + }, + "originLocationCode": { + "type": "Text", + "value": "CO0101" + }, + "originLocationName": { + "type": "Text", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Text", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Text", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Text", + "value": "DE" + }, + "nationalityName": { + "type": "Text", + "value": "Germany" + }, + "flowCount": { + "type": "Number", + "value": 145 + }, + "flowType": { + "type": "Text", + "value": "tourism" + }, + "countryCode": { + "type": "Text", + "value": "PT" + }, + "originLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Text", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Text", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + } +} +``` +
+ +#### UrsprungZielFluss NGSI-LD Schlüsselwert Beispiel + +Hier ist ein Beispiel für einen OriginDestinationFlow im JSON-LD-Format als Schlüssel-Werte. Dies ist kompatibel mit NGSI-LD, wenn `options=keyValues` verwendet wird und die Kontextdaten einer einzelnen Entität zurückgibt. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:0602:0406:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:00:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "0602", + "originLocationName": "Coimbra", + "destinationLocationCode": "0406", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z", + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ +#### UrsprungZielFluss NGSI-LD normalisiertes Beispiel + +Hier ist ein Beispiel für einen OriginDestinationFlow im JSON-LD-Format als normalisiert. Dies ist kompatibel mit NGSI-LD, wenn keine Optionen verwendet werden und gibt die Kontextdaten einer einzelnen Entität zurück. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "Property", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Property", + "value": "hourly" + }, + "hour": { + "type": "Property", + "value": 10 + }, + "originLocationCode": { + "type": "Property", + "value": "CO0101" + }, + "originLocationName": { + "type": "Property", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Property", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Property", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Property", + "value": "DE" + }, + "nationalityName": { + "type": "Property", + "value": "Germany" + }, + "flowCount": { + "type": "Property", + "value": 145 + }, + "flowType": { + "type": "Property", + "value": "tourism" + }, + "countryCode": { + "type": "Property", + "value": "PT" + }, + "originLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Property", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Property", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/OriginDestinationFlow/doc/spec_ES.md b/OriginDestinationFlow/doc/spec_ES.md new file mode 100644 index 000000000..0191bfa02 --- /dev/null +++ b/OriginDestinationFlow/doc/spec_ES.md @@ -0,0 +1,1245 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entidad: OriginDestinationFlow +============================= + + + + + +[Licencia Abierta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md) + +[documento generado automáticamente](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) + + + + + +Global description: **Observación horaria de los flujos de movimiento de visitantes entre municipios de origen y destino, segmentados por nacionalidad. Cada entidad representa el recuento de flujo entre dos ubicaciones durante una hora específica.** + +version: 0.0.1 + + + + + + +## Lista de propiedades + + +[*] Si no hay un tipo en un atributo es porque podría tener varios tipos o diferentes formatos/patrones +- `address[object]`: La dirección de correo . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: El país. Por ejemplo, España . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La localidad en la que está la dirección de la calle, y que está en la región . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La región en la que se encuentra la localidad, y que se encuentra en el país . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un distrito es un tipo de división administrativa que, en algunos países, es gestionado por el gobierno local + - `postOfficeBoxNumber[string]`: El número de casilla de correos para las direcciones de casilla de correos. Por ejemplo, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: El código postal. Por ejemplo, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: La dirección de la calle . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Número que identifica una propiedad específica en una calle pública +- `aggregationDateType[string]`: Tipo de agregación de fecha (p. ej., por hora, diaria, mensual) +- `alternateName[string]`: Un nombre alternativo para este artículo +- `areaServed[string]`: El área geográfica donde se proporciona un servicio o artículo ofrecido . Model: [https://schema.org/Text](https://schema.org/Text) +- `countryCode[string]`: Código de país de origen asociado a las personas asociadas al flujo, por ejemplo, ES, IT, FR, etc... +- `dataProvider[string]`: Una secuencia de caracteres que identifica al proveedor de la entidad de datos armonizados +- `dateCreated[date-time]`: Marca de tiempo de creación de la entidad. Esto generalmente será asignado por la plataforma de almacenamiento +- `dateModified[date-time]`: Marca de tiempo de la última modificación de la entidad. Esto generalmente será asignado por la plataforma de almacenamiento +- `dateObserved[date-time]`: Fecha y hora de la observación en formato ISO 8601 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `description[string]`: Una descripción de este artículo +- `destinationLocation[*]`: Referencia Geojson al elemento. Puede ser Punto, LineaString, Polígono, MultiPunto, MultiLineaString o MultiPolígono +- `destinationLocationCode[string]`: Código oficial del municipio de destino . Model: [https://schema.org/Text](https://schema.org/Text) +- `destinationLocationName[string]`: Nombre del municipio de destino . Model: [https://schema.org/Text](https://schema.org/Text) +- `flowCount[number]`: Número total de movimientos/flujos entre el origen y el destino durante esta hora . Model: [https://schema.org/Number](https://schema.org/Number) +- `flowType[string]`: Tipo de flujo. Enum: 'turismo, desplazamiento, negocio, migración, mixto' . Model: [https://schema.org/Text](https://schema.org/Text) +- `hour[number]`: Hora del día (0-23) para esta observación . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: Identificador único de la entidad +- `location[*]`: Referencia Geojson al elemento. Puede ser Punto, LineaString, Polígono, MultiPunto, MultiLineaString o MultiPolígono +- `name[string]`: El nombre de este artículo +- `nationality[string]`: Nacionalidad de los visitantes que realizan el movimiento. Código de país alpha-2 ISO 3166-1 (por ejemplo, ES, FR, GB, PT, DE) . Model: [https://schema.org/Text](https://schema.org/Text) +- `nationalityName[string]`: Nombre completo de la nacionalidad del país (opcional, para legibilidad humana) . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocation[*]`: Referencia Geojson del elemento. Puede ser Punto, LineaString, Polígono, MultiPunto, MultiLineaString o MultiPolígono +- `originLocationCode[string]`: Código oficial del municipio de origen . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocationName[string]`: Nombre del municipio de origen . Model: [https://schema.org/Text](https://schema.org/Text) +- `owner[array]`: Una lista que contiene una secuencia de caracteres codificada en JSON que hace referencia a los Ids únicos del(los) propietario(s) +- `seeAlso[*]`: Lista de uri que apuntan a recursos adicionales sobre el artículo +- `source[string]`: Una secuencia de caracteres que proporciona la fuente original de los datos de la entidad como una URL. Se recomienda que sea el nombre de dominio completamente calificado del proveedor de la fuente, o la URL del objeto de la fuente. +- `type[string]`: Tipo de entidad NGSI. Tiene que ser OriginDestinationFlow + + + + + +Propiedades requeridas +- `id` +- `tipo` + + + + + + + + + +## Descripción del modelo de datos de propiedades + +Ordenado alfabéticamente (haga clic para detalles) + + + + +
full yaml details + +```yaml +OriginDestinationFlow: + description: Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + 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 + aggregationDateType: + description: Type of date aggregation (e.g., hourly, daily, monthly) + type: string + x-ngsi: + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + 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 + countryCode: + description: Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc... + type: string + x-ngsi: + 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 + dateObserved: + description: Date and time of the observation in ISO 8601 format + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + destinationLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + destinationLocationCode: + description: Official code of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + destinationLocationName: + description: Name of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + flowCount: + description: Total number of movements/flows between origin and destination during this hour + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: movements + flowType: + description: Type of flow. Enum:'tourism, commuting, business, migration, mixed' + enum: + - tourism + - commuting + - business + - migration + - mixed + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + hour: + description: Hour of the day (0-23) for this observation + maximum: 23 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + nationality: + description: Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE) + pattern: ^[A-Z]{2}$ + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + nationalityName: + description: Full name of the nationality country (optional, for human readability) + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + originLocationCode: + description: Official code of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocationName: + description: Name of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI entity type. It has to be OriginDestinationFlow + enum: + - OriginDestinationFlow + type: string + x-ngsi: + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/schema.json + x-model-tags: '' + x-version: 0.0.1 +``` +
+ + + + + + + + + +## Cargas de ejemplo + +#### OrigenDestinoFlujo clave-valor Ejemplo NGSI-v2 + +Aquí hay un ejemplo de un OriginDestinationFlow en formato JSON como clave-valor. Esto es compatible con NGSI-v2 cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. +
show/hide example + +```json + +{ + "id": "OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:30:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "CO0101", + "originLocationName": "Coimbra", + "destinationLocationCode": "CO0102", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z" +} +``` +
+ +#### OrigenDestinoFlujo NGSI-v2 normalizado Ejemplo + +Aquí hay un ejemplo de un OriginDestinationFlow en formato JSON normalizado. Esto es compatible con NGSI-v2 cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "DateTime", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Text", + "value": "hourly" + }, + "hour": { + "type": "Number", + "value": 10 + }, + "originLocationCode": { + "type": "Text", + "value": "CO0101" + }, + "originLocationName": { + "type": "Text", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Text", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Text", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Text", + "value": "DE" + }, + "nationalityName": { + "type": "Text", + "value": "Germany" + }, + "flowCount": { + "type": "Number", + "value": 145 + }, + "flowType": { + "type": "Text", + "value": "tourism" + }, + "countryCode": { + "type": "Text", + "value": "PT" + }, + "originLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Text", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Text", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + } +} +``` +
+ +#### OrigenDestinoFlujo clave-valor de ejemplo NGSI-LD + +Aquí hay un ejemplo de un OriginDestinationFlow en formato JSON-LD como clave-valor. Esto es compatible con NGSI-LD cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:0602:0406:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:00:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "0602", + "originLocationName": "Coimbra", + "destinationLocationCode": "0406", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z", + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ +#### OrigenDestinoFlujo ejemplo normalizado NGSI-LD + +Aquí hay un ejemplo de un OriginDestinationFlow en formato JSON-LD normalizado. Esto es compatible con NGSI-LD cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "Property", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Property", + "value": "hourly" + }, + "hour": { + "type": "Property", + "value": 10 + }, + "originLocationCode": { + "type": "Property", + "value": "CO0101" + }, + "originLocationName": { + "type": "Property", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Property", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Property", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Property", + "value": "DE" + }, + "nationalityName": { + "type": "Property", + "value": "Germany" + }, + "flowCount": { + "type": "Property", + "value": 145 + }, + "flowType": { + "type": "Property", + "value": "tourism" + }, + "countryCode": { + "type": "Property", + "value": "PT" + }, + "originLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Property", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Property", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/OriginDestinationFlow/doc/spec_FR.md b/OriginDestinationFlow/doc/spec_FR.md new file mode 100644 index 000000000..b0eef2a5c --- /dev/null +++ b/OriginDestinationFlow/doc/spec_FR.md @@ -0,0 +1,1245 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entité: OriginDestinationFlow +============================= + + + + + +[Licence ouverte](https://github.com/smart-data-models//dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md) + +[document généré automatiquement](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) + + + + + +Global description: **Observation horaire des flux de déplacement des visiteurs entre les communes d'origine et de destination, segmentés par nationalité. Chaque entité représente le nombre de flux entre deux emplacements pendant une heure spécifique.** + +version: 0.0.1 + + + + + + +## Liste des propriétés + + +[*] Si il n'y a pas de type dans un attribut, c'est parce qu'il pourrait avoir plusieurs types ou différents formats/modes. +- `address[object]`: L'adresse postale . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: Le pays. Par exemple, l'Espagne . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La localité dans laquelle se trouve l'adresse de la rue, et qui se trouve dans la région . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La région dans laquelle se trouve la localité, et qui se trouve dans le pays . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un district est un type de division administrative qui, dans certains pays, est géré par le gouvernement local + - `postOfficeBoxNumber[string]`: Le numéro de boîte postale pour les adresses de boîte postale. Par exemple, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Le code postal. Par exemple, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: L'adresse de la rue . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Numéro identifiant une propriété spécifique sur une rue publique +- `aggregationDateType[string]`: Type d'agrégation de date (par exemple, horaire, quotidien, mensuel) +- `alternateName[string]`: Un nom alternatif pour cet article +- `areaServed[string]`: La zone géographique où un service ou un article offert est fourni . Model: [https://schema.org/Text](https://schema.org/Text) +- `countryCode[string]`: Code pays d'origine associé aux personnes associées au flux, par exemple ES, IT, FR, etc... +- `dataProvider[string]`: Une séquence de caractères identifiant le fournisseur de l'entité de données harmonisées +- `dateCreated[date-time]`: Horodatage de création d'entité. Ceci sera généralement alloué par la plateforme de stockage +- `dateModified[date-time]`: Horodatage de la dernière modification de l'entité. Ceci sera généralement alloué par la plateforme de stockage +- `dateObserved[date-time]`: Date et heure de l'observation au format ISO 8601 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `description[string]`: Une description de cet article +- `destinationLocation[*]`: Référence Geojson de l'élément. Il peut s'agir d'un Point, LineString, Polygon, MultiPoint, MultiLineString ou MultiPolygon +- `destinationLocationCode[string]`: Code officiel de la municipalité de destination . Model: [https://schema.org/Text](https://schema.org/Text) +- `destinationLocationName[string]`: Nom de la municipalité de destination . Model: [https://schema.org/Text](https://schema.org/Text) +- `flowCount[number]`: Nombre total de mouvements/flux entre l'origine et la destination pendant cette heure . Model: [https://schema.org/Number](https://schema.org/Number) +- `flowType[string]`: Type de flux. Enum:'tourisme, navette, entreprise, migration, mixte' . Model: [https://schema.org/Text](https://schema.org/Text) +- `hour[number]`: Heure de la journée (0-23) pour cette observation . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: Identifiant unique de l'entité +- `location[*]`: Référence Geojson de l'élément. Il peut s'agir d'un Point, LineString, Polygon, MultiPoint, MultiLineString ou MultiPolygon +- `name[string]`: Le nom de cet article +- `nationality[string]`: Nationalité des visiteurs effectuant le mouvement. Code pays alpha-2 ISO 3166-1 (par exemple, ES, FR, GB, PT, DE) . Model: [https://schema.org/Text](https://schema.org/Text) +- `nationalityName[string]`: Nom complet du pays de nationalité (facultatif, pour la lisibilité humaine) . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocation[*]`: Référence Geojson de l'élément. Il peut s'agir d'un Point, LineString, Polygon, MultiPoint, MultiLineString ou MultiPolygon +- `originLocationCode[string]`: Code officiel de la commune d'origine . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocationName[string]`: Nom de la municipalité d'origine . Model: [https://schema.org/Text](https://schema.org/Text) +- `owner[array]`: Une liste contenant une séquence de caractères codée en JSON faisant référence aux Ids uniques du ou des propriétaires +- `seeAlso[*]`: Liste d'uri pointant vers des ressources supplémentaires sur l'élément +- `source[string]`: Une séquence de caractères indiquant la source d'origine des données de l'entité sous forme d'URL. Il est recommandé d'utiliser le nom de domaine pleinement qualifié du fournisseur de la source ou l'URL de l'objet source. +- `type[string]`: Type d'entité NGSI. Il doit s'agir de OriginDestinationFlow + + + + + +Propriétés requises +- `id` +- `type` + + + + + + + + + +## Description du modèle de données des propriétés + +Classé par ordre alphabétique (cliquez pour plus de détails) + + + + +
full yaml details + +```yaml +OriginDestinationFlow: + description: Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + 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 + aggregationDateType: + description: Type of date aggregation (e.g., hourly, daily, monthly) + type: string + x-ngsi: + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + 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 + countryCode: + description: Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc... + type: string + x-ngsi: + 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 + dateObserved: + description: Date and time of the observation in ISO 8601 format + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + destinationLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + destinationLocationCode: + description: Official code of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + destinationLocationName: + description: Name of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + flowCount: + description: Total number of movements/flows between origin and destination during this hour + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: movements + flowType: + description: Type of flow. Enum:'tourism, commuting, business, migration, mixed' + enum: + - tourism + - commuting + - business + - migration + - mixed + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + hour: + description: Hour of the day (0-23) for this observation + maximum: 23 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + nationality: + description: Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE) + pattern: ^[A-Z]{2}$ + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + nationalityName: + description: Full name of the nationality country (optional, for human readability) + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + originLocationCode: + description: Official code of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocationName: + description: Name of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI entity type. It has to be OriginDestinationFlow + enum: + - OriginDestinationFlow + type: string + x-ngsi: + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/schema.json + x-model-tags: '' + x-version: 0.0.1 +``` +
+ + + + + + + + + +## Exemples de charges utiles + +#### OrigineDestinationFlow clés-valeurs NGSI-v2 Exemple + +Voici un exemple d'un OriginDestinationFlow au format JSON sous forme de paires clé-valeur. Cela est compatible avec NGSI-v2 lors de l'utilisation de `options=keyValues` et retourne les données de contexte d'une entité individuelle. +
show/hide example + +```json + +{ + "id": "OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:30:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "CO0101", + "originLocationName": "Coimbra", + "destinationLocationCode": "CO0102", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z" +} +``` +
+ +#### Exemple de flux OrigineDestination normalisé NGSI-v2 + +Voici un exemple de OriginDestinationFlow au format JSON normalisé. Ceci est compatible avec NGSI-v2 lorsqu'il n'utilise pas d'options et retourne les données de contexte d'une entité individuelle. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "DateTime", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Text", + "value": "hourly" + }, + "hour": { + "type": "Number", + "value": 10 + }, + "originLocationCode": { + "type": "Text", + "value": "CO0101" + }, + "originLocationName": { + "type": "Text", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Text", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Text", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Text", + "value": "DE" + }, + "nationalityName": { + "type": "Text", + "value": "Germany" + }, + "flowCount": { + "type": "Number", + "value": 145 + }, + "flowType": { + "type": "Text", + "value": "tourism" + }, + "countryCode": { + "type": "Text", + "value": "PT" + }, + "originLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Text", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Text", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + } +} +``` +
+ +#### Exemple de clés-valeurs OriginDestinationFlow NGSI-LD + +Voici un exemple d'un OriginDestinationFlow au format JSON-LD sous forme de paires clé-valeur. Ceci est compatible avec NGSI-LD lors de l'utilisation de `options=keyValues` et retourne les données de contexte d'une entité individuelle. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:0602:0406:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:00:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "0602", + "originLocationName": "Coimbra", + "destinationLocationCode": "0406", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z", + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ +#### Exemple de flux OrigineDestination normalisé NGSI-LD + +Voici un exemple d'un OriginDestinationFlow au format JSON-LD normalisé. Ceci est compatible avec NGSI-LD lorsqu'il n'utilise pas d'options et renvoie les données de contexte d'une entité individuelle. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "Property", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Property", + "value": "hourly" + }, + "hour": { + "type": "Property", + "value": 10 + }, + "originLocationCode": { + "type": "Property", + "value": "CO0101" + }, + "originLocationName": { + "type": "Property", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Property", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Property", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Property", + "value": "DE" + }, + "nationalityName": { + "type": "Property", + "value": "Germany" + }, + "flowCount": { + "type": "Property", + "value": 145 + }, + "flowType": { + "type": "Property", + "value": "tourism" + }, + "countryCode": { + "type": "Property", + "value": "PT" + }, + "originLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Property", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Property", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/OriginDestinationFlow/doc/spec_IT.md b/OriginDestinationFlow/doc/spec_IT.md new file mode 100644 index 000000000..2aab396e6 --- /dev/null +++ b/OriginDestinationFlow/doc/spec_IT.md @@ -0,0 +1,1245 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entità: OriginDestinationFlow +============================= + + + + + +[Licenza aperta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/OriginDestinationFlow/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) + + + + + +Global description: **Osservazione oraria dei flussi di movimento dei visitatori tra comuni di origine e di destinazione, suddivisi per nazionalità. Ogni entità rappresenta il conteggio del flusso tra due località durante un'ora specifica.** + +version: 0.0.1 + + + + + + +## Elenco delle proprietà + + +[*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o formati/modello diversi +- `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 di via 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, è gestito 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 di via . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Numero che identifica una proprietà specifica in una strada pubblica +- `aggregationDateType[string]`: Tipo di aggregazione delle date (ad esempio, orario, giornaliero, mensile) +- `alternateName[string]`: Un nome alternativo per questo elemento +- `areaServed[string]`: L'area geografica in cui viene fornito un servizio o un articolo offerto . Model: [https://schema.org/Text](https://schema.org/Text) +- `countryCode[string]`: Codice del paese di origine associato alle persone associate al flusso, ad es. ES, IT, FR, ecc... +- `dataProvider[string]`: Una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzati +- `dateCreated[date-time]`: Timestamp di creazione dell'entità. Questo verrà solitamente assegnato dalla piattaforma di archiviazione +- `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Questo sarà solitamente assegnato dalla piattaforma di archiviazione +- `dateObserved[date-time]`: Data e ora dell'osservazione in formato ISO 8601 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `description[string]`: Una descrizione di questo articolo +- `destinationLocation[*]`: Riferimento Geojson all'elemento. Può essere Punto, LineString, Poligono, MultiPunto, MultiLineString o MultiPoligono +- `destinationLocationCode[string]`: Codice ufficiale del comune di destinazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `destinationLocationName[string]`: Nome del comune di destinazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `flowCount[number]`: Numero totale di movimenti/flussi tra origine e destinazione durante questa ora . Model: [https://schema.org/Number](https://schema.org/Number) +- `flowType[string]`: Tipo di flusso. Enum: 'turismo, pendolarismo, business, migrazione, misto' . Model: [https://schema.org/Text](https://schema.org/Text) +- `hour[number]`: Ora del giorno (0-23) per questa osservazione . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: Identificatore univoco dell'entità +- `location[*]`: Riferimento Geojson all'elemento. Può essere Punto, LineString, Poligono, MultiPunto, MultiLineString o MultiPoligono +- `name[string]`: Il nome di questo articolo +- `nationality[string]`: Nazionalità dei visitatori che effettuano il movimento. Codice paese ISO 3166-1 alpha-2 (ad esempio, ES, FR, GB, PT, DE) . Model: [https://schema.org/Text](https://schema.org/Text) +- `nationalityName[string]`: Nome completo della nazione di cittadinanza (opzionale, per leggibilità umana) . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocation[*]`: Riferimento Geojson all'elemento. Può essere Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon +- `originLocationCode[string]`: Codice ufficiale del comune di origine . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocationName[string]`: Nome del comune di origine . Model: [https://schema.org/Text](https://schema.org/Text) +- `owner[array]`: Una lista che contiene una sequenza di caratteri codificata in JSON che fa riferimento agli Id univoci del/dei proprietario/i +- `seeAlso[*]`: Elenco di uri che puntano a risorse aggiuntive sull'elemento +- `source[string]`: Una sequenza di caratteri che fornisce la fonte originale dei dati dell'entità come URL. Si consiglia di utilizzare il nome di dominio completamente qualificato del fornitore di origine o l'URL dell'oggetto di origine +- `type[string]`: Tipo di entità NGSI. Deve essere OriginDestinationFlow + + + + + +Proprietà richieste +- `id` +- `tipo` + + + + + + + + + +## Descrizione del modello di dati delle proprietà + +Ordinati in ordine alfabetico (clicca per i dettagli) + + + + +
full yaml details + +```yaml +OriginDestinationFlow: + description: Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + 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 + aggregationDateType: + description: Type of date aggregation (e.g., hourly, daily, monthly) + type: string + x-ngsi: + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + 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 + countryCode: + description: Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc... + type: string + x-ngsi: + 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 + dateObserved: + description: Date and time of the observation in ISO 8601 format + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + destinationLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + destinationLocationCode: + description: Official code of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + destinationLocationName: + description: Name of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + flowCount: + description: Total number of movements/flows between origin and destination during this hour + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: movements + flowType: + description: Type of flow. Enum:'tourism, commuting, business, migration, mixed' + enum: + - tourism + - commuting + - business + - migration + - mixed + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + hour: + description: Hour of the day (0-23) for this observation + maximum: 23 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + nationality: + description: Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE) + pattern: ^[A-Z]{2}$ + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + nationalityName: + description: Full name of the nationality country (optional, for human readability) + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + originLocationCode: + description: Official code of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocationName: + description: Name of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI entity type. It has to be OriginDestinationFlow + enum: + - OriginDestinationFlow + type: string + x-ngsi: + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/schema.json + x-model-tags: '' + x-version: 0.0.1 +``` +
+ + + + + + + + + +## Payload di esempio + +#### OrigineDestinazioneFlusso Esempio di valori chiave NGSI-v2 + +Ecco un esempio di OriginDestinationFlow in formato JSON come chiavi-valori. Ciò è compatibile con NGSI-v2 quando si utilizza `options=keyValues` e restituisce i dati di contesto di un'entità individuale. +
show/hide example + +```json + +{ + "id": "OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:30:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "CO0101", + "originLocationName": "Coimbra", + "destinationLocationCode": "CO0102", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z" +} +``` +
+ +#### OrigineDestinazioneFlusso Esempio NGSI-v2 normalizzato + +Ecco un esempio di un OriginDestinationFlow in formato JSON come normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano opzioni e restituisce i dati di contesto di un'entità individuale. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "DateTime", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Text", + "value": "hourly" + }, + "hour": { + "type": "Number", + "value": 10 + }, + "originLocationCode": { + "type": "Text", + "value": "CO0101" + }, + "originLocationName": { + "type": "Text", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Text", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Text", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Text", + "value": "DE" + }, + "nationalityName": { + "type": "Text", + "value": "Germany" + }, + "flowCount": { + "type": "Number", + "value": 145 + }, + "flowType": { + "type": "Text", + "value": "tourism" + }, + "countryCode": { + "type": "Text", + "value": "PT" + }, + "originLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Text", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Text", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + } +} +``` +
+ +#### OrigineDestinazioneFlusso Esempio di valori chiave NGSI-LD + +Ecco un esempio di un OriginDestinationFlow in formato JSON-LD come chiavi-valori. Ciò è compatibile con NGSI-LD quando si utilizza `options=keyValues` e restituisce i dati di contesto di un'entità individuale. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:0602:0406:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:00:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "0602", + "originLocationName": "Coimbra", + "destinationLocationCode": "0406", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z", + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ +#### OrigineDestinazioneFlusso Esempio normalizzato NGSI-LD + +Ecco un esempio di un OriginDestinationFlow in formato JSON-LD normalizzato. Ciò è compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati di contesto di un'entità individuale. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "Property", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Property", + "value": "hourly" + }, + "hour": { + "type": "Property", + "value": 10 + }, + "originLocationCode": { + "type": "Property", + "value": "CO0101" + }, + "originLocationName": { + "type": "Property", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Property", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Property", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Property", + "value": "DE" + }, + "nationalityName": { + "type": "Property", + "value": "Germany" + }, + "flowCount": { + "type": "Property", + "value": 145 + }, + "flowType": { + "type": "Property", + "value": "tourism" + }, + "countryCode": { + "type": "Property", + "value": "PT" + }, + "originLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Property", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Property", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/OriginDestinationFlow/doc/spec_JA.md b/OriginDestinationFlow/doc/spec_JA.md new file mode 100644 index 000000000..8c6630d09 --- /dev/null +++ b/OriginDestinationFlow/doc/spec_JA.md @@ -0,0 +1,1245 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +実体: OriginDestinationFlow +============================= + + + + + +[オープンライセンス](https://github.com/smart-data-models//dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md) + +[自動生成文書](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) + + + + + +Global description: **出発と到着の自治体を通じた来訪者移動フローの一時間ごとの観察、国籍でセグメント化される。各エンティティは、特定の時間帯に2つのロケーションの間のフロー数を表す。** + +version: 0.0.1 + + + + + + +## プロパティの一覧 + + +[*] 属性に型がない場合、それは複数の型や異なるフォーマット/パターンを持つ可能性があるためです。 +- `address[object]`: 郵送先住所 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: その国。例えば、スペインです。 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 住所が存在する地域、そしてその地域が位置する地域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: その地域は、自治体が存在し、かつその国に位置する地域です。 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 地区は、行政区画の一種であり、一部の国では地方自治体によって管理される + - `postOfficeBoxNumber[string]`: ポストオフィスボックス番号は、ポストオフィスボックス住所の場合。例：03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 郵便番号。例えば、24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 住所 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 公道上の特定の物件を識別する番号 +- `aggregationDateType[string]`: 集計日の種類（例：時間別、日別、月別） +- `alternateName[string]`: このアイテムの別名 +- `areaServed[string]`: サービスまたは提供されるアイテムが提供される地理的な地域 . Model: [https://schema.org/Text](https://schema.org/Text) +- `countryCode[string]`: フローに関連する人々に関連付けられた国コード（例：ES、IT、FRなど） +- `dataProvider[string]`: 調和データエンティティの提供者を識別する文字列のシーケンス +- `dateCreated[date-time]`: エンティティ作成タイムスタンプ。このタイムスタンプは、通常、ストレージプラットフォームによって割り当てられる。 +- `dateModified[date-time]`: エンティティの最後の変更のタイムスタンプ。このタイムスタンプは通常、ストレージプラットフォームによって割り当てられる。 +- `dateObserved[date-time]`: ISO 8601形式の観測日時 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `description[string]`: このアイテムの説明 +- `destinationLocation[*]`: アイテムへのGeojson参照。Point、LineString、Polygon、MultiPoint、MultiLineString、またはMultiPolygonのいずれかになります。 +- `destinationLocationCode[string]`: 目的地の市町村の公式コード . Model: [https://schema.org/Text](https://schema.org/Text) +- `destinationLocationName[string]`: 目的地の市町村の名称 . Model: [https://schema.org/Text](https://schema.org/Text) +- `flowCount[number]`: この時間帯における出発地と目的地の間の移動/流れの総数 . Model: [https://schema.org/Number](https://schema.org/Number) +- `flowType[string]`: フローの種類。 Enum:'観光、通勤、ビジネス、移住、混合' . Model: [https://schema.org/Text](https://schema.org/Text) +- `hour[number]`: この観測の日の時間（0-23） . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: エンティティのユニーク識別子 +- `location[*]`: アイテムへのGeojson参照。Point、LineString、Polygon、MultiPoint、MultiLineString、またはMultiPolygonのいずれかになることができる。 +- `name[string]`: このアイテムの名前 +- `nationality[string]`: 訪問者の国籍。ISO 3166-1 alpha-2 国コード（例：ES、FR、GB、PT、DE） . Model: [https://schema.org/Text](https://schema.org/Text) +- `nationalityName[string]`: 国籍の国名（任意、人間の読みやすさのため） . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocation[*]`: アイテムへのGeojson参照。Point、LineString、Polygon、MultiPoint、MultiLineString、またはMultiPolygonのいずれかになります。 +- `originLocationCode[string]`: 発生自治体の公式コード . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocationName[string]`: 発祥自治体の名前 . Model: [https://schema.org/Text](https://schema.org/Text) +- `owner[array]`: オーナー（所有者）のユニークIDを参照する文字シーケンスをJSONでエンコードしたものが含まれるリスト +- `seeAlso[*]`: アイテムに関する追加のリソースを指すURIのリスト +- `source[string]`: エンティティデータの元のソースをURLとして示す文字列のシーケンス。ソースプロバイダーの完全修飾ドメイン名、またはソースオブジェクトへのURLであることが推奨される。 +- `type[string]`: NGSIエンティティタイプでなければならない。OriginDestinationFlowでなければならない。 + + + + + +必要なプロパティ +- `ID` +- `タイプ` + + + + + + + + + +## データモデルのプロパティの説明 + +アルファベット順に並べ替え（詳細） + + + + +
full yaml details + +```yaml +OriginDestinationFlow: + description: Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + 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 + aggregationDateType: + description: Type of date aggregation (e.g., hourly, daily, monthly) + type: string + x-ngsi: + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + 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 + countryCode: + description: Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc... + type: string + x-ngsi: + 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 + dateObserved: + description: Date and time of the observation in ISO 8601 format + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + destinationLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + destinationLocationCode: + description: Official code of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + destinationLocationName: + description: Name of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + flowCount: + description: Total number of movements/flows between origin and destination during this hour + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: movements + flowType: + description: Type of flow. Enum:'tourism, commuting, business, migration, mixed' + enum: + - tourism + - commuting + - business + - migration + - mixed + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + hour: + description: Hour of the day (0-23) for this observation + maximum: 23 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + nationality: + description: Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE) + pattern: ^[A-Z]{2}$ + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + nationalityName: + description: Full name of the nationality country (optional, for human readability) + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + originLocationCode: + description: Official code of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocationName: + description: Name of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI entity type. It has to be OriginDestinationFlow + enum: + - OriginDestinationFlow + type: string + x-ngsi: + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/schema.json + x-model-tags: '' + x-version: 0.0.1 +``` +
+ + + + + + + + + +## 例のペイロード + +#### 起点終点フロー NGSI-v2 キー値の例 + +ここは、キー値としてのJSON形式のOriginDestinationFlowの例です。これは、`options=keyValues`を使用してNGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example + +```json + +{ + "id": "OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:30:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "CO0101", + "originLocationName": "Coimbra", + "destinationLocationCode": "CO0102", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z" +} +``` +
+ +#### 起点終点フロー NGSI-v2 正規化例 + +ここは、OriginDestinationFlow の JSON 形式の例です。これは、オプションを使用しない場合に NGSI-v2 と互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "DateTime", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Text", + "value": "hourly" + }, + "hour": { + "type": "Number", + "value": 10 + }, + "originLocationCode": { + "type": "Text", + "value": "CO0101" + }, + "originLocationName": { + "type": "Text", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Text", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Text", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Text", + "value": "DE" + }, + "nationalityName": { + "type": "Text", + "value": "Germany" + }, + "flowCount": { + "type": "Number", + "value": 145 + }, + "flowType": { + "type": "Text", + "value": "tourism" + }, + "countryCode": { + "type": "Text", + "value": "PT" + }, + "originLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Text", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Text", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + } +} +``` +
+ +#### 起点目的地フロー NGSI-LD キー値の例 + +ここは、JSON-LD形式のOriginDestinationFlowの例です。これは、`options=keyValues`を使用してNGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:0602:0406:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:00:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "0602", + "originLocationName": "Coimbra", + "destinationLocationCode": "0406", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z", + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ +#### 起点目的地フロー NGSI-LD 正規化例 + +ここは、JSON-LD形式で正規化されたOriginDestinationFlowの例です。これは、オプションを使用しない場合、NGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "Property", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Property", + "value": "hourly" + }, + "hour": { + "type": "Property", + "value": 10 + }, + "originLocationCode": { + "type": "Property", + "value": "CO0101" + }, + "originLocationName": { + "type": "Property", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Property", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Property", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Property", + "value": "DE" + }, + "nationalityName": { + "type": "Property", + "value": "Germany" + }, + "flowCount": { + "type": "Property", + "value": 145 + }, + "flowType": { + "type": "Property", + "value": "tourism" + }, + "countryCode": { + "type": "Property", + "value": "PT" + }, + "originLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Property", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Property", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/OriginDestinationFlow/doc/spec_KO.md b/OriginDestinationFlow/doc/spec_KO.md new file mode 100644 index 000000000..3308bc95f --- /dev/null +++ b/OriginDestinationFlow/doc/spec_KO.md @@ -0,0 +1,1245 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +엔티티: OriginDestinationFlow +============================= + + + + + +[오픈 라이선스](https://github.com/smart-data-models//dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md) + +[자동으로 생성된 문서](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) + + + + + +Global description: **방문자 이동 흐름의 출발지와 도착지 자치체 간의 시간별 관찰, 국적별 구분. 각 엔티티는 특정 시간 동안 두 위치 간의 흐름 수를 나타낸다.** + +version: 0.0.1 + + + + + + +## 속성 목록 + + +[*] 속성에 유형이 없으면 여러 유형이나 다른 형식/패턴을 가질 수 있기 때문입니다. +- `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: 그 국가. 예를 들어 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 그 거리 주소가 속한 지역 및 지역에 속한 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 그 지역은 그 지방이 있으며, 또한 그 국가에 있습니다 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 구는 일부 국가에서 지방 정부가 관리하는 유형의 행정 구역입니다 + - `postOfficeBoxNumber[string]`: 우체국 사서함 번호(PO 박스 주소용). 예를 들어, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 우편번호. 예를 들어, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 도로 주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 공공 도로상 특정 부동산을 식별하는 번호 +- `aggregationDateType[string]`: 날짜 집계 유형(예: 시간별, 일별, 월별) +- `alternateName[string]`: 이 항목의 대체 이름 +- `areaServed[string]`: 서비스나 제공된 항목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) +- `countryCode[string]`: 흐름과 관련된 사람들과 관련된 국가 코드, 예를 들어 ES, IT, FR 등... +- `dataProvider[string]`: 조화된 데이터 엔티티의 제공자를 식별하는 문자열 시퀀스 +- `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이것은 일반적으로 저장소 플랫폼에 의해 할당됩니다. +- `dateModified[date-time]`: 엔티티의 마지막 수정 시각. 이것은 일반적으로 저장소 플랫폼에 의해 할당된다. +- `dateObserved[date-time]`: ISO 8601 형식의 관측 일시 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `description[string]`: 이 항목에 대한 설명 +- `destinationLocation[*]`: Geojson 아이템 참조입니다. Point, LineString, Polygon, MultiPoint, MultiLineString 또는 MultiPolygon 중 하나일 수 있습니다. +- `destinationLocationCode[string]`: 도착 지자체의 공식 코드 . Model: [https://schema.org/Text](https://schema.org/Text) +- `destinationLocationName[string]`: 도착지 시정촌의 이름 . Model: [https://schema.org/Text](https://schema.org/Text) +- `flowCount[number]`: 이 시간 동안 출발지와 도착지 사이를 이동한 총 이동/흐름 수 . Model: [https://schema.org/Number](https://schema.org/Number) +- `flowType[string]`: 유형의 흐름. Enum: '관광, 통근, 비즈니스, 이주, 혼합' . Model: [https://schema.org/Text](https://schema.org/Text) +- `hour[number]`: 이 관측에 대한 일일 시간(0-23) . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: 엔티티의 고유 식별자 +- `location[*]`: Geojson 아이템 참조입니다. Point, LineString, Polygon, MultiPoint, MultiLineString 또는 MultiPolygon 중 하나가 될 수 있습니다. +- `name[string]`: 이 항목의 이름 +- `nationality[string]`: 방문자 국적. ISO 3166-1 alpha-2 국가 코드 (예: ES, FR, GB, PT, DE) . Model: [https://schema.org/Text](https://schema.org/Text) +- `nationalityName[string]`: 국적 국가의 전체 이름(선택 사항, 인간의 가독성을 위해) . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocation[*]`: Geojson 아이템 참조입니다. Point, LineString, Polygon, MultiPoint, MultiLineString 또는 MultiPolygon 중 하나일 수 있습니다. +- `originLocationCode[string]`: 원래 자치체의 공식 코드 . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocationName[string]`: 원래 시정촌 이름 . Model: [https://schema.org/Text](https://schema.org/Text) +- `owner[array]`: 소유자(들)의 고유 ID를 참조하는 문자열 시퀀스를 JSON으로 인코딩한 문자열을 포함하는 목록 +- `seeAlso[*]`: 아이템에 대한 추가 리소스를 가리키는 URI 목록 +- `source[string]`: 엔티티 데이터의 원래 출처를 URL로 제공하는 문자열 시퀀스. 출처 제공자의 완전한 도메인 이름이나 출처 객체에 대한 URL로 지정하는 것을 권장합니다. +- `type[string]`: NGSI 엔티티 유형입니다. OriginDestinationFlow이어야 합니다. + + + + + +필수 속성 +- `id` +- `유형` + + + + + + + + + +## 데이터 모델 속성 설명 + +가나다순으로 정렬됨 (자세한 정보 클릭) + + + + +
full yaml details + +```yaml +OriginDestinationFlow: + description: Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + 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 + aggregationDateType: + description: Type of date aggregation (e.g., hourly, daily, monthly) + type: string + x-ngsi: + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + 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 + countryCode: + description: Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc... + type: string + x-ngsi: + 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 + dateObserved: + description: Date and time of the observation in ISO 8601 format + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + destinationLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + destinationLocationCode: + description: Official code of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + destinationLocationName: + description: Name of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + flowCount: + description: Total number of movements/flows between origin and destination during this hour + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: movements + flowType: + description: Type of flow. Enum:'tourism, commuting, business, migration, mixed' + enum: + - tourism + - commuting + - business + - migration + - mixed + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + hour: + description: Hour of the day (0-23) for this observation + maximum: 23 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + nationality: + description: Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE) + pattern: ^[A-Z]{2}$ + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + nationalityName: + description: Full name of the nationality country (optional, for human readability) + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + originLocationCode: + description: Official code of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocationName: + description: Name of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI entity type. It has to be OriginDestinationFlow + enum: + - OriginDestinationFlow + type: string + x-ngsi: + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/schema.json + x-model-tags: '' + x-version: 0.0.1 +``` +
+ + + + + + + + + +## 예제 페이로드 + +#### 원본목적지흐름 NGSI-v2 키-값 예시 + +여기에는 키-값으로 JSON 형식의 OriginDestinationFlow의 예가 나와 있습니다. 이것은 `options=keyValues`를 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + +```json + +{ + "id": "OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:30:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "CO0101", + "originLocationName": "Coimbra", + "destinationLocationCode": "CO0102", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z" +} +``` +
+ +#### 원본목적지흐름 NGSI-v2 정규화 예시 + +여기에는 JSON 형식으로 정규화된 OriginDestinationFlow의 예가 나와 있습니다. 옵션을 사용하지 않을 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "DateTime", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Text", + "value": "hourly" + }, + "hour": { + "type": "Number", + "value": 10 + }, + "originLocationCode": { + "type": "Text", + "value": "CO0101" + }, + "originLocationName": { + "type": "Text", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Text", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Text", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Text", + "value": "DE" + }, + "nationalityName": { + "type": "Text", + "value": "Germany" + }, + "flowCount": { + "type": "Number", + "value": 145 + }, + "flowType": { + "type": "Text", + "value": "tourism" + }, + "countryCode": { + "type": "Text", + "value": "PT" + }, + "originLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Text", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Text", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + } +} +``` +
+ +#### 원본목적지흐름 NGSI-LD 키-값 예시 + +여기에는 JSON-LD 형식의 키-값 쌍으로 OriginDestinationFlow의 예가 나와 있습니다. 이것은 `options=keyValues`를 사용할 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:0602:0406:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:00:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "0602", + "originLocationName": "Coimbra", + "destinationLocationCode": "0406", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z", + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ +#### 원본목적지흐름 NGSI-LD 정규화 예시 + +여기에는 JSON-LD 형식으로 정규화된 OriginDestinationFlow의 예가 있습니다. 이것은 옵션을 사용하지 않을 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "Property", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Property", + "value": "hourly" + }, + "hour": { + "type": "Property", + "value": 10 + }, + "originLocationCode": { + "type": "Property", + "value": "CO0101" + }, + "originLocationName": { + "type": "Property", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Property", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Property", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Property", + "value": "DE" + }, + "nationalityName": { + "type": "Property", + "value": "Germany" + }, + "flowCount": { + "type": "Property", + "value": 145 + }, + "flowType": { + "type": "Property", + "value": "tourism" + }, + "countryCode": { + "type": "Property", + "value": "PT" + }, + "originLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Property", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Property", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/OriginDestinationFlow/doc/spec_ZH.md b/OriginDestinationFlow/doc/spec_ZH.md new file mode 100644 index 000000000..36ec5d506 --- /dev/null +++ b/OriginDestinationFlow/doc/spec_ZH.md @@ -0,0 +1,1245 @@ + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +实体: OriginDestinationFlow +============================= + + + + + +[开放许可证](https://github.com/smart-data-models//dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md) + +[自动生成的文档](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) + + + + + +Global description: **按小时观察游客移动流动，按国籍划分，记录各个起始和目的地市镇之间的流动情况。每个实体代表两个地点在特定小时之间的流动数量。** + +version: 0.0.1 + + + + + + +## 属性列表 + + +[*] 如果一个属性中没有指定类型，那是因为它可能有多种类型或不同的格式/模式 +- `address[object]`: 邮寄地址 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: 该国。例如，西班牙 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 街道地址所在的地区，并且该地区位于某个区域内 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 该地方所在的地区，以及该地区所在的国家 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 區域是一種行政區劃類型，在一些國家，由地方政府管理。 + - `postOfficeBoxNumber[string]`: 邮政信箱的邮政信箱号码。例如，03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 邮政编码。例如，24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 街道地址 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 公共街道上特定房产的识别号码 +- `aggregationDateType[string]`: 日期聚合类型（例如，每小时、每天、每月） +- `alternateName[string]`: 该物品的另一个名称 +- `areaServed[string]`: 提供服务或商品的地域范围 . Model: [https://schema.org/Text](https://schema.org/Text) +- `countryCode[string]`: 与流程相关人员关联的原国家代码，例如ES、IT、FR等... +- `dataProvider[string]`: 识别和谐数据实体提供者的字符序列 +- `dateCreated[date-time]`: 实体创建时间戳。这通常由存储平台分配 +- `dateModified[date-time]`: 实体最后修改的时间戳。这通常由存储平台分配 +- `dateObserved[date-time]`: 观察的日期和时间以ISO 8601格式表示 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `description[string]`: 对该物品的描述 +- `destinationLocation[*]`: GeoJSON指向该项的引用。它可以是Point、LineString、Polygon、MultiPoint、MultiLineString或MultiPolygon +- `destinationLocationCode[string]`: 目的地市政官方代码 . Model: [https://schema.org/Text](https://schema.org/Text) +- `destinationLocationName[string]`: 目的地市政名称 . Model: [https://schema.org/Text](https://schema.org/Text) +- `flowCount[number]`: 本小时内起点和终点之间的移动/流动总数 . Model: [https://schema.org/Number](https://schema.org/Number) +- `flowType[string]`: 流动类型。枚举：'旅游，通勤，商务，移民，混合' . Model: [https://schema.org/Text](https://schema.org/Text) +- `hour[number]`: 本次观测的当日时刻（0-23） . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: 实体的唯一标识符 +- `location[*]`: 对该项目的Geojson引用。它可以是Point、LineString、Polygon、MultiPoint、MultiLineString或MultiPolygon +- `name[string]`: 该物品的名称 +- `nationality[string]`: 游客的国籍。ISO 3166-1 alpha-2 国家代码（例如，ES，FR，GB，PT，DE） . Model: [https://schema.org/Text](https://schema.org/Text) +- `nationalityName[string]`: 全称（国家的国籍， 可选，为了方便人类阅读） . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocation[*]`: GeoJSON引用该项目的内容。它可以是Point、LineString、Polygon、MultiPoint、MultiLineString或MultiPolygon +- `originLocationCode[string]`: 起源市的官方代码 . Model: [https://schema.org/Text](https://schema.org/Text) +- `originLocationName[string]`: 起源市镇名称 . Model: [https://schema.org/Text](https://schema.org/Text) +- `owner[array]`: 包含一个JSON编码的字符序列，引用所有者（们）的唯一Id的列表 +- `seeAlso[*]`: 关于该项目的其他资源的URI列表 +- `source[string]`: 一个字符序列，给出实体数据的原始来源作为URL。建议为源提供者的全限定域名，或源对象的URL。 +- `type[string]`: NGSI 实体类型。它必须是 OriginDestinationFlow + + + + + +所需属性 +- `id` +- `类型` + + + + + + + + + +## 数据模型属性描述 + +按字母顺序排列（点击查看详情） + + + + +
full yaml details + +```yaml +OriginDestinationFlow: + description: Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + 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 + aggregationDateType: + description: Type of date aggregation (e.g., hourly, daily, monthly) + type: string + x-ngsi: + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + 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 + countryCode: + description: Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc... + type: string + x-ngsi: + 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 + dateObserved: + description: Date and time of the observation in ISO 8601 format + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + destinationLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + destinationLocationCode: + description: Official code of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + destinationLocationName: + description: Name of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + flowCount: + description: Total number of movements/flows between origin and destination during this hour + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: movements + flowType: + description: Type of flow. Enum:'tourism, commuting, business, migration, mixed' + enum: + - tourism + - commuting + - business + - migration + - mixed + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + hour: + description: Hour of the day (0-23) for this observation + maximum: 23 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + nationality: + description: Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE) + pattern: ^[A-Z]{2}$ + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + nationalityName: + description: Full name of the nationality country (optional, for human readability) + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + originLocationCode: + description: Official code of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocationName: + description: Name of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI entity type. It has to be OriginDestinationFlow + enum: + - OriginDestinationFlow + type: string + x-ngsi: + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/schema.json + x-model-tags: '' + x-version: 0.0.1 +``` +
+ + + + + + + + + +## 示例有效载荷 + +#### 起点目的地流 NGSI-v2 键值示例 + +这里是JSON格式的OriginDestinationFlow示例，以键值对的形式呈现。当使用`options=keyValues`时，它与NGSI-v2兼容，并返回个体实体的上下文数据。 +
show/hide example + +```json + +{ + "id": "OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:30:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "CO0101", + "originLocationName": "Coimbra", + "destinationLocationCode": "CO0102", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z" +} +``` +
+ +#### 起点目的地流 NGSI-v2 标准化 示例 + +这是一个OriginDestinationFlow在JSON格式的例子，已经标准化。这与NGSI-v2兼容，当不使用选项时，返回个体实体的上下文数据。 +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "DateTime", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Text", + "value": "hourly" + }, + "hour": { + "type": "Number", + "value": 10 + }, + "originLocationCode": { + "type": "Text", + "value": "CO0101" + }, + "originLocationName": { + "type": "Text", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Text", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Text", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Text", + "value": "DE" + }, + "nationalityName": { + "type": "Text", + "value": "Germany" + }, + "flowCount": { + "type": "Number", + "value": 145 + }, + "flowType": { + "type": "Text", + "value": "tourism" + }, + "countryCode": { + "type": "Text", + "value": "PT" + }, + "originLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Text", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Text", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + } +} +``` +
+ +#### 起点目的地流 NGSI-LD 键值示例 + +这是一个以JSON-LD格式表示的OriginDestinationFlow的例子，以键值对的形式表示。当使用`options=keyValues`时，它与NGSI-LD兼容，并返回个体实体的上下文数据。 +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:0602:0406:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": "2024-12-31T10:00:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + "originLocationCode": "0602", + "originLocationName": "Coimbra", + "destinationLocationCode": "0406", + "destinationLocationName": "Figueira da Foz", + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z", + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ +#### 起点目的地流 NGSI-LD 标准化 示例 + +这是一个以JSON-LD格式标准化的OriginDestinationFlow示例。当不使用选项时，它与NGSI-LD兼容，并返回个体实体的上下文数据。 +
show/hide example + +```json + +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "Property", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Property", + "value": "hourly" + }, + "hour": { + "type": "Property", + "value": 10 + }, + "originLocationCode": { + "type": "Property", + "value": "CO0101" + }, + "originLocationName": { + "type": "Property", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Property", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Property", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Property", + "value": "DE" + }, + "nationalityName": { + "type": "Property", + "value": "Germany" + }, + "flowCount": { + "type": "Property", + "value": 145 + }, + "flowType": { + "type": "Property", + "value": "tourism" + }, + "countryCode": { + "type": "Property", + "value": "PT" + }, + "originLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Property", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Property", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} +``` +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/OriginDestinationFlow/examples/example-normalized.json b/OriginDestinationFlow/examples/example-normalized.json new file mode 100644 index 000000000..1a80d7b2c --- /dev/null +++ b/OriginDestinationFlow/examples/example-normalized.json @@ -0,0 +1,88 @@ +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "DateTime", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Text", + "value": "hourly" + }, + "hour": { + "type": "Number", + "value": 10 + }, + "originLocationCode": { + "type": "Text", + "value": "CO0101" + }, + "originLocationName": { + "type": "Text", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Text", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Text", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Text", + "value": "DE" + }, + "nationalityName": { + "type": "Text", + "value": "Germany" + }, + "flowCount": { + "type": "Number", + "value": 145 + }, + "flowType": { + "type": "Text", + "value": "tourism" + }, + "countryCode": { + "type": "Text", + "value": "PT" + }, + "originLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "geo:json", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Text", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Text", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "DateTime", + "value": "2024-12-31T11:00:00.00Z" + } +} diff --git a/OriginDestinationFlow/examples/example-normalized.json.csv b/OriginDestinationFlow/examples/example-normalized.json.csv new file mode 100644 index 000000000..e9280af2c --- /dev/null +++ b/OriginDestinationFlow/examples/example-normalized.json.csv @@ -0,0 +1,2 @@ +"id_", "type_", "dateObserved__type_", "dateObserved__value_", "aggregationDateType__type_", "aggregationDateType__value_", "hour__type_", "hour__value_", "originLocationCode__type_", "originLocationCode__value_", "originLocationName__type_", "originLocationName__value_", "destinationLocationCode__type_", "destinationLocationCode__value_", "destinationLocationName__type_", "destinationLocationName__value_", "nationality__type_", "nationality__value_", "nationalityName__type_", "nationalityName__value_", "flowCount__type_", "flowCount__value_", "flowType__type_", "flowType__value_", "countryCode__type_", "countryCode__value_", "originLocation__type_", "originLocation__value__type_", "originLocation__value__coordinates__0_", "originLocation__value__coordinates__1_", "destinationLocation__type_", "destinationLocation__value__type_", "destinationLocation__value__coordinates__0_", "destinationLocation__value__coordinates__1_", "description__type_", "description__value_", "source__type_", "source__value_", "dateCreated__type_", "dateCreated__value_", "dateModified__type_", "dateModified__value_" +"urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", "OriginDestinationFlow", "DateTime", "2024-12-31T10:30:00.00Z", "Text", "hourly", "Number", "10", "Text", "CO0101", "Text", "Coimbra", "Text", "CO0102", "Text", "Figueira da Foz", "Text", "DE", "Text", "Germany", "Number", "145", "Text", "tourism", "Text", "PT", "geo:json", "Point", "-8.4103", "40.2033", "geo:json", "Point", "-8.8618", "40.1508", "Text", "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", "Text", "MobilityDataPlatform", "DateTime", "2024-12-31T11:00:00.00Z", "DateTime", "2024-12-31T11:00:00.00Z" \ No newline at end of file diff --git a/OriginDestinationFlow/examples/example-normalized.jsonld b/OriginDestinationFlow/examples/example-normalized.jsonld new file mode 100644 index 000000000..833a61048 --- /dev/null +++ b/OriginDestinationFlow/examples/example-normalized.jsonld @@ -0,0 +1,91 @@ +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + "dateObserved": { + "type": "Property", + "value": "2024-12-31T10:30:00.00Z" + }, + "aggregationDateType": { + "type": "Property", + "value": "hourly" + }, + "hour": { + "type": "Property", + "value": 10 + }, + "originLocationCode": { + "type": "Property", + "value": "CO0101" + }, + "originLocationName": { + "type": "Property", + "value": "Coimbra" + }, + "destinationLocationCode": { + "type": "Property", + "value": "CO0102" + }, + "destinationLocationName": { + "type": "Property", + "value": "Figueira da Foz" + }, + "nationality": { + "type": "Property", + "value": "DE" + }, + "nationalityName": { + "type": "Property", + "value": "Germany" + }, + "flowCount": { + "type": "Property", + "value": 145 + }, + "flowType": { + "type": "Property", + "value": "tourism" + }, + "countryCode": { + "type": "Property", + "value": "PT" + }, + "originLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.4103, + 40.2033 + ] + } + }, + "destinationLocation": { + "type": "GeoProperty", + "value": { + "type": "Point", + "coordinates": [ + -8.8618, + 40.1508 + ] + } + }, + "description": { + "type": "Property", + "value": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00" + }, + "source": { + "type": "Property", + "value": "MobilityDataPlatform" + }, + "dateCreated": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "dateModified": { + "type": "Property", + "value": "2024-12-31T11:00:00.00Z" + }, + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} diff --git a/OriginDestinationFlow/examples/example-normalized.jsonld.csv b/OriginDestinationFlow/examples/example-normalized.jsonld.csv new file mode 100644 index 000000000..601ba6ee9 --- /dev/null +++ b/OriginDestinationFlow/examples/example-normalized.jsonld.csv @@ -0,0 +1,2 @@ +"id_", "type_", "dateObserved__type_", "dateObserved__value_", "aggregationDateType__type_", "aggregationDateType__value_", "hour__type_", "hour__value_", "originLocationCode__type_", "originLocationCode__value_", "originLocationName__type_", "originLocationName__value_", "destinationLocationCode__type_", "destinationLocationCode__value_", "destinationLocationName__type_", "destinationLocationName__value_", "nationality__type_", "nationality__value_", "nationalityName__type_", "nationalityName__value_", "flowCount__type_", "flowCount__value_", "flowType__type_", "flowType__value_", "countryCode__type_", "countryCode__value_", "originLocation__type_", "originLocation__value__type_", "originLocation__value__coordinates__0_", "originLocation__value__coordinates__1_", "destinationLocation__type_", "destinationLocation__value__type_", "destinationLocation__value__coordinates__0_", "destinationLocation__value__coordinates__1_", "description__type_", "description__value_", "source__type_", "source__value_", "dateCreated__type_", "dateCreated__value_", "dateModified__type_", "dateModified__value_", "@context__0_" +"urn:ngsi-ld:OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", "OriginDestinationFlow", "Property", "2024-12-31T10:30:00.00Z", "Property", "hourly", "Property", "10", "Property", "CO0101", "Property", "Coimbra", "Property", "CO0102", "Property", "Figueira da Foz", "Property", "DE", "Property", "Germany", "Property", "145", "Property", "tourism", "Property", "PT", "GeoProperty", "Point", "-8.4103", "40.2033", "GeoProperty", "Point", "-8.8618", "40.1508", "Property", "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", "Property", "MobilityDataPlatform", "Property", "2024-12-31T11:00:00.00Z", "Property", "2024-12-31T11:00:00.00Z", "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" \ No newline at end of file diff --git a/OriginDestinationFlow/examples/example.json b/OriginDestinationFlow/examples/example.json new file mode 100644 index 000000000..20c9c1d63 --- /dev/null +++ b/OriginDestinationFlow/examples/example.json @@ -0,0 +1,34 @@ +{ + "id": "OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", + "type": "OriginDestinationFlow", + + "dateObserved": "2024-12-31T10:30:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + + "originLocationCode": "CO0101", + "originLocationName": "Coimbra", + "destinationLocationCode": "CO0102", + "destinationLocationName": "Figueira da Foz", + + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z" +} diff --git a/OriginDestinationFlow/examples/example.json.csv b/OriginDestinationFlow/examples/example.json.csv new file mode 100644 index 000000000..72ec4c78d --- /dev/null +++ b/OriginDestinationFlow/examples/example.json.csv @@ -0,0 +1,2 @@ +"id_", "type_", "dateObserved_", "aggregationDateType_", "hour_", "originLocationCode_", "originLocationName_", "destinationLocationCode_", "destinationLocationName_", "nationality_", "nationalityName_", "flowCount_", "flowType_", "countryCode_", "originLocation__type_", "originLocation__coordinates__0_", "originLocation__coordinates__1_", "destinationLocation__type_", "destinationLocation__coordinates__0_", "destinationLocation__coordinates__1_", "description_", "source_", "dateCreated_", "dateModified_" +"OriginDestinationFlow:PT:CO0101:CO0102:DE:20241231T10", "OriginDestinationFlow", "2024-12-31T10:30:00.00Z", "hourly", "10", "CO0101", "Coimbra", "CO0102", "Figueira da Foz", "DE", "Germany", "145", "tourism", "PT", "Point", "-8.4103", "40.2033", "Point", "-8.8618", "40.1508", "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", "MobilityDataPlatform", "2024-12-31T11:00:00.00Z", "2024-12-31T11:00:00.00Z" \ No newline at end of file diff --git a/OriginDestinationFlow/examples/example.jsonld b/OriginDestinationFlow/examples/example.jsonld new file mode 100644 index 000000000..229a08210 --- /dev/null +++ b/OriginDestinationFlow/examples/example.jsonld @@ -0,0 +1,38 @@ +{ + "id": "urn:ngsi-ld:OriginDestinationFlow:PT:0602:0406:DE:20241231T10", + "type": "OriginDestinationFlow", + + "dateObserved": "2024-12-31T10:00:00.00Z", + "aggregationDateType": "hourly", + "hour": 10, + + "originLocationCode": "0602", + "originLocationName": "Coimbra", + "destinationLocationCode": "0406", + "destinationLocationName": "Figueira da Foz", + + "nationality": "DE", + "nationalityName": "Germany", + "flowCount": 145, + "flowType": "tourism", + "countryCode": "PT", + + "originLocation": { + "type": "Point", + "coordinates": [-8.4103, 40.2033] + }, + "destinationLocation": { + "type": "Point", + "coordinates": [-8.8618, 40.1508] + }, + + "description": "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", + "source": "MobilityDataPlatform", + + "dateCreated": "2024-12-31T11:00:00.00Z", + "dateModified": "2024-12-31T11:00:00.00Z", + + "@context": [ + "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" + ] +} diff --git a/OriginDestinationFlow/examples/example.jsonld.csv b/OriginDestinationFlow/examples/example.jsonld.csv new file mode 100644 index 000000000..ac677521c --- /dev/null +++ b/OriginDestinationFlow/examples/example.jsonld.csv @@ -0,0 +1,2 @@ +"id_", "type_", "dateObserved_", "aggregationDateType_", "hour_", "originLocationCode_", "originLocationName_", "destinationLocationCode_", "destinationLocationName_", "nationality_", "nationalityName_", "flowCount_", "flowType_", "countryCode_", "originLocation__type_", "originLocation__coordinates__0_", "originLocation__coordinates__1_", "destinationLocation__type_", "destinationLocation__coordinates__0_", "destinationLocation__coordinates__1_", "description_", "source_", "dateCreated_", "dateModified_", "@context__0_" +"urn:ngsi-ld:OriginDestinationFlow:PT:0602:0406:DE:20241231T10", "OriginDestinationFlow", "2024-12-31T10:00:00.00Z", "hourly", "10", "0602", "Coimbra", "0406", "Figueira da Foz", "DE", "Germany", "145", "tourism", "PT", "Point", "-8.4103", "40.2033", "Point", "-8.8618", "40.1508", "Hourly visitor flow from Coimbra to Figueira da Foz (German tourists) on 2024-12-31 at 10:00-11:00", "MobilityDataPlatform", "2024-12-31T11:00:00.00Z", "2024-12-31T11:00:00.00Z", "https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/context.jsonld" \ No newline at end of file diff --git a/OriginDestinationFlow/model.yaml b/OriginDestinationFlow/model.yaml new file mode 100644 index 000000000..625a41bb7 --- /dev/null +++ b/OriginDestinationFlow/model.yaml @@ -0,0 +1,843 @@ +OriginDestinationFlow: + description: Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + 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 + aggregationDateType: + description: Type of date aggregation (e.g., hourly, daily, monthly) + type: string + x-ngsi: + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + 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 + countryCode: + description: Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc... + type: string + x-ngsi: + 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 + dateObserved: + description: Date and time of the observation in ISO 8601 format + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + destinationLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + destinationLocationCode: + description: Official code of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + destinationLocationName: + description: Name of the destination municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + flowCount: + description: Total number of movements/flows between origin and destination during this hour + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: movements + flowType: + description: Type of flow. Enum:'tourism, commuting, business, migration, mixed' + enum: + - tourism + - commuting + - business + - migration + - mixed + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + hour: + description: Hour of the day (0-23) for this observation + maximum: 23 + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + 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: Relationship + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + 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 + nationality: + description: Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE) + pattern: ^[A-Z]{2}$ + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + nationalityName: + description: Full name of the nationality country (optional, for human readability) + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocation: + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + originLocationCode: + description: Official code of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + originLocationName: + description: Name of the origin municipality + type: string + x-ngsi: + model: https://schema.org/Text + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI entity type. It has to be OriginDestinationFlow + enum: + - OriginDestinationFlow + type: string + x-ngsi: + type: Property + required: + - id + - type + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/schema.json + x-model-tags: '' + x-version: 0.0.1 \ No newline at end of file diff --git a/OriginDestinationFlow/notes.yaml b/OriginDestinationFlow/notes.yaml new file mode 100644 index 000000000..e09bc133e --- /dev/null +++ b/OriginDestinationFlow/notes.yaml @@ -0,0 +1,7 @@ +notesHeader: + +notesMiddle: + +notesFooter: + +notesReadme: diff --git a/OriginDestinationFlow/schema.json b/OriginDestinationFlow/schema.json new file mode 100644 index 000000000..2f36109e1 --- /dev/null +++ b/OriginDestinationFlow/schema.json @@ -0,0 +1,98 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$schemaVersion": "0.0.1", + "$id": "https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/schema.json", + "title": "Origin Destination Flow", + "modelTags": "", + "description": "Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour.", + "type": "object", + "allOf": [ + { + "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/GSMA-Commons" + }, + { + "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/Location-Commons" + }, + { + "properties": { + "type": { + "type": "string", + "enum": [ + "OriginDestinationFlow" + ], + "description": "Property. NGSI entity type. It has to be OriginDestinationFlow" + }, + "dateObserved": { + "type": "string", + "format": "date-time", + "description": "Property. Date and time of the observation in ISO 8601 format. Model:'https://schema.org/DateTime'" + }, + "aggregationDateType": { + "type": "string", + "description": "Property. Type of date aggregation (e.g., hourly, daily, monthly)" + }, + "hour": { + "type": "integer", + "minimum": 0, + "maximum": 23, + "description": "Property. Hour of the day (0-23) for this observation. Model:'https://schema.org/Number'" + }, + "originLocationCode": { + "type": "string", + "description": "Property. Official code of the origin municipality. Model:'https://schema.org/Text'" + }, + "originLocationName": { + "type": "string", + "description": "Property. Name of the origin municipality. Model:'https://schema.org/Text'" + }, + "originLocation": { + "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/Location-Commons/properties/location" + }, + "destinationLocationCode": { + "type": "string", + "description": "Property. Official code of the destination municipality. Model:'https://schema.org/Text'" + }, + "destinationLocationName": { + "type": "string", + "description": "Property. Name of the destination municipality. Model:'https://schema.org/Text'" + }, + "destinationLocation": { + "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/Location-Commons/properties/location" + }, + "nationality": { + "type": "string", + "pattern": "^[A-Z]{2}$", + "description": "Property. Nationality of visitors making the movement. ISO 3166-1 alpha-2 country code (e.g., ES, FR, GB, PT, DE). Model:'https://schema.org/Text'" + }, + "nationalityName": { + "type": "string", + "description": "Property. Full name of the nationality country (optional, for human readability). Model:'https://schema.org/Text'" + }, + "flowCount": { + "type": "integer", + "minimum": 0, + "description": "Property. Total number of movements/flows between origin and destination during this hour. Units:'movements'. Model:'https://schema.org/Number'" + }, + "flowType": { + "type": "string", + "enum": [ + "tourism", + "commuting", + "business", + "migration", + "mixed" + ], + "description": "Property. Type of flow. Enum:'tourism, commuting, business, migration, mixed'. Model:'https://schema.org/Text'" + }, + "countryCode": { + "type": "string", + "description": "Property. Origin country code associated to the people associated to the flow, eg. ES, IT, FR, etc..." + } + } + } + ], + "required": [ + "id", + "type" + ] +} \ No newline at end of file diff --git a/OriginDestinationFlow/schema.sql b/OriginDestinationFlow/schema.sql new file mode 100644 index 000000000..1e4db9028 --- /dev/null +++ b/OriginDestinationFlow/schema.sql @@ -0,0 +1,35 @@ +/* (Beta) Export of data model OriginDestinationFlow of the subject dataModel.Transportation +for a PostgreSQL database. Pending translation of enumerations and multityped attributes */ +CREATE TYPE flowType_type AS ENUM ('tourism', 'commuting', 'business', 'migration', 'mixed'); +CREATE TYPE OriginDestinationFlow_type AS ENUM ('OriginDestinationFlow'); + +CREATE TABLE OriginDestinationFlow ( + address JSON, + aggregationDateType TEXT, + alternateName TEXT, + areaServed TEXT, + countryCode TEXT, + dataProvider TEXT, + dateCreated TIMESTAMP, + dateModified TIMESTAMP, + dateObserved TIMESTAMP, + description TEXT, + destinationLocation JSON, + destinationLocationCode TEXT, + destinationLocationName TEXT, + flowCount NUMERIC, + flowType flowType_type, + hour NUMERIC, + id TEXT PRIMARY KEY, + location JSON, + name TEXT, + nationality TEXT, + nationalityName TEXT, + originLocation JSON, + originLocationCode TEXT, + originLocationName TEXT, + owner JSON, + seeAlso JSON, + source TEXT, + type OriginDestinationFlow_type +); \ No newline at end of file diff --git a/OriginDestinationFlow/swagger.yaml b/OriginDestinationFlow/swagger.yaml new file mode 100644 index 000000000..eecd93d08 --- /dev/null +++ b/OriginDestinationFlow/swagger.yaml @@ -0,0 +1,52 @@ +--- +# Copyleft (c) 2022 Contributors to Smart Data Models initiative +# + + +components: + schemas: + OriginDestinationFlow: + $ref: "https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/model.yaml#OriginDestinationFlow" +info: + description: | + Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + title: OriginDestinationFlow + version: "0.0.1" +openapi: "3.0.0" + +paths: + /ngsi-ld/v1/entities: + get: + description: "Retrieve a set of entities which matches a specific query from an NGSI-LD system" + parameters: + - + in: query + name: type + required: true + schema: + enum: + - OriginDestinationFlow + type: string + responses: + ? "200" + : + content: + application/ld+json: + examples: + keyvalues: + summary: "Key-Values Pairs" + value: + - + $ref: "https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/examples/example.json" + normalized: + summary: "Normalized NGSI-LD" + value: + - + $ref: "https://smart-data-models.github.io/dataModel.Transportation/OriginDestinationFlow/examples/example-normalized.jsonld" + description: OK + tags: + - ngsi-ld +tags: + - + description: "NGSI-LD Linked-data Format" + name: ngsi-ld \ No newline at end of file diff --git a/README.md b/README.md index d79361750..cda27f93f 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,5 @@ # dataModel.Transportation + These data models describe the main entities involved with smart applications that deal with transportation issues. This set of entities is primarily associated with the Automotive and Smart City vertical segments and related IoT applications. When feasible, references to existing schema.org entity types and attributes are included. These models have been devised to be as generic as possible, thus allowing to deal with different scenarios @@ -21,6 +22,8 @@ The following entity types are available: - [CrowdFlowObserved](https://github.com/smart-data-models/dataModel.Transportation/blob/master/CrowdFlowObserved/README.md). CrowdFlowObserved +- [ElectricVehicleMobility](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ElectricVehicleMobility/README.md). Daily observation of electric vehicle mobility patterns aggregated by location, vehicle brand, and geographic region. + - [EVChargingStation](https://github.com/smart-data-models/dataModel.Transportation/blob/master/EVChargingStation/README.md). EV Charging Station - [FareCollectionSystem](https://github.com/smart-data-models/dataModel.Transportation/blob/master/FareCollectionSystem/README.md). A public transit fare collection system Data Model @@ -33,6 +36,8 @@ The following entity types are available: - [ItemFlowObserved](https://github.com/smart-data-models/dataModel.Transportation/blob/master/ItemFlowObserved/README.md). The data model intended to measure an observation linked to the movement of an item at a certain location and over a given period. This Data Model proposes an evolution of two Data Model by merging them and integrating all the attributes of the initial version of [TrafficFlowObserved] and [CrowFlowObserved] and by extension any type of item that we want to analyze the movements. Attributes `vehicleType` and `vehicleSubType` are removed from the initial data Model in order to become generic `itemType` and `itemSubType` of possible values. (people, Type of vehicle, Type of boat, Type of plane, ...). +- [OriginDestinationFlow](https://github.com/smart-data-models/dataModel.Transportation/blob/master/OriginDestinationFlow/README.md). Hourly observation of visitor movement flows between origin and destination municipalities, segmented by nationality. Each entity represents the flow count between two locations during a specific hour. + - [RestrictedTrafficArea](https://github.com/smart-data-models/dataModel.Transportation/blob/master/RestrictedTrafficArea/README.md). An area of a city in which the traffic generated by cars or any other kind of vehicles is subjected to limitation. - [RestrictionException](https://github.com/smart-data-models/dataModel.Transportation/blob/master/RestrictionException/README.md). A Restriction Exception represents a particular case that specialise restriction reported in a Restricted Traffic Areas; for instance it could describe particular permissions applied to specific kind vehicles @@ -57,13 +62,8 @@ The following entity types are available: - [VehicleModel](https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/README.md). This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. - - ### Contributors -[Link](https://github.com/smart-data-models/dataModel.Transportation/blob/master/CONTRIBUTORS.yaml) to the 20 current contributors of the data models of this Subject. - +[Link](https://github.com/smart-data-models/dataModel.Transportation/blob/master/CONTRIBUTORS.yaml) to the 22 current contributors. ### Contribution -You can raise an [issue](https://github.com/smart-data-models/dataModel.Transportation/issues) or submit your [PR](https://github.com/smart-data-models/dataModel.Transportation/pulls) on existing data models - - +You can raise an [issue](https://github.com/smart-data-models/dataModel.Transportation/issues) or submit your [PR](https://github.com/smart-data-models/dataModel.Transportation/pulls) on existing data models. diff --git a/TrafficFlowObserved/schema.json b/TrafficFlowObserved/schema.json index 5e177d432..54e735258 100644 --- a/TrafficFlowObserved/schema.json +++ b/TrafficFlowObserved/schema.json @@ -87,7 +87,7 @@ "forward", "backward" ], - "description": "Property. Usual direction of travel in the lane referred by this observation. This attribute is useful when the observation is not referencing any road segment, allowing to know the direction of travel of the traffic flow observed. Model:'https://schema.org/Text'. Enum:forward, backward'. See RoadSegment for a description of the semantics of these values" + "description": "Property. Usual direction of travel in the lane referred by this observation. This attribute is useful when the observation is not referencing any road segment, allowing to know the direction of travel of the traffic flow observed. Model:'https://schema.org/Text'. Enum:'forward, backward'. See RoadSegment for a description of the semantics of these values" }, "reversedLane": { "type": "boolean", @@ -133,4 +133,4 @@ "type", "dateObserved" ] -} \ No newline at end of file +} diff --git a/Vehicle/ADOPTERS.yaml b/Vehicle/ADOPTERS.yaml index 276b676a5..48bd562b7 100644 --- a/Vehicle/ADOPTERS.yaml +++ b/Vehicle/ADOPTERS.yaml @@ -24,4 +24,12 @@ currentAdopters: project: https://sedimark.eu/ comments: startDate: +- + adopter: OS2 GPS-Connector + description: Open source project for danish municipalities to collect GPS data for analysis and optimisation + mail: os2fleetoptimiser@os2.eu + organization: https://www.os2.eu/ + project: https://github.com/OS2sandbox/gps-connector + comments: Storing additional meta-data for vehicle, such as 'leasingInfo', is useful for the municipalities when managing their leased vehicles. Further, it is crucial for analysis and optimisation to bring in values such as 'monthlyLeaseCost' and 'allowedAnnualDistance' to account for the TCO of a vehicle. + startDate: \ No newline at end of file diff --git a/Vehicle/README.md b/Vehicle/README.md index 376138901..22229028c 100644 --- a/Vehicle/README.md +++ b/Vehicle/README.md @@ -1,10 +1,11 @@ [![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - # Vehicle +# Vehicle Version: 0.2.2 -## Description +## Description This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. + ### Specification Link to the [interactive specification](https://swagger.lab.fiware.org/?url=https://smart-data-models.github.io/dataModel.Transportation/Vehicle/swagger.yaml) @@ -24,6 +25,7 @@ Link alla [specifica](https://github.com/smart-data-models/dataModel.Transportat [链接到规范](https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/doc/spec_ZH.md) [사양 링크](https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/doc/spec_KO.md) + ### Examples Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/Vehicle/examples/example.json) (keyvalues) for NGSI v2 @@ -41,6 +43,7 @@ Link to the [example](https://github.com/smart-data-models/dataModel.Transportat Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/examples/example-normalized.json.csv) (normalized) for NGSI-V2 in CSV format Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/examples/example-normalized.jsonld.csv) (normalized) for NGSI-LD in CSV format + ### Dynamic Examples generation Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/Vehicle/schema.json&email=info@smartdatamodels.org) of NGSI-LD normalized payloads compliant with this data model. Refresh for new values @@ -48,13 +51,15 @@ Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator.php? Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator_keyvalues.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/Vehicle/schema.json&email=info@smartdatamodels.org) of NGSI-LD keyvalues payloads compliant with this data model. Refresh for new values Link to the [Generator](https://smartdatamodels.org/extra/geojson_features_generator.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/Vehicle/schema.json&email=info@smartdatamodels.org) of geojson feature format payloads compliant with this data model. Refresh for new values + ### PostgreSQL schema Link to the [PostgreSQL schema](https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/schema.sql) of this data model + ### Contribution - If you have any issue on this data model you can raise an [issue](https://github.com/smart-data-models/dataModel.Transportation/issues) or contribute with a [PR](https://github.com/smart-data-models/dataModel.Transportation/pulls) + If you have any issue on this data model you can raise an [issue](https://github.com/smart-data-models/dataModel.Transportation/issues) or contribute with a [PR](https://github.com/smart-data-models/dataModel.Transportation/pulls) - If you wish to develop your own data model you can start from [contribution manual](https://bit.ly/contribution_manual). Several services have been developed to help with: + If you wish to develop your own data model you can start from [contribution manual](https://bit.ly/contribution_manual). Several services have been developed to help with: - [Test data model repository](https://smartdatamodels.org/index.php/data-models-contribution-api/) including the schema and example payloads, etc - [Generate PostgreSQL schema](https://smartdatamodels.org/index.php/sql-service/) to help create a table, create type, etc \ No newline at end of file diff --git a/Vehicle/doc/spec.md b/Vehicle/doc/spec.md index 533b41154..75844e063 100644 --- a/Vehicle/doc/spec.md +++ b/Vehicle/doc/spec.md @@ -47,42 +47,42 @@
full yaml details ```yaml Vehicle: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -122,14 +122,14 @@ Vehicle: model: https://schema.org/Text type: Property battery: - description: 'The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle' + description: The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle maximum: 1 minimum: 0 type: number x-ngsi: type: Property bearing: - description: "Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position)" + description: Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) type: number x-ngsi: model: https://schema.org/Number @@ -144,7 +144,7 @@ Vehicle: type: Property units: Kilograms category: - description: 'Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:''municipalServices, nonTracked, private, public, specialUsage, tracked''. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...)' + description: Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...) items: enum: - municipalServices @@ -207,7 +207,7 @@ Vehicle: x-ngsi: type: Property deviceBatteryStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''connected, disconnected''' + description: Gives the Battery charging status of the reporting device. Enum:'connected, disconnected' enum: - connected - disconnected @@ -222,7 +222,7 @@ Vehicle: model: https://schema.org/Text type: Property emergencyVehicleType: - description: 'Type of emergency vehicle corresponding to this observation. Enum:''policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck' + description: Type of emergency vehicle corresponding to this observation. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck enum: - policeCar - policeMotorcycle @@ -266,7 +266,7 @@ Vehicle: model: https://schema.org/Text type: Property fuelEfficiency: - description: 'The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L)' + description: The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L) type: number x-ngsi: model: https://schema.org/Number @@ -284,7 +284,7 @@ Vehicle: model: https://schema.org/Text type: Property heading: - description: 'Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1`' + description: Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1` oneOf: - exclusiveMaximum: 360 maximum: 360 @@ -313,7 +313,7 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship ignitionStatus: description: Gives the ignition status of the vehicle. True means ignited type: boolean @@ -328,26 +328,32 @@ Vehicle: model: https://schema.org/URL type: Property license_plate: - description: "Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)'" + description: 'Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)''' type: string x-ngsi: model: https://schema.org/Text type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -362,11 +368,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -374,6 +384,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -388,11 +400,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -402,6 +418,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -416,17 +434,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -441,11 +465,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -455,6 +483,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -474,6 +504,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -485,6 +516,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -499,7 +532,7 @@ Vehicle: x-ngsi: type: GeoProperty mileageFromOdometer: - description: 'The total distance travelled by the particular vehicle since its initial production, as read from its odometer' + description: The total distance travelled by the particular vehicle since its initial production, as read from its odometer type: number x-ngsi: model: https://schema.org/mileageFromOdometer @@ -601,25 +634,31 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property previousLocation: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -634,11 +673,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -646,6 +689,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -660,11 +705,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -674,6 +723,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -688,17 +739,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -713,11 +770,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -727,6 +788,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -746,6 +809,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -757,6 +821,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -820,7 +886,7 @@ Vehicle: model: https://schema.org/Boolean type: Property serviceProvided: - description: 'Service(s) the vehicle is capable of providing or it is assigned to. Enum:''auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning''. Or any other value needed by an specific application' + description: Service(s) the vehicle is capable of providing or it is assigned to. Enum:'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Or any other value needed by an specific application items: enum: - auxiliaryServices @@ -854,12 +920,12 @@ Vehicle: model: https://schema.org/DateTime 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' + 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 speed: - description: 'Denotes the magnitude of the horizontal component of the vehicle''s current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason' + description: Denotes the magnitude of the horizontal component of the vehicle's current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason oneOf: - minimum: 0 type: number @@ -890,7 +956,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleConfiguration: - description: 'A short text indicating the configuration of the vehicle, e.g. ''5dr hatchback ST 2.5 MT 225 hp'' or ''limited edition''' + description: A short text indicating the configuration of the vehicle, e.g. '5dr hatchback ST 2.5 MT 225 hp' or 'limited edition' type: string x-ngsi: model: https://schema.org/vehicleConfiguration @@ -908,7 +974,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleRunningStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''running, waiting, stopped''' + description: Gives the Battery charging status of the reporting device. Enum:'running, waiting, stopped' enum: - running - stopped @@ -918,7 +984,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleSpecialUsage: - description: 'Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:''ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement''' + description: Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:'ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement' enum: - ambulance - fireBrigade @@ -938,7 +1004,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses' + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses enum: - agriculturalVehicle - ambulance @@ -1027,11 +1093,11 @@ Vehicle: - category - location 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) 2024 Contributors to Smart Data Models Program' + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/Vehicle/schema.json - x-model-tags: 'IUDX, SEDIMARK' + x-model-tags: IUDX, SEDIMARK x-version: 0.2.2 ```
@@ -1041,7 +1107,7 @@ Vehicle: ## Example payloads #### Vehicle NGSI-v2 key-values Example - Here is an example of a Vehicle in JSON-LD format as key-values. This is compatible with NGSI-v2 when using `options=keyValues` and returns the context data of an individual entity. + Here is an example of a Vehicle in JSON format as key-values. This is compatible with NGSI-v2 when using `options=keyValues` and returns the context data of an individual entity.
show/hide example ```json { @@ -1101,12 +1167,22 @@ Vehicle: "wardName": "Bangalore Urban", "zoneId": "2", "wardNum": 4 + }, + "leasingInfo": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" } } ```
#### Vehicle NGSI-v2 normalized Example - Here is an example of a Vehicle in JSON-LD format as normalized. This is compatible with NGSI-v2 when not using options and returns the context data of an individual entity. + Here is an example of a Vehicle in JSON format as normalized. This is compatible with NGSI-v2 when not using options and returns the context data of an individual entity.
show/hide example ```json { @@ -1277,6 +1353,19 @@ Vehicle: "zoneId": "2", "wardNum": 4 } + }, + "leasingInfo": { + "type": "StructuredValue", + "value": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" + } } } ``` @@ -1343,6 +1432,16 @@ Vehicle: "wardId": "4", "wardName": "Kempegowda Ward", "zoneName": "South Zone", + "leasingInfo": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" + }, "@context": [ "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" ] @@ -1515,6 +1614,19 @@ Vehicle: "zoneName": { "type": "Property", "value": "South Zone" + }, + "leasingInfo": { + "type": "Property", + "value": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" + } }, "@context": [ "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" diff --git a/Vehicle/doc/spec_DE.md b/Vehicle/doc/spec_DE.md index ae1456d1b..4f0630c2e 100644 --- a/Vehicle/doc/spec_DE.md +++ b/Vehicle/doc/spec_DE.md @@ -1,88 +1,178 @@ - + + [![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entität: Fahrzeug -================= - - [Offene Lizenz](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/LICENSE.md) - [Dokument automatisch generiert](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) - - - Globale Beschreibung: **Diese Einheit modelliert ein bestimmtes Fahrzeugmodell, einschließlich aller Eigenschaften, die mehreren zu diesem Modell gehörenden Fahrzeuginstanzen gemeinsam sind.** - Version: 0.2.2 - - - ## Liste der Eigenschaften +Entität: Vehicle +=============== + + + + - [*] Wenn es für ein Attribut keinen Typ gibt, kann es mehrere Typen oder verschiedene Formate/Muster haben. -- `address[object]`: Die Postanschrift . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Das Land. Zum Beispiel, Spanien . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: Die Ortschaft, in der sich die Adresse befindet, und die in der Region liegt . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: Die Region, in der sich der Ort befindet, und die auf dem Land liegt . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: Ein Bezirk ist eine Art von Verwaltungseinheit, die in einigen Ländern von der lokalen Regierung verwaltet wird. - - `postOfficeBoxNumber[string]`: Die Postfachnummer für Postfachadressen. Zum Beispiel, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: Die Postleitzahl. Zum Beispiel, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: Die Straßenanschrift . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) - - `streetNr[string]`: Nummer zur Identifizierung eines bestimmten Grundstücks an einer öffentlichen Straße -- `alternateName[string]`: Ein alternativer Name für diesen Artikel - `annotations[array]`: Anmerkungen zum Artikel . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: Das geografische Gebiet, in dem eine Dienstleistung oder ein angebotener Artikel erbracht wird . Model: [https://schema.org/Text](https://schema.org/Text) - `battery[number]`: Der aktuelle Prozentsatz der verbleibenden Batterie im Falle eines Elektrofahrzeugs oder eines mit dem Fahrzeug verbundenen Geräts - `bearing[number]`: Gibt den GPS-Winkel des Fahrzeugs, gemessen im Uhrzeigersinn vom wahren Norden, an. Entspricht dem Feld "Peilung" der GTFS-Echtzeitnachricht-Position (https://developers.google.com/transit/gtfs-realtime/reference#message-position) . Model: [https://schema.org/Number](https://schema.org/Number) - `cargoWeight[number]`: Aktuelles Gewicht der Ladung des Fahrzeugs . Model: [https://schema.org/Number](https://schema.org/Number) - `category[array]`: Fahrzeugkategorie(n) aus externer Sicht. Dies ist etwas anderes als der Fahrzeugtyp (Pkw, Lkw usw.), der durch die Eigenschaft "vehicleType" dargestellt wird. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. Verfolgte Fahrzeuge sind Fahrzeuge, deren Position permanent von einem entfernten System verfolgt wird. Sie verfügen über einen GPS-Empfänger und eine Netzverbindung, um die gemeldete Position (Standort, Geschwindigkeit, Kurs ...) regelmäßig zu aktualisieren. . Model: [https://schema.org/Text](https://schema.org/Text) - `color[string]`: Die Farbe des Produkts . Model: [https://schema.org/color](https://schema.org/color) - `currentTripCount[number]`: Die aktuelle Anzahl der Fahrten, die von dem Fahrzeug, das dieser Beobachtung entspricht, an dem jeweiligen Betriebstag durchgeführt wurden . Model: [https://schema.org/Number](https://schema.org/Number) - `dataProvider[string]`: Eine Folge von Zeichen zur Identifizierung des Anbieters der harmonisierten Dateneinheit - `dateCreated[date-time]`: Zeitstempel der Entitätserstellung. Dieser wird normalerweise von der Speicherplattform zugewiesen - `dateFirstUsed[date]`: Zeitstempel, der angibt, wann das Fahrzeug zum ersten Mal benutzt wurde . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateModified[date-time]`: Zeitstempel der letzten Änderung der Entität. Dieser wird in der Regel von der Speicherplattform vergeben - `dateVehicleFirstRegistered[date]`: Das Datum der Erstzulassung des Fahrzeugs bei den jeweiligen Behörden . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) - `description[string]`: Eine Beschreibung dieses Artikels - `deviceBatteryStatus[string]`: Gibt den Batterieladestatus des meldenden Geräts an. Enum:'connected, disconnected' . Model: [https://schema.org/Text](https://schema.org/Text) - `deviceSimNumber[string]`: Gibt die SIM-Nummer des Geräts im Fahrzeug an . Model: [https://schema.org/Text](https://schema.org/Text) - `emergencyVehicleType[string]`: Typ des Einsatzfahrzeugs, das dieser Beobachtung entspricht. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck . Model: [https://schema.org/Text](https://schema.org/Text) - `feature[array]`: Vom Fahrzeug eingebaute Funktion(en). Enum:' abs, airbag, alarm, backCamera, disabledRamp, gps, internetConnection, overspeed, proximitySensor, wifi'. Oder jedes andere, das die Anwendung benötigt. Um mehrere Instanzen eines Merkmals darzustellen, kann die folgende Syntax verwendet werden: ,". Zum Beispiel, ein Auto mit 4 Airbags wird durch `airbag,4` dargestellt. . Model: [https://schema.org/Text](https://schema.org/Text) - `fleetVehicleId[string]`: Die Kennung des Fahrzeugs im Zusammenhang mit der Fahrzeugflotte, zu der es gehört . Model: [https://schema.org/Text](https://schema.org/Text) - `fuelEfficiency[number]`: Die pro verbrauchter Kraftstoffeinheit zurückgelegte Strecke, in der Regel in Kilometern pro Liter (km/L) . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelFilled[number]`: Menge des in das Fahrzeug eingefüllten Kraftstoffs in Litern, die dieser Beobachtung entspricht . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelType[string]`: Die Art des Kraftstoffs, der für den Motor oder die Motoren des Fahrzeugs geeignet ist, das dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - `heading[*]`: Bezeichnet die Fahrtrichtung des Fahrzeugs und wird in Dezimalgraden angegeben, wobei 0 <= "Fahrtrichtung" < 360, im Uhrzeigersinn relativ zum wahren Norden gezählt wird. Wenn das Fahrzeug steht (d. h. der Wert des Attributs "Geschwindigkeit" ist "0"), muss der Wert des Attributs "Richtung" gleich "1" sein. . Model: [https://schema.org/Number](https://schema.org/Number) - `id[*]`: Eindeutiger Bezeichner der Entität - `ignitionStatus[boolean]`: Gibt den Zündungsstatus des Fahrzeugs an. Wahr bedeutet gezündet . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `image[uri]`: Ein Bild des Artikels . Model: [https://schema.org/URL](https://schema.org/URL) - `license_plate[string]`: Gibt das Nummernschild des Fahrzeugs an. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)' . Model: [https://schema.org/Text](https://schema.org/Text) - `location[*]`: Geojson-Referenz auf das Element. Es kann Punkt, LineString, Polygon, MultiPoint, MultiLineString oder MultiPolygon sein - `mileageFromOdometer[number]`: Die auf dem Kilometerzähler abgelesene Gesamtkilometerleistung des Fahrzeugs seit seiner ersten Herstellung . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) - `municipalityInfo[object]`: Informationen der Gemeinde zu dieser Beobachtung . Model: [https://schema.org/Text](https://schema.org/Text) - `cityId[string]`: ID der Stadt, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - - `cityName[string]`: Name der Stadt, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - - `district[string]`: Name des Bezirks, der dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - - `stateName[string]`: Name des Staates, der dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - - `ulbName[string]`: Name der lokalen Gebietskörperschaft, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardId[string]`: Stations-ID, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardName[string]`: Name der Station, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardNum[number]`: Stationsnummer, die dieser Beobachtung entspricht . Model: [https://schema.org/Number](https://schema.org/Number) - - `zoneId[string]`: ID der Zone, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - - `zoneName[string]`: Name der Zone, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) -- `name[string]`: Der Name dieses Artikels - `observationDateTime[date-time]`: Letzter gemeldeter Zeitpunkt der Beobachtung . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `owner[array]`: Eine Liste mit einer JSON-kodierten Zeichenfolge, die auf die eindeutigen Kennungen der Eigentümer verweist - `previousLocation[*]`: Geojson-Referenz auf das Element. Es kann Punkt, LineString, Polygon, MultiPoint, MultiLineString oder MultiPolygon sein - `purchaseDate[date-time]`: Das Datum, an dem das Objekt, z. B. das Fahrzeug, vom derzeitigen Eigentümer gekauft wurde . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) - `refVehicleModel[*]`: Verweis auf ein VehicleModel . Model: [https://schema.org/URL](https://schema.org/URL) - `reportId[string]`: Eindeutige Kennung für das Problem, den Bericht, das Feedback oder die Transaktion, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - `seeAlso[*]`: Liste von URLs, die auf zusätzliche Ressourcen zu dem Artikel verweisen - `serviceOnDuty[boolean]`: Art des Dienstes, den das dieser Beobachtung entsprechende Einsatzfahrzeug leistet. True zeigt an, dass das dieser Beobachtung entsprechende Einsatzfahrzeug einen Notruf bedient/ bedient und andernfalls False . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `serviceProvided[array]`: Dienst(e), den/die das Fahrzeug leisten kann oder dem/denen es zugewiesen ist. Enum:'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Oder jeder andere Wert, der für eine bestimmte Anwendung benötigt wird . Model: [https://schema.org/Text](https://schema.org/Text) - `serviceStatus[string]`: Fahrzeugstatus (unter dem Gesichtspunkt der erbrachten Dienstleistung, kann also nicht für Privatfahrzeuge gelten). geparkt": Das Fahrzeug ist geparkt und erbringt derzeit keine Dienstleistung. onRoute": Das Fahrzeug führt einen Einsatz durch. Ein durch Komma getrennter Modifikator kann hinzugefügt werden, um anzugeben, für welchen Auftrag das Fahrzeug gerade unterwegs ist. So kann z. B. mit "onRoute,garbageCollection" angegeben werden, dass sich das Fahrzeug auf einer Route und in einem Müllsammelauftrag befindet. kaputt" : Das Fahrzeug hat eine vorübergehende Panne. outOfService": Das Fahrzeug ist auf der Straße, führt aber keinen Einsatz durch, sondern fährt wahrscheinlich zu seinem Parkplatz. Enum:'broken, onRoute, outOfService, parked' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `source[string]`: Eine Folge von Zeichen, die die ursprüngliche Quelle der Entitätsdaten als URL angibt. Empfohlen wird der voll qualifizierte Domänenname des Quellanbieters oder die URL des Quellobjekts. - `speed[*]`: Bezeichnet die Größe der horizontalen Komponente der aktuellen Geschwindigkeit des Fahrzeugs und wird in Kilometern pro Stunde angegeben. Falls angegeben, muss der Wert des Attributs "Geschwindigkeit" eine nichtnegative reelle Zahl sein. Der Wert "-1" KANN verwendet werden, wenn die Geschwindigkeit aus irgendeinem Grund vorübergehend nicht bekannt ist. . Model: [https://schema.org/Number](https://schema.org/Number) - `tripNetWeightCollected[number]`: Das Nettogewicht, das das Fahrzeug entsprechend dieser Beobachtung am Ende der Fahrt aufnimmt . Model: [https://schema.org/Number](https://schema.org/Number) - `type[string]`: NGSI-Entitätstyp. Es muss Fahrzeug sein - `vehicleAltitude[string]`: Gibt die aktuelle Höhe des Fahrzeugs über GPS an . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleConfiguration[string]`: Ein kurzer Text, der die Konfiguration des Fahrzeugs angibt, z. B. "5dr Fließheck ST 2.5 MT 225 PS" oder "Limited Edition". . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) - `vehicleIdentificationNumber[string]`: Die Fahrzeug-Identifikationsnummer (VIN) ist eine eindeutige Seriennummer, die von der Automobilindustrie zur Identifizierung einzelner Kraftfahrzeuge verwendet wird. . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) - `vehiclePlateIdentifier[string]`: Eine Kennung oder ein Code, die bzw. der auf einem am Fahrzeug angebrachten Nummernschild zur amtlichen Identifizierung angebracht ist. Die Zulassungskennung ist numerisch oder alphanumerisch und ist innerhalb der Region der ausstellenden Behörde eindeutig. Normative Verweise: DATEXII `vehicleRegistrationPlateIdentifier` . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleRunningStatus[string]`: Gibt den Batterieladestatus des meldenden Geräts an. Enum:'running, waiting, stopped' . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleSpecialUsage[string]`: Gibt an, ob das Fahrzeug für besondere Zwecke verwendet wurde, z. B. für gewerbliche Vermietung, Fahrschule oder als Taxi. In vielen Ländern ist diese Information gesetzlich vorgeschrieben, wenn ein Fahrzeug zum Verkauf angeboten wird. Enum:'Krankenwagen, Feuerwehr, Militär, Polizei, Schülertransport, Taxi, Müllabfuhr' . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) - `vehicleTrackerDevice[string]`: Installationsstatus des GPS-Geräts oder des Ortungsgeräts, das in das Fahrzeug eingebaut ist, das dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleType[string]`: Fahrzeugtyp unter dem Gesichtspunkt seiner strukturellen Merkmale. Dies ist etwas anderes als die Fahrzeugklasse. Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, MotorradMitSeitenwagen, Motorroller, Kehrmaschine, Tankwagen, Dreiradfahrzeug, Anhänger, Straßenbahn, Zweiradfahrzeug, Draisine, Lieferwagen, FahrzeugOhneKatalysator, FahrzeugMitWohnwagen, FahrzeugMitAnhänger, mitGeradeNummernKennzeichen, mitUngeradeNummernKennzeichen, Sonstiges". Die folgenden Werte, die durch _VehicleTypeEnum_ und _VehicleTypeEnum2_, [DATEX 2 Version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) definiert und für andere Verwendungen erweitert wurden . Model: [https://schema.org/Text](https://schema.org/Text) - `wardId[string]`: Stations-ID der Einrichtung, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - `wardName[string]`: Name der Entität, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - `zoneName[string]`: Zonenname der Entität, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) - - Erforderliche Eigenschaften -- `category` - `id` - `location` - `type` - `vehicleType` - - - - ## Datenmodell Beschreibung der Eigenschaften - Alphabetisch sortiert (für Details anklicken) - - +[Offene Lizenz](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/LICENSE.md) + +[Dokument wurde automatisch generiert](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) + + + + + +Global description: **Diese Entität modelliert ein bestimmtes Fahrzeugmodell, einschließlich aller Eigenschaften, die mehreren Fahrzeuginstanzen angehören, die zu einem solchen Modell gehören.** + +version: 0.2.2 + + + + + + +## Liste der Eigenschaften + + +[*] Wenn es in einem Attribut keinen Typ gibt, liegt das daran, dass es mehrere Typen oder unterschiedliche Formate/Muster haben könnte +- `address[object]`: Die Postadresse . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: Das Land. Zum Beispiel Spanien . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: Die Ortschaft, in der sich die Straßenadresse befindet und die in der Region liegt . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: Die Region, in der die Ortschaft liegt und die im Land liegt . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Ein Bezirk ist eine Art von Verwaltungseinheit, die in einigen Ländern von der lokalen Regierung verwaltet wird + - `postOfficeBoxNumber[string]`: Die Postfachnummer für Postfachadressen. Zum Beispiel 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Die Postleitzahl. Zum Beispiel 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: Die Straßenadresse . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Nummer, die ein bestimmtes Grundstück auf einer öffentlichen Straße identifiziert +- `alternateName[string]`: Ein alternativer Name für diesen Artikel +- `annotations[array]`: Anmerkungen zum Artikel . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: Das geografische Gebiet, in dem ein Service oder ein angebotenes Produkt bereitgestellt wird . Model: [https://schema.org/Text](https://schema.org/Text) +- `battery[number]`: Der aktuelle Prozentsatz der verbleibenden Batteriekapazität im Falle eines Elektrofahrzeugs oder eines an das Fahrzeug angeschlossenen Geräts +- `bearing[number]`: Gibt den GPS-Winkel des Fahrzeugs an, gemessen im Uhrzeigersinn vom wahren Norden. Entsprechend dem 'bearing'-Feld der GTFS-Echtzeitnachricht-Position (https://developers.google.com/transit/gtfs-realtime/reference#message-position) . Model: [https://schema.org/Number](https://schema.org/Number) +- `cargoWeight[number]`: Aktuelles Gewicht der Ladung des Fahrzeugs . Model: [https://schema.org/Number](https://schema.org/Number) +- `category[array]`: Fahrzeugkategorie(n) aus einer externen Perspektive. Dies ist anders als der Fahrzeugtyp (Auto, LKW usw.), der durch die `vehicleType`-Eigenschaft dargestellt wird. Enum: 'municipalServices, nonTracked, private, public, specialUsage, tracked'. Geführte Fahrzeuge sind solche, deren Position permanent von einem Fernsystem verfolgt wird. Oder alle anderen, die von einer Anwendung benötigt werden. Sie enthalten einen GPS-Empfänger zusammen mit einer Netzwerkverbindung, um regelmäßig eine gemeldete Position (Ort, Geschwindigkeit, Richtung ...) zu aktualisieren. . Model: [https://schema.org/Text](https://schema.org/Text) +- `color[string]`: Die Farbe des Produkts . Model: [https://schema.org/color](https://schema.org/color) +- `currentTripCount[number]`: Die aktuelle Anzahl der Fahrten, die das Fahrzeug entsprechend dieser Beobachtung an dem gegebenen Betriebstag unternommen hat . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: Eine Folge von Zeichen, die den Anbieter der harmonisierten Datenentität identifiziert +- `dateCreated[date-time]`: Zeitstempel für die Erstellung der Entität. Dieser wird in der Regel von der Speicherplattform zugewiesen +- `dateFirstUsed[date]`: Zeitstempel, der angibt, wann das Fahrzeug erstmals verwendet wurde . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `dateModified[date-time]`: Zeitstempel der letzten Änderung der Entität. Dieser wird in der Regel von der Speicherplattform zugewiesen +- `dateVehicleFirstRegistered[date]`: Das Datum der ersten Registrierung des Fahrzeugs bei den zuständigen Behörden . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) +- `description[string]`: Eine Beschreibung dieses Artikels +- `deviceBatteryStatus[string]`: Gibt den Ladezustand der Batterie des meldepflichtigen Geräts an. Enum: 'verbunden, getrennt' . Model: [https://schema.org/Text](https://schema.org/Text) +- `deviceSimNumber[string]`: Gibt die SIM-Nummer des Geräts im Fahrzeug an . Model: [https://schema.org/Text](https://schema.org/Text) +- `emergencyVehicleType[string]`: Art des Rettungsfahrzeugs, das dieser Beobachtung entspricht. Enum: 'Polizeiwagen, Polizeimotorrad, Polizeivan, Polizei-SWAT, Feuerwehrwagen, Tanklöschfahrzeug, Luftrettung, Rettungswagen, Motorradrettung, Rettungsfahrzeug, Fahrzeug für gefährliche Stoffe, Abschleppwagen' . Model: [https://schema.org/Text](https://schema.org/Text) +- `feature[array]`: Funktion(en), die in das Fahrzeug integriert sind. Enum: 'abs, airbag, alarm, backCamera, disabledRamp, gps, internetConnection, overspeed, proximitySensor, wifi'. Oder alle anderen, die von der Anwendung benötigt werden. Um mehrere Instanzen einer Funktion darzustellen, kann die folgende Syntax verwendet werden: `,`. Zum Beispiel wird ein Auto mit 4 Airbags durch `airbag,4` dargestellt . Model: [https://schema.org/Text](https://schema.org/Text) +- `fleetVehicleId[string]`: Die Identifikationsnummer des Fahrzeugs im Kontext der Fahrzeugflotte, der es angehört . Model: [https://schema.org/Text](https://schema.org/Text) +- `fuelEfficiency[number]`: Die zurückgelegte Strecke pro verbrauchter Brennstoffeinheit, üblicherweise in Kilometern pro Liter (km/L) . Model: [https://schema.org/Number](https://schema.org/Number) +- `fuelFilled[number]`: Menge an in Litern aufgefülltem Kraftstoff für das Fahrzeug, das dieser Beobachtung entspricht . Model: [https://schema.org/Number](https://schema.org/Number) +- `fuelType[string]`: Die Art des Kraftstoffs, der für den Motor oder die Motoren des Fahrzeugs geeignet ist, das dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) +- `heading[*]`: Bennent die Fahrtrichtung des Fahrzeugs und wird in Dezimalgraden angegeben, wobei 0 <= `heading` < 360, im Uhrzeigersinn relativ zum wahren Norden gezählt. Wenn das Fahrzeug stationär ist (d. h. der Wert des `speed`-Attributs ist `0`), muss der Wert des `heading`-Attributs `-1` entsprechen . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: Eindeutiger Identifikator der Entität +- `ignitionStatus[boolean]`: Gibt den Zündungsstatus des Fahrzeugs an. True bedeutet entzündet . Model: [https://schema.org/Boolean](https://schema.org/Boolean) +- `image[uri]`: Ein Bild des Artikels . Model: [https://schema.org/URL](https://schema.org/URL) +- `license_plate[string]`: Gibt die Nummer des Kennzeichens des Fahrzeugs an. SameAs: license_plate-Feld aus GTFS-Echtzeitnachricht-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor) . Model: [https://schema.org/Text](https://schema.org/Text) +- `location[*]`: Geojson-Referenz zum Artikel. Es kann Punkt, Linienzug, Polygon, MultiPunkt, MultiLinienzug oder MultiPolygon sein +- `mileageFromOdometer[number]`: Die gesamte vom jeweiligen Fahrzeug seit seiner ersten Produktion zurückgelegte Strecke, wie sie vom Tachometer abgelesen wird . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) +- `municipalityInfo[object]`: Gemeindeinformationen, die dieser Beobachtung entsprechen . Model: [https://schema.org/Text](https://schema.org/Text) + - `cityId[string]`: Stadt-ID, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) + - `cityName[string]`: Stadtname, der dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) + - `district[string]`: Bezirksname entsprechend dieser Beobachtung . Model: [https://schema.org/Text](https://schema.org/Text) + - `stateName[string]`: Name des Staates, der dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) + - `ulbName[string]`: Name des städtischen lokalen Verwaltungskörpers, der dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardId[string]`: Ward-ID, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardName[string]`: Name des Ward, der dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardNum[number]`: Stationsnummer, die dieser Beobachtung entspricht . Model: [https://schema.org/Number](https://schema.org/Number) + - `zoneId[string]`: Zonen-ID, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) + - `zoneName[string]`: Zonennamen, die dieser Beobachtung entsprechen . Model: [https://schema.org/Text](https://schema.org/Text) +- `name[string]`: Der Name dieses Artikels +- `observationDateTime[date-time]`: Letzte gemeldete Beobachtungszeit . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `owner[array]`: Eine Liste, die eine JSON-kodierte Zeichenfolge enthält, die auf die eindeutigen IDs des/die Eigentümer(s) verweist +- `previousLocation[*]`: Geojson-Referenz zum Artikel. Es kann Punkt, Linienzug, Polygon, MultiPunkt, MultiLinienzug oder MultiPolygon sein +- `purchaseDate[date-time]`: Das Datum, an dem das Objekt, z. B. das Fahrzeug, vom aktuellen Eigentümer gekauft wurde . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) +- `refVehicleModel[*]`: Verweis auf ein Fahrzeugmodell . Model: [https://schema.org/URL](https://schema.org/URL) +- `reportId[string]`: Eindeutige ID, die für das Problem oder den Bericht oder das Feedback oder die Transaktion zugewiesen wird, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: Liste von URIs, die auf zusätzliche Ressourcen über das Element verweisen +- `serviceOnDuty[boolean]`: Art der von dem entsprechenden Rettungsfahrzeug erbrachten Dienstleistung. True bedeutet, dass das entsprechende Rettungsfahrzeug einem Notruf nachkommt bzw. eine Notrufdienstleistung erbringt und False ist ansonsten . Model: [https://schema.org/Boolean](https://schema.org/Boolean) +- `serviceProvided[array]`: Dienst(e), den das Fahrzeug leisten kann oder dem es zugewiesen ist. Enum: 'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Oder jeder andere Wert, der von einer bestimmten Anwendung benötigt wird . Model: [https://schema.org/Text](https://schema.org/Text) +- `serviceStatus[string]`: Fahrzeugstatus (aus der Sicht der bereitgestellten Dienstleistung, daher kann er nicht auf private Fahrzeuge anwendbar sein). `parked` : Das Fahrzeug ist geparkt und bietet derzeit keinen Dienst. `onRoute` : Das Fahrzeug führt eine Mission aus. Ein durch Komma getrennter Modifikator kann hinzugefügt werden, um anzugeben, welche Mission das Fahrzeug derzeit ausführt. Zum Beispiel kann `onRoute,Abfallentsorgung` verwendet werden, um anzugeben, dass das Fahrzeug unterwegs ist und eine Abfallentsorgungsmission ausführt. `defekt` : Das Fahrzeug erleidet einen vorübergehenden Ausfall. `außerBetrieb` : Das Fahrzeug ist auf der Straße, führt aber keine Mission aus, wahrscheinlich auf dem Weg zu seinem Parkplatz. Enum:'defekt, onRoute, außerBetrieb, geparkt' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `source[string]`: Eine Folge von Zeichen, die die ursprüngliche Quelle der Entitätsdaten als URL angibt. Es wird empfohlen, den vollqualifizierten Domänennamen des Quellanbieters oder die URL zum Quellobjekt zu verwenden. +- `speed[*]`: Bennent die Größe der horizontalen Komponente der aktuellen Geschwindigkeit des Fahrzeugs und wird in Kilometern pro Stunde angegeben. Wenn vorhanden, muss der Wert des Speed-Attributs eine nicht-negative reelle Zahl sein. `-1` DARF verwendet werden, wenn die Geschwindigkeit aus einem bestimmten Grund vorübergehend unbekannt ist . Model: [https://schema.org/Number](https://schema.org/Number) +- `tripNetWeightCollected[number]`: Das Nettogewicht, das vom Fahrzeug, das dieser Beobachtung entspricht, am Ende der Fahrt gesammelt wurde . Model: [https://schema.org/Number](https://schema.org/Number) +- `type[string]`: NGSI-Entitätentyp. Es muss Fahrzeug sein +- `vehicleAltitude[string]`: Gibt die aktuelle Höhe des Fahrzeugs unter Verwendung von GPS an . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleConfiguration[string]`: Ein kurzer Text, der die Konfiguration des Fahrzeugs angibt, z. B. '5-türer Schrägheck ST 2,5 MT 225 PS' oder 'Limitierte Auflage' . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) +- `vehicleIdentificationNumber[string]`: Die Fahrzeugidentifikationsnummer (FIN) ist eine eindeutige Seriennummer, die von der Automobilindustrie verwendet wird, um einzelne Kraftfahrzeuge zu identifizieren . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) +- `vehiclePlateIdentifier[string]`: Ein Identifikator oder Code, der auf einer am Fahrzeug angebrachten Zulassungsplakette angezeigt wird und zu offiziellen Identifizierungszwecken verwendet wird. Der Registrierungsidentifikator ist numerisch oder alphanumerisch und innerhalb der Region der ausgebenden Behörde eindeutig. Normative Verweisungen: DATEXII `vehicleRegistrationPlateIdentifier` . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleRunningStatus[string]`: Gibt den Ladezustand der Batterie des meldepflichtigen Geräts an. Enum: 'laufend, wartend, gestoppt' . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleSpecialUsage[string]`: Gibt an, ob das Fahrzeug für besondere Zwecke wie gewerbliche Vermietung, Fahrschule oder als Taxi verwendet wurde. Die Gesetzgebung in vielen Ländern erfordert, dass diese Informationen offengelegt werden, wenn ein Auto zum Verkauf angeboten wird. Enum: 'Rettungswagen, Feuerwehr, Militär, Polizei, Schultransport, Taxi, Abfallwirtschaft' . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) +- `vehicleTrackerDevice[string]`: Installationsstatus des GPS-Geräts oder des zu diesem Fahrzeug gehörenden Ortungsgeräts, entsprechend dieser Beobachtung . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleType[string]`: Fahrzeugtyp aus Sicht seiner strukturellen Eigenschaften. Dies ist anders als die Fahrzeugkategorie. Enum: 'LandwirtschaftlichesFahrzeug, beliebigesFahrzeug, Gelenkfahrzeug, Fahrrad, Abfallwagen, Bus, Pkw, Wohnwagen, PkwOderLeichtesFahrzeug, PkwMitWohnwagen, PkwMitAnhänger, Reinigungswagen, Baufahrzeug, Allradfahrzeug, Hochseitenfahrzeug, Lkw, Minibus, Moped, Motorrad, MotorradMitBeiwagen, Motorroller, Kehrmaschine, Tankwagen, Dreiradfahrzeug, Anhänger, Straßenbahn, ZweiRäderFahrzeug, Wagen, FahrzeugOhneKatalysator, FahrzeugMitWohnwagen, FahrzeugMitAnhänger, mitGerademKennzeichen, mitUngerademKennzeichen, andere'. Die folgenden Werte sind definiert durch _VehicleTypeEnum_ und _VehicleTypeEnum2_, [DATEX 2 Version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) und für andere Verwendungen erweitert. . Model: [https://schema.org/Text](https://schema.org/Text) +- `wardId[string]`: Ward-ID der Entität, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) +- `wardName[string]`: Name des Ward der diesem Beobachtung entsprechenden Entität . Model: [https://schema.org/Text](https://schema.org/Text) +- `zoneName[string]`: Zonennamen der Entität, die dieser Beobachtung entspricht . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +Erforderliche Eigenschaften +- `Kategorie` +- `id` +- `Standort` +- `Typ` +- `Fahrzeugtyp` + + + + + + + + + +## Datenmodellbeschreibung von Eigenschaften + +Sortiert alphabetisch (Klicken für Details) + + + +
full yaml details - ```yaml + +```yaml Vehicle: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -122,14 +212,14 @@ Vehicle: model: https://schema.org/Text type: Property battery: - description: 'The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle' + description: The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle maximum: 1 minimum: 0 type: number x-ngsi: type: Property bearing: - description: "Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position)" + description: Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) type: number x-ngsi: model: https://schema.org/Number @@ -144,7 +234,7 @@ Vehicle: type: Property units: Kilograms category: - description: 'Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:''municipalServices, nonTracked, private, public, specialUsage, tracked''. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...)' + description: Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...) items: enum: - municipalServices @@ -207,7 +297,7 @@ Vehicle: x-ngsi: type: Property deviceBatteryStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''connected, disconnected''' + description: Gives the Battery charging status of the reporting device. Enum:'connected, disconnected' enum: - connected - disconnected @@ -222,7 +312,7 @@ Vehicle: model: https://schema.org/Text type: Property emergencyVehicleType: - description: 'Type of emergency vehicle corresponding to this observation. Enum:''policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck' + description: Type of emergency vehicle corresponding to this observation. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck enum: - policeCar - policeMotorcycle @@ -266,7 +356,7 @@ Vehicle: model: https://schema.org/Text type: Property fuelEfficiency: - description: 'The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L)' + description: The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L) type: number x-ngsi: model: https://schema.org/Number @@ -284,7 +374,7 @@ Vehicle: model: https://schema.org/Text type: Property heading: - description: 'Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1`' + description: Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1` oneOf: - exclusiveMaximum: 360 maximum: 360 @@ -313,7 +403,7 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship ignitionStatus: description: Gives the ignition status of the vehicle. True means ignited type: boolean @@ -328,26 +418,32 @@ Vehicle: model: https://schema.org/URL type: Property license_plate: - description: "Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)'" + description: 'Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)''' type: string x-ngsi: model: https://schema.org/Text type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -362,11 +458,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -374,6 +474,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -388,11 +490,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -402,6 +508,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -416,17 +524,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -441,11 +555,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -455,6 +573,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -474,6 +594,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -485,6 +606,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -499,7 +622,7 @@ Vehicle: x-ngsi: type: GeoProperty mileageFromOdometer: - description: 'The total distance travelled by the particular vehicle since its initial production, as read from its odometer' + description: The total distance travelled by the particular vehicle since its initial production, as read from its odometer type: number x-ngsi: model: https://schema.org/mileageFromOdometer @@ -601,25 +724,31 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property previousLocation: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -634,11 +763,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -646,6 +779,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -660,11 +795,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -674,6 +813,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -688,17 +829,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -713,11 +860,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -727,6 +878,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -746,6 +899,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -757,6 +911,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -820,7 +976,7 @@ Vehicle: model: https://schema.org/Boolean type: Property serviceProvided: - description: 'Service(s) the vehicle is capable of providing or it is assigned to. Enum:''auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning''. Or any other value needed by an specific application' + description: Service(s) the vehicle is capable of providing or it is assigned to. Enum:'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Or any other value needed by an specific application items: enum: - auxiliaryServices @@ -854,12 +1010,12 @@ Vehicle: model: https://schema.org/DateTime 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' + 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 speed: - description: 'Denotes the magnitude of the horizontal component of the vehicle''s current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason' + description: Denotes the magnitude of the horizontal component of the vehicle's current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason oneOf: - minimum: 0 type: number @@ -890,7 +1046,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleConfiguration: - description: 'A short text indicating the configuration of the vehicle, e.g. ''5dr hatchback ST 2.5 MT 225 hp'' or ''limited edition''' + description: A short text indicating the configuration of the vehicle, e.g. '5dr hatchback ST 2.5 MT 225 hp' or 'limited edition' type: string x-ngsi: model: https://schema.org/vehicleConfiguration @@ -908,7 +1064,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleRunningStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''running, waiting, stopped''' + description: Gives the Battery charging status of the reporting device. Enum:'running, waiting, stopped' enum: - running - stopped @@ -918,7 +1074,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleSpecialUsage: - description: 'Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:''ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement''' + description: Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:'ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement' enum: - ambulance - fireBrigade @@ -938,7 +1094,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses' + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses enum: - agriculturalVehicle - ambulance @@ -1027,24 +1183,33 @@ Vehicle: - category - location 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) 2024 Contributors to Smart Data Models Program' + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/Vehicle/schema.json - x-model-tags: 'IUDX, SEDIMARK' + x-model-tags: IUDX, SEDIMARK x-version: 0.2.2 ```
- - - - - ## Beispiel-Nutzlasten - #### Fahrzeug NGSI-v2 Schlüsselwerte Beispiel - Hier ist ein Beispiel für ein Fahrzeug im JSON-LD-Format als Schlüsselwerte. Dies ist mit NGSI-v2 kompatibel, wenn `options=keyValues` verwendet wird, und liefert die Kontextdaten einer einzelnen Entität. + + + + + + + + + +## Beispielnutzlasten + +#### Fahrzeug NGSI-v2 Schlüssel-Wert-Beispiel + +Hier ist ein Beispiel für ein Fahrzeug im JSON-Format als Schlüssel-Werte. Dies ist kompatibel mit NGSI-v2, wenn `options=keyValues` verwendet wird und es die Kontextdaten einer einzelnen Entität zurückgibt.
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "vehicleType": "lorry", @@ -1105,11 +1270,15 @@ Vehicle: } ```
- #### Fahrzeug NGSI-v2 normalisiert Beispiel - Hier ist ein Beispiel für ein Fahrzeug im JSON-LD-Format in normalisierter Form. Dies ist mit NGSI-v2 kompatibel, wenn keine Optionen verwendet werden, und liefert die Kontextdaten einer einzelnen Entität. + +#### Fahrzeug NGSI-v2 normalisiertes Beispiel + +Hier ist ein Beispiel für ein Fahrzeug im JSON-Format als normalisiert. Dies ist kompatibel mit NGSI-v2, wenn keine Optionen verwendet werden und es die Kontextdaten einer einzelnen Entität zurückgibt.
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "category": { @@ -1281,11 +1450,15 @@ Vehicle: } ```
- #### Fahrzeug NGSI-LD-Schlüsselwerte Beispiel - Hier ist ein Beispiel für ein Fahrzeug im JSON-LD-Format als Schlüsselwerte. Dies ist mit NGSI-LD kompatibel, wenn `options=keyValues` verwendet wird und liefert die Kontextdaten einer einzelnen Entität. + +#### Fahrzeug-NGSI-LD-Schlüsselwert-Beispiel + +Hier ist ein Beispiel für ein Fahrzeug im JSON-LD-Format als Schlüssel-Werte. Dies ist kompatibel mit NGSI-LD, wenn `options=keyValues` verwendet wird und die Kontextdaten einer einzelnen Entität zurückgibt.
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": "Centro", @@ -1349,11 +1522,15 @@ Vehicle: } ```
- #### Fahrzeug NGSI-LD normalisiert Beispiel - Hier ist ein Beispiel für ein Fahrzeug im JSON-LD-Format in normalisierter Form. Dies ist mit NGSI-LD kompatibel, wenn keine Optionen verwendet werden, und liefert die Kontextdaten einer einzelnen Entität. + +#### Fahrzeug NGSI-LD normalisiertes Beispiel + +Hier ist ein Beispiel für ein Fahrzeug im JSON-LD-Format als normalisiert. Dies ist kompatibel mit NGSI-LD, wenn keine Optionen verwendet werden und gibt die Kontextdaten einer einzelnen Entität zurück.
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": { @@ -1521,12 +1698,21 @@ Vehicle: ] } ``` -
- - - - Siehe [FAQ 10] (https://smartdatamodels.org/index.php/faqs/), um eine Antwort auf die Frage zu erhalten, wie man mit Größeneinheiten umgeht - - +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + --- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/Vehicle/doc/spec_ES.md b/Vehicle/doc/spec_ES.md index d933da01b..9ace85a39 100644 --- a/Vehicle/doc/spec_ES.md +++ b/Vehicle/doc/spec_ES.md @@ -1,88 +1,178 @@ - + + [![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entidad: Vehículo -================= - - [Licencia abierta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/LICENSE.md) - [documento generado automáticamente](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) - - - Descripción global: **Esta entidad modela un modelo de vehículo en particular, incluyendo todas las propiedades que son comunes a múltiples instancias de vehículos pertenecientes a dicho modelo.** - versión: 0.2.2 - - - ## Lista de propiedades +Entidad: Vehicle +=============== + + + + - [*] Si no hay un tipo en un atributo es porque puede tener varios tipos o diferentes formatos/patrones. -- `address[object]`: La dirección postal . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: El país. Por ejemplo, España . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: La localidad en la que se encuentra la dirección postal, y que está en la región . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: La región en la que se encuentra la localidad, y que está en el país . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: Un distrito es un tipo de división administrativa que, en algunos países, gestiona el gobierno local - - `postOfficeBoxNumber[string]`: El número del apartado de correos para las direcciones de apartados postales. Por ejemplo, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: El código postal. Por ejemplo, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: La dirección . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) - - `streetNr[string]`: Número que identifica una propiedad específica en una vía pública -- `alternateName[string]`: Un nombre alternativo para este artículo - `annotations[array]`: Anotaciones sobre el artículo . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: La zona geográfica en la que se presta un servicio o se ofrece un artículo . Model: [https://schema.org/Text](https://schema.org/Text) - `battery[number]`: El porcentaje actual de batería restante en el caso de un vehículo eléctrico, o un dispositivo conectado al vehículo. - `bearing[number]`: Indica el ángulo GPS del vehículo medido en el sentido de las agujas del reloj a partir del Norte verdadero. Igual que el campo "bearing" de GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) . Model: [https://schema.org/Number](https://schema.org/Number) - `cargoWeight[number]`: Peso actual de la carga del vehículo . Model: [https://schema.org/Number](https://schema.org/Number) - `category[array]`: Categoría(s) de vehículo(s) desde un punto de vista externo. Es diferente del tipo de vehículo (coche, camión, etc.) representado por la propiedad `vehicleType`. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. Los vehículos rastreados son aquellos cuya posición es seguida permanentemente por un sistema remoto. O cualquier otro que necesite una aplicación Incorporan un receptor GPS junto con una conexión de red para actualizar periódicamente una posición notificada (localización, velocidad, rumbo...) . Model: [https://schema.org/Text](https://schema.org/Text) - `color[string]`: El color del producto . Model: [https://schema.org/color](https://schema.org/color) - `currentTripCount[number]`: El recuento actual de los viajes realizados por el vehículo correspondiente a esta observación en el día de funcionamiento dado. . Model: [https://schema.org/Number](https://schema.org/Number) - `dataProvider[string]`: Una secuencia de caracteres que identifica al proveedor de la entidad de datos armonizada - `dateCreated[date-time]`: Fecha de creación de la entidad. Normalmente será asignada por la plataforma de almacenamiento - `dateFirstUsed[date]`: Marca de tiempo que indica cuándo se utilizó el vehículo por primera vez . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateModified[date-time]`: Marca de tiempo de la última modificación de la entidad. Suele ser asignada por la plataforma de almacenamiento - `dateVehicleFirstRegistered[date]`: La fecha de la primera matriculación del vehículo ante las autoridades públicas respectivas . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) - `description[string]`: Descripción de este artículo - `deviceBatteryStatus[string]`: Indica el estado de carga de la batería del dispositivo informador. Enum:'conectado, desconectado' . Model: [https://schema.org/Text](https://schema.org/Text) - `deviceSimNumber[string]`: Indica el número SIM del dispositivo en el vehículo . Model: [https://schema.org/Text](https://schema.org/Text) - `emergencyVehicleType[string]`: Tipo de vehículo de emergencia correspondiente a esta observación. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck. . Model: [https://schema.org/Text](https://schema.org/Text) - `feature[array]`: Característica(s) incorporada(s) por el vehículo. Enum:' abs, airbag, alarma, backCamera, disabledRamp, gps, internetConnection, overspeed, proximitySensor, wifi'. O cualquier otro que necesite la aplicación. Para representar múltiples instancias de una característica se puede utilizar la siguiente sintaxis: `,`. Por ejemplo, un coche con 4 airbags será representado por `airbag,4`. . Model: [https://schema.org/Text](https://schema.org/Text) - `fleetVehicleId[string]`: El identificador del vehículo en el contexto de la flota de vehículos a la que pertenece. . Model: [https://schema.org/Text](https://schema.org/Text) - `fuelEfficiency[number]`: La distancia recorrida por unidad de combustible utilizado, comúnmente en kilómetros por litro (km/L). . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelFilled[number]`: Cantidad de combustible cargado en litros al vehículo correspondiente a esta observación . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelType[string]`: El tipo de combustible adecuado para el motor o motores del vehículo correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - `heading[*]`: Denota la dirección de desplazamiento del vehículo y se especifica en grados decimales, donde 0 <= `heading` < 360, contando en el sentido de las agujas del reloj respecto al norte verdadero. Si el vehículo está parado (es decir, el valor del atributo `speed` es `0`), el valor del atributo heading debe ser igual a `-1`. . Model: [https://schema.org/Number](https://schema.org/Number) - `id[*]`: Identificador único de la entidad - `ignitionStatus[boolean]`: Indica el estado de encendido del vehículo. Verdadero significa encendido . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `image[uri]`: Una imagen del artículo . Model: [https://schema.org/URL](https://schema.org/URL) - `license_plate[string]`: Indica el número de matrícula del vehículo. Idéntico a: campo license_plate de GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)". . Model: [https://schema.org/Text](https://schema.org/Text) - `location[*]`: Referencia Geojson al elemento. Puede ser Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon. - `mileageFromOdometer[number]`: La distancia total recorrida por el vehículo concreto desde su fabricación inicial, según la lectura de su cuentakilómetros. . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) - `municipalityInfo[object]`: Información municipal correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - `cityId[string]`: ID de la ciudad correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - - `cityName[string]`: Nombre de la ciudad correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - - `district[string]`: Nombre del distrito correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - - `stateName[string]`: Nombre del estado correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - - `ulbName[string]`: Nombre de la Entidad Local Urbana correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardId[string]`: ID de pabellón correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardName[string]`: Nombre del pabellón correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardNum[number]`: Número de pabellón correspondiente a esta observación . Model: [https://schema.org/Number](https://schema.org/Number) - - `zoneId[string]`: ID de zona correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - - `zoneName[string]`: Nombre de la zona correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) -- `name[string]`: El nombre de este artículo - `observationDateTime[date-time]`: Última hora de observación comunicada . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `owner[array]`: Una lista que contiene una secuencia de caracteres codificada en JSON que hace referencia a los identificadores únicos de los propietarios. - `previousLocation[*]`: Referencia Geojson al elemento. Puede ser Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon. - `purchaseDate[date-time]`: La fecha en que, por ejemplo, el vehículo fue adquirido por el propietario actual. . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) - `refVehicleModel[*]`: Referencia a un VehicleModel . Model: [https://schema.org/URL](https://schema.org/URL) - `reportId[string]`: Id. único asignado a la incidencia, informe, comentario o transacción correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - `seeAlso[*]`: lista de uri que apuntan a recursos adicionales sobre el artículo - `serviceOnDuty[boolean]`: Naturaleza del servicio prestado por el vehículo de emergencia correspondiente a esta observación. Verdadero indica que el vehículo de emergencia correspondiente a esta observación está atendiendo/prestando servicio a una llamada de emergencia y es Falso en caso contrario . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `serviceProvided[array]`: Servicio(s) que el vehículo puede prestar o al que está asignado. Enum:'servicios auxiliares, transporte de carga, construcción, recinto ferial, recogida de basuras, venta de mercancías, mantenimiento, parques y jardines, señalización vial, transporte especial, limpieza viaria, alumbrado público, transporte urbano, limpieza de contenedores'. O cualquier otro valor que necesite una aplicación específica . Model: [https://schema.org/Text](https://schema.org/Text) - `serviceStatus[string]`: Estado del vehículo (desde el punto de vista del servicio prestado, por lo que no podría aplicarse a vehículos particulares). `parked` : El vehículo está aparcado y no presta ningún servicio en este momento. `onRoute` : El vehículo está realizando una misión. Se pueden añadir modificadores separados por comas para indicar qué misión está realizando el vehículo en ese momento. Por ejemplo, `onRoute,garbageCollection` puede utilizarse para indicar que el vehículo está en ruta y en una misión de recogida de basura. `roto` : El vehículo está sufriendo una avería temporal. `outOfService` : El vehículo está en ruta pero no está realizando ninguna misión, probablemente se dirige a su zona de aparcamiento. Enum:'averiado, enRuta, fueraDeServicio, aparcado' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `source[string]`: Secuencia de caracteres que indica la fuente original de los datos de la entidad en forma de URL. Se recomienda que sea el nombre de dominio completo del proveedor de origen o la URL del objeto de origen. - `speed[*]`: Denota la magnitud del componente horizontal de la velocidad actual del vehículo y se especifica en Kilómetros por Hora. Si se proporciona, el valor del atributo velocidad debe ser un número real no negativo. PUEDE utilizarse `-1` si la velocidad se desconoce transitoriamente por algún motivo. . Model: [https://schema.org/Number](https://schema.org/Number) - `tripNetWeightCollected[number]`: El peso neto recogido por el vehículo correspondiente a esta observación al final del trayecto . Model: [https://schema.org/Number](https://schema.org/Number) - `type[string]`: Tipo de entidad NGSI. Tiene que ser Vehículo - `vehicleAltitude[string]`: Indica la altitud actual del vehículo mediante GPS . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleConfiguration[string]`: Un breve texto que indique la configuración del vehículo, por ejemplo, "5dr hatchback ST 2.5 MT 225 CV" o "edición limitada". . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) - `vehicleIdentificationNumber[string]`: El número de identificación del vehículo (VIN) es un número de serie único utilizado por la industria del automóvil para identificar vehículos de motor individuales. . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) - `vehiclePlateIdentifier[string]`: Identificador o código que figura en la placa de matrícula de un vehículo y que se utiliza a efectos de identificación oficial. El identificador de matrícula es numérico o alfanumérico y es único dentro de la región de la autoridad emisora. Referencias normativas: DATEXII `vehicleRegistrationPlateIdentifier` (identificador de la placa de matrícula del vehículo) . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleRunningStatus[string]`: Indica el estado de carga de la batería del dispositivo informador. Enum:'en funcionamiento, en espera, parado' . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleSpecialUsage[string]`: Indica si el vehículo se ha utilizado para fines especiales, como alquiler comercial, autoescuela o como taxi. La legislación de muchos países obliga a revelar esta información cuando se pone un coche a la venta. Enum:'ambulancia, bomberos, militar, policía, transporte escolar, taxi, gestión de basuras' . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) - `vehicleTrackerDevice[string]`: Estado de instalación del dispositivo GPS o del dispositivo de seguimiento instalado en el vehículo correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleType[string]`: Tipo de vehículo desde el punto de vista de sus características estructurales. Es diferente de la categoría de vehículo . Enum:vehículo agrícola, cualquier vehículo, vehículo articulado, bicicleta, carro de basura, autobús, coche, caravana, vehículo ligero, coche con caravana, coche con remolque, carro de limpieza, vehículo de construcción o mantenimiento, tracción a las cuatro ruedas, vehículo de gran altura, camión, minibús, ciclomotor, motocicleta, motocicleta con sidecar, motocarro, barredora, cisterna, vehículo de tres ruedas, remolque, tranvía, vehículo de dos ruedas, carro, furgoneta, vehículo sin convertidor catalítico, vehículo con caravana, vehículo con remolque, con matrícula par, con matrícula impar, otros". Los siguientes valores definidos por _VehicleTypeEnum_ y _VehicleTypeEnum2_, [DATEX 2 versión 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) y ampliados para otros usos . Model: [https://schema.org/Text](https://schema.org/Text) - `wardId[string]`: Ward ID de la entidad correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - `wardName[string]`: Nombre de pabellón de la entidad correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - `zoneName[string]`: Nombre de zona de la entidad correspondiente a esta observación . Model: [https://schema.org/Text](https://schema.org/Text) - - Propiedades requeridas -- `category` - `id` - `location` - `type` - `vehicleType` - - - - ## Descripción de las propiedades del modelo de datos - Ordenados alfabéticamente (pulse para más detalles) - - +[Licencia Abierta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/LICENSE.md) + +[documento generado automáticamente](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) + + + + + +Global description: **Esta entidad modela un modelo de vehículo en particular, incluyendo todas las propiedades que son comunes a varias instancias de vehículos que pertenecen a dicho modelo.** + +version: 0.2.2 + + + + + + +## Lista de propiedades + + +[*] Si no hay un tipo en un atributo es porque podría tener varios tipos o diferentes formatos/patrones +- `address[object]`: La dirección de correo . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: El país. Por ejemplo, España . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La localidad en la que está la dirección de la calle, y que está en la región . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La región en la que se encuentra la localidad, y que se encuentra en el país . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un distrito es un tipo de división administrativa que, en algunos países, es gestionado por el gobierno local + - `postOfficeBoxNumber[string]`: El número de apartado de correos para direcciones de apartado postal. Por ejemplo, 03578. . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: El código postal. Por ejemplo, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: La dirección de la calle . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Número que identifica una propiedad específica en una vía pública. +- `alternateName[string]`: Un nombre alternativo para este artículo +- `annotations[array]`: Anotaciones sobre el artículo . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: El área geográfica donde se presta un servicio o se ofrece un artículo. . Model: [https://schema.org/Text](https://schema.org/Text) +- `battery[number]`: El porcentaje actual de batería restante en el caso de un vehículo eléctrico, o un dispositivo conectado al vehículo. +- `bearing[number]`: Da el ángulo GPS del vehículo medido en dirección hacia la derecha desde el Norte Verdadero. SameAs 'campo de rumbo' del mensaje de GTFS Realtime-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) . Model: [https://schema.org/Number](https://schema.org/Number) +- `cargoWeight[number]`: Peso actual de la carga del vehículo. . Model: [https://schema.org/Number](https://schema.org/Number) +- `category[array]`: Categoría(s) de vehículo desde un punto de vista externo. Esto es diferente al tipo de vehículo (automóvil, camión, etc.) representado por la propiedad `vehicleType`. Enum: 'municipalServices, nonTracked, private, public, specialUsage, tracked'. Los vehículos rastreados son aquellos cuya posición es rastreada permanentemente por un sistema remoto. O cualquier otro que necesite una aplicación. Incorporan un receptor GPS junto con una conexión de red para actualizar periódicamente una posición reportada (ubicación, velocidad, rumbo...). . Model: [https://schema.org/Text](https://schema.org/Text) +- `color[string]`: El color del producto . Model: [https://schema.org/color](https://schema.org/color) +- `currentTripCount[number]`: El número actual de viajes realizados por el vehículo correspondiente a esta observación en el día de operación dado. . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: Una secuencia de caracteres que identifica al proveedor de la entidad de datos armonizada. +- `dateCreated[date-time]`: Marca de tiempo de creación de entidad. Esto generalmente será asignado por la plataforma de almacenamiento +- `dateFirstUsed[date]`: Marca de tiempo que indica cuándo se utilizó el vehículo por primera vez. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `dateModified[date-time]`: Marca de tiempo de la última modificación de la entidad. Normalmente, será asignada por la plataforma de almacenamiento. +- `dateVehicleFirstRegistered[date]`: La fecha de la primera inscripción del vehículo ante las autoridades públicas correspondientes . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) +- `description[string]`: Una descripción de este artículo +- `deviceBatteryStatus[string]`: Proporciona el estado de carga de la batería del dispositivo que informa. Enum: 'conectado, desconectado' . Model: [https://schema.org/Text](https://schema.org/Text) +- `deviceSimNumber[string]`: Proporciona el número de SIM del dispositivo en el vehículo . Model: [https://schema.org/Text](https://schema.org/Text) +- `emergencyVehicleType[string]`: Tipo de vehículo de emergencia correspondiente a esta observación. Enum: 'coche de policía, motocicleta de policía, furgón de policía, SWAT de la policía, camión de bomberos . Model: [https://schema.org/Text](https://schema.org/Text) +- `feature[array]`: Característica(s) incorporada(s) por el vehículo. Enum: 'abs, airbag, alarm, backCamera, disabledRamp, gps, internetConnection, overspeed, proximitySensor, wifi'. O cualquier otra que necesite la aplicación. Para representar múltiples instancias de una característica, se puede utilizar la siguiente sintaxis: `, + + + + +Propiedades requeridas +- `categoría` +- `id` +- `ubicación` +- `tipo` +- `tipoDeVehiculo` + + + + + + + + + +## Descripción del modelo de datos de propiedades + +Ordenado alfabéticamente (haga clic para ver detalles) + + + +
full yaml details - ```yaml + +```yaml Vehicle: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -122,14 +212,14 @@ Vehicle: model: https://schema.org/Text type: Property battery: - description: 'The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle' + description: The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle maximum: 1 minimum: 0 type: number x-ngsi: type: Property bearing: - description: "Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position)" + description: Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) type: number x-ngsi: model: https://schema.org/Number @@ -144,7 +234,7 @@ Vehicle: type: Property units: Kilograms category: - description: 'Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:''municipalServices, nonTracked, private, public, specialUsage, tracked''. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...)' + description: Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...) items: enum: - municipalServices @@ -207,7 +297,7 @@ Vehicle: x-ngsi: type: Property deviceBatteryStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''connected, disconnected''' + description: Gives the Battery charging status of the reporting device. Enum:'connected, disconnected' enum: - connected - disconnected @@ -222,7 +312,7 @@ Vehicle: model: https://schema.org/Text type: Property emergencyVehicleType: - description: 'Type of emergency vehicle corresponding to this observation. Enum:''policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck' + description: Type of emergency vehicle corresponding to this observation. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck enum: - policeCar - policeMotorcycle @@ -266,7 +356,7 @@ Vehicle: model: https://schema.org/Text type: Property fuelEfficiency: - description: 'The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L)' + description: The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L) type: number x-ngsi: model: https://schema.org/Number @@ -284,7 +374,7 @@ Vehicle: model: https://schema.org/Text type: Property heading: - description: 'Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1`' + description: Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1` oneOf: - exclusiveMaximum: 360 maximum: 360 @@ -313,7 +403,7 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship ignitionStatus: description: Gives the ignition status of the vehicle. True means ignited type: boolean @@ -328,26 +418,32 @@ Vehicle: model: https://schema.org/URL type: Property license_plate: - description: "Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)'" + description: 'Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)''' type: string x-ngsi: model: https://schema.org/Text type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -362,11 +458,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -374,6 +474,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -388,11 +490,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -402,6 +508,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -416,17 +524,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -441,11 +555,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -455,6 +573,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -474,6 +594,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -485,6 +606,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -499,7 +622,7 @@ Vehicle: x-ngsi: type: GeoProperty mileageFromOdometer: - description: 'The total distance travelled by the particular vehicle since its initial production, as read from its odometer' + description: The total distance travelled by the particular vehicle since its initial production, as read from its odometer type: number x-ngsi: model: https://schema.org/mileageFromOdometer @@ -601,25 +724,31 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property previousLocation: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -634,11 +763,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -646,6 +779,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -660,11 +795,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -674,6 +813,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -688,17 +829,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -713,11 +860,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -727,6 +878,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -746,6 +899,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -757,6 +911,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -820,7 +976,7 @@ Vehicle: model: https://schema.org/Boolean type: Property serviceProvided: - description: 'Service(s) the vehicle is capable of providing or it is assigned to. Enum:''auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning''. Or any other value needed by an specific application' + description: Service(s) the vehicle is capable of providing or it is assigned to. Enum:'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Or any other value needed by an specific application items: enum: - auxiliaryServices @@ -854,12 +1010,12 @@ Vehicle: model: https://schema.org/DateTime 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' + 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 speed: - description: 'Denotes the magnitude of the horizontal component of the vehicle''s current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason' + description: Denotes the magnitude of the horizontal component of the vehicle's current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason oneOf: - minimum: 0 type: number @@ -890,7 +1046,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleConfiguration: - description: 'A short text indicating the configuration of the vehicle, e.g. ''5dr hatchback ST 2.5 MT 225 hp'' or ''limited edition''' + description: A short text indicating the configuration of the vehicle, e.g. '5dr hatchback ST 2.5 MT 225 hp' or 'limited edition' type: string x-ngsi: model: https://schema.org/vehicleConfiguration @@ -908,7 +1064,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleRunningStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''running, waiting, stopped''' + description: Gives the Battery charging status of the reporting device. Enum:'running, waiting, stopped' enum: - running - stopped @@ -918,7 +1074,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleSpecialUsage: - description: 'Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:''ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement''' + description: Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:'ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement' enum: - ambulance - fireBrigade @@ -938,7 +1094,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses' + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses enum: - agriculturalVehicle - ambulance @@ -1027,24 +1183,33 @@ Vehicle: - category - location 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) 2024 Contributors to Smart Data Models Program' + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/Vehicle/schema.json - x-model-tags: 'IUDX, SEDIMARK' + x-model-tags: IUDX, SEDIMARK x-version: 0.2.2 ```
- - - - - ## Ejemplo de carga útil - #### Vehículo NGSI-v2 key-values Ejemplo - He aquí un ejemplo de un Vehículo en formato JSON-LD como key-values. Esto es compatible con NGSI-v2 cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. + + + + + + + + + +## Cargas de ejemplo + +#### Ejemplo de valores clave de vehículo NGSI-v2 + +Aquí hay un ejemplo de un Vehículo en formato JSON como clave-valor. Esto es compatible con NGSI-v2 cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual.
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "vehicleType": "lorry", @@ -1101,15 +1266,29 @@ Vehicle: "wardName": "Bangalore Urban", "zoneId": "2", "wardNum": 4 + }, + "leasingInfo": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" } } ```
- #### Vehículo NGSI-v2 normalizado Ejemplo - He aquí un ejemplo de un Vehículo en formato JSON-LD normalizado. Esto es compatible con NGSI-v2 cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. + +#### Ejemplo normalizado de vehículo NGSI-v2 + +Aquí hay un ejemplo de un Vehículo en formato JSON normalizado. Esto es compatible con NGSI-v2 cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual.
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "category": { @@ -1277,15 +1456,32 @@ Vehicle: "zoneId": "2", "wardNum": 4 } + }, + "leasingInfo": { + "type": "StructuredValue", + "value": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" + } } } ```
- #### Vehículo NGSI-LD key-values Ejemplo - He aquí un ejemplo de un Vehículo en formato JSON-LD como key-values. Esto es compatible con NGSI-LD cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. + +#### Ejemplo de valores clave de vehículo NGSI-LD + +Aquí hay un ejemplo de un Vehículo en formato JSON-LD como clave-valor. Esto es compatible con NGSI-LD cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual.
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": "Centro", @@ -1343,17 +1539,31 @@ Vehicle: "wardId": "4", "wardName": "Kempegowda Ward", "zoneName": "South Zone", + "leasingInfo": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" + }, "@context": [ "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" ] } ```
- #### Vehículo NGSI-LD normalizado Ejemplo - He aquí un ejemplo de un Vehículo en formato JSON-LD normalizado. Esto es compatible con NGSI-LD cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. + +#### Ejemplo normalizado de NGSI-LD de vehículo + +Aquí hay un ejemplo de un Vehículo en formato JSON-LD normalizado. Esto es compatible con NGSI-LD cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual.
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": { @@ -1515,18 +1725,40 @@ Vehicle: "zoneName": { "type": "Property", "value": "South Zone" + }, + "leasingInfo": { + "type": "Property", + "value": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" + } }, "@context": [ "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" ] } ``` -
- - - - Consulte [FAQ 10](https://smartdatamodels.org/index.php/faqs/) para obtener una respuesta sobre cómo tratar las unidades de magnitud. - - +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + --- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/Vehicle/doc/spec_IT.md b/Vehicle/doc/spec_IT.md index 9617b0e48..96fdeaf4b 100644 --- a/Vehicle/doc/spec_IT.md +++ b/Vehicle/doc/spec_IT.md @@ -1,88 +1,178 @@ - + + [![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entità: Veicolo -=============== - - [Licenza aperta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/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: **Questa entità modella un particolare modello di veicolo, comprese tutte le proprietà che sono comuni a più istanze di veicolo appartenenti a tale modello.** - versione: 0.2.2 - - - ## Elenco delle proprietà +Entità: Vehicle +=============== + + + + - [*] 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) - - `streetNr[string]`: Numero che identifica una proprietà specifica su una strada pubblica -- `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) - `battery[number]`: L'attuale percentuale di batteria residua nel caso di un veicolo elettrico o di un dispositivo collegato al veicolo. - `bearing[number]`: Indica l'angolo GPS del veicolo misurato in senso orario rispetto al Nord vero. Come il campo "bearing" del messaggio di posizione in tempo reale GTFS (https://developers.google.com/transit/gtfs-realtime/reference#message-position). . Model: [https://schema.org/Number](https://schema.org/Number) - `cargoWeight[number]`: Peso attuale del carico del veicolo . Model: [https://schema.org/Number](https://schema.org/Number) - `category[array]`: Categoria/e del veicolo da un punto di vista esterno. È diversa dal tipo di veicolo (auto, camion, ecc.) rappresentato dalla proprietà `vehicleType`. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. I veicoli tracciati sono quelli la cui posizione è permanentemente tracciata da un sistema remoto. O qualsiasi altro tipo di veicolo necessario a un'applicazione. Essi incorporano un ricevitore GPS e una connessione di rete per aggiornare periodicamente la posizione segnalata (posizione, velocità, direzione...). . Model: [https://schema.org/Text](https://schema.org/Text) - `color[string]`: Il colore del prodotto . Model: [https://schema.org/color](https://schema.org/color) - `currentTripCount[number]`: Il conteggio attuale dei viaggi effettuati dal veicolo corrispondente a questa osservazione in un determinato giorno di funzionamento. . Model: [https://schema.org/Number](https://schema.org/Number) - `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 - `dateFirstUsed[date]`: Timestamp che indica quando il veicolo è stato utilizzato per la prima volta . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `dateVehicleFirstRegistered[date]`: La data della prima immatricolazione del veicolo presso le rispettive autorità pubbliche. . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) - `description[string]`: Descrizione dell'articolo - `deviceBatteryStatus[string]`: Indica lo stato di carica della batteria del dispositivo segnalato. Enum:'connesso, disconnesso' . Model: [https://schema.org/Text](https://schema.org/Text) - `deviceSimNumber[string]`: Indica il numero di SIM del dispositivo nel veicolo. . Model: [https://schema.org/Text](https://schema.org/Text) - `emergencyVehicleType[string]`: Tipo di veicolo di emergenza corrispondente a questa osservazione. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck . Model: [https://schema.org/Text](https://schema.org/Text) - `feature[array]`: Caratteristiche incorporate dal veicolo. Enum:' abs, airbag, allarme, retrocamera, disabledRamp, gps, internetConnection, overspeed, proximitySensor, wifi'. O qualsiasi altro necessario all'applicazione. Per rappresentare istanze multiple di una caratteristica si può usare la seguente sintassi: `,`. Ad esempio, un'auto con 4 airbag sarà rappresentata da `airbag,4`. . Model: [https://schema.org/Text](https://schema.org/Text) - `fleetVehicleId[string]`: L'identificativo del veicolo nel contesto della flotta di veicoli a cui appartiene. . Model: [https://schema.org/Text](https://schema.org/Text) - `fuelEfficiency[number]`: La distanza percorsa per unità di carburante utilizzato, comunemente espressa in chilometri per litro (km/L). . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelFilled[number]`: Quantità di carburante riempita in litri al veicolo corrispondente a questa osservazione . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelType[string]`: Il tipo di carburante adatto al motore o ai motori del veicolo corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - `heading[*]`: Indica la direzione di marcia del veicolo ed è specificata in gradi decimali, dove 0 <= `heading` < 360, contando in senso orario rispetto al nord vero. Se il veicolo è fermo (cioè il valore dell'attributo `speed` è `0`), il valore dell'attributo heading deve essere uguale a `-1`. . Model: [https://schema.org/Number](https://schema.org/Number) - `id[*]`: Identificatore univoco dell'entità - `ignitionStatus[boolean]`: Indica lo stato di accensione del veicolo. Vero significa acceso . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `image[uri]`: Un'immagine dell'articolo . Model: [https://schema.org/URL](https://schema.org/URL) - `license_plate[string]`: Fornisce il numero di targa del veicolo. Uguale a: campo targa da GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)". . Model: [https://schema.org/Text](https://schema.org/Text) - `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. - `mileageFromOdometer[number]`: La distanza totale percorsa dal veicolo in questione dalla sua produzione iniziale, come risulta dal suo contachilometri. . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) - `municipalityInfo[object]`: Informazioni sul comune corrispondenti a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - `cityId[string]`: ID della città corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - - `cityName[string]`: Nome della città corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - - `district[string]`: Nome del distretto corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - - `stateName[string]`: Nome dello stato corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - - `ulbName[string]`: Nome dell'Ente Locale Urbano corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardId[string]`: ID del reparto corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardName[string]`: Nome del reparto corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardNum[number]`: Numero del reparto corrispondente a questa osservazione . Model: [https://schema.org/Number](https://schema.org/Number) - - `zoneId[string]`: ID della zona corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - - `zoneName[string]`: Nome della zona corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) -- `name[string]`: Il nome di questo elemento - `observationDateTime[date-time]`: Ultima ora di osservazione segnalata . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `previousLocation[*]`: 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. - `purchaseDate[date-time]`: La data in cui l'oggetto, ad esempio il veicolo, è stato acquistato dall'attuale proprietario. . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) - `refVehicleModel[*]`: Riferimento a un modello di veicolo . Model: [https://schema.org/URL](https://schema.org/URL) - `reportId[string]`: Id univoco assegnato per il problema, la segnalazione, il feedback o la transazione corrispondente a questa osservazione. . Model: [https://schema.org/Text](https://schema.org/Text) - `seeAlso[*]`: elenco di uri che puntano a risorse aggiuntive sull'elemento - `serviceOnDuty[boolean]`: Natura del servizio fornito dal veicolo di emergenza corrispondente a questa osservazione. Vero indica che il veicolo d'emergenza corrispondente a questa osservazione sta rispondendo/assistendo a una chiamata d'emergenza, altrimenti è Falso. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `serviceProvided[array]`: Servizi che il veicolo è in grado di fornire o a cui è assegnato. Enum:'servizi ausiliari, trasporto merci, costruzione, fiera, raccolta rifiuti, vendita merci, manutenzione, parchi e giardini, segnalazione stradale, trasporto speciale, pulizia strade, illuminazione stradale, trasporto urbano, pulizia contenitori di rifiuti'. O qualsiasi altro valore necessario per un'applicazione specifica . Model: [https://schema.org/Text](https://schema.org/Text) - `serviceStatus[string]`: Stato del veicolo (dal punto di vista del servizio fornito, quindi non può essere applicato ai veicoli privati). `parked` : il veicolo è parcheggiato e non fornisce alcun servizio al momento. `onRoute` : il veicolo sta svolgendo una missione. È possibile aggiungere uno o più modificatori separati da virgole per indicare quale missione sta svolgendo il veicolo. Ad esempio, `onRoute,garbageCollection` può essere usato per indicare che il veicolo è in viaggio e in missione di raccolta rifiuti. 'broken' : Il veicolo sta subendo un guasto temporaneo. `outOfService` : il veicolo è in viaggio ma non sta svolgendo alcuna missione, probabilmente sta andando al suo parcheggio. Enum:'broken, onRoute, outOfService, parked'. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `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. - `speed[*]`: Indica la grandezza della componente orizzontale della velocità corrente del veicolo ed è specificata in chilometri all'ora. Se fornito, il valore dell'attributo speed deve essere un numero reale non negativo. Si può usare `-1` se la velocità è transitoriamente sconosciuta per qualche motivo. . Model: [https://schema.org/Number](https://schema.org/Number) - `tripNetWeightCollected[number]`: Il peso netto raccolto dal veicolo corrispondente a questa osservazione alla fine del viaggio . Model: [https://schema.org/Number](https://schema.org/Number) - `type[string]`: Tipo di entità NGSI. Deve essere un veicolo - `vehicleAltitude[string]`: Fornisce l'altitudine corrente del veicolo utilizzando il GPS. . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleConfiguration[string]`: Un breve testo che indichi la configurazione del veicolo, ad esempio "5dr hatchback ST 2.5 MT 225 CV" o "edizione limitata". . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) - `vehicleIdentificationNumber[string]`: Il numero di identificazione del veicolo (VIN) è un numero di serie unico utilizzato dall'industria automobilistica per identificare i singoli veicoli a motore. . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) - `vehiclePlateIdentifier[string]`: Un identificatore o un codice visualizzato su una targa di immatricolazione del veicolo, applicata al veicolo stesso e utilizzata a fini di identificazione ufficiale. L'identificatore di immatricolazione è numerico o alfanumerico ed è unico all'interno della regione dell'autorità emittente. Riferimenti normativi: DATEXII `veicoloRegistrationPlateIdentifier` . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleRunningStatus[string]`: Indica lo stato di carica della batteria del dispositivo segnalato. Enum:'in funzione, in attesa, fermo'. . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleSpecialUsage[string]`: Indica se il veicolo è stato utilizzato per scopi speciali, come il noleggio commerciale, la scuola guida o il taxi. La legislazione di molti Paesi richiede che questa informazione venga rivelata quando si mette in vendita un'auto. Enum:'ambulanza, vigili del fuoco, militari, polizia, trasporto scolastico, taxi, gestione dei rifiuti'. . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) - `vehicleTrackerDevice[string]`: Stato dell'installazione del dispositivo GPS o del dispositivo di localizzazione montato sul veicolo corrispondente all'osservazione. . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleType[string]`: Tipo di veicolo dal punto di vista delle sue caratteristiche strutturali. È diverso dalla categoria del veicolo. Enum:'veicolo agricolo, qualsiasi veicolo, veicolo articolato, bicicletta, carrello portarifiuti, autobus, automobile, roulotte, autovettura o veicolo leggero, autovettura con roulotte, autovettura con rimorchio, carrello per le pulizie, veicolo da costruzione o manutenzione, quattro ruote motrici, veicolo a ruote alte, autocarro, minibus, ciclomotore, motocicletta, motociclo con auto laterale, motoscooter, macchina spazzatrice, autocisterna, veicolo a tre ruote, rimorchio, tram, veicolo a due ruote, carrello, furgone, veicolo senza convertitore catalitico, veicolo con roulotte, veicolo con rimorchio, con targhe pari, con targhe dispari, altro". I seguenti valori definiti da _VehicleTypeEnum_ e _VehicleTypeEnum2_, [DATEX 2 versione 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) ed estesi per altri usi . Model: [https://schema.org/Text](https://schema.org/Text) - `wardId[string]`: ID del rione dell'entità corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - `wardName[string]`: Nome del rione dell'entità corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - `zoneName[string]`: Nome della zona dell'entità corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) - - Proprietà richieste -- `category` - `id` - `location` - `type` - `vehicleType` - - - - ## Modello di dati descrizione delle proprietà - Ordinati in ordine alfabetico (clicca per i dettagli) - - +[Licenza aperta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/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) + + + + + +Global description: **Questa entità modella un particolare modello di veicolo, comprese tutte le proprietà che sono comuni a più istanze di veicoli appartenenti a tale modello.** + +version: 0.2.2 + + + + + + +## Elenco delle proprietà + + +[*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o formati/modello diversi +- `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 di via, 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, è gestito 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 di via . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Numero che identifica una proprietà specifica in una strada pubblica +- `alternateName[string]`: Un nome alternativo per questo elemento +- `annotations[array]`: Annotazioni sull'elemento . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: L'area geografica in cui viene fornito un servizio o un articolo offerto . Model: [https://schema.org/Text](https://schema.org/Text) +- `battery[number]`: La percentuale corrente di batteria rimasta nel caso di un veicolo elettrico, o di un dispositivo connesso al veicolo +- `bearing[number]`: Fornisce l'angolo GPS del veicolo misurato in senso orario rispetto al Nord Vero. SameAs campo 'bearing' da messaggio GTFS Realtime-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) . Model: [https://schema.org/Number](https://schema.org/Number) +- `cargoWeight[number]`: Peso attuale del carico del veicolo . Model: [https://schema.org/Number](https://schema.org/Number) +- `category[array]`: Categoria(e) di veicoli da un punto di vista esterno. Ciò è diverso dal tipo di veicolo (auto, camion, ecc.) rappresentato dalla proprietà `vehicleType`. Enum: 'municipalServices, nonTracked, private, public, specialUsage, tracked'. I veicoli tracciati sono quelli il cui posizionamento è tracciato permanentemente da un sistema remoto. O qualsiasi altro necessario per un'applicazione. Incorporano un ricevitore GPS insieme a una connessione di rete per aggiornare periodicamente una posizione segnalata (posizione, velocità, direzione ...). . Model: [https://schema.org/Text](https://schema.org/Text) +- `color[string]`: Il colore del prodotto . Model: [https://schema.org/color](https://schema.org/color) +- `currentTripCount[number]`: Il conteggio attuale dei viaggi effettuati dal veicolo corrispondente a questa osservazione nel giorno di esercizio dato . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: Una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzati +- `dateCreated[date-time]`: Timestamp di creazione dell'entità. Questo sarà solitamente assegnato dalla piattaforma di archiviazione +- `dateFirstUsed[date]`: Timestamp che indica quando il veicolo è stato utilizzato per la prima volta . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Questo sarà solitamente assegnato dalla piattaforma di archiviazione +- `dateVehicleFirstRegistered[date]`: La data della prima immatricolazione del veicolo presso le rispettive autorità pubbliche . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) +- `description[string]`: Una descrizione di questo articolo +- `deviceBatteryStatus[string]`: Fornisce lo stato di ricarica della batteria del dispositivo di reporting. Enum: 'connesso, disconnesso' . Model: [https://schema.org/Text](https://schema.org/Text) +- `deviceSimNumber[string]`: Fornisce il numero di SIM del dispositivo nel veicolo . Model: [https://schema.org/Text](https://schema.org/Text) +- `emergencyVehicleType[string]`: Tipo di veicolo di emergenza corrispondente a questa osservazione. Enum: 'autoPolizia, motociclettaPolizia, furgonePolizia, poliziaSWAT, autopompa, autobotte, eliambulanza, ambulanza, motociclettaAmbulanza, veicoloDiSoccorso, apparecchioPerMaterialiPericolosi, carroAttrezzi . Model: [https://schema.org/Text](https://schema.org/Text) +- `feature[array]`: Caratteristica(e) incorporate nel veicolo. Enum: 'abs, airbag, allarme, telecamera posteriore, rampa per disabili, gps, connessione internet, overspeed, sensore di prossimità, wifi'. Oppure qualsiasi altra necessaria all'applicazione. Per rappresentare più istanze di una caratteristica può essere utilizzata la seguente sintassi: `,`. Ad esempio, un'auto con 4 airbag sarà rappresentata da `airbag,4` . Model: [https://schema.org/Text](https://schema.org/Text) +- `fleetVehicleId[string]`: L'identificatore del veicolo nel contesto della flotta di veicoli a cui appartiene . Model: [https://schema.org/Text](https://schema.org/Text) +- `fuelEfficiency[number]`: La distanza percorsa per unità di carburante utilizzato, comunemente in chilometri per litro (km/L) . Model: [https://schema.org/Number](https://schema.org/Number) +- `fuelFilled[number]`: Quantità di carburante riempito in litri nel veicolo corrispondente a questa osservazione . Model: [https://schema.org/Number](https://schema.org/Number) +- `fuelType[string]`: Il tipo di carburante adatto al motore o ai motori del veicolo corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `heading[*]`: Indica la direzione di marcia del veicolo e viene specificata in gradi decimali, dove 0 <= `heading` < 360, contando in senso orario rispetto al nord vero. Se il veicolo è fermo (ossia il valore dell'attributo `speed` è `0`), allora il valore dell'attributo `heading` deve essere uguale a `-1` . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: Identificatore univoco dell'entità +- `ignitionStatus[boolean]`: Fornisce lo stato di accensione del veicolo. True significa acceso . Model: [https://schema.org/Boolean](https://schema.org/Boolean) +- `image[uri]`: Un'immagine dell'oggetto . Model: [https://schema.org/URL](https://schema.org/URL) +- `license_plate[string]`: Fornisce il numero di targa del veicolo. SameAs: campo license_plate dal messaggio VehicleDescriptor di GTFS Realtime (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor) . Model: [https://schema.org/Text](https://schema.org/Text) +- `location[*]`: Riferimento Geojson all'elemento. Può essere Punto, LineString, Poligono, MultiPunto, MultiLineString o MultiPoligono +- `mileageFromOdometer[number]`: La distanza totale percorsa dal veicolo in questione dalla sua produzione iniziale, come letta dal suo contagiri . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) +- `municipalityInfo[object]`: Informazioni del comune corrispondenti a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) + - `cityId[string]`: ID città corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) + - `cityName[string]`: Nome della città corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) + - `district[string]`: Nome del distretto corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) + - `stateName[string]`: Nome dello stato corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) + - `ulbName[string]`: Nome dell'Ente Locale Urbano corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardId[string]`: ID del reparto corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardName[string]`: Nome del reparto corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardNum[number]`: Numero di reparto corrispondente a questa osservazione . Model: [https://schema.org/Number](https://schema.org/Number) + - `zoneId[string]`: ID zona corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) + - `zoneName[string]`: Nome della zona corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `name[string]`: Il nome di questo elemento +- `observationDateTime[date-time]`: Ultimo orario di osservazione segnalato . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `owner[array]`: Una lista che contiene una sequenza di caratteri codificata in JSON che fa riferimento agli Id univoci del/dei proprietario/i +- `previousLocation[*]`: Riferimento Geojson all'elemento. Può essere Punto, LineString, Poligono, MultiPunto, MultiLineString o MultiPoligono +- `purchaseDate[date-time]`: La data in cui l'articolo, ad esempio il veicolo, è stato acquistato dall'attuale proprietario . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) +- `refVehicleModel[*]`: Riferimento a un VehicleModel . Model: [https://schema.org/URL](https://schema.org/URL) +- `reportId[string]`: ID univoco assegnato per il problema o la segnalazione o il feedback o la transazione corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: Elenco di uri che puntano a risorse aggiuntive sull'elemento +- `serviceOnDuty[boolean]`: Natura del servizio fornito dal veicolo di emergenza corrispondente a questa osservazione. True indica che il veicolo di emergenza corrispondente a questa osservazione sta rispondendo/a servizio di una chiamata di emergenza e False altrimenti . Model: [https://schema.org/Boolean](https://schema.org/Boolean) +- `serviceProvided[array]`: Servizio(i) che il veicolo è in grado di fornire o a cui è assegnato. Enum: 'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Oppure qualsiasi altro valore necessario per una specifica applicazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `serviceStatus[string]`: Stato del veicolo (dal punto di vista del servizio fornito, quindi potrebbe non applicarsi ai veicoli privati). `parcheggiato` : Il veicolo è parcheggiato e non fornisce alcun servizio al momento. `inTransito` : Il veicolo sta svolgendo una missione. Un modificatore separato da virgola può essere aggiunto per indicare quale missione sta attualmente consegnando il veicolo. Ad esempio, `inTransito, raccoltaRifiuti` può essere utilizzato per indicare che il veicolo è in transito e sta svolgendo una missione di raccolta rifiuti. `guasto` : Il veicolo sta subendo un guasto temporaneo. `fuoriServizio` : Il veicolo è sulla strada ma non sta svolgendo alcuna missione, probabilmente sta andando alla sua area di parcheggio. Enum: 'guasto, inTransito, fuoriServizio, parcheggiato' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `source[string]`: Una sequenza di caratteri che fornisce la fonte originale dei dati dell'entità come URL. Si consiglia di utilizzare il nome di dominio completamente qualificato del fornitore di origine o l'URL dell'oggetto di origine +- `speed[*]`: Indica la magnitudine della componente orizzontale della velocità attuale del veicolo e viene specificata in chilometri all'ora. Se fornito, il valore dell'attributo velocità deve essere un numero reale non negativo. `-1` PUÒ essere utilizzato se la velocità è transitoriamente sconosciuta per qualche motivo. . Model: [https://schema.org/Number](https://schema.org/Number) +- `tripNetWeightCollected[number]`: Il peso netto raccolto dal veicolo corrispondente a questa osservazione alla fine del viaggio . Model: [https://schema.org/Number](https://schema.org/Number) +- `type[string]`: Tipo di entità NGSI. Deve essere Veicolo +- `vehicleAltitude[string]`: Fornisce la quota altimetrica attuale del veicolo utilizzando il GPS . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleConfiguration[string]`: Un breve testo che indica la configurazione del veicolo, ad es. '5 porte hatchback ST 2.5 MT 225 cv' o 'edizione limitata' . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) +- `vehicleIdentificationNumber[string]`: Il numero di identificazione del veicolo (VIN) è un numero seriale univoco utilizzato dall'industria automobilistica per identificare i singoli veicoli a motore . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) +- `vehiclePlateIdentifier[string]`: Un identificatore o codice visualizzato su una targa di immatricolazione del veicolo allegata al veicolo utilizzato per scopi di identificazione ufficiale. L'identificatore di registrazione è numerico o alfanumerico e univoco all'interno della regione dell'autorità di rilascio. Riferimenti normativi: DATEXII `vehicleRegistrationPlateIdentifier` . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleRunningStatus[string]`: Fornisce lo stato di ricarica della batteria del dispositivo di report. Enum: 'in esecuzione, in attesa, interrotto' . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleSpecialUsage[string]`: Indica se il veicolo è stato utilizzato per scopi speciali, come noleggio commerciale, scuola guida o come taxi. La legislazione di molti paesi richiede che queste informazioni vengano rese note quando si offre un'auto in vendita. Enum: 'ambulanza, vigili del fuoco, militare, polizia, trasportoScolastico, taxi, gestioneRifiuti' . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) +- `vehicleTrackerDevice[string]`: Stato di installazione del dispositivo GPS o del dispositivo di tracciamento installato sul veicolo corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleType[string]`: Tipo di veicolo dal punto di vista delle sue caratteristiche strutturali. Ciò è diverso dalla categoria di veicolo. Enum: 'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. I seguenti valori definiti da _VehicleTypeEnum_ e _VehicleTypeEnum2_, [DATEX 2 versione 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) e estesi per altri usi . Model: [https://schema.org/Text](https://schema.org/Text) +- `wardId[string]`: ID del reparto dell'entità corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `wardName[string]`: Nome del reparto dell'entità corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) +- `zoneName[string]`: Nome della zona dell'entità corrispondente a questa osservazione . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +Proprietà richieste +- `categoria` +- `id` +- `posizione` +- `tipo` +- `tipoDiVeicolo` + + + + + + + + + +## Descrizione del modello di dati delle proprietà + +Ordinati in ordine alfabetico (clicca per i dettagli) + + + +
full yaml details - ```yaml + +```yaml Vehicle: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -122,14 +212,14 @@ Vehicle: model: https://schema.org/Text type: Property battery: - description: 'The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle' + description: The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle maximum: 1 minimum: 0 type: number x-ngsi: type: Property bearing: - description: "Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position)" + description: Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) type: number x-ngsi: model: https://schema.org/Number @@ -144,7 +234,7 @@ Vehicle: type: Property units: Kilograms category: - description: 'Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:''municipalServices, nonTracked, private, public, specialUsage, tracked''. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...)' + description: Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...) items: enum: - municipalServices @@ -207,7 +297,7 @@ Vehicle: x-ngsi: type: Property deviceBatteryStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''connected, disconnected''' + description: Gives the Battery charging status of the reporting device. Enum:'connected, disconnected' enum: - connected - disconnected @@ -222,7 +312,7 @@ Vehicle: model: https://schema.org/Text type: Property emergencyVehicleType: - description: 'Type of emergency vehicle corresponding to this observation. Enum:''policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck' + description: Type of emergency vehicle corresponding to this observation. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck enum: - policeCar - policeMotorcycle @@ -266,7 +356,7 @@ Vehicle: model: https://schema.org/Text type: Property fuelEfficiency: - description: 'The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L)' + description: The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L) type: number x-ngsi: model: https://schema.org/Number @@ -284,7 +374,7 @@ Vehicle: model: https://schema.org/Text type: Property heading: - description: 'Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1`' + description: Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1` oneOf: - exclusiveMaximum: 360 maximum: 360 @@ -313,7 +403,7 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship ignitionStatus: description: Gives the ignition status of the vehicle. True means ignited type: boolean @@ -328,26 +418,32 @@ Vehicle: model: https://schema.org/URL type: Property license_plate: - description: "Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)'" + description: 'Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)''' type: string x-ngsi: model: https://schema.org/Text type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -362,11 +458,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -374,6 +474,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -388,11 +490,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -402,6 +508,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -416,17 +524,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -441,11 +555,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -455,6 +573,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -474,6 +594,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -485,6 +606,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -499,7 +622,7 @@ Vehicle: x-ngsi: type: GeoProperty mileageFromOdometer: - description: 'The total distance travelled by the particular vehicle since its initial production, as read from its odometer' + description: The total distance travelled by the particular vehicle since its initial production, as read from its odometer type: number x-ngsi: model: https://schema.org/mileageFromOdometer @@ -601,25 +724,31 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property previousLocation: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -634,11 +763,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -646,6 +779,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -660,11 +795,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -674,6 +813,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -688,17 +829,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -713,11 +860,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -727,6 +878,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -746,6 +899,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -757,6 +911,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -820,7 +976,7 @@ Vehicle: model: https://schema.org/Boolean type: Property serviceProvided: - description: 'Service(s) the vehicle is capable of providing or it is assigned to. Enum:''auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning''. Or any other value needed by an specific application' + description: Service(s) the vehicle is capable of providing or it is assigned to. Enum:'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Or any other value needed by an specific application items: enum: - auxiliaryServices @@ -854,12 +1010,12 @@ Vehicle: model: https://schema.org/DateTime 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' + 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 speed: - description: 'Denotes the magnitude of the horizontal component of the vehicle''s current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason' + description: Denotes the magnitude of the horizontal component of the vehicle's current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason oneOf: - minimum: 0 type: number @@ -890,7 +1046,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleConfiguration: - description: 'A short text indicating the configuration of the vehicle, e.g. ''5dr hatchback ST 2.5 MT 225 hp'' or ''limited edition''' + description: A short text indicating the configuration of the vehicle, e.g. '5dr hatchback ST 2.5 MT 225 hp' or 'limited edition' type: string x-ngsi: model: https://schema.org/vehicleConfiguration @@ -908,7 +1064,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleRunningStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''running, waiting, stopped''' + description: Gives the Battery charging status of the reporting device. Enum:'running, waiting, stopped' enum: - running - stopped @@ -918,7 +1074,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleSpecialUsage: - description: 'Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:''ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement''' + description: Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:'ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement' enum: - ambulance - fireBrigade @@ -938,7 +1094,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses' + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses enum: - agriculturalVehicle - ambulance @@ -1027,24 +1183,33 @@ Vehicle: - category - location 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) 2024 Contributors to Smart Data Models Program' + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/Vehicle/schema.json - x-model-tags: 'IUDX, SEDIMARK' + x-model-tags: IUDX, SEDIMARK x-version: 0.2.2 ```
- - - - - ## Esempi di payload - #### Veicolo NGSI-v2 valori-chiave Esempio - Ecco un esempio di veicolo 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à. + + + + + + + + + +## Payload di esempio + +#### Esempio di valori chiave NGSI-v2 per veicoli + +Ecco un esempio di un Veicolo in formato JSON come chiavi-valori. Ciò è compatibile con NGSI-v2 quando si utilizza `options=keyValues` e restituisce i dati di contesto di un'entità individuale.
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "vehicleType": "lorry", @@ -1105,11 +1270,15 @@ Vehicle: } ```
- #### Veicolo NGSI-v2 normalizzato Esempio - Ecco un esempio di veicolo in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si usano le opzioni e restituisce i dati di contesto di una singola entità. + +#### Veicolo Esempio NGSI-v2 normalizzato + +Ecco un esempio di un Veicolo in formato JSON come normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano opzioni e restituisce i dati di contesto di un'entità individuale.
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "category": { @@ -1281,11 +1450,15 @@ Vehicle: } ```
- #### Valori chiave NGSI-LD del veicolo Esempio - Ecco un esempio di veicolo 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à. + +#### Esempio di valori chiave NGSI-LD del veicolo + +Ecco un esempio di un Veicolo in formato JSON-LD come chiavi-valori. Ciò è compatibile con NGSI-LD quando si utilizza `options=keyValues` e restituisce i dati di contesto di un'entità individuale.
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": "Centro", @@ -1349,11 +1522,15 @@ Vehicle: } ```
- #### Veicolo NGSI-LD normalizzato Esempio - Ecco un esempio di veicolo in formato JSON-LD normalizzato. Questo è compatibile con NGSI-LD quando non si usano opzioni e restituisce i dati di contesto di una singola entità. + +#### Veicolo esempio normalizzato NGSI-LD + +Ecco un esempio di un Veicolo in formato JSON-LD normalizzato, compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati di contesto di un'entità individuale.
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": { @@ -1521,12 +1698,21 @@ Vehicle: ] } ``` -
- - - - Vedere [FAQ 10](https://smartdatamodels.org/index.php/faqs/) per ottenere una risposta su come gestire le unità di grandezza. - - +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + --- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/Vehicle/doc/spec_JA.md b/Vehicle/doc/spec_JA.md index 28032b780..888031348 100644 --- a/Vehicle/doc/spec_JA.md +++ b/Vehicle/doc/spec_JA.md @@ -1,88 +1,178 @@ - + + [![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - エンティティ車両 -======== - - [オープン・ライセンス](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/LICENSE.md) - [文書は自動的に生成される](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) - - - グローバルな記述：**このエンティティは、そのようなモデルに属する複数の車両インスタンスに共通するすべてのプロパティを含む、特定の車両モデルをモデル化する。 - バージョン: 0.2.2 - - - ## プロパティのリスト +実体: Vehicle +=============== + + + + - [*] 属性に型がない場合は、複数の型があるか、異なるフォーマット/パターンがある可能性があるためです。 -- `address[object]`: 郵送先住所 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国。例えば、スペイン . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 番地がある地域と、その地域に含まれる地域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: その地域がある地域、またその国がある地域 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: 地区とは行政区画の一種で、国によっては地方自治体によって管理されている。 - - `postOfficeBoxNumber[string]`: 私書箱の住所のための私書箱番号。例：03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: 郵便番号。例：24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: 番地 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) - - `streetNr[string]`: 公道上の特定の物件を特定する番号 -- `alternateName[string]`: この項目の別名 - `annotations[array]`: アイテムに関する注釈 . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: サービスまたは提供品が提供される地理的地域 . Model: [https://schema.org/Text](https://schema.org/Text) - `battery[number]`: 電気自動車、または電気自動車に接続された装置のバッテリー残量のパーセンテージ。 - `bearing[number]`: 真北から時計回りで測定した車両の GPS 角度を示す。GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position)の'bearing'フィールドと同じ。 . Model: [https://schema.org/Number](https://schema.org/Number) - `cargoWeight[number]`: 現在の積載重量 . Model: [https://schema.org/Number](https://schema.org/Number) - `category[array]`: 外部から見た車両のカテゴリー。これは `vehicleType` プロパティで表される車両タイプ（自動車、ローリーなど）とは異なる。Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'.追跡車両とは、リモートシステムによって位置が常時追跡されている車両のことである。GPS受信機とネットワーク接続が組み込まれており、報告された位置（位置、速度、方位...）を定期的に更新する。 . Model: [https://schema.org/Text](https://schema.org/Text) - `color[string]`: 製品の色 . Model: [https://schema.org/color](https://schema.org/color) - `currentTripCount[number]`: この観測に対応する車両が、特定の運行日に行った現在のトリップ回数。 . Model: [https://schema.org/Number](https://schema.org/Number) - `dataProvider[string]`: ハーモナイズされたデータ・エンティティの提供者を識別する一連の文字。 - `dateCreated[date-time]`: エンティティの作成タイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられます。 - `dateFirstUsed[date]`: 車両が最初に使用された時期を示すタイムスタンプ . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateModified[date-time]`: エンティティの最終変更のタイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられる。 - `dateVehicleFirstRegistered[date]`: 各公的機関への車両の最初の登録日 . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) - `description[string]`: この商品の説明 - `deviceBatteryStatus[string]`: 報告デバイスのバッテリ充電状態を示す。列挙型：「接続、切断 . Model: [https://schema.org/Text](https://schema.org/Text) - `deviceSimNumber[string]`: 車両に搭載されているデバイスのSIM番号をお知らせします。 . Model: [https://schema.org/Text](https://schema.org/Text) - `emergencyVehicleType[string]`: この観測に対応する緊急車両のタイプ。Enum:'policeCar、policeMotorcycle、policeVan、policeSWAT、fireEngine、waterTender、airAmbulance、ambulance、motorcycleAmbulance、rescueVehicle、hazardousMaterialsApparatus、towTruck . Model: [https://schema.org/Text](https://schema.org/Text) - `feature[array]`: 車両に搭載されている機能。Enum:' abs, airbag, alarm, backCamera, disabledRamp, gps, internetConnection, overspeed, proximitySensor, wifi'.または、アプリケーションが必要とするその他のもの。1つの機能の複数のインスタンスを表すには、以下の構文を使用します：,`。例えば、エアバッグが4つある車は`airbag,4`で表されます。 . Model: [https://schema.org/Text](https://schema.org/Text) - `fleetVehicleId[string]`: その車両が属する車両群におけるその車両の識別子。 . Model: [https://schema.org/Text](https://schema.org/Text) - `fuelEfficiency[number]`: 単位燃料使用量当たりの走行距離で、単位はキロメートル／リットル（km／L）。 . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelFilled[number]`: この観測に対応する車両に充填された燃料量（リットル . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelType[string]`: 本観測に対応する車両のエンジンまたはエンジンに適した燃料の種類。 . Model: [https://schema.org/Text](https://schema.org/Text) - `heading[*]`: 車両の進行方向を表し、真北から時計回りに 0 <= `heading` < 360 の範囲で10進数で指定します。車両が静止している場合（つまり `speed` 属性の値が `0`）、heading 属性の値は `-1` に等しくなければなりません。 . Model: [https://schema.org/Number](https://schema.org/Number) - `id[*]`: エンティティの一意識別子 - `ignitionStatus[boolean]`: 車両の点火状態を示す。真は点火済み . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `image[uri]`: 商品の画像 . Model: [https://schema.org/URL](https://schema.org/URL) - `license_plate[string]`: 車両のナンバープレート番号。SameAs: GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)' の license_plate フィールド。 . Model: [https://schema.org/Text](https://schema.org/Text) - `location[*]`: アイテムへの Geojson 参照。Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon のいずれか。 - `mileageFromOdometer[number]`: オドメーターから読み取った、特定の自動車が製造当初から走行した総距離。 . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) - `municipalityInfo[object]`: この観測に対応する自治体情報 . Model: [https://schema.org/Text](https://schema.org/Text) - `cityId[string]`: この観測に対応する都市ID . Model: [https://schema.org/Text](https://schema.org/Text) - - `cityName[string]`: この観測に対応する都市名 . Model: [https://schema.org/Text](https://schema.org/Text) - - `district[string]`: この観測に対応する地区名 . Model: [https://schema.org/Text](https://schema.org/Text) - - `stateName[string]`: この観測に対応する州名 . Model: [https://schema.org/Text](https://schema.org/Text) - - `ulbName[string]`: この観測に対応する都市自治体の名称 . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardId[string]`: この観察に対応する病棟ID . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardName[string]`: この観測に対応する区名 . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardNum[number]`: この観測に対応する病棟番号 . Model: [https://schema.org/Number](https://schema.org/Number) - - `zoneId[string]`: この観測に対応するゾーンID . Model: [https://schema.org/Text](https://schema.org/Text) - - `zoneName[string]`: この観測に対応するゾーン名 . Model: [https://schema.org/Text](https://schema.org/Text) -- `name[string]`: このアイテムの名前 - `observationDateTime[date-time]`: 最終観測報告時刻 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `owner[array]`: 所有者の固有IDを参照するJSONエンコードされた文字列を含むリスト。 - `previousLocation[*]`: アイテムへの Geojson 参照。Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon のいずれか。 - `purchaseDate[date-time]`: 現所有者が車両などを購入した日付 . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) - `refVehicleModel[*]`: VehicleModel への参照 . Model: [https://schema.org/URL](https://schema.org/URL) - `reportId[string]`: このオブザベーションに対応するissueまたはレポート、フィードバック、トランザクションに割り当てられた一意のID . Model: [https://schema.org/Text](https://schema.org/Text) - `seeAlso[*]`: アイテムに関する追加リソースを指すURIのリスト - `serviceOnDuty[boolean]`: この観測に対応する緊急車両が提供したサービスの性質。Trueは、この観測に対応する緊急車両が緊急通報に対応/サービスしていることを示す。 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `serviceProvided[array]`: 車両が提供できる、または割り当てられたサービス。Enum:'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'.または、特定のアプリケーションが必要とするその他の値 . Model: [https://schema.org/Text](https://schema.org/Text) - `serviceStatus[string]`: 車両の状態（サービス提供の観点から、自家用車には適用できない）。駐車中` : 車両は駐車中であり、現在サービスを提供していない。onRoute` : 車両はミッションを遂行中である。カンマで区切られた修飾子(複数可)を追加することで、その車両が現在どのようなミッションを遂行中であるかを示すことができる。例えば`onRoute,garbageCollection`は車両がルート上にあり、ゴミ収集のミッション中であることを示す。'broken' ：車両が一時的に故障している。outOfService` : 車両は道路上にあるが、ミッションは行っていない。Enum:'broken、onRoute、outOfService、parked' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `source[string]`: エンティティ・データの元のソースを URL として示す一連の文字。ソース・プロバイダの完全修飾ドメイン名、またはソース・オブジェクトの URL を推奨する。 - `speed[*]`: 車両の現在速度の水平成分の大きさを表し、キロメートル毎時で指定する。指定する場合、speed属性の値は非負の実数でなければならない。何らかの理由で速度が一時的に不明な場合は `-1` を使用してもよい。 . Model: [https://schema.org/Number](https://schema.org/Number) - `tripNetWeightCollected[number]`: 走行終了時に、この観測に対応する車両が収集した正味重量。 . Model: [https://schema.org/Number](https://schema.org/Number) - `type[string]`: NGSIエンティティタイプ。車両でなければならない。 - `vehicleAltitude[string]`: GPSを使用して車両の現在の高度を表示します。 . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleConfiguration[string]`: 例：「5dr hatchback ST 2.5 MT 225 hp」や「limited edition」など。 . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) - `vehicleIdentificationNumber[string]`: 車両識別番号（VIN）は、自動車業界が個々の自動車を識別するために使用する固有のシリアル番号である。 . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) - `vehiclePlateIdentifier[string]`: 公的な識別を目的として、車両に取り付けられた車両登録プレートに表示される識別子またはコード。登録識別子は数字または英数字で、発行機関の地域内で一意である。規格参照：DATEXII `vehicleRegistrationPlateIdentifier` （車両登録プレート識別子 . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleRunningStatus[string]`: 報告デバイスのバッテリ充電状態を示す。Enum:'実行中、待機中、停止中' . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleSpecialUsage[string]`: 商用レンタル、自動車教習所、タクシーなど、特殊な目的で使用されているかどうかを示す。多くの国の法律では、自動車を販売する際にはこの情報を明らかにすることが義務付けられている。Enum:'救急車、消防隊、軍隊、警察、学校輸送、タクシー、ゴミ処理' . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) - `vehicleTrackerDevice[string]`: この観測に対応する車両に取り付けられたGPS装置または追跡装置の設置状況。 . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleType[string]`: 車両の構造的特徴から見た車両のタイプ。これは車両カテゴリーとは異なる。列挙する：agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle、motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'.VehicleTypeEnum_および_VehicleTypeEnum2_、[DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)で定義され、他の用途のために拡張された以下の値。 . Model: [https://schema.org/Text](https://schema.org/Text) - `wardId[string]`: この観測に対応するエンティティのワードID . Model: [https://schema.org/Text](https://schema.org/Text) - `wardName[string]`: このオブザベーションに対応するエンティティのワード名 . Model: [https://schema.org/Text](https://schema.org/Text) - `zoneName[string]`: この観測に対応するエンティティのゾーン名 . Model: [https://schema.org/Text](https://schema.org/Text) - - 必須プロパティ -- `category` - `id` - `location` - `type` - `vehicleType` - - - - ## プロパティのデータモデル記述 - アルファベット順（クリックで詳細表示） - - +[オープンライセンス](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/LICENSE.md) + +[自動生成された文書](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) + + + + + +Global description: **このエンティティは、特定の車両モデルを表し、そのモデルに属する複数の車両インスタンスに共通するすべてのプロパティを含む。** + +version: 0.2.2 + + + + + + +## プロパティの一覧 + + +[*] 属性に型がないのは、それが複数の型や異なる形式/パターンを持つ可能性があるためです。 +- `address[object]`: 郵送先住所 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: その国。例えば、スペイン . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 住所が存在する地域、そしてその地域が存在する地域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: その地域は、自治体が存在し、かつその国に位置する地域です。 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 地区は、一部の国では地方自治体によって管理される行政区画の一種です。 + - `postOfficeBoxNumber[string]`: ポストオフィスボックス番号は、ポストオフィスボックスアドレスの場合。たとえば、03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 郵便番号。例えば、24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 住所 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 公道上の特定の物件を識別する番号 +- `alternateName[string]`: このアイテムの別名 +- `annotations[array]`: アイテムについての注釈 . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: サービスまたは提供されるアイテムが提供される地理的な地域 . Model: [https://schema.org/Text](https://schema.org/Text) +- `battery[number]`: 電気自動車の場合、または車両に接続されたデバイスの残りのバッテリーの現在のパーセンテージ +- `bearing[number]`: True Northから時計回りに測定された車両のGPS角度を示します。GTFS RealtimeメッセージのPosition(https://developers.google.com/transit/gtfs-realtime/reference#message-position)の'bearing'フィールドと同じです。 . Model: [https://schema.org/Number](https://schema.org/Number) +- `cargoWeight[number]`: 車両の貨物の現在の重量 . Model: [https://schema.org/Number](https://schema.org/Number) +- `category[array]`: 外部からの観点からの車両カテゴリ。車両タイプ（車、トラックなど）を表す`vehicleType`プロパティとは異なる。列挙型：'municipalServices, nonTracked, private, public, specialUsage, tracked'。トラックされた車両とは、常にリモートシステムによって位置が追跡される車両である。またはアプリケーションによって必要とされるもの。GPSレシーバーとネットワーク接続を組み合わせて、報告された位置（位置、速度、方角など）を定期的に更新する。 . Model: [https://schema.org/Text](https://schema.org/Text) +- `color[string]`: 製品の色 . Model: [https://schema.org/color](https://schema.org/color) +- `currentTripCount[number]`: この観測に対応する車両が運行日の当日に行った移動の現在の回数 . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: 調和されたデータエンティティの提供者を識別する文字シーケンス +- `dateCreated[date-time]`: エンティティ作成タイムスタンプ。このタイムスタンプは通常、ストレージプラットフォームによって割り当てられる。 +- `dateFirstUsed[date]`: 初めて使用された時刻を示すタイムスタンプ . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `dateModified[date-time]`: エンティティの最後の変更のタイムスタンプ。このタイムスタンプは通常、ストレージプラットフォームによって割り当てられる。 +- `dateVehicleFirstRegistered[date]`: その車両がそれぞれの公的機関に最初に登録された日付 . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) +- `description[string]`: このアイテムの説明 +- `deviceBatteryStatus[string]`: レポートデバイスのバッテリー充電状態を示します。 Enum: '接続済み、接続解除済み' . Model: [https://schema.org/Text](https://schema.org/Text) +- `deviceSimNumber[string]`: 車両内のデバイスのSIM番号を示します . Model: [https://schema.org/Text](https://schema.org/Text) +- `emergencyVehicleType[string]`: この観測に対応する緊急車両の種類。 Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck . Model: [https://schema.org/Text](https://schema.org/Text) +- `feature[array]`: 車両に搭載されている機能。列挙: 'abs、エアバッグ、警報装置、後部カメラ、車椅子用スロープ、GPS、インターネット接続、過速度、近接センサー、Wi-Fi'。または、アプリケーションで必要なその他のもの。複数の機能インスタンスを表すには、次の構文を使用できます: `<機能>,<発生回数>`。たとえば、4つのエアバッグを備えた車両は、`エアバッグ、4`で表されます。 . Model: [https://schema.org/Text](https://schema.org/Text) +- `fleetVehicleId[string]`: その車両が所属する車両のフリートの文脈における車両の識別子 . Model: [https://schema.org/Text](https://schema.org/Text) +- `fuelEfficiency[number]`: 燃料効率（英語版）とは、燃料を１単位使用したときに移動できる距離で、一般的には１リットルあたりのキロメートル（km/L）で表される。 . Model: [https://schema.org/Number](https://schema.org/Number) +- `fuelFilled[number]`: この観測に相当する車両に充填された燃料のリットル数 . Model: [https://schema.org/Number](https://schema.org/Number) +- `fuelType[string]`: この観測に対応する車両のエンジンまたはエンジンに適した燃料の種類 . Model: [https://schema.org/Text](https://schema.org/Text) +- `heading[*]`: 車両の移動方向を表し、10進度で指定され、0 <= `heading` < 360となり、真北を基準に時計回りに数える。如果車両が停止している場合（すなわち、`speed`属性の値が`0`の場合）、`heading`属性の値は`-1`に等しくなければならない。 . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: エンティティのユニーク識別子 +- `ignitionStatus[boolean]`: 車両の点火状態を示します。True は点火されたことを意味します。 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) +- `image[uri]`: アイテムの画像 . Model: [https://schema.org/URL](https://schema.org/URL) +- `license_plate[string]`: 車両のナンバープレート番号を示します。 SameAs: GTFS Realtime メッセージの VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor) の license_plate フィールド . Model: [https://schema.org/Text](https://schema.org/Text) +- `location[*]`: アイテムへのGeojson参照。Point、LineString、Polygon、MultiPoint、MultiLineString、またはMultiPolygonのいずれかになることができる。 +- `mileageFromOdometer[number]`: その特定の車両が初期製造以来移動した総距離、そのオドメーターから読み取った距離 . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) +- `municipalityInfo[object]`: この観測に対応する自治体情報 . Model: [https://schema.org/Text](https://schema.org/Text) + - `cityId[string]`: この観測に対応する都市ID . Model: [https://schema.org/Text](https://schema.org/Text) + - `cityName[string]`: この観測に対応する都市名 . Model: [https://schema.org/Text](https://schema.org/Text) + - `district[string]`: この観測に対応する地区名 . Model: [https://schema.org/Text](https://schema.org/Text) + - `stateName[string]`: この観測に対応する州の名前 . Model: [https://schema.org/Text](https://schema.org/Text) + - `ulbName[string]`: この観測に対応する都市地方自治体の名称 . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardId[string]`: この観測に対応するワードID . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardName[string]`: この観測に対応するワード名 . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardNum[number]`: この観察に相当するワード番号 . Model: [https://schema.org/Number](https://schema.org/Number) + - `zoneId[string]`: この観測に対応するゾーンID . Model: [https://schema.org/Text](https://schema.org/Text) + - `zoneName[string]`: この観測に対応するゾーン名 . Model: [https://schema.org/Text](https://schema.org/Text) +- `name[string]`: このアイテムの名前 +- `observationDateTime[date-time]`: 観測の最終報告時間 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `owner[array]`: 所有者のユニークIDを参照する文字シーケンスをJSONでエンコードしたものが含まれるリスト +- `previousLocation[*]`: アイテムへのGeojson参照。Point、LineString、Polygon、MultiPoint、MultiLineString、またはMultiPolygonのいずれかになります。 +- `purchaseDate[date-time]`: 現在の所有者がアイテム（例：車両）を購入した日付 . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) +- `refVehicleModel[*]`: 車両モデルへの参照 . Model: [https://schema.org/URL](https://schema.org/URL) +- `reportId[string]`: この観察に対応する問題、報告、フィードバック、またはトランザクションに割り当てられた一意のID . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: アイテムに関する追加のリソースを指すURIのリスト +- `serviceOnDuty[boolean]`: この観察に対応する緊急車両が提供するサービスの性質。Trueは、この観察に対応する緊急車両が緊急の呼び出しに対応していることを示し、Falseはそうでないことを示す。 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) +- `serviceProvided[array]`: 車両が提供できるサービス、または割り当てられたサービス。Enum: 'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'。または、特定のアプリケーションで必要なその他の値。 . Model: [https://schema.org/Text](https://schema.org/Text) +- `serviceStatus[string]`: 車両の状態（提供されるサービスからの観点で、したがって私有車両には適用できない可能性がある）。 `parked` ：車両は駐車されており、現在はサービスを提供していない。 `onRoute` ：車両はミッションを実行中である。コンマで区切られた修飾子（s）を追加して、車両が現在配達しているミッションを示すことができる。たとえば、`onRoute,garbageCollection`を使用して、車両がルート上にあり、ごみ収集ミッション中であることを示すことができる。 `broken` ：車両は一時的な故障を起こしている。 `outOfService` ：車両は道路上にあるが、ミッションを実行しておらず、駐車エリアに向かっている可能性がある。 Enum：`broken, onRoute, outOfService, parked` . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `source[string]`: エンティティデータの元のソースをURLとして示す文字列のシーケンス。ソースプロバイダーの完全修飾ドメイン名、またはソースオブジェクトへのURLであることを推奨する。 +- `speed[*]`: 車両の現在の速度の水平成分の大きさを表し、キロメートル毎時で指定される。如果提供される場合、speed 属性の値は非負の実数でなければならない。速度が一時的に何らかの理由で不明である場合、 `-1` を使用することができる。 . Model: [https://schema.org/Number](https://schema.org/Number) +- `tripNetWeightCollected[number]`: この観測に対応する車両が旅の終わりに収集したネット重量 . Model: [https://schema.org/Number](https://schema.org/Number) +- `type[string]`: NGSIエンティティタイプ。Vehicleでなければなりません。 +- `vehicleAltitude[string]`: 車両の現在の高度をGPSを使用して取得する . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleConfiguration[string]`: 車両の設定を示す短いテキスト、例えば「5ドアハッチバックST 2.5 MT 225馬力」または「限定版」 . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) +- `vehicleIdentificationNumber[string]`: 車両識別番号（VIN）とは、自動車業界が個々の自動車を識別するために使用する一意のシリアル番号である。 . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) +- `vehiclePlateIdentifier[string]`: 車両に取り付けられた車両登録番号板に表示される識別子またはコードで、公的識別のために使用される。登録識別子は、数字またはアルファベットと数字の組み合わせで、発行機関の地域内では一意である。規範参照：DATEXII `vehicleRegistrationPlateIdentifier` . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleRunningStatus[string]`: レポートデバイスのバッテリー充電状態を示します。 Enum: '実行中, 待機中, 停止' . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleSpecialUsage[string]`: 車両が商用レンタル、ドライブスクール、またはタクシーとして使用されているかどうかを示します。多くの国では、車両を販売する際にこの情報を開示することが法律で義務付けられています。列挙:'救急車、消防署、軍事、警察、学校輸送、タクシー、ごみ処理' . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) +- `vehicleTrackerDevice[string]`: この観測に対応する車両に取り付けられたGPSデバイスまたはトラッキングデバイスの設置状況 . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleType[string]`: その構造的特性からの車両の種類。これは、車両カテゴリとは異なる。 Enum:'農業車両、任意の車両、連節車両、自転車、ごみ収集トロリー、バス、自動車、キャラバン、自動車または軽車両、キャラバン付自動車、トレーラー付自動車、清掃トロリー、建設または保守車両、四輪駆動車、高床車、トラック、ミニバス、原動機付自転車、オートバイ、サイドカー付きオートバイ、モータースクーター、掃除機、タンカー、三輪車、トレーラー、路面電車、สอง輪車、トロリー、バン、触媒コンバータなし車両、キャラバン付車両、トレーラー付車両、偶数のナンバープレート、奇数のナンバープレート、その他'。以下の値は、_VehicleTypeEnum_ と _VehicleTypeEnum2_ で定義され、[DATEX 2 バージョン 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) で拡張されており、他の用途にも使用される。 . Model: [https://schema.org/Text](https://schema.org/Text) +- `wardId[string]`: この観測に対応するエンティティのワードID . Model: [https://schema.org/Text](https://schema.org/Text) +- `wardName[string]`: この観測に対応するエンティティのワード名 . Model: [https://schema.org/Text](https://schema.org/Text) +- `zoneName[string]`: この観測に対応するエンティティのゾーン名 . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +必要なプロパティ +- `カテゴリ` +- `ID` +- `ロケーション` +- `タイプ` +`車両タイプ` + + + + + + + + + +## データモデルのプロパティの説明 + +アルファベット順に並べ替え（詳細） + + + +
full yaml details - ```yaml + +```yaml Vehicle: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -122,14 +212,14 @@ Vehicle: model: https://schema.org/Text type: Property battery: - description: 'The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle' + description: The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle maximum: 1 minimum: 0 type: number x-ngsi: type: Property bearing: - description: "Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position)" + description: Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) type: number x-ngsi: model: https://schema.org/Number @@ -144,7 +234,7 @@ Vehicle: type: Property units: Kilograms category: - description: 'Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:''municipalServices, nonTracked, private, public, specialUsage, tracked''. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...)' + description: Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...) items: enum: - municipalServices @@ -207,7 +297,7 @@ Vehicle: x-ngsi: type: Property deviceBatteryStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''connected, disconnected''' + description: Gives the Battery charging status of the reporting device. Enum:'connected, disconnected' enum: - connected - disconnected @@ -222,7 +312,7 @@ Vehicle: model: https://schema.org/Text type: Property emergencyVehicleType: - description: 'Type of emergency vehicle corresponding to this observation. Enum:''policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck' + description: Type of emergency vehicle corresponding to this observation. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck enum: - policeCar - policeMotorcycle @@ -266,7 +356,7 @@ Vehicle: model: https://schema.org/Text type: Property fuelEfficiency: - description: 'The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L)' + description: The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L) type: number x-ngsi: model: https://schema.org/Number @@ -284,7 +374,7 @@ Vehicle: model: https://schema.org/Text type: Property heading: - description: 'Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1`' + description: Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1` oneOf: - exclusiveMaximum: 360 maximum: 360 @@ -313,7 +403,7 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship ignitionStatus: description: Gives the ignition status of the vehicle. True means ignited type: boolean @@ -328,26 +418,32 @@ Vehicle: model: https://schema.org/URL type: Property license_plate: - description: "Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)'" + description: 'Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)''' type: string x-ngsi: model: https://schema.org/Text type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -362,11 +458,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -374,6 +474,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -388,11 +490,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -402,6 +508,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -416,17 +524,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -441,11 +555,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -455,6 +573,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -474,6 +594,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -485,6 +606,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -499,7 +622,7 @@ Vehicle: x-ngsi: type: GeoProperty mileageFromOdometer: - description: 'The total distance travelled by the particular vehicle since its initial production, as read from its odometer' + description: The total distance travelled by the particular vehicle since its initial production, as read from its odometer type: number x-ngsi: model: https://schema.org/mileageFromOdometer @@ -601,25 +724,31 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property previousLocation: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -634,11 +763,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -646,6 +779,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -660,11 +795,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -674,6 +813,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -688,17 +829,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -713,11 +860,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -727,6 +878,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -746,6 +899,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -757,6 +911,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -820,7 +976,7 @@ Vehicle: model: https://schema.org/Boolean type: Property serviceProvided: - description: 'Service(s) the vehicle is capable of providing or it is assigned to. Enum:''auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning''. Or any other value needed by an specific application' + description: Service(s) the vehicle is capable of providing or it is assigned to. Enum:'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Or any other value needed by an specific application items: enum: - auxiliaryServices @@ -854,12 +1010,12 @@ Vehicle: model: https://schema.org/DateTime 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' + 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 speed: - description: 'Denotes the magnitude of the horizontal component of the vehicle''s current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason' + description: Denotes the magnitude of the horizontal component of the vehicle's current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason oneOf: - minimum: 0 type: number @@ -890,7 +1046,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleConfiguration: - description: 'A short text indicating the configuration of the vehicle, e.g. ''5dr hatchback ST 2.5 MT 225 hp'' or ''limited edition''' + description: A short text indicating the configuration of the vehicle, e.g. '5dr hatchback ST 2.5 MT 225 hp' or 'limited edition' type: string x-ngsi: model: https://schema.org/vehicleConfiguration @@ -908,7 +1064,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleRunningStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''running, waiting, stopped''' + description: Gives the Battery charging status of the reporting device. Enum:'running, waiting, stopped' enum: - running - stopped @@ -918,7 +1074,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleSpecialUsage: - description: 'Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:''ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement''' + description: Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:'ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement' enum: - ambulance - fireBrigade @@ -938,7 +1094,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses' + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses enum: - agriculturalVehicle - ambulance @@ -1027,24 +1183,33 @@ Vehicle: - category - location 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) 2024 Contributors to Smart Data Models Program' + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/Vehicle/schema.json - x-model-tags: 'IUDX, SEDIMARK' + x-model-tags: IUDX, SEDIMARK x-version: 0.2.2 ```
- - - - - ## ペイロードの例 - #### 車両 NGSI-v2 キー値の例 - JSON-LD形式のVehicleのkey-valuesの例です。これはNGSI-v2と互換性があり、`options=keyValues`を使用すると、個々のエンティティのコンテキストデータを返す。 + + + + + + + + + +## 例のペイロード + +#### 車両 NGSI-v2 キー値の例 + +ここでは、キーと値のペアで表されたJSON形式のVehicleの例を示します。これは、`options=keyValues`を使用してNGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返します。
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "vehicleType": "lorry", @@ -1105,11 +1270,15 @@ Vehicle: } ```
- #### 車両 NGSI-v2 正規化例 - 以下は、正規化された JSON-LD フォーマットの Vehicle の例です。これは、オプションを使用しない場合、NGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返します。 + +#### 車両NGSI-v2正規化例 + +ここには、正規化されたJSON形式のVehicleの例が記載されています。これは、オプションを使用しない場合にNGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返します。
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "category": { @@ -1281,11 +1450,15 @@ Vehicle: } ```
- #### 車両 NGSI-LD キー値の例 - JSON-LD形式のVehicleのkey-valuesの例です。これは、`options=keyValues`を使用した場合にNGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。 + +#### 車両NGSI-LDキー値の例 + +ここでは、キー値としてのJSON-LD形式のVehicleの例を示します。これは、`options=keyValues`を使用してNGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": "Centro", @@ -1349,11 +1522,15 @@ Vehicle: } ```
- #### 車両 NGSI-LD 正規化例 - 以下は、正規化された JSON-LD フォーマットの Vehicle の例です。これは、オプションを使用しない場合、NGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。 + +#### 車両NGSI-LD正規化例 + +ここはJSON-LD形式のVehicleの例である。これはオプションを使用しない場合にNGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返す。
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": { @@ -1521,12 +1698,21 @@ Vehicle: ] } ``` -
- - - - マグニチュード単位の扱い方については、[FAQ 10](https://smartdatamodels.org/index.php/faqs/)を参照のこと。 - - + + + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + --- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/Vehicle/doc/spec_KO.md b/Vehicle/doc/spec_KO.md index 18c2e82e2..fd4030761 100644 --- a/Vehicle/doc/spec_KO.md +++ b/Vehicle/doc/spec_KO.md @@ -1,88 +1,183 @@ - + + [![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - 엔티티: 엔티티: 차량 -============ - - [오픈 라이선스](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/LICENSE.md) - [문서 자동 생성](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) - - - 글로벌 설명: **이 엔터티는 특정 차량 모델을 모델링하며, 해당 모델에 속한 여러 차량 인스턴스에 공통으로 적용되는 모든 속성을 포함합니다.** - 버전: 0.2.2 - - - ## 속성 목록 +엔티티: Vehicle +=============== + + + + - [*] 속성에 유형이 없는 것은 여러 유형 또는 다른 형식/패턴을 가질 수 있기 때문입니다. -- `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 국가. 예를 들어, 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 도로명 주소가 있는 지역 및 해당 지역 내 지역 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: 해당 지역이 위치한 지역과 해당 국가의 지역 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: 지구는 일부 국가에서는 지방 정부에서 관리하는 행정 구역의 일종입니다. - - `postOfficeBoxNumber[string]`: 사서함 주소의 우체국 사서함 번호입니다. 예: 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: 우편 번호입니다. 예: 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: 거리 주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) - - `streetNr[string]`: 공공 도로의 특정 건물을 식별하는 번호 -- `alternateName[string]`: 이 항목의 대체 이름 - `annotations[array]`: 항목에 대한 주석 . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: 서비스 또는 제공 품목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) - `battery[number]`: 전기 자동차 또는 차량에 연결된 장치의 경우 현재 남은 배터리 비율입니다. - `bearing[number]`: 진북에서 시계 방향으로 측정된 차량 GPS 각도를 제공합니다. GTFS 실시간 메시지-위치(https://developers.google.com/transit/gtfs-realtime/reference#message-position)의 '방위' 필드와 동일합니다. . Model: [https://schema.org/Number](https://schema.org/Number) - `cargoWeight[number]`: 차량 화물의 현재 무게 . Model: [https://schema.org/Number](https://schema.org/Number) - `category[array]`: 외부 관점에서의 차량 카테고리입니다. 차량 유형(승용차, 화물차 등)은 `vehicleType` 속성으로 표현되는 차량 유형과는 다릅니다. Enum: '지자체서비스, 비추적, 자가용, 공용, 특수용도, 추적'. 추적 차량은 원격 시스템에 의해 위치가 영구적으로 추적되는 차량입니다. 또는 애플리케이션에서 필요로 하는 기타 모든 것 GPS 수신기를 네트워크 연결과 함께 통합하여 보고된 위치(위치, 속도, 방향 등)를 주기적으로 업데이트합니다. . Model: [https://schema.org/Text](https://schema.org/Text) - `color[string]`: 제품 색상 . Model: [https://schema.org/color](https://schema.org/color) - `currentTripCount[number]`: 주어진 운행일에 이 관측에 해당하는 차량의 현재 운행 횟수입니다. . Model: [https://schema.org/Number](https://schema.org/Number) - `dataProvider[string]`: 조화된 데이터 엔티티의 공급자를 식별하는 일련의 문자 - `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateFirstUsed[date]`: 차량이 처음 사용된 시점을 나타내는 타임스탬프 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateModified[date-time]`: 엔티티의 마지막 수정 타임스탬프입니다. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateVehicleFirstRegistered[date]`: 각 공공 기관에 차량을 처음 등록한 날짜입니다. . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) - `description[string]`: 이 항목에 대한 설명 - `deviceBatteryStatus[string]`: 리포팅 디바이스의 배터리 충전 상태를 반환합니다. Enum:'연결됨, 연결 끊김' . Model: [https://schema.org/Text](https://schema.org/Text) - `deviceSimNumber[string]`: 차량 내 기기의 SIM 번호를 제공합니다. . Model: [https://schema.org/Text](https://schema.org/Text) - `emergencyVehicleType[string]`: 이 관측에 해당하는 긴급 차량의 유형입니다. Enum:'경찰자동차, 경찰오토바이, 경찰밴, 경찰소방, 소방엔진, 물탱크, 공기구급차, 구급차, 오토바이구급차, 구조차, 위험물기구, 견인트럭 . Model: [https://schema.org/Text](https://schema.org/Text) - `feature[array]`: 차량에 통합된 기능. Enum: 'abs, 에어백, 알람, 후방카메라, 장애인램프, GPS, 인터넷연결, 과속, 근접센서, 와이파이'. 또는 애플리케이션에 필요한 다른 모든 것. 기능의 여러 인스턴스를 표현하기 위해 다음 구문을 사용할 수 있습니다: `<기능>,<발생>`. 예를 들어 에어백이 4개 있는 자동차는 `에어백,4`로 표현됩니다. . Model: [https://schema.org/Text](https://schema.org/Text) - `fleetVehicleId[string]`: 차량이 속한 차량의 컨텍스트에서 차량의 식별자 . Model: [https://schema.org/Text](https://schema.org/Text) - `fuelEfficiency[number]`: 사용된 연료 단위당 이동 거리(일반적으로 리터당 킬로미터(km/L) 단위) . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelFilled[number]`: 이 관측에 해당하는 차량에 리터 단위로 충전된 연료의 양입니다. . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelType[string]`: 이 관측에 해당하는 차량의 엔진에 적합한 연료의 종류는 다음과 같습니다. . Model: [https://schema.org/Text](https://schema.org/Text) - `heading[*]`: 차량의 진행 방향을 나타내며 소수점으로 지정되며, 0 <= `방향` < 360, 진북을 기준으로 시계 방향으로 세는 값입니다. 차량이 정지 상태인 경우(즉, `속도` 속성의 값이 `0`인 경우), 방향 속성 값은 `-1`이어야 합니다. . Model: [https://schema.org/Number](https://schema.org/Number) - `id[*]`: 엔티티의 고유 식별자 - `ignitionStatus[boolean]`: 차량의 점화 상태를 나타냅니다. 참은 점화됨을 의미합니다. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `image[uri]`: 항목 이미지 . Model: [https://schema.org/URL](https://schema.org/URL) - `license_plate[string]`: 차량의 번호판 번호를 제공합니다. 동일: GTFS 실시간 메시지-차량 설명자(https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)의 차량 번호판 필드' . Model: [https://schema.org/Text](https://schema.org/Text) - `location[*]`: 항목에 대한 지오숀 참조입니다. 포인트, 라인스트링, 다각형, 멀티포인트, 멀티라인스트링 또는 멀티폴리곤일 수 있습니다. - `mileageFromOdometer[number]`: 주행 거리계에서 읽은 특정 차량이 최초 생산 이후 이동한 총 거리입니다. . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) - `municipalityInfo[object]`: 이 관측에 해당하는 지자체 정보 . Model: [https://schema.org/Text](https://schema.org/Text) - `cityId[string]`: 이 관측에 해당하는 도시 ID . Model: [https://schema.org/Text](https://schema.org/Text) - - `cityName[string]`: 이 관측에 해당하는 도시 이름 . Model: [https://schema.org/Text](https://schema.org/Text) - - `district[string]`: 이 관측에 해당하는 지구 이름 . Model: [https://schema.org/Text](https://schema.org/Text) - - `stateName[string]`: 이 관찰에 해당하는 상태의 이름 . Model: [https://schema.org/Text](https://schema.org/Text) - - `ulbName[string]`: 이 관측에 해당하는 도시 지역 단체의 이름 . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardId[string]`: 이 관찰에 해당하는 병동 ID . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardName[string]`: 이 관찰에 해당하는 병동 이름 . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardNum[number]`: 이 관찰에 해당하는 병동 번호 . Model: [https://schema.org/Number](https://schema.org/Number) - - `zoneId[string]`: 이 관측에 해당하는 구역 ID . Model: [https://schema.org/Text](https://schema.org/Text) - - `zoneName[string]`: 이 관측에 해당하는 영역 이름 . Model: [https://schema.org/Text](https://schema.org/Text) -- `name[string]`: 이 항목의 이름 - `observationDateTime[date-time]`: 마지막으로 보고된 관찰 시간 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `owner[array]`: 소유자의 고유 ID를 참조하는 JSON 인코딩된 문자 시퀀스가 포함된 목록입니다. - `previousLocation[*]`: 항목에 대한 지오숀 참조입니다. 포인트, 라인스트링, 다각형, 멀티포인트, 멀티라인스트링 또는 멀티폴리곤일 수 있습니다. - `purchaseDate[date-time]`: 현재 소유자가 해당 품목(예: 차량)을 구매한 날짜입니다. . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) - `refVehicleModel[*]`: 차량 모델에 대한 참조 . Model: [https://schema.org/URL](https://schema.org/URL) - `reportId[string]`: 이 관찰에 해당하는 이슈 또는 보고서, 피드백 또는 거래에 대해 할당된 고유 ID . Model: [https://schema.org/Text](https://schema.org/Text) - `seeAlso[*]`: 항목에 대한 추가 리소스를 가리키는 URL 목록 - `serviceOnDuty[boolean]`: 이 관찰에 해당하는 긴급 차량이 제공하는 서비스의 성격. 참은 이 관찰에 해당하는 긴급 차량이 긴급 출동에 출동/서비스 중임을 나타내며, 그렇지 않으면 거짓입니다. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `serviceProvided[array]`: 차량이 제공할 수 있거나 차량이 할당된 서비스. Enum: '보조서비스, 화물운송, 건설, 박람회장, 쓰레기수거, 물품판매, 유지보수, 공원 및 정원, 도로신호, 특수운송, 거리청소, 거리조명, 도시교통, 폐기물용기청소'. 또는 특정 애플리케이션에 필요한 기타 값 . Model: [https://schema.org/Text](https://schema.org/Text) - `serviceStatus[string]`: 차량 상태(제공되는 서비스 관점의 차량 상태이므로 개인 차량에는 적용되지 않음). 주차 중` : 차량이 주차되어 있으며 현재 서비스를 제공하지 않습니다. `온라우트` : 차량이 임무를 수행 중입니다. 쉼표로 구분된 수정자를 추가하여 현재 차량이 어떤 임무를 수행 중인지 나타낼 수 있습니다. 예를 들어 `onRoute,garbageCollection`은 차량이 운행 중이며 쓰레기 수거 임무를 수행 중임을 나타내는 데 사용할 수 있습니다. 'broken' : 차량이 일시적인 고장을 겪고 있습니다. 'outOfService' : 차량이 도로에 있지만 미션을 수행하지 않고 주차 구역으로 이동 중입니다. Enum:'broken, onRoute, outOfService, parked' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `source[string]`: 엔티티 데이터의 원본 소스를 URL로 제공하는 문자 시퀀스입니다. 소스 공급자의 정규화된 도메인 이름 또는 소스 개체에 대한 URL을 사용하는 것이 좋습니다. - `speed[*]`: 차량의 현재 속도의 수평 성분의 크기를 나타내며 시간당 킬로미터 단위로 지정됩니다. 제공된 경우 속도 속성의 값은 음수가 아닌 실수여야 합니다. 어떤 이유로 일시적으로 속도를 알 수 없는 경우 `-1`을 사용할 수 있습니다. . Model: [https://schema.org/Number](https://schema.org/Number) - `tripNetWeightCollected[number]`: 여행이 끝날 때 이 관측에 해당하는 차량이 수집한 순중량입니다. . Model: [https://schema.org/Number](https://schema.org/Number) - `type[string]`: NGSI 엔티티 유형. 차량이어야 합니다. - `vehicleAltitude[string]`: GPS를 사용하여 차량의 현재 고도를 제공합니다. . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleConfiguration[string]`: 차량 구성을 나타내는 짧은 텍스트(예: '5dr 해치백 ST 2.5 MT 225마력' 또는 '한정판') . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) - `vehicleIdentificationNumber[string]`: 차량 식별 번호(VIN)는 자동차 업계에서 개별 자동차를 식별하기 위해 사용하는 고유 일련 번호입니다. . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) - `vehiclePlateIdentifier[string]`: 공식 식별 목적으로 사용되는 차량에 부착된 차량 등록 번호판에 표시된 식별자 또는 코드입니다. 등록 식별자는 숫자 또는 영숫자로 구성되며 발급 기관의 지역 내에서 고유합니다. 규범 참조: DATEXII `차량등록번호판 식별자` . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleRunningStatus[string]`: 리포팅 디바이스의 배터리 충전 상태를 반환합니다. Enum: '실행 중, 대기 중, 중지됨' . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleSpecialUsage[string]`: 차량이 상업용 렌트, 운전학원 또는 택시와 같은 특수 목적으로 사용되었는지 여부를 나타냅니다. 많은 국가의 법률에 따라 자동차를 판매할 때 이 정보를 공개해야 합니다. Enum:'구급차, 소방대, 군대, 경찰, 학교교통수단, 택시, 쓰레기관리' . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) - `vehicleTrackerDevice[string]`: 이 관측에 해당하는 차량에 장착된 GPS 장치 또는 추적 장치의 설치 상태 . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleType[string]`: 구조적 특성의 관점에서 본 차량 유형입니다. 이는 차량 카테고리와는 다릅니다. Enum:'농업용 차량, 모든 차량, 굴절식 차량, 자전거, 빈 트롤리, 버스, 자동차, 캐러밴, 자동차 또는 경량 차량, 자동차 위드 캐러밴, 자동차 위드 트레일러, 청소 트롤리, 건설 또는 유지 보수 차량, 4륜 구동, 하이 사이드 차량, 트럭, 미니 버스, 오토바이, 오토바이, motorcycleWithSideCar, 모터스쿠터, 스위핑머신, 탱커, 3륜차, 트레일러, 트램, 2륜차, 트롤리, 밴, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, 기타' 등. 이 값은 '차량 번호판이 짝수로 표시된 차량, 차량 번호판이 홀수로 표시된 차량, 차량 번호판이 짝수인 차량'을 의미합니다. DATEX 2 버전 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)에서 정의하고 다른 용도로 확장된 _VehicleTypeEnum_ 및 _VehicleTypeEnum2_에 의해 정의된 다음 값 . Model: [https://schema.org/Text](https://schema.org/Text) - `wardId[string]`: 이 관찰에 해당하는 엔티티의 병동 ID . Model: [https://schema.org/Text](https://schema.org/Text) - `wardName[string]`: 이 관찰에 해당하는 엔티티의 병동 이름 . Model: [https://schema.org/Text](https://schema.org/Text) - `zoneName[string]`: 이 관측에 해당하는 엔티티의 영역 이름 . Model: [https://schema.org/Text](https://schema.org/Text) - - 필수 속성 -- `category` - `id` - `location` - `type` - `vehicleType` - - - - ## 속성에 대한 데이터 모델 설명 - 알파벳순으로 정렬(자세한 내용을 보려면 클릭) - - +[오픈 라이선스](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/LICENSE.md) + +[자동으로 생성된 문서](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) + + + + + +Global description: **이 엔티티는 특정 차량 모델을 모델링하며, 그러한 모델에 속하는 여러 차량 인스턴스에 공통인 모든 속성을 포함한다.** + +version: 0.2.2 + + + + + + +## 속성 목록 + + +[*] 속성에 유형이 없다면, 그것은 여러 유형이나 서로 다른 형식/패턴을 가질 수 있기 때문입니다. +- `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: 그 국가. 예를 들어 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 그 거리 주소가 속한 지역 및 그 지역에 있는 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 그 지역은 지자체가 위치하고 있으며, 그 국가에 있습니다 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 구는 일부 국가에서 지방 정부가 관리하는 유형의 행정 구역입니다 + - `postOfficeBoxNumber[string]`: 우체국 사서함 번호(PO 박스 주소용). 예를 들어, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 우편번호. 예를 들어, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 도로 주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 공공 도로상 특정 부동산을 식별하는 번호 +- `alternateName[string]`: 이 항목의 대체 이름 +- `annotations[array]`: 아이템에 대한 주석 . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: 서비스나 제공되는 항목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) +- `battery[number]`: 전기 자동차의 경우 남은 배터리 백분율 또는 차량에 연결된 장치 +- `bearing[number]`: 차량의 GPS 각도를 真北에서 시계 방향으로 측정한 값을 반환한다. GTFS 실시간 메시지의 Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) 필드의 'bearing'과 동일하다. . Model: [https://schema.org/Number](https://schema.org/Number) +- `cargoWeight[number]`: 차량의 화물 현재 무게 . Model: [https://schema.org/Number](https://schema.org/Number) +- `category[array]`: 외부의 관점에서 차량 카테고리. 이것은 차량 유형(차, 트럭 등)과는 다르며, `vehicleType` 속성으로 표현된다. Enum: 'municipalServices, nonTracked, private, public, specialUsage, tracked'. 추적 가능한 차량은 원격 시스템에 의해 항상 위치가 추적되는 차량이다. 또는 애플리케이션이 필요로 하는 다른 것들. 위치, 속도, 방향 등을 주기적으로 업데이트하기 위해 GPS 수신기와 네트워크 연결을 함께 통합한다. . Model: [https://schema.org/Text](https://schema.org/Text) +- `color[string]`: 제품의 색상 . Model: [https://schema.org/color](https://schema.org/color) +- `currentTripCount[number]`: 해당 관측값에 해당하는 차량이 운행일에 수행한 여행의 현재 수 . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: 조화된 데이터 엔티티의 제공자를 식별하는 문자열 시퀀스 +- `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이는 일반적으로 저장소 플랫폼에 의해 할당됩니다. +- `dateFirstUsed[date]`: 처음 사용된 시점을 나타내는 타임스탬프 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `dateModified[date-time]`: 엔티티의 마지막 수정 타임스탬프. 이는 일반적으로 저장 플랫폼에 의해 할당됨 +- `dateVehicleFirstRegistered[date]`: 차량이 해당 공공기관에 최초로 등록된 날짜 . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) +- `description[string]`: 이 항목에 대한 설명 +- `deviceBatteryStatus[string]`: 리포팅 장치의 배터리 충전 상태를 제공합니다. Enum: '연결됨, 연결안됨' . Model: [https://schema.org/Text](https://schema.org/Text) +- `deviceSimNumber[string]`: 차량의 기기에서 SIM 번호를 제공합니다 . Model: [https://schema.org/Text](https://schema.org/Text) +- `emergencyVehicleType[string]`: 이 관찰에 해당하는 긴급 차량의 유형. Enum: '경찰차, 경찰모터사이클, 경찰밴, 경찰SWAT, 소방차, 소화차, 공중구급차, 구급차, 모터사이클구급차, 구조차, 위험물처리차, 견인차 . Model: [https://schema.org/Text](https://schema.org/Text) +- `feature[array]`: 차량에 통합된 기능. Enum: 'abs, 에어백, 경보, 후방카메라, 장애인 램프, gps, 인터넷 연결, 과속, 근접 센서, wifi'. 또는 애플리케이션에서 필요한 기타 항목. 여러 기능의 인스턴스를 나타내는 데에는 다음 구문을 사용할 수 있다: `<기능>,<발생 횟수>`. 예를 들어, 4개의 에어백이 있는 차량은 `에어백,4`로 표시된다. . Model: [https://schema.org/Text](https://schema.org/Text) +- `fleetVehicleId[string]`: 그것이 속한 차량 대의 맥락에서 차량의 식별자 . Model: [https://schema.org/Text](https://schema.org/Text) +- `fuelEfficiency[number]`: 연료 사용량 당 이동한 거리, 일반적으로 리터당 킬로미터(km/L)로 표시된다. . Model: [https://schema.org/Number](https://schema.org/Number) +- `fuelFilled[number]`: 이 관찰에 해당하는 차량에 채워진 연료의 리터 단위 количе . Model: [https://schema.org/Number](https://schema.org/Number) +- `fuelType[string]`: 이 관찰에 해당하는 차량의 엔진 또는 엔진에 적합한 연료의 유형 . Model: [https://schema.org/Text](https://schema.org/Text) +- `heading[*]`: 차량의 이동 방향을 나타내며, 10진도 단위로 지정되며, 0 <= `heading` < 360이며, 진북을 기준으로 시계 방향으로 계산된다. 차량이 정지해 있는 경우(즉, `speed` 속성의 값이 `0`인 경우), `heading` 속성의 값은 `-1`과 같아야 한다. . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: 개체의 고유 식별자 +- `ignitionStatus[boolean]`: 차량의 점화 상태를 반환합니다. True는 점화된 것을 의미합니다. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) +- `image[uri]`: 아이템의 이미지 . Model: [https://schema.org/URL](https://schema.org/URL) +- `license_plate[string]`: 차량의 번호판 번호를 제공합니다. SameAs: GTFS 실시간 메시지-VehicleDescriptor의 license_plate 필드(https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor) . Model: [https://schema.org/Text](https://schema.org/Text) +- `location[*]`: Geojson 아이템 참조입니다. Point, LineString, Polygon, MultiPoint, MultiLineString 또는 MultiPolygon 중 하나일 수 있습니다. +- `mileageFromOdometer[number]`: 초기 생산 이후 특정 차량이 이동한 총 거리로서, 그것의 속도계에서 읽은 거리 . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) +- `municipalityInfo[object]`: 이 관측에 해당하는 자치체 정보 . Model: [https://schema.org/Text](https://schema.org/Text) + - `cityId[string]`: 이 관측에 해당하는 도시 ID . Model: [https://schema.org/Text](https://schema.org/Text) + - `cityName[string]`: 이 관측에 해당하는 도시 이름 . Model: [https://schema.org/Text](https://schema.org/Text) + - `district[string]`: 이 관측에 해당하는 지구 이름 . Model: [https://schema.org/Text](https://schema.org/Text) + - `stateName[string]`: 이 관찰에 해당하는 주의 이름 . Model: [https://schema.org/Text](https://schema.org/Text) + - `ulbName[string]`: 이 관찰에 해당하는 도시 지역 단체의 이름 . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardId[string]`: 이 관찰에 해당하는 Ward ID . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardName[string]`: 이 관찰에 해당하는 구 이름 . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardNum[number]`: 이 관찰에 해당하는 구 번호 . Model: [https://schema.org/Number](https://schema.org/Number) + - `zoneId[string]`: 이 관측에 해당하는 존 ID . Model: [https://schema.org/Text](https://schema.org/Text) + - `zoneName[string]`: 이 관측에 해당하는 구역 이름 . Model: [https://schema.org/Text](https://schema.org/Text) +- `name[string]`: 이 항목의 이름 +- `observationDateTime[date-time]`: 최종 관측 보고 시간 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `owner[array]`: 소유자(들)의 고유 ID를 참조하는 문자열 시퀀스를 JSON으로 인코딩한 문자열을 포함하는 목록 +- `previousLocation[*]`: Geojson 아이템 참조입니다. Point, LineString, Polygon, MultiPoint, MultiLineString 또는 MultiPolygon 일 수 있습니다. +- `purchaseDate[date-time]`: 현재 소유자가 차량 등을 구입한 날짜 . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) +- `refVehicleModel[*]`: 차량 모델 참조 . Model: [https://schema.org/URL](https://schema.org/URL) +- `reportId[string]`: 이 관찰에 해당하는 문제 또는 보고서 또는 피드백 또는 트랜잭션에 할당된 고유 ID . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: 아이템에 대한 추가 리소스를 가리키는 URI 목록 +- `serviceOnDuty[boolean]`: 이 관찰에 해당하는 응급 차량이 제공하는 서비스의 특성. True는 이 관찰에 해당하는 응급 차량이 응급 호출에 출동하여 서비스를 제공하고 있음을 나타내며, False는 그렇지 않음을 나타낸다. . Model: [https://schema.org/Boolean](https://schema.org/Boolean) +- `serviceProvided[array]`: 차량이 제공할 수 있는 서비스 또는 할당된 서비스. Enum: 'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. 또는 특정 애플리케이션이 필요로 하는 다른 값 . Model: [https://schema.org/Text](https://schema.org/Text) +- `serviceStatus[string]`: 차량 상태(제공되는 서비스의 관점에서 볼 때, 따라서 개인 차량에는 적용되지 않을 수 있음). +`parked` : 차량이 주차되어 있으며 현재 서비스를 제공하지 않고 있음. +`onRoute` : 차량이 임무를 수행 중임. 쉼표로 구분된 수정자(modifier)를 추가하여 현재 차량이 수행 중인 임무를 나타낼 수 있음. 예를 들어, `onRoute,garbageCollection`은 차량이 이동 중이며 쓰레기 수집 임무를 수행 중임을 나타낼 수 있음. +`broken` : 차량이 일시적인 고장을 겪고 있음. +`outOfService` : 차량이 도로에 있지만 임무를 수행하지 않고 있으므로 아마도 주차 구역으로 이동 중임. +Enum: 'broken, onRoute, outOfService, parked' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `source[string]`: 엔티티 데이터의 원래 출처를 URL로 제공하는 문자열 시퀀스. 출처 제공자의 완전히 정규화된 도메인 이름이나 출처 개체에 대한 URL로 지정하는 것을 권장합니다. +- `speed[*]`: 차량의 현재 속도의 수평 성분의 크기를 나타내며, 킬로미터당 시간으로 지정된다. 제공되는 경우, 속도 속성의 값은 음이 아닌 실수여야 한다. 일시적으로 어떤 이유로 속도가 알 수 없을 때는 `-1`을 사용할 수 있다. . Model: [https://schema.org/Number](https://schema.org/Number) +- `tripNetWeightCollected[number]`: 이 관찰에 해당하는 차량이 여행의 끝에 수집한 순중량 . Model: [https://schema.org/Number](https://schema.org/Number) +- `type[string]`: NGSI 엔티티 유형. 차량이어야 합니다. +- `vehicleAltitude[string]`: GPS를 이용하여 차량의 현재 고도를 제공합니다. . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleConfiguration[string]`: 차량의 구성에 대한 짧은 텍스트, 예를 들어 '5도어 해치백 ST 2.5 MT 225 마력' 또는 '한정판' . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) +- `vehicleIdentificationNumber[string]`: 차량 식별 번호(Vehicle Identification Number, VIN)는 자동차 산업에서 개별 자동차를 식별하기 위해 사용되는 고유한 일련 번호이다. . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) +- `vehiclePlateIdentifier[string]`: 차량 등록증에 부착되어 공식적인 식별 목적으로 사용되는 차량 등록 번호판에 표시된 식별자 또는 코드이다. 등록 식별자는 숫자 또는 영숫자이며 발급 기관의 지역 내에서 고유하다. 규범적 참조: DATEXII `vehicleRegistrationPlateIdentifier` . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleRunningStatus[string]`: 리포팅 장치의 배터리 충전 상태를 제공합니다. Enum: '실행중, 대기중, 중지됨' . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleSpecialUsage[string]`: 차량이 상업용 렌탈, 운전 학교 또는 택시와 같은 특별한 용도로 사용되었는지 여부를 나타냅니다. 많은 국가의 법률은 차량을 판매할 때 이 정보를 공개하도록 요구합니다. Enum: '구급차, 소방대, 군대, 경찰, 학교 교통, 택시, 쓰레기 관리' . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) +- `vehicleTrackerDevice[string]`: 이 관찰에 해당하는 차량에 장착된 GPS 장치 또는 추적 장치의 설치 상태 . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleType[string]`: 차량의 구조적 특성으로 본 차량의 유형입니다. 이것은 차량 카테고리와 다릅니다. Enum: '농업용차량, 모든차량, 관절차량, 자전거, 쓰레기통, 버스, 자동차, 카라반, 자동차 또는 경차, 카라반을 끄는 자동차, 트레일러를 끄는 자동차, 청소용 수레, 건설 또는 유지 보수 차량, 4륜구동, 높은 측면 차량, 트럭, 미니버스, 모ペ드, 오토바이, 사이드카가 있는 오토바이, 모터스쿠터, 청소기, 탱크로리, 3륜차, 트레일러, 전차, 2륜차, 수레, 밴, 촉매 변환기가 없는 차량, 카라반을 끄는 차량, 트레일러를 끄는 차량, 짝수 번호판이 있는 차량, 홀수 번호판이 있는 차량, 기타'. 다음 값은 _VehicleTypeEnum_ 및 _VehicleTypeEnum2_에 의해 정의되며, [DATEX 2 버전 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) 및 기타 용도로 확장됩니다. . Model: [https://schema.org/Text](https://schema.org/Text) +- `wardId[string]`: 이 관찰에 해당하는 엔티티의 워드 ID . Model: [https://schema.org/Text](https://schema.org/Text) +- `wardName[string]`: 이 관찰에 해당하는 엔티티의 구 이름 . Model: [https://schema.org/Text](https://schema.org/Text) +- `zoneName[string]`: 이 관찰에 해당하는 엔티티의 존 이름 . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +필수 속성 +- `카테고리` +- `id` +- `위치` +- `유형` +- `차량 유형` + + + + + + + + + +## 데이터 모델 속성 설명 + +가나다순으로 정렬 (자세한 정보 클릭) + + + +
full yaml details - ```yaml + +```yaml Vehicle: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -122,14 +217,14 @@ Vehicle: model: https://schema.org/Text type: Property battery: - description: 'The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle' + description: The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle maximum: 1 minimum: 0 type: number x-ngsi: type: Property bearing: - description: "Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position)" + description: Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) type: number x-ngsi: model: https://schema.org/Number @@ -144,7 +239,7 @@ Vehicle: type: Property units: Kilograms category: - description: 'Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:''municipalServices, nonTracked, private, public, specialUsage, tracked''. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...)' + description: Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...) items: enum: - municipalServices @@ -207,7 +302,7 @@ Vehicle: x-ngsi: type: Property deviceBatteryStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''connected, disconnected''' + description: Gives the Battery charging status of the reporting device. Enum:'connected, disconnected' enum: - connected - disconnected @@ -222,7 +317,7 @@ Vehicle: model: https://schema.org/Text type: Property emergencyVehicleType: - description: 'Type of emergency vehicle corresponding to this observation. Enum:''policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck' + description: Type of emergency vehicle corresponding to this observation. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck enum: - policeCar - policeMotorcycle @@ -266,7 +361,7 @@ Vehicle: model: https://schema.org/Text type: Property fuelEfficiency: - description: 'The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L)' + description: The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L) type: number x-ngsi: model: https://schema.org/Number @@ -284,7 +379,7 @@ Vehicle: model: https://schema.org/Text type: Property heading: - description: 'Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1`' + description: Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1` oneOf: - exclusiveMaximum: 360 maximum: 360 @@ -313,7 +408,7 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship ignitionStatus: description: Gives the ignition status of the vehicle. True means ignited type: boolean @@ -328,26 +423,32 @@ Vehicle: model: https://schema.org/URL type: Property license_plate: - description: "Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)'" + description: 'Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)''' type: string x-ngsi: model: https://schema.org/Text type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -362,11 +463,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -374,6 +479,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -388,11 +495,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -402,6 +513,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -416,17 +529,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -441,11 +560,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -455,6 +578,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -474,6 +599,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -485,6 +611,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -499,7 +627,7 @@ Vehicle: x-ngsi: type: GeoProperty mileageFromOdometer: - description: 'The total distance travelled by the particular vehicle since its initial production, as read from its odometer' + description: The total distance travelled by the particular vehicle since its initial production, as read from its odometer type: number x-ngsi: model: https://schema.org/mileageFromOdometer @@ -601,25 +729,31 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property previousLocation: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -634,11 +768,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -646,6 +784,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -660,11 +800,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -674,6 +818,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -688,17 +834,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -713,11 +865,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -727,6 +883,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -746,6 +904,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -757,6 +916,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -820,7 +981,7 @@ Vehicle: model: https://schema.org/Boolean type: Property serviceProvided: - description: 'Service(s) the vehicle is capable of providing or it is assigned to. Enum:''auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning''. Or any other value needed by an specific application' + description: Service(s) the vehicle is capable of providing or it is assigned to. Enum:'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Or any other value needed by an specific application items: enum: - auxiliaryServices @@ -854,12 +1015,12 @@ Vehicle: model: https://schema.org/DateTime 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' + 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 speed: - description: 'Denotes the magnitude of the horizontal component of the vehicle''s current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason' + description: Denotes the magnitude of the horizontal component of the vehicle's current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason oneOf: - minimum: 0 type: number @@ -890,7 +1051,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleConfiguration: - description: 'A short text indicating the configuration of the vehicle, e.g. ''5dr hatchback ST 2.5 MT 225 hp'' or ''limited edition''' + description: A short text indicating the configuration of the vehicle, e.g. '5dr hatchback ST 2.5 MT 225 hp' or 'limited edition' type: string x-ngsi: model: https://schema.org/vehicleConfiguration @@ -908,7 +1069,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleRunningStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''running, waiting, stopped''' + description: Gives the Battery charging status of the reporting device. Enum:'running, waiting, stopped' enum: - running - stopped @@ -918,7 +1079,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleSpecialUsage: - description: 'Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:''ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement''' + description: Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:'ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement' enum: - ambulance - fireBrigade @@ -938,7 +1099,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses' + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses enum: - agriculturalVehicle - ambulance @@ -1027,24 +1188,33 @@ Vehicle: - category - location 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) 2024 Contributors to Smart Data Models Program' + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/Vehicle/schema.json - x-model-tags: 'IUDX, SEDIMARK' + x-model-tags: IUDX, SEDIMARK x-version: 0.2.2 ```
- - - - - ## 페이로드 예시 - #### 차량 NGSI-v2 키 값 예시 - 다음은 키 값으로 JSON-LD 형식의 차량 예시입니다. 이는 `옵션=키값`을 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. + + + + + + + + + +## 예시 페이로드 + +#### 차량 NGSI-v2 키-값 예시 + +여기에는 키-값으로 JSON 형식의 차량 예가 있습니다. 이것은 `options=keyValues`를 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다.
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "vehicleType": "lorry", @@ -1105,11 +1275,15 @@ Vehicle: } ```
- #### 차량 NGSI-v2 정규화 예제 - 다음은 정규화된 JSON-LD 형식의 차량 예시입니다. 이는 옵션을 사용하지 않을 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. + +#### 차량 NGSI-v2 정규화 예시 + +여기에는 JSON 형식으로 정규화된 차량의 예가 있습니다. 옵션을 사용하지 않을 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다.
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "category": { @@ -1281,11 +1455,15 @@ Vehicle: } ```
- #### 차량 NGSI-LD 키 값 예시 - 다음은 키 값으로 JSON-LD 형식의 차량 예시입니다. 이는 `옵션=키값`을 사용할 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. + +#### 차량 NGSI-LD 키-값 예시 + +여기에는 JSON-LD 형식의 키-값으로 된 차량의 예가 있습니다. 이것은 `options=keyValues`를 사용할 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다.
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": "Centro", @@ -1349,11 +1527,15 @@ Vehicle: } ```
- #### 차량 NGSI-LD 정규화 예시 - 다음은 정규화된 JSON-LD 형식의 차량 예시입니다. 이는 옵션을 사용하지 않을 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. + +#### 차량 NGSI-LD 정규화 예시 + +여기에는 JSON-LD 형식으로 정규화된 차량의 예가 있습니다. 이것은 옵션을 사용하지 않을 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다.
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": { @@ -1521,12 +1703,21 @@ Vehicle: ] } ``` -
- - - - 규모 단위를 다루는 방법에 대한 답변은 [FAQ 10](https://smartdatamodels.org/index.php/faqs/)을 참조하세요. - - + + + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + --- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/Vehicle/doc/spec_ZH.md b/Vehicle/doc/spec_ZH.md index f209ffe86..636f55b4a 100644 --- a/Vehicle/doc/spec_ZH.md +++ b/Vehicle/doc/spec_ZH.md @@ -1,88 +1,183 @@ - + + [![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - 实体：车辆 -===== - - [开放许可](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/LICENSE.md) - [文件自动生成](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) - - - 全局描述：**该实体模拟一个特定的车辆模型，包括属于该模型的多个车辆实例所共有的所有属性。 - 版本： 0.2.2 - - - ## 属性列表 +实体: Vehicle +=============== + + + + - [*] 如果属性中没有类型，是因为它可能有多个类型或不同的格式/模式。 -- `address[object]`: 邮寄地址 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国家。例如，西班牙 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 街道地址所在的地点，以及该地点所在的区域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: 地点所在的地区，以及该地区位于哪个国家 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: 地区是一种行政区划，在一些国家由地方政府管理 - - `postOfficeBoxNumber[string]`: 用于邮政信箱地址的邮政信箱号码。例如：03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: 邮政编码。例如：24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: 街道地址 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) - - `streetNr[string]`: 标识公共街道上特定房产的编号 -- `alternateName[string]`: 该项目的替代名称 - `annotations[array]`: 项目说明 . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: 提供服务或提供物品的地理区域 . Model: [https://schema.org/Text](https://schema.org/Text) - `battery[number]`: 电动汽车或与汽车连接的设备当前剩余电池的百分比 - `bearing[number]`: 提供从真北方向顺时针方向测量的车辆 GPS 角度。与 GTFS 实时信息位置（https://developers.google.com/transit/gtfs-realtime/reference#message-position）中的 "方位 "字段相同。 . Model: [https://schema.org/Number](https://schema.org/Number) - `cargoWeight[number]`: 当前车辆货物重量 . Model: [https://schema.org/Number](https://schema.org/Number) - `category[array]`: 从外部角度看的车辆类别。这不同于 "车辆类型 "属性所代表的车辆类型（汽车、货车等）。枚举："市政服务、无轨、私人、公共、特殊用途、有轨"。跟踪车辆是指由远程系统永久跟踪位置的车辆。或应用程序所需的任何其他车辆。它们配有 GPS 接收器和网络连接，可定期更新报告的位置（位置、速度、航向......）。 . Model: [https://schema.org/Text](https://schema.org/Text) - `color[string]`: 产品的颜色 . Model: [https://schema.org/color](https://schema.org/color) - `currentTripCount[number]`: 该观测点对应的车辆在指定运行日的当前行程次数 . Model: [https://schema.org/Number](https://schema.org/Number) - `dataProvider[string]`: 标识统一数据实体提供者的字符序列 - `dateCreated[date-time]`: 实体创建时间戳。通常由存储平台分配 - `dateFirstUsed[date]`: 表示车辆首次使用时间的时间戳 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateModified[date-time]`: 实体最后一次修改的时间戳。通常由存储平台分配 - `dateVehicleFirstRegistered[date]`: 车辆在相关公共机构首次登记的日期 . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) - `description[string]`: 项目描述 - `deviceBatteryStatus[string]`: 报告设备的电池充电状态。枚举："已连接，已断开 . Model: [https://schema.org/Text](https://schema.org/Text) - `deviceSimNumber[string]`: 提供车载设备的 SIM 卡号 . Model: [https://schema.org/Text](https://schema.org/Text) - `emergencyVehicleType[string]`: 与该观测点相对应的应急车辆类型。枚举：'警车、警用摩托车、警用货车、警用搜救车、消防车、供水车、空中救护车、救护车、摩托车救护车、救援车、危险品运输车、拖车 . Model: [https://schema.org/Text](https://schema.org/Text) - `feature[array]`: 车辆集成的功能。枚举：' abs, airbag, alarm, backCamera, disabledRamp, gps, internetConnection, overspeed, proximitySensor, wifi'。或应用程序所需的任何其他内容。为了表示一个功能的多个实例，可以使用以下语法：<特征>,<实例>`。例如，一辆汽车有 4 个安全气囊，可以用 `airbag,4` 表示。 . Model: [https://schema.org/Text](https://schema.org/Text) - `fleetVehicleId[string]`: 车辆在所属车队中的标识符 . Model: [https://schema.org/Text](https://schema.org/Text) - `fuelEfficiency[number]`: 单位燃料的行驶距离，通常以公里/升（km/L）表示 . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelFilled[number]`: 与该观察结果相对应的车辆燃料加注量（升）。 . Model: [https://schema.org/Number](https://schema.org/Number) - `fuelType[string]`: 与该观测结果相对应的适合车辆发动机的燃料类型 . Model: [https://schema.org/Text](https://schema.org/Text) - `heading[*]`: 表示车辆的行驶方向，以十进制度表示，其中 0 <= `heading` < 360，相对于真正的北方顺时针计数。如果车辆静止不动（即 "速度 "属性的值为 "0"），则航向属性的值必须等于"-1"。 . Model: [https://schema.org/Number](https://schema.org/Number) - `id[*]`: 实体的唯一标识符 - `ignitionStatus[boolean]`: 显示车辆的点火状态。真表示已点火 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `image[uri]`: 物品的图片 . Model: [https://schema.org/URL](https://schema.org/URL) - `license_plate[string]`: 提供车辆的车牌号码。与 GTFS 实时信息-车辆描述符（https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor）中的 license_plate 字段相同' . Model: [https://schema.org/Text](https://schema.org/Text) - `location[*]`: 项目的 Geojson 引用。它可以是点、线条字符串、多边形、多点、多线条字符串或多多边形 - `mileageFromOdometer[number]`: 从里程表上读出的特定车辆自首次生产以来的总行驶距离 . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) - `municipalityInfo[object]`: 与该观测结果相对应的城市信息 . Model: [https://schema.org/Text](https://schema.org/Text) - `cityId[string]`: 该观测值对应的城市 ID . Model: [https://schema.org/Text](https://schema.org/Text) - - `cityName[string]`: 该观测值对应的城市名称 . Model: [https://schema.org/Text](https://schema.org/Text) - - `district[string]`: 与该观测结果相对应的地区名称 . Model: [https://schema.org/Text](https://schema.org/Text) - - `stateName[string]`: 该观测值对应的国家名称 . Model: [https://schema.org/Text](https://schema.org/Text) - - `ulbName[string]`: 与该意见相对应的城市地方机构名称 . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardId[string]`: 该观察结果对应的病房编号 . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardName[string]`: 与该观察结果相对应的病房名称 . Model: [https://schema.org/Text](https://schema.org/Text) - - `wardNum[number]`: 与该观察结果相对应的病房号 . Model: [https://schema.org/Number](https://schema.org/Number) - - `zoneId[string]`: 该观测值对应的区域 ID . Model: [https://schema.org/Text](https://schema.org/Text) - - `zoneName[string]`: 该观测值对应的区域名称 . Model: [https://schema.org/Text](https://schema.org/Text) -- `name[string]`: 该项目的名称 - `observationDateTime[date-time]`: 最后报告的观察时间 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `owner[array]`: 包含一个 JSON 编码字符序列的列表，其中引用了所有者的唯一 Ids - `previousLocation[*]`: 项目的 Geojson 引用。它可以是点、线条字符串、多边形、多点、多线条字符串或多多边形 - `purchaseDate[date-time]`: 物品的购买日期，例如车辆由当前所有者购买的日期 . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) - `refVehicleModel[*]`: 对车辆模型的引用 . Model: [https://schema.org/URL](https://schema.org/URL) - `reportId[string]`: 为与该观察结果相对应的问题、报告、反馈或交易分配的唯一 ID . Model: [https://schema.org/Text](https://schema.org/Text) - `seeAlso[*]`: 指向有关该项目的其他资源的 uri 列表 - `serviceOnDuty[boolean]`: 与此观察结果相对应的应急车辆所提供服务的性质。为 "true "表示该观测点对应的应急车辆正在执行/服务于紧急任务，否则为 "false"。 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) - `serviceProvided[array]`: 车辆能够提供或分配的服务。枚举："辅助服务、货物运输、建筑、游乐场、垃圾收集、货物销售、维护、公园和花园、道路信号、特殊运输、街道清洁、街道照明、城市交通、废物容器清洁"。或特定应用所需的任何其他值 . Model: [https://schema.org/Text](https://schema.org/Text) - `serviceStatus[string]`: 车辆状态（从提供服务的角度来看，因此不适用于私家车）。parked"（已停放）： 车辆已停放，目前不提供任何服务。onRoute`：车辆正在执行任务。可以添加逗号分隔的修饰符来表示车辆目前正在执行什么任务。例如，"onRoute,garbageCollection "可用于表示车辆正在执行垃圾收集任务。坏了"：车辆发生临时故障。outOfService"：车辆在路上，但不执行任何任务，可能是去停车区。枚举：'broken、onRoute、outOfService、parked . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `source[string]`: 以 URL 形式给出实体数据原始来源的字符串。建议使用源提供者的完全合格域名或源对象的 URL - `speed[*]`: 表示车辆当前速度水平分量的大小，单位为公里/小时。如果提供，速度属性值必须是非负实数。如果由于某种原因速度暂时未知，可以使用 `-1`。 . Model: [https://schema.org/Number](https://schema.org/Number) - `tripNetWeightCollected[number]`: 该观测点对应的车辆在行程结束时收集的净重量 . Model: [https://schema.org/Number](https://schema.org/Number) - `type[string]`: NGSI 实体类型。必须是车辆 - `vehicleAltitude[string]`: 使用 GPS 提供车辆当前的高度 . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleConfiguration[string]`: 简短文字说明车辆配置，例如 "5dr hatchback ST 2.5 MT 225 hp "或 "限量版"。 . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) - `vehicleIdentificationNumber[string]`: 车辆识别码 (VIN) 是汽车行业用于识别单个机动车的唯一序列号 . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) - `vehiclePlateIdentifier[string]`: 车辆登记牌上显示的用于官方识别的标识或代码。登记标识符为数字或字母数字，在发证机关所在区域内独一无二。规范性参考文件：DATEXII `车辆登记牌照标识符 . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleRunningStatus[string]`: 报告设备的电池充电状态。枚举："运行、等待、停止 . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleSpecialUsage[string]`: 说明车辆是否用于特殊用途，如商业租赁、驾校或出租车。许多国家的法律规定，在出售汽车时必须披露这些信息。枚举：'救护车、消防队、军队、警察、学校交通、出租车、垃圾管理'。 . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) - `vehicleTrackerDevice[string]`: 与此次观测相对应的车辆上安装的 GPS 设备或跟踪设备的安装状态 . Model: [https://schema.org/Text](https://schema.org/Text) - `vehicleType[string]`: 从结构特征的角度来看的车辆类型。这与车辆类别不同。枚举'农用车、任何车辆、铰接式车辆、自行车、垃圾车、公共汽车、轿车、大篷车、轻型车、带大篷车的车、带拖车的车、清洁车、建筑或维护车辆、四轮驱动、高边车、货车、小客车、轻便摩托车、摩托车、摩托车、带侧车的摩托车、摩托艇、扫地机、油罐车、三轮汽车、拖车、电车、两轮汽车、手推车、面包车、无催化转换器的车辆、带大篷车的车辆、带拖车的车辆、带偶数登记牌照的车辆、带奇数登记牌照的车辆、其他"。下列由 _VehicleTypeEnum_ 和 _VehicleTypeEnum2_, [DATEX 2 版本 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) 定义并扩展用于其他用途的值 . Model: [https://schema.org/Text](https://schema.org/Text) - `wardId[string]`: 与该观察结果相对应的实体的 Ward ID . Model: [https://schema.org/Text](https://schema.org/Text) - `wardName[string]`: 与该观测值相对应的实体名称 . Model: [https://schema.org/Text](https://schema.org/Text) - `zoneName[string]`: 与该观测值相对应的实体的区域名称 . Model: [https://schema.org/Text](https://schema.org/Text) - - 所需属性 -- `category` - `id` - `location` - `type` - `vehicleType` - - - - ## 属性的数据模型描述 - 按字母顺序排列（点击查看详情） - - +[开放许可证](https://github.com/smart-data-models//dataModel.Transportation/blob/master/Vehicle/LICENSE.md) + +[自动生成的文档](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) + + + + + +Global description: **该实体模拟一种特定的车辆型号，包括所有属于此型号的多个车辆实例的共同属性。** + +version: 0.2.2 + + + + + + +## 属性列表 + + +[*] 如果一个属性中没有指定类型，那是因为它可能有多种类型或不同的格式/模式 +- `address[object]`: 邮寄地址 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: 该国。例如，西班牙 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 该街道地址所在的地区，以及该地区所在的区域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 该地所在的地区，也是该国所在的地区 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 区是某些国家的一种行政区划，由当地政府管理 + - `postOfficeBoxNumber[string]`: 邮政信箱的邮政信箱号码。例如，03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 邮政编码。例如，24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 街道地址 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 公共街道上特定房产的识别号码 +- `alternateName[string]`: 该物品的另一个名称 +- `annotations[array]`: 关于该项的注释 . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: 提供服务或项目的区域 . Model: [https://schema.org/Text](https://schema.org/Text) +- `battery[number]`: 电动车辆中电池剩余的当前百分比，或连接到车辆的设备 +- `bearing[number]`: 提供以真北为基准，顺时针方向测量的车辆GPS角度。与GTFS实时信息-位置（https://developers.google.com/transit/gtfs-realtime/reference#message-position）中的'bearing'字段相同。 . Model: [https://schema.org/Number](https://schema.org/Number) +- `cargoWeight[number]`: 车辆货物的当前重量 . Model: [https://schema.org/Number](https://schema.org/Number) +- `category[array]`: 从外部视角的车辆类别。这与由 `vehicleType` 属性表示的车辆类型（汽车、卡车等）不同。枚举：'municipalServices, nonTracked, private, public, specialUsage, tracked'。被跟踪的车辆是指其位置由远程系统永久跟踪的车辆。或者任何应用程序需要的其他车辆。它们结合GPS接收器和网络连接，定期更新报告位置（位置、速度、方向...） . Model: [https://schema.org/Text](https://schema.org/Text) +- `color[string]`: 产品的颜色 . Model: [https://schema.org/color](https://schema.org/color) +- `currentTripCount[number]`: 该观察对应的车辆在给定营运日的行程当前计数 . Model: [https://schema.org/Number](https://schema.org/Number) +- `dataProvider[string]`: 识别和谐数据实体提供者的字符序列 +- `dateCreated[date-time]`: 实体创建时间戳。这通常由存储平台分配 +- `dateFirstUsed[date]`: 车辆首次使用的时间戳 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `dateModified[date-time]`: 实体最后修改的时间戳。这通常由存储平台分配 +- `dateVehicleFirstRegistered[date]`: 车辆首次向相关公共机构登记的日期 . Model: [https://schema.org/dateVehicleFirstRegistered](https://schema.org/dateVehicleFirstRegistered) +- `description[string]`: 对此项的描述 +- `deviceBatteryStatus[string]`: 提供报告设备的电池充电状态。枚举：'已连接，已断开' . Model: [https://schema.org/Text](https://schema.org/Text) +- `deviceSimNumber[string]`: 提供车辆内设备的SIM卡号码 . Model: [https://schema.org/Text](https://schema.org/Text) +- `emergencyVehicleType[string]`: 对应此观察的紧急车辆类型。枚举：'警车，警用摩托车，警用面包车，特警队，消防车，水罐车，空中救护车，救护车，摩托车救护车，救援车辆，危险品车，拖车' . Model: [https://schema.org/Text](https://schema.org/Text) +- `feature[array]`: 车辆整合的功能。枚举：' abs, airbag, alarm, backCamera, disabledRamp, gps, internetConnection, overspeed, proximitySensor, wifi'。或者应用程序所需的其他功能。为了表示功能的多个实例，可以使用以下语法： `<功能>,<出现次数>`。例如，一辆车有4个安全气囊，将被表示为 `airbag,4` . Model: [https://schema.org/Text](https://schema.org/Text) +- `fleetVehicleId[string]`: 该车辆在其所属车队中的标识符 . Model: [https://schema.org/Text](https://schema.org/Text) +- `fuelEfficiency[number]`: 每单位燃料消耗所行进的距离，通常用公里每升（公里/升）表示 . Model: [https://schema.org/Number](https://schema.org/Number) +- `fuelFilled[number]`: 本观察对应车辆所加油量（升） . Model: [https://schema.org/Number](https://schema.org/Number) +- `fuelType[string]`: 该观察对应的车辆的发动机或发动机适用的燃料类型 . Model: [https://schema.org/Text](https://schema.org/Text) +- `heading[*]`: 表示车辆的行进方向，以十进制度为单位，范围为0 <= `heading` < 360，相对于真北顺时针计数。如果车辆静止（即`speed`属性的值为`0`），则`heading`属性的值必须等于`-1`。 . Model: [https://schema.org/Number](https://schema.org/Number) +- `id[*]`: 实体的唯一标识符 +- `ignitionStatus[boolean]`: 提供车辆的点火状态。True 表示已点火 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) +- `image[uri]`: 该物品的图像 . Model: [https://schema.org/URL](https://schema.org/URL) +- `license_plate[string]`: 提供车辆的车牌号码。SameAs：GTFS实时信息中VehicleDescriptor（https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor）的license_plate字段。 . Model: [https://schema.org/Text](https://schema.org/Text) +- `location[*]`: GeoJSON指向该项的引用。它可以是Point、LineString、Polygon、MultiPoint、MultiLineString或MultiPolygon +- `mileageFromOdometer[number]`: 该车辆自初始生产以来行驶的总距离，以其里程表读数为准 . Model: [https://schema.org/mileageFromOdometer](https://schema.org/mileageFromOdometer) +- `municipalityInfo[object]`: 与此观察相对应的市政信息 . Model: [https://schema.org/Text](https://schema.org/Text) + - `cityId[string]`: 与此观测相对应的城市ID . Model: [https://schema.org/Text](https://schema.org/Text) + - `cityName[string]`: 与此观测相对应的城市名称 . Model: [https://schema.org/Text](https://schema.org/Text) + - `district[string]`: 与此观测相对应的区名称 . Model: [https://schema.org/Text](https://schema.org/Text) + - `stateName[string]`: 该观察结果对应的州名称 . Model: [https://schema.org/Text](https://schema.org/Text) + - `ulbName[string]`: 与该观察相对应的城市地方机构名称 . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardId[string]`: 与此观察相对应的病房ID . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardName[string]`: 与此观察相对应的病房名称 . Model: [https://schema.org/Text](https://schema.org/Text) + - `wardNum[number]`: 与此观察相对应的病房编号 . Model: [https://schema.org/Number](https://schema.org/Number) + - `zoneId[string]`: 与此观测相对应的区域ID . Model: [https://schema.org/Text](https://schema.org/Text) + - `zoneName[string]`: 对应此观测的区域名称 . Model: [https://schema.org/Text](https://schema.org/Text) +- `name[string]`: 该物品的名称 +- `observationDateTime[date-time]`: 最近报告的观测时间 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `owner[array]`: 包含对所有者唯一Id的JSON编码字符序列的列表 +- `previousLocation[*]`: 对项目的Geojson引用。它可以是点、线字符串、多边形、多点、多线字符串或多多边形 +- `purchaseDate[date-time]`: 该物品（例如车辆）被当前所有者购买的日期 . Model: [https://schema.org/purchaseDate](https://schema.org/purchaseDate) +- `refVehicleModel[*]`: 对VehicleModel的引用 . Model: [https://schema.org/URL](https://schema.org/URL) +- `reportId[string]`: 为此观察对应的问题、报告、反馈或事务分配的唯一ID . Model: [https://schema.org/Text](https://schema.org/Text) +- `seeAlso[*]`: 关于该项目的附加资源的URI列表 +- `serviceOnDuty[boolean]`: 本次观察对应的紧急车辆所提供的服务性质。若紧急车辆对应本次观察正在处理/服务紧急呼叫任务，则为True，否则为False。 . Model: [https://schema.org/Boolean](https://schema.org/Boolean) +- `serviceProvided[array]`: 车辆能够提供的服务或其被分配的服务。枚举：'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'。或者任何特定应用程序所需的其他值。 . Model: [https://schema.org/Text](https://schema.org/Text) +- `serviceStatus[string]`: 车辆状态（从提供的服务角度来看，因此不适用于私人车辆）。 +`停车`：车辆已停车，目前不提供任何服务。 +`行驶中`：车辆正在执行任务。可以添加逗号分隔的修饰符来指示车辆当前正在执行哪个任务。例如，`行驶中，垃圾收集`可以用来表示车辆正在行驶中并执行垃圾收集任务。 +`故障`：车辆正在经历暂时的故障。 +`不提供服务`：车辆在道路上但不执行任何任务，可能正在前往其停车区域。 +枚举：`故障，行驶中，不提供服务，停车` . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `source[string]`: 一个字符序列，给出实体数据的原始来源作为URL。建议为源提供者的全限定域名，或源对象的URL。 +- `speed[*]`: 表示车辆当前速度的水平分量的大小，以公里每小时为单位指定。如果提供，速度属性的值必须是非负实数。 `-1` 可以在速度由于某种原因暂时未知时使用 . Model: [https://schema.org/Number](https://schema.org/Number) +- `tripNetWeightCollected[number]`: 该观察对应的车辆在行程结束时收集的净重量 . Model: [https://schema.org/Number](https://schema.org/Number) +- `type[string]`: NGSI 实体类型。它必须是车辆 +- `vehicleAltitude[string]`: 使用GPS获取车辆的当前海拔高度 . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleConfiguration[string]`: 一段简短的文本，指示车辆的配置，例如“5门掀背车ST 2.5手动变速箱225马力”或“限量版” . Model: [https://schema.org/vehicleConfiguration](https://schema.org/vehicleConfiguration) +- `vehicleIdentificationNumber[string]`: 车辆识别号码（VIN）是汽车行业用来识别个别机动车辆的唯一序列号 . Model: [https://schema.org/vehicleIdentificationNumber](https://schema.org/vehicleIdentificationNumber) +- `vehiclePlateIdentifier[string]`: 用于官方识别目的的车辆注册板上的标识符或代码，附着在车辆上。注册标识符是数字或字母数字的，并且在发行机构的区域内是唯一的。规范性引用：DATEXII `vehicleRegistrationPlateIdentifier` . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleRunningStatus[string]`: 提供报告设备的电池充电状态。枚举：'运行，等待，停止' . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleSpecialUsage[string]`: 指示该车辆是否用于特殊用途，例如商业租赁、驾驶学校或出租车。许多国家的法律要求在出售汽车时披露此信息。枚举：'救护车，消防队，军事，警察，校车，出租车，垃圾管理' . Model: [https://schema.org/vehicleSpecialUsage](https://schema.org/vehicleSpecialUsage) +- `vehicleTrackerDevice[string]`: 该观察对应车辆上GPS设备或跟踪设备的安装状态 . Model: [https://schema.org/Text](https://schema.org/Text) +- `vehicleType[string]`: 从其结构特征的角度来看的车辆类型。这与车辆类别不同。枚举：'农业车辆、任何车辆、半挂车、自行车、手推车、公共汽车、汽车、拖车、汽车或轻型车辆、带拖车的汽车、带拖车的汽车、清洁手推车、建筑或维护车辆、四轮驱动车、高边车、卡车、小型巴士、轻便摩托车、摩托车、带侧车的摩托车、摩托脚踏车、扫街机、油罐车、三轮车、拖车、有轨电车、两轮车、手推车、货车、无催化转换器的车辆、带拖车的车辆、带拖车的车辆、带有偶数注册牌的车辆、带有奇数注册牌的车辆、其他'。以下值由_VehicleTypeEnum_和_VehicleTypeEnum2_定义，[DATEX 2版本2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)并为其他用途扩展。 . Model: [https://schema.org/Text](https://schema.org/Text) +- `wardId[string]`: 与此观察相对应的实体的区域编号 . Model: [https://schema.org/Text](https://schema.org/Text) +- `wardName[string]`: 该观察对应的实体的行政区划名称 . Model: [https://schema.org/Text](https://schema.org/Text) +- `zoneName[string]`: 该观测对应实体的区域名称 . Model: [https://schema.org/Text](https://schema.org/Text) + + + + + +必需属性 +- `类别` +- `id` +- `位置` +- `类型` +- `车辆类型` + + + + + + + + + +## 数据模型属性描述 + +按字母顺序排序（点击查看详情） + + + +
full yaml details - ```yaml + +```yaml Vehicle: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -122,14 +217,14 @@ Vehicle: model: https://schema.org/Text type: Property battery: - description: 'The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle' + description: The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle maximum: 1 minimum: 0 type: number x-ngsi: type: Property bearing: - description: "Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position)" + description: Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) type: number x-ngsi: model: https://schema.org/Number @@ -144,7 +239,7 @@ Vehicle: type: Property units: Kilograms category: - description: 'Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:''municipalServices, nonTracked, private, public, specialUsage, tracked''. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...)' + description: Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...) items: enum: - municipalServices @@ -207,7 +302,7 @@ Vehicle: x-ngsi: type: Property deviceBatteryStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''connected, disconnected''' + description: Gives the Battery charging status of the reporting device. Enum:'connected, disconnected' enum: - connected - disconnected @@ -222,7 +317,7 @@ Vehicle: model: https://schema.org/Text type: Property emergencyVehicleType: - description: 'Type of emergency vehicle corresponding to this observation. Enum:''policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck' + description: Type of emergency vehicle corresponding to this observation. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck enum: - policeCar - policeMotorcycle @@ -266,7 +361,7 @@ Vehicle: model: https://schema.org/Text type: Property fuelEfficiency: - description: 'The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L)' + description: The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L) type: number x-ngsi: model: https://schema.org/Number @@ -284,7 +379,7 @@ Vehicle: model: https://schema.org/Text type: Property heading: - description: 'Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1`' + description: Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1` oneOf: - exclusiveMaximum: 360 maximum: 360 @@ -313,7 +408,7 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship ignitionStatus: description: Gives the ignition status of the vehicle. True means ignited type: boolean @@ -328,26 +423,32 @@ Vehicle: model: https://schema.org/URL type: Property license_plate: - description: "Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)'" + description: 'Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)''' type: string x-ngsi: model: https://schema.org/Text type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -362,11 +463,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -374,6 +479,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -388,11 +495,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -402,6 +513,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -416,17 +529,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -441,11 +560,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -455,6 +578,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -474,6 +599,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -485,6 +611,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -499,7 +627,7 @@ Vehicle: x-ngsi: type: GeoProperty mileageFromOdometer: - description: 'The total distance travelled by the particular vehicle since its initial production, as read from its odometer' + description: The total distance travelled by the particular vehicle since its initial production, as read from its odometer type: number x-ngsi: model: https://schema.org/mileageFromOdometer @@ -601,25 +729,31 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property previousLocation: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -634,11 +768,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -646,6 +784,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -660,11 +800,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -674,6 +818,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -688,17 +834,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -713,11 +865,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -727,6 +883,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -746,6 +904,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -757,6 +916,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -820,7 +981,7 @@ Vehicle: model: https://schema.org/Boolean type: Property serviceProvided: - description: 'Service(s) the vehicle is capable of providing or it is assigned to. Enum:''auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning''. Or any other value needed by an specific application' + description: Service(s) the vehicle is capable of providing or it is assigned to. Enum:'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Or any other value needed by an specific application items: enum: - auxiliaryServices @@ -854,12 +1015,12 @@ Vehicle: model: https://schema.org/DateTime 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' + 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 speed: - description: 'Denotes the magnitude of the horizontal component of the vehicle''s current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason' + description: Denotes the magnitude of the horizontal component of the vehicle's current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason oneOf: - minimum: 0 type: number @@ -890,7 +1051,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleConfiguration: - description: 'A short text indicating the configuration of the vehicle, e.g. ''5dr hatchback ST 2.5 MT 225 hp'' or ''limited edition''' + description: A short text indicating the configuration of the vehicle, e.g. '5dr hatchback ST 2.5 MT 225 hp' or 'limited edition' type: string x-ngsi: model: https://schema.org/vehicleConfiguration @@ -908,7 +1069,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleRunningStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''running, waiting, stopped''' + description: Gives the Battery charging status of the reporting device. Enum:'running, waiting, stopped' enum: - running - stopped @@ -918,7 +1079,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleSpecialUsage: - description: 'Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:''ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement''' + description: Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:'ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement' enum: - ambulance - fireBrigade @@ -938,7 +1099,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses' + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses enum: - agriculturalVehicle - ambulance @@ -1027,24 +1188,33 @@ Vehicle: - category - location 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) 2024 Contributors to Smart Data Models Program' + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/Vehicle/schema.json - x-model-tags: 'IUDX, SEDIMARK' + x-model-tags: IUDX, SEDIMARK x-version: 0.2.2 ```
- - - - - ## 有效载荷示例 - #### 车辆 NGSI-v2 键值示例 - 下面是一个以 JSON-LD 格式作为键值的车辆示例。当使用 `options=keyValues` 时，这与 NGSI-v2 兼容，并返回单个实体的上下文数据。 + + + + + + + + + +## 示例有效载荷 + +#### 车辆NGSI-v2键值示例 + +这是JSON格式的车辆示例，以键值对的形式呈现。当使用`options=keyValues`时，这与NGSI-v2兼容，并返回个体实体的上下文数据。
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "vehicleType": "lorry", @@ -1105,11 +1275,15 @@ Vehicle: } ```
- #### 车辆 NGSI-v2 标准化示例 - 下面是一个以 JSON-LD 格式规范化的车辆示例。在不使用选项的情况下，它与 NGSI-v2 兼容，并返回单个实体的上下文数据。 + +#### 车辆NGSI-v2标准化示例 + +这是一个以JSON格式标准化的车辆示例。当不使用选项时，它与NGSI-v2兼容，并返回单个实体的上下文数据。
show/hide example - ```json - { + +```json + +{ "id": "vehicle:WasteManagement:1", "type": "Vehicle", "category": { @@ -1281,11 +1455,15 @@ Vehicle: } ```
- #### 车辆 NGSI-LD 键值示例 - 下面是一个以 JSON-LD 格式作为键值的车辆示例。当使用 `options=keyValues` 时，它与 NGSI-LD 兼容，并返回单个实体的上下文数据。 + +#### 车辆NGSI-LD键值示例 + +这是一个JSON-LD格式的车辆示例，以键值对的形式呈现。当使用`options=keyValues`时，它与NGSI-LD兼容，并返回个体实体的上下文数据。
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": "Centro", @@ -1349,11 +1527,15 @@ Vehicle: } ```
- #### 车辆 NGSI-LD 标准化示例 - 下面是一个以 JSON-LD 格式规范化的车辆示例。在不使用选项时，它与 NGSI-LD 兼容，并返回单个实体的上下文数据。 + +#### 车辆NGSI-LD标准化示例 + +这是一个以JSON-LD格式标准化的车辆示例。当不使用选项时，它与NGSI-LD兼容，并返回个体实体的上下文数据。
show/hide example - ```json - { + +```json + +{ "id": "urn:ngsi-ld:Vehicle:vehicle:WasteManagement:1", "type": "Vehicle", "areaServed": { @@ -1521,12 +1703,21 @@ Vehicle: ] } ``` -
- - - - 请参阅 [FAQ 10](https://smartdatamodels.org/index.php/faqs/)，获取如何处理幅度单位的答案。 - - + + + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + --- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/Vehicle/examples/example-normalized.json b/Vehicle/examples/example-normalized.json index cd6fe9364..50d0e588f 100644 --- a/Vehicle/examples/example-normalized.json +++ b/Vehicle/examples/example-normalized.json @@ -166,5 +166,18 @@ "zoneId": "2", "wardNum": 4 } + }, + "leasingInfo": { + "type": "StructuredValue", + "value": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" + } } } \ No newline at end of file diff --git a/Vehicle/examples/example-normalized.jsonld b/Vehicle/examples/example-normalized.jsonld index 9090d95b9..00fd97634 100644 --- a/Vehicle/examples/example-normalized.jsonld +++ b/Vehicle/examples/example-normalized.jsonld @@ -160,6 +160,19 @@ "zoneName": { "type": "Property", "value": "South Zone" + }, + "leasingInfo": { + "type": "Property", + "value": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" + } }, "@context": [ "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" diff --git a/Vehicle/examples/example.json b/Vehicle/examples/example.json index ad66b5453..8ce9cdace 100644 --- a/Vehicle/examples/example.json +++ b/Vehicle/examples/example.json @@ -55,5 +55,15 @@ "wardName": "Bangalore Urban", "zoneId": "2", "wardNum": 4 + }, + "leasingInfo": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" } } \ No newline at end of file diff --git a/Vehicle/examples/example.jsonld b/Vehicle/examples/example.jsonld index 7751d9c31..22d2131fa 100644 --- a/Vehicle/examples/example.jsonld +++ b/Vehicle/examples/example.jsonld @@ -56,6 +56,16 @@ "wardId": "4", "wardName": "Kempegowda Ward", "zoneName": "South Zone", + "leasingInfo": { + "leasingType": "Operating Lease", + "leasingStartDate": "2025-06-01T00:00:00.000Z", + "leasingEndDate": "2029-06-01T00:00:00.000Z", + "monthlyLeaseCost": 525, + "allowedAnnualDistance": 20000, + "allowedDistanceUnit": "kilometer", + "excessDistanceCost": 1, + "leasingProvider": "Municipality Leasing A/S" + }, "@context": [ "https://smart-data-models.github.io/dataModel.Transportation/context.jsonld" ] diff --git a/Vehicle/model.yaml b/Vehicle/model.yaml index 894088588..874112e5c 100644 --- a/Vehicle/model.yaml +++ b/Vehicle/model.yaml @@ -1,40 +1,40 @@ Vehicle: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -74,14 +74,14 @@ Vehicle: model: https://schema.org/Text type: Property battery: - description: 'The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle' + description: The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle maximum: 1 minimum: 0 type: number x-ngsi: type: Property bearing: - description: "Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position)" + description: Gives the vehicle GPS angle measured in a clockwise direction from the True North. SameAs 'bearing' field from GTFS Realtime message-Position(https://developers.google.com/transit/gtfs-realtime/reference#message-position) type: number x-ngsi: model: https://schema.org/Number @@ -96,7 +96,7 @@ Vehicle: type: Property units: Kilograms category: - description: 'Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:''municipalServices, nonTracked, private, public, specialUsage, tracked''. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...)' + description: Vehicle category(ies) from an external point of view. This is different than the vehicle type (car, lorry, etc.) represented by the `vehicleType` property. Enum:'municipalServices, nonTracked, private, public, specialUsage, tracked'. Tracked vehicles are those vehicles which position is permanently tracked by a remote system. Or any other needed by an application They incorporate a GPS receiver together with a network connection to periodically update a reported position (location, speed, heading ...) items: enum: - municipalServices @@ -159,7 +159,7 @@ Vehicle: x-ngsi: type: Property deviceBatteryStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''connected, disconnected''' + description: Gives the Battery charging status of the reporting device. Enum:'connected, disconnected' enum: - connected - disconnected @@ -174,7 +174,7 @@ Vehicle: model: https://schema.org/Text type: Property emergencyVehicleType: - description: 'Type of emergency vehicle corresponding to this observation. Enum:''policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck' + description: Type of emergency vehicle corresponding to this observation. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck enum: - policeCar - policeMotorcycle @@ -218,7 +218,7 @@ Vehicle: model: https://schema.org/Text type: Property fuelEfficiency: - description: 'The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L)' + description: The distance traveled per unit of fuel used, commonly in kilometers per liter (km/L) type: number x-ngsi: model: https://schema.org/Number @@ -236,7 +236,7 @@ Vehicle: model: https://schema.org/Text type: Property heading: - description: 'Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1`' + description: Denotes the direction of travel of the vehicle and is specified in decimal degrees, where 0 <= `heading` < 360, counting clockwise relative to the true north. If the vehicle is stationary (i.e. the value of the `speed` attribute is `0`), then the value of the heading attribute must be equal to `-1` oneOf: - exclusiveMaximum: 360 maximum: 360 @@ -265,7 +265,7 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship ignitionStatus: description: Gives the ignition status of the vehicle. True means ignited type: boolean @@ -280,26 +280,32 @@ Vehicle: model: https://schema.org/URL type: Property license_plate: - description: "Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)'" + description: 'Gives the License Plate number of the vehicle. SameAs: license_plate field from GTFS Realtime message-VehicleDescriptor (https://developers.google.com/transit/gtfs-realtime/reference#message-vehicledescriptor)''' type: string x-ngsi: model: https://schema.org/Text type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -314,11 +320,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -326,6 +336,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -340,11 +352,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -354,6 +370,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -368,17 +386,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -393,11 +417,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -407,6 +435,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -426,6 +456,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -437,6 +468,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -451,7 +484,7 @@ Vehicle: x-ngsi: type: GeoProperty mileageFromOdometer: - description: 'The total distance travelled by the particular vehicle since its initial production, as read from its odometer' + description: The total distance travelled by the particular vehicle since its initial production, as read from its odometer type: number x-ngsi: model: https://schema.org/mileageFromOdometer @@ -553,25 +586,31 @@ Vehicle: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property previousLocation: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -586,11 +625,15 @@ Vehicle: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -598,6 +641,8 @@ Vehicle: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -612,11 +657,15 @@ Vehicle: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -626,6 +675,8 @@ Vehicle: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -640,17 +691,23 @@ Vehicle: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -665,11 +722,15 @@ Vehicle: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -679,6 +740,8 @@ Vehicle: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -698,6 +761,7 @@ Vehicle: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -709,6 +773,8 @@ Vehicle: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -772,7 +838,7 @@ Vehicle: model: https://schema.org/Boolean type: Property serviceProvided: - description: 'Service(s) the vehicle is capable of providing or it is assigned to. Enum:''auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning''. Or any other value needed by an specific application' + description: Service(s) the vehicle is capable of providing or it is assigned to. Enum:'auxiliaryServices, cargoTransport, construction, fairground, garbageCollection, goodsSelling, maintenance, parksAndGardens, roadSignalling, specialTransport, streetCleaning, streetLighting, urbanTransit, wasteContainerCleaning'. Or any other value needed by an specific application items: enum: - auxiliaryServices @@ -806,12 +872,12 @@ Vehicle: model: https://schema.org/DateTime 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' + 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 speed: - description: 'Denotes the magnitude of the horizontal component of the vehicle''s current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason' + description: Denotes the magnitude of the horizontal component of the vehicle's current velocity and is specified in Kilometers per Hour. If provided, the value of the speed attribute must be a non-negative real number. `-1` MAY be used if speed is transiently unknown for some reason oneOf: - minimum: 0 type: number @@ -842,7 +908,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleConfiguration: - description: 'A short text indicating the configuration of the vehicle, e.g. ''5dr hatchback ST 2.5 MT 225 hp'' or ''limited edition''' + description: A short text indicating the configuration of the vehicle, e.g. '5dr hatchback ST 2.5 MT 225 hp' or 'limited edition' type: string x-ngsi: model: https://schema.org/vehicleConfiguration @@ -860,7 +926,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleRunningStatus: - description: 'Gives the Battery charging status of the reporting device. Enum:''running, waiting, stopped''' + description: Gives the Battery charging status of the reporting device. Enum:'running, waiting, stopped' enum: - running - stopped @@ -870,7 +936,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleSpecialUsage: - description: 'Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:''ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement''' + description: Indicates whether the vehicle is been used for special purposes, like commercial rental, driving school, or as a taxi. The legislation in many countries requires this information to be revealed when offering a car for sale. Enum:'ambulance, fireBrigade, military, police, schoolTransportation, taxi, trashManagement' enum: - ambulance - fireBrigade @@ -890,7 +956,7 @@ Vehicle: model: https://schema.org/Text type: Property vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses' + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) and extended for other uses enum: - agriculturalVehicle - ambulance @@ -979,9 +1045,9 @@ Vehicle: - category - location 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) 2024 Contributors to Smart Data Models Program' + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/Vehicle/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/Vehicle/schema.json - x-model-tags: 'IUDX, SEDIMARK' - x-version: 0.2.2 + x-model-tags: IUDX, SEDIMARK + x-version: 0.2.2 \ No newline at end of file diff --git a/Vehicle/schema.json b/Vehicle/schema.json index e89c192fb..84bae9a1e 100644 --- a/Vehicle/schema.json +++ b/Vehicle/schema.json @@ -1,6 +1,6 @@ { "$schema": "https://json-schema.org/draft/2020-12/schema", - "$schemaVersion": "0.2.2", + "$schemaVersion": "0.2.4", "modelTags": "IUDX, SEDIMARK", "$id": "https://smart-data-models.github.io/dataModel.Transportation/Vehicle/schema.json", "title": "Smart Data Models - Vehicle", @@ -36,7 +36,7 @@ "autorickshaw", "bicycle", "binTrolley", - "BRT mini bus\u00b7", + "BRT mini bus", "BRT bus", "bus", "car", @@ -107,7 +107,8 @@ "public", "specialUsage", "tracked" - ] + ], + "description": "Property. Individual category items included for the vehicle" } }, "previousLocation": { @@ -201,7 +202,8 @@ "overspeed", "proximitySensor", "wifi" - ] + ], + "description": "Property. Each of the features of the vehicle" } }, "serviceProvided": { @@ -355,7 +357,7 @@ }, "emergencyVehicleType": { "type": "string", - "description": "Property. Model:'https://schema.org/Text'. Type of emergency vehicle corresponding to this observation. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck", + "description": "Property. Model:'https://schema.org/Text'. Type of emergency vehicle corresponding to this observation. Enum:'policeCar, policeMotorcycle, policeVan, policeSWAT, fireEngine, waterTender, airAmbulance, ambulance, motorcycleAmbulance, rescueVehicle, hazardousMaterialsApparatus, towTruck'pip ins", "enum": [ "policeCar", "policeMotorcycle", @@ -373,7 +375,7 @@ }, "municipalityInfo": { "type": "object", - "description": "Property. Model:'https://schema.org/Text. Municipality information corresponding to this observation", + "description": "Property. Model:'https://schema.org/Text'. Municipality information corresponding to this observation", "properties": { "district": { "type": "string", @@ -416,6 +418,53 @@ "description": "Property. Model:'https://schema.org/Number'. Ward number corresponding to this observation" } } + }, + "leasingInfo": { + "type": "object", + "description": "Property. Leasing contract information for the vehicle.", + "properties": { + "leasingType": { + "type": "string", + "description": "Property. Type of leasing contract" + }, + "leasingStartDate": { + "type": "string", + "format": "date-time", + "description": "Property. Model:'https://schema.org/DateTime'. Start date of the leasing contract" + }, + "leasingEndDate": { + "type": "string", + "format": "date-time", + "description": "Property. Model:'https://schema.org/DateTime'. End date of the leasing contract" + }, + "monthlyLeaseCost": { + "type": "number", + "minimum": 0, + "description": "Property. Fixed monthly lease payment amount in the contract currency" + }, + "allowedAnnualDistance": { + "type": "number", + "minimum": 0, + "description": "Property. Maximum allowed annual distance according to lease contract" + }, + "allowedDistanceUnit": { + "type": "string", + "enum": [ + "kilometer", + "mile" + ], + "description": "Property. Unit for distance measurements in the lease contract" + }, + "excessDistanceCost": { + "type": "number", + "minimum": 0, + "description": "Property. Cost per unit distance for exceeding the allowed annual distance" + }, + "leasingProvider": { + "type": "string", + "description": "Property. Name or identifier of the leasing company" + } + } } } } diff --git a/Vehicle/schema.sql b/Vehicle/schema.sql index b2a3413ea..c91753a75 100644 --- a/Vehicle/schema.sql +++ b/Vehicle/schema.sql @@ -1,3 +1,69 @@ -/* (Beta) Export of data model Vehicle of the subject dataModel.Transportation for a PostgreSQL database. Pending translation of enumerations and multityped attributes */ -CREATE TYPE deviceBatteryStatus_type AS ENUM ('connected','disconnected');CREATE TYPE emergencyVehicleType_type AS ENUM ('policeCar','policeMotorcycle','policeVan','policeSWAT','fireEngine','waterTender','airAmbulance','ambulance','motorcycleAmbulance','rescueVehicle','hazardousMaterialsApparatus','towTruck');CREATE TYPE serviceStatus_type AS ENUM ('broken','onRoute','outOfService','parked');CREATE TYPE Vehicle_type AS ENUM ('Vehicle');CREATE TYPE vehicleRunningStatus_type AS ENUM ('running','stopped','waiting');CREATE TYPE vehicleSpecialUsage_type AS ENUM ('ambulance','fireBrigade','military','police','schoolTransportation','taxi','trashManagement');CREATE TYPE vehicleType_type AS ENUM ('agriculturalVehicle','ambulance','anyVehicle','articulatedVehicle','autorickshaw','bicycle','binTrolley','BRT mini bus·','BRT bus','bus','car','caravan','carOrLightVehicle','carWithCaravan','carWithTrailer','cleaningTrolley','compactor','constructionOrMaintenanceVehicle','dumper','e-bike','e-moped','e-scooter','e-motorcycle','fireTender','fourWheelDrive','highSidedVehicle','hopper','lorry','minibus','moped','motorcycle','motorcycleWithSideCar','motorscooter','policeVan','publicMotor','sweepingMachine','tanker','tempo','threeWheeledVehicle','tipper','trailer','tram','trolley','twoWheeledVehicle','van','vehicleWithoutCatalyticConverter','vehicleWithCaravan','vehicleWithTrailer','withEvenNumberedRegistrationPlates','withOddNumberedRegistrationPlates','pilotVessel','passengerVessel','cargoVessel','tug','militaryVessel','sailingVessel','vessel','other'); -CREATE TABLE Vehicle (address JSON, alternateName TEXT, annotations JSON, areaServed TEXT, battery NUMERIC, bearing NUMERIC, cargoWeight NUMERIC, category JSON, color TEXT, currentTripCount NUMERIC, dataProvider TEXT, dateCreated TIMESTAMP, dateFirstUsed DATE, dateModified TIMESTAMP, dateVehicleFirstRegistered DATE, description TEXT, deviceBatteryStatus deviceBatteryStatus_type, deviceSimNumber TEXT, emergencyVehicleType emergencyVehicleType_type, feature JSON, fleetVehicleId TEXT, fuelEfficiency NUMERIC, fuelFilled NUMERIC, fuelType TEXT, heading JSON, id TEXT PRIMARY KEY, ignitionStatus BOOLEAN, image TEXT, license_plate TEXT, location JSON, mileageFromOdometer NUMERIC, municipalityInfo JSON, name TEXT, observationDateTime TIMESTAMP, owner JSON, previousLocation JSON, purchaseDate TIMESTAMP, reportId TEXT, seeAlso JSON, serviceOnDuty BOOLEAN, serviceProvided JSON, serviceStatus serviceStatus_type, source TEXT, speed JSON, tripNetWeightCollected NUMERIC, type Vehicle_type, vehicleAltitude TEXT, vehicleConfiguration TEXT, vehicleIdentificationNumber TEXT, vehiclePlateIdentifier TEXT, vehicleRunningStatus vehicleRunningStatus_type, vehicleSpecialUsage vehicleSpecialUsage_type, vehicleTrackerDevice TEXT, vehicleType vehicleType_type, wardId TEXT, wardName TEXT, zoneName TEXT); \ No newline at end of file +/* (Beta) Export of data model Vehicle of the subject dataModel.Transportation +for a PostgreSQL database. Pending translation of enumerations and multityped attributes */ +CREATE TYPE deviceBatteryStatus_type AS ENUM ('connected', 'disconnected'); +CREATE TYPE emergencyVehicleType_type AS ENUM ('policeCar', 'policeMotorcycle', 'policeVan', 'policeSWAT', 'fireEngine', 'waterTender', 'airAmbulance', 'ambulance', 'motorcycleAmbulance', 'rescueVehicle', 'hazardousMaterialsApparatus', 'towTruck'); +CREATE TYPE serviceStatus_type AS ENUM ('broken', 'onRoute', 'outOfService', 'parked'); +CREATE TYPE Vehicle_type AS ENUM ('Vehicle'); +CREATE TYPE vehicleRunningStatus_type AS ENUM ('running', 'stopped', 'waiting'); +CREATE TYPE vehicleSpecialUsage_type AS ENUM ('ambulance', 'fireBrigade', 'military', 'police', 'schoolTransportation', 'taxi', 'trashManagement'); +CREATE TYPE vehicleType_type AS ENUM ('agriculturalVehicle', 'ambulance', 'anyVehicle', 'articulatedVehicle', 'autorickshaw', 'bicycle', 'binTrolley', 'BRT mini bus·', 'BRT bus', 'bus', 'car', 'caravan', 'carOrLightVehicle', 'carWithCaravan', 'carWithTrailer', 'cleaningTrolley', 'compactor', 'constructionOrMaintenanceVehicle', 'dumper', 'e-bike', 'e-moped', 'e-scooter', 'e-motorcycle', 'fireTender', 'fourWheelDrive', 'highSidedVehicle', 'hopper', 'lorry', 'minibus', 'moped', 'motorcycle', 'motorcycleWithSideCar', 'motorscooter', 'policeVan', 'publicMotor', 'sweepingMachine', 'tanker', 'tempo', 'threeWheeledVehicle', 'tipper', 'trailer', 'tram', 'trolley', 'twoWheeledVehicle', 'van', 'vehicleWithoutCatalyticConverter', 'vehicleWithCaravan', 'vehicleWithTrailer', 'withEvenNumberedRegistrationPlates', 'withOddNumberedRegistrationPlates', 'pilotVessel', 'passengerVessel', 'cargoVessel', 'tug', 'militaryVessel', 'sailingVessel', 'vessel', 'other'); + +CREATE TABLE Vehicle ( + address JSON, + alternateName TEXT, + annotations JSON, + areaServed TEXT, + battery NUMERIC, + bearing NUMERIC, + cargoWeight NUMERIC, + category JSON, + color TEXT, + currentTripCount NUMERIC, + dataProvider TEXT, + dateCreated TIMESTAMP, + dateFirstUsed DATE, + dateModified TIMESTAMP, + dateVehicleFirstRegistered DATE, + description TEXT, + deviceBatteryStatus deviceBatteryStatus_type, + deviceSimNumber TEXT, + emergencyVehicleType emergencyVehicleType_type, + feature JSON, + fleetVehicleId TEXT, + fuelEfficiency NUMERIC, + fuelFilled NUMERIC, + fuelType TEXT, + heading JSON, + id TEXT PRIMARY KEY, + ignitionStatus BOOLEAN, + image TEXT, + license_plate TEXT, + location JSON, + mileageFromOdometer NUMERIC, + municipalityInfo JSON, + name TEXT, + observationDateTime TIMESTAMP, + owner JSON, + previousLocation JSON, + purchaseDate TIMESTAMP, + reportId TEXT, + seeAlso JSON, + serviceOnDuty BOOLEAN, + serviceProvided JSON, + serviceStatus serviceStatus_type, + source TEXT, + speed JSON, + tripNetWeightCollected NUMERIC, + type Vehicle_type, + vehicleAltitude TEXT, + vehicleConfiguration TEXT, + vehicleIdentificationNumber TEXT, + vehiclePlateIdentifier TEXT, + vehicleRunningStatus vehicleRunningStatus_type, + vehicleSpecialUsage vehicleSpecialUsage_type, + vehicleTrackerDevice TEXT, + vehicleType vehicleType_type, + wardId TEXT, + wardName TEXT, + zoneName TEXT +); \ No newline at end of file diff --git a/Vehicle/swagger.yaml b/Vehicle/swagger.yaml index b96b1827d..2d0bb65e1 100644 --- a/Vehicle/swagger.yaml +++ b/Vehicle/swagger.yaml @@ -1,14 +1,14 @@ --- # Copyleft (c) 2022 Contributors to Smart Data Models initiative -# +# components: - schemas: - Vehicle: - $ref: "https://smart-data-models.github.io/dataModel.Transportation/Vehicle/model.yaml#/Vehicle" + schemas: + Vehicle: + $ref: "https://smart-data-models.github.io/dataModel.Transportation/Vehicle/model.yaml#Vehicle" info: - description: | + description: | This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. title: Vehicle version: "0.2.2" @@ -49,4 +49,4 @@ paths: tags: - description: "NGSI-LD Linked-data Format" - name: ngsi-ld + name: ngsi-ld \ No newline at end of file diff --git a/VehicleModel/README.md b/VehicleModel/README.md index 50b8bb9dd..bd28c6158 100644 --- a/VehicleModel/README.md +++ b/VehicleModel/README.md @@ -1,10 +1,11 @@ [![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - # VehicleModel -Version: 0.0.1 +# VehicleModel +Version: 0.0.2 -## Description +## Description This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. + ### Specification Link to the [interactive specification](https://swagger.lab.fiware.org/?url=https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/swagger.yaml) @@ -24,6 +25,7 @@ Link alla [specifica](https://github.com/smart-data-models/dataModel.Transportat [链接到规范](https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/doc/spec_ZH.md) [사양 링크](https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/doc/spec_KO.md) + ### Examples Link to the [example](https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/examples/example.json) (keyvalues) for NGSI v2 @@ -41,6 +43,7 @@ Link to the [example](https://github.com/smart-data-models/dataModel.Transportat Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/examples/example-normalized.json.csv) (normalized) for NGSI-V2 in CSV format Link to the [example](https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/examples/example-normalized.jsonld.csv) (normalized) for NGSI-LD in CSV format + ### Dynamic Examples generation Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/VehicleModel/schema.json&email=info@smartdatamodels.org) of NGSI-LD normalized payloads compliant with this data model. Refresh for new values @@ -48,13 +51,15 @@ Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator.php? Link to the [Generator](https://smartdatamodels.org/extra/ngsi-ld_generator_keyvalues.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/VehicleModel/schema.json&email=info@smartdatamodels.org) of NGSI-LD keyvalues payloads compliant with this data model. Refresh for new values Link to the [Generator](https://smartdatamodels.org/extra/geojson_features_generator.php?schemaUrl=https://raw.githubusercontent.com/smart-data-models/dataModel.Transportation/master/VehicleModel/schema.json&email=info@smartdatamodels.org) of geojson feature format payloads compliant with this data model. Refresh for new values + ### PostgreSQL schema Link to the [PostgreSQL schema](https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/schema.sql) of this data model + ### Contribution - If you have any issue on this data model you can raise an [issue](https://github.com/smart-data-models/dataModel.Transportation/issues) or contribute with a [PR](https://github.com/smart-data-models/dataModel.Transportation/pulls) + If you have any issue on this data model you can raise an [issue](https://github.com/smart-data-models/dataModel.Transportation/issues) or contribute with a [PR](https://github.com/smart-data-models/dataModel.Transportation/pulls) - If you wish to develop your own data model you can start from [contribution manual](https://bit.ly/contribution_manual). Several services have been developed to help with: + If you wish to develop your own data model you can start from [contribution manual](https://bit.ly/contribution_manual). Several services have been developed to help with: - [Test data model repository](https://smartdatamodels.org/index.php/data-models-contribution-api/) including the schema and example payloads, etc - [Generate PostgreSQL schema](https://smartdatamodels.org/index.php/sql-service/) to help create a table, create type, etc \ No newline at end of file diff --git a/VehicleModel/code/code_for_using_dataModel.Transportation_VehicleModel.py b/VehicleModel/code/code_for_using_dataModel.Transportation_VehicleModel.py index eb9c498f1..159f69be2 100644 --- a/VehicleModel/code/code_for_using_dataModel.Transportation_VehicleModel.py +++ b/VehicleModel/code/code_for_using_dataModel.Transportation_VehicleModel.py @@ -1,9 +1,33 @@ -# # The code for installing different versions of context brokers are located after the code +# # This code allows you to install a orion-ld broker in a linux system +# # The manuals are here https://github.com/FIWARE/context.Orion-LD/tree/develop/doc/manuals-ld +# +# # INSTALL NGSI LD broker (OrionLD) +# sudo docker pull mongo:3.6 +# sudo docker pull fiware/orion-ld +# sudo docker network create fiware_default +# sudo docker run -d --name=mongo-db --network=fiware_default --expose=27017 mongo:3.6 --bind_ip_all --smallfiles +# sudo docker run -d --name fiware-orionld -h orion --network=fiware_default -p 1026:1026 fiware/orion-ld -dbhost mongo-db +# +# # TO RELAUNCH (only if you have already installed a broker in the same machine) +# sudo docker stop fiware-orionld +# sudo docker rm fiware-orionld +# sudo docker stop mongo-db +# sudo docker rm mongo-db +# sudo docker network rm fiware_default +# +# # CHECK INSTANCES +# # Check the broker is running +# curl -X GET 'http://localhost:1026/version' +# +# # Check what entities are in the broker +# curl -X GET http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000 +# +# # now the python code you can use to insert some value in the context broker according to the data model # from pysmartdatamodels import pysmartdatamodels as sdm import subprocess -serverUrl = "http://localhost:1026" # supposed that your broker is installed in localhost with 1026 as default port. Edit to match your configuration +serverUrl = "http://localhost:1026" # supposed that your broker is installed in localhost. Edit to match your configuration dataModel = "VehicleModel" subject = "dataModel.Transportation" brandName = "Mercedes Benz" @@ -30,84 +54,8 @@ # The next line creates the query for inserting this attribute in a NGSI-LD context broker if the attribute does not exist it creates it print(sdm.update_broker(dataModel, subject, attribute, value, serverUrl=serverUrl, updateThenCreate=True)) -print(" In case you have installed the a cntext broker (see comments below )") +print(" In case you have installed the orion-ld broker (see comments on the header of this program)") print(" Execute this instruction to check that the entities has been inserted") command = ['curl', '-X', 'GET', 'http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000'] result = subprocess.run(command, capture_output=True, text=True) print(result.stdout) - -# This code allows you to install different context brokers in a linux system -# -# # ORION-LD -# # The manuals are here https://github.com/FIWARE/context.Orion-LD/tree/develop/doc/manuals-ld -# -# # INSTALL NGSI LD broker (OrionLD) -# sudo docker pull mongo:3.6 -# sudo docker pull fiware/orion-ld -# sudo docker network create fiware_default -# sudo docker run -d --name=mongo-db --network=fiware_default --expose=27017 mongo:3.6 --bind_ip_all --smallfiles -# sudo docker run -d --name fiware-orionld -h orion --network=fiware_default -p 1026:1026 fiware/orion-ld -dbhost mongo-db -# -# # TO RELAUNCH (only if you have already installed a broker in the same machine) -# sudo docker stop fiware-orionld -# sudo docker rm fiware-orionld -# sudo docker stop mongo-db -# sudo docker rm mongo-db -# sudo docker network rm fiware_default -# -# # CHECK INSTANCES -# # Check the broker is running -# curl -X GET 'http://localhost:1026/version' -# -# # Check what entities are in the broker -# curl -X GET http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000 -# -# # STELLIO -# -# # INSTALL NGSI LD broker (Stellio) -# curl -O https://raw.githubusercontent.com/stellio-hub/stellio-context-broker/develop/docker-compose.yml -O https://raw.githubusercontent.com/stellio-hub/stellio-context-broker/develop/.env -# curl -o config/kafka/update_run.sh --create-dirs https://raw.githubusercontent.com/stellio-hub/stellio-context-broker/develop/config/kafka/update_run.sh && chmod u+x config/kafka/update_run.sh -# docker compose up -d -# # wait for some seconds for services to be up and running -# -# # TO RELAUNCH (only if you have already installed a broker in the same machine) -# docker compose down -# -# # CHECK INSTANCES -# curl -X GET 'http://localhost:8080/actuator/health' -# curl -X GET 'http://localhost:8080/search-service/actuator/health' -# -# # view the logs -# docker-compose logs -f --tail=100 -# -# # SCORPIO -# sudo docker pull postgis/postgis -# sudo docker pull scorpiobroker/all-in-one-runner:java-latest -# sudo docker network create fiware_default -# sudo docker run -d --name postgres --network=fiware_default -h postgres -p 5432 -e POSTGRES_USER=ngb -e POSTGRES_PASSWORD=ngb -e POSTGRES_DB=ngb postgis/postgis -# sudo docker run -d --name scorpio -h scorpio --network=fiware_default -e DBHOST=postgres -p 9090:9090 scorpiobroker/all-in-one-runner:java-latest -# -# # TO RELAUNCH (only if you have already installed a broker in the same machine) -# sudo docker stop scorpio -# sudo docker rm scorpio -# sudo docker stop postgres -# sudo docker rm postgres -# sudo docker network rm fiware_default -# -# # CHECK INSTANCES -# # Check the broker is running -# # Release Info -# curl -X GET 'http://localhost:9090/q/info' -# # Health status of the broker -# curl -X GET 'http://localhost:9090/q/health' -# -# # Check what entities are in the broker -# curl -X GET http://localhost:1026/ngsi-ld/v1/entities?local=true&limit=1000 -# -# -# # now the python code you can use to insert some value in the context broker according to the data model -# # Version Warning! -# # This code is designed to work with the version 0.8.0.1 of pysmartdatamodels or later -# -# -# \ No newline at end of file diff --git a/VehicleModel/doc/spec.md b/VehicleModel/doc/spec.md index a714add9f..5b72f02a6 100644 --- a/VehicleModel/doc/spec.md +++ b/VehicleModel/doc/spec.md @@ -1,539 +1,578 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entity: VehicleModel -==================== - - [Open License](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) - [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) - - - Global description: **This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.** - version: 0.0.1 - - - ## List of properties - [*] If there is not a type in an attribute is because it could have several types or different formats/patterns -- `address[object]`: The mailing address . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: The country. For example, Spain . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: The locality in which the street address is, and which is in the region . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: The region in which the locality is, and which is in the country . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: A district is a type of administrative division that, in some countries, is managed by the local government - - `postOfficeBoxNumber[string]`: The post office box number for PO box addresses. For example, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: The postal code. For example, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: The street address . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: An alternative name for this item - `annotations[array]`: Annotations about the item . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: The geographic area where a service or offered item is provided . Model: [https://schema.org/Text](https://schema.org/Text) - `brandName[string]`: Vehicle's brand name . Model: [https://schema.org/brand](https://schema.org/brand) - `cargoVolume[number]`: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) - `color[string]`: The color of the product . Model: [https://schema.org/color](https://schema.org/color) - `dataProvider[string]`: A sequence of characters identifying the provider of the harmonised data entity - `dateCreated[date-time]`: Entity creation timestamp. This will usually be allocated by the storage platform - `dateModified[date-time]`: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform - `depth[number]`: Vehicle's depth . Model: [https://schema.org/depth](https://schema.org/depth) - `description[string]`: A description of this item - `fuelConsumption[number]`: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) - `fuelType[string]`: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `height[number]`: Vehicle's height . Model: [https://schema.org/height](https://schema.org/height) - `id[*]`: Unique identifier of the entity - `image[uri]`: An image of the item . Model: [https://schema.org/URL](https://schema.org/URL) - `location[*]`: Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon - `manufacturerName[string]`: Vehicle's manufacturer name . Model: [https://schema.org/Text](https://schema.org/Text) - `modelName[string]`: Vehicle's model name . Model: [https://schema.org/model](https://schema.org/model) - `name[string]`: The name of this item - `owner[array]`: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) - `seeAlso[*]`: list of uri pointing to additional resources about the item - `source[string]`: 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]`: NGSI Entity type. It has to be VehicleModel - `url[uri]`: URL which provides a description of this vehicle model . Model: [https://schema.org/URL](https://schema.org/URL) - `vehicleEngine[string]`: Information about the engine or engines of the vehicle . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) - `vehicleModelDate[date-time]`: The release date of a vehicle model (often used to differentiate versions of the same make and model) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) - `vehicleType[string]`: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) - `weight[number]`: Vehicle's weigth . Model: [https://schema.org/weigth](https://schema.org/weigth) - `width[number]`: Vehicle's width . Model: [https://schema.org/width](https://schema.org/width) - - Required properties -- `brandName` - `id` - `manufacturerName` - `modelName` - `name` - `type` - `vehicleType` - - - - ## Data Model description of properties - Sorted alphabetically (click for details) - - -
full yaml details - ```yaml -VehicleModel: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' - 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 - brandName: - description: Vehicle's brand name - type: string - x-ngsi: - model: https://schema.org/brand - type: Property - cargoVolume: - description: 'The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume' - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/cargoVolume - type: Property - units: Liters - 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 - depth: - description: Vehicle's depth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/depth - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - fuelConsumption: - description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/fuelConsumption - type: Property - units: liters per 100 kilometer - fuelType: - description: 'The type of fuel suitable for the engine or engines of the vehicle. Enum:''autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other''' - enum: - - autogas - - biodiesel - - cng - - diesel - - electric - - ethanol - - gasoline - - hybrid_electric_diesel - - hybrid_electric_petrol - - hydrogen - - lpg - - petrol - - petrol(unleaded) - - petrol(leaded) - - other - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - height: - description: Vehicle's height - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/height - 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 - 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 - manufacturerName: - description: Vehicle's manufacturer name - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - modelName: - description: Vehicle's model name - type: string - x-ngsi: - model: https://schema.org/model - type: Property - 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 - 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 - type: - description: NGSI Entity type. It has to be VehicleModel - enum: - - VehicleModel - type: string - x-ngsi: - type: Property - url: - description: URL which provides a description of this vehicle model - format: uri - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - vehicleEngine: - description: Information about the engine or engines of the vehicle - type: string - x-ngsi: - model: https://schema.org/vehicleEngine - type: Property - vehicleModelDate: - description: The release date of a vehicle model (often used to differentiate versions of the same make and model) - format: date-time - type: string - x-ngsi: - model: https://schema.org/vehicleModelDate - type: Property - vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)' - enum: - - agriculturalVehicle - - bicycle - - binTrolley - - bus - - car - - caravan - - carWithCaravan - - carWithTrailer - - cleaningTrolley - - constructionOrMaintenanceVehicle - - lorry - - minibus - - moped - - motorcycle - - motorcycleWithSideCar - - motorscooter - - sweepingMachine - - tanker - - trailer - - tram - - van - - trolley - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - weight: - description: Vehicle's weigth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/weigth - type: Property - width: - description: Vehicle's width - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/width - type: Property - required: - - id - - name - - type - - vehicleType - - brandName - - modelName - - manufacturerName - 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.Transportation/blob/master/VehicleModel/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json - x-model-tags: "" - x-version: 0.0.1 -``` -
- - - - - ## Example payloads - #### VehicleModel NGSI-v2 key-values Example - Here is an example of a VehicleModel in JSON-LD format as key-values. This is compatible with NGSI-v2 when using `options=keyValues` and returns the context data of an individual entity. -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + Entity: VehicleModel +==================== + + [Open License](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) + [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) + + + Global description: **This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.** + version: 0.0.2 + + + + ## List of properties + + [*] If there is not a type in an attribute is because it could have several types or different formats/patterns +- `address[object]`: The mailing address . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: The country. For example, Spain . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: The locality in which the street address is, and which is in the region . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: The region in which the locality is, and which is in the country . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: A district is a type of administrative division that, in some countries, is managed by the local government + - `postOfficeBoxNumber[string]`: The post office box number for PO box addresses. For example, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: The postal code. For example, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: The street address . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Number identifying a specific property on a public street +- `alternateName[string]`: An alternative name for this item - `annotations[array]`: Annotations about the item . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: The geographic area where a service or offered item is provided . Model: [https://schema.org/Text](https://schema.org/Text) - `brandName[string]`: Vehicle's brand name . Model: [https://schema.org/brand](https://schema.org/brand) - `cargoVolume[number]`: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) - `color[string]`: The color of the product . Model: [https://schema.org/color](https://schema.org/color) - `dataProvider[string]`: A sequence of characters identifying the provider of the harmonised data entity - `dateCreated[date-time]`: Entity creation timestamp. This will usually be allocated by the storage platform - `dateModified[date-time]`: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform - `depth[number]`: Vehicle's depth . Model: [https://schema.org/depth](https://schema.org/depth) - `description[string]`: A description of this item - `fuelConsumption[number]`: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) - `fuelType[string]`: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `height[number]`: Vehicle's height . Model: [https://schema.org/height](https://schema.org/height) - `id[*]`: Unique identifier of the entity - `image[uri]`: An image of the item . Model: [https://schema.org/URL](https://schema.org/URL) - `location[*]`: Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon - `manufacturerName[string]`: Vehicle's manufacturer name . Model: [https://schema.org/Text](https://schema.org/Text) - `modelName[string]`: Vehicle's model name . Model: [https://schema.org/model](https://schema.org/model) - `name[string]`: The name of this item - `owner[array]`: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) - `seeAlso[*]`: list of uri pointing to additional resources about the item - `source[string]`: 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]`: NGSI Entity type. It has to be VehicleModel - `url[uri]`: URL which provides a description of this vehicle model . Model: [https://schema.org/URL](https://schema.org/URL) - `vehicleEngine[string]`: Information about the engine or engines of the vehicle . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) - `vehicleModelDate[date-time]`: The release date of a vehicle model (often used to differentiate versions of the same make and model) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) - `vehicleType[string]`: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) - `weight[number]`: Vehicle's weigth . Model: [https://schema.org/weigth](https://schema.org/weigth) - `width[number]`: Vehicle's width . Model: [https://schema.org/width](https://schema.org/width) + + Required properties +- `brandName` - `id` - `manufacturerName` - `modelName` - `name` - `type` - `vehicleType` + + + + ## Data Model description of properties + Sorted alphabetically (click for details) + + +
full yaml details + ```yaml +VehicleModel: + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. + 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: + description: Eventy element in the annotations + type: string + x-ngsi: + type: Property + 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 + brandName: + description: Vehicle's brand name + type: string + x-ngsi: + model: https://schema.org/brand + type: Property + cargoVolume: + description: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/cargoVolume + type: Property + units: Liters + 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 + depth: + description: Vehicle's depth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/depth + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + fuelConsumption: + description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/fuelConsumption + type: Property + units: liters per 100 kilometer + fuelType: + description: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' + enum: + - autogas + - biodiesel + - cng + - diesel + - electric + - ethanol + - gasoline + - hybrid_electric_diesel + - hybrid_electric_petrol + - hydrogen + - lpg + - petrol + - petrol(unleaded) + - petrol(leaded) + - other + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + height: + description: Vehicle's height + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/height + 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: Relationship + image: + description: An image of the item + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + manufacturerName: + description: Vehicle's manufacturer name + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + modelName: + description: Vehicle's model name + type: string + x-ngsi: + model: https://schema.org/model + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI Entity type. It has to be VehicleModel + enum: + - VehicleModel + type: string + x-ngsi: + type: Property + url: + description: URL which provides a description of this vehicle model + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + vehicleEngine: + description: Information about the engine or engines of the vehicle + type: string + x-ngsi: + model: https://schema.org/vehicleEngine + type: Property + vehicleModelDate: + description: The release date of a vehicle model (often used to differentiate versions of the same make and model) + format: date-time + type: string + x-ngsi: + model: https://schema.org/vehicleModelDate + type: Property + vehicleType: + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) + enum: + - agriculturalVehicle + - bicycle + - binTrolley + - bus + - car + - caravan + - carWithCaravan + - carWithTrailer + - cleaningTrolley + - constructionOrMaintenanceVehicle + - lorry + - minibus + - moped + - motorcycle + - motorcycleWithSideCar + - motorscooter + - sweepingMachine + - tanker + - trailer + - tram + - van + - trolley + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + weight: + description: Vehicle's weigth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/weigth + type: Property + width: + description: Vehicle's width + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/width + type: Property + required: + - id + - name + - type + - vehicleType + - brandName + - modelName + - manufacturerName + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json + x-model-tags: '' + x-version: 0.0.2 +``` +
+ + + + + ## Example payloads + #### VehicleModel NGSI-v2 key-values Example + Here is an example of a VehicleModel in JSON format as key-values. This is compatible with NGSI-v2 when using `options=keyValues` and returns the context data of an individual entity. +
show/hide example ```json { "id": "vehiclemodel:econic", @@ -547,10 +586,10 @@ VehicleModel: "fuelType": "diesel" } ``` -
- #### VehicleModel NGSI-v2 normalized Example - Here is an example of a VehicleModel in JSON-LD format as normalized. This is compatible with NGSI-v2 when not using options and returns the context data of an individual entity. -
show/hide example +
+ #### VehicleModel NGSI-v2 normalized Example + Here is an example of a VehicleModel in JSON format as normalized. This is compatible with NGSI-v2 when not using options and returns the context data of an individual entity. +
show/hide example ```json { "id": "vehiclemodel:econic", @@ -585,10 +624,10 @@ VehicleModel: } } ``` -
- #### VehicleModel NGSI-LD key-values Example - Here is an example of a VehicleModel in JSON-LD format as key-values. This is compatible with NGSI-LD when using `options=keyValues` and returns the context data of an individual entity. -
show/hide example +
+ #### VehicleModel NGSI-LD key-values Example + Here is an example of a VehicleModel in JSON-LD format as key-values. This is compatible with NGSI-LD when using `options=keyValues` and returns the context data of an individual entity. +
show/hide example ```json { "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", @@ -606,10 +645,10 @@ VehicleModel: ] } ``` -
- #### VehicleModel NGSI-LD normalized Example - Here is an example of a VehicleModel in JSON-LD format as normalized. This is compatible with NGSI-LD when not using options and returns the context data of an individual entity. -
show/hide example +
+ #### VehicleModel NGSI-LD normalized Example + Here is an example of a VehicleModel in JSON-LD format as normalized. This is compatible with NGSI-LD when not using options and returns the context data of an individual entity. +
show/hide example ```json { "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", @@ -648,12 +687,12 @@ VehicleModel: ] } ``` -
- - - - See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) diff --git a/VehicleModel/doc/spec_DE.md b/VehicleModel/doc/spec_DE.md index 095d4bf7d..91e2f581e 100644 --- a/VehicleModel/doc/spec_DE.md +++ b/VehicleModel/doc/spec_DE.md @@ -1,541 +1,654 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entität: FahrzeugModell -======================= - - [Offene Lizenz](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) - [Dokument automatisch generiert](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) - - - Globale Beschreibung: **Diese Einheit modelliert ein bestimmtes Fahrzeugmodell, einschließlich aller Eigenschaften, die mehreren zu diesem Modell gehörenden Fahrzeuginstanzen gemeinsam sind.** - Version: 0.0.1 - - - ## Liste der Eigenschaften - [*] Wenn es für ein Attribut keinen Typ gibt, kann es mehrere Typen oder verschiedene Formate/Muster haben. -- `address[object]`: Die Postanschrift . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Das Land. Zum Beispiel, Spanien . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: Die Ortschaft, in der sich die Adresse befindet, und die in der Region liegt . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: Die Region, in der sich der Ort befindet, und die auf dem Land liegt . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: Ein Bezirk ist eine Art von Verwaltungseinheit, die in einigen Ländern von der lokalen Regierung verwaltet wird. - - `postOfficeBoxNumber[string]`: Die Postfachnummer für Postfachadressen. Zum Beispiel, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: Die Postleitzahl. Zum Beispiel, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: Die Straßenanschrift . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: Ein alternativer Name für diesen Artikel - `annotations[array]`: Anmerkungen zum Artikel . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: Das geografische Gebiet, in dem eine Dienstleistung oder ein angebotener Artikel erbracht wird . Model: [https://schema.org/Text](https://schema.org/Text) - `brandName[string]`: Markenname des Fahrzeugs . Model: [https://schema.org/brand](https://schema.org/brand) - `cargoVolume[number]`: Das verfügbare Volumen für Fracht oder Gepäck. Bei Kraftfahrzeugen ist dies in der Regel das Kofferraumvolumen. Wenn nur ein einziger Wert angegeben wird (Typ Number), bezieht sich dieser auf das maximale Volumen . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) - `color[string]`: Die Farbe des Produkts . Model: [https://schema.org/color](https://schema.org/color) - `dataProvider[string]`: Eine Folge von Zeichen zur Identifizierung des Anbieters der harmonisierten Dateneinheit - `dateCreated[date-time]`: Zeitstempel der Entitätserstellung. Dieser wird normalerweise von der Speicherplattform zugewiesen - `dateModified[date-time]`: Zeitstempel der letzten Änderung der Entität. Dieser wird in der Regel von der Speicherplattform vergeben - `depth[number]`: Tiefe des Fahrzeugs . Model: [https://schema.org/depth](https://schema.org/depth) - `description[string]`: Eine Beschreibung dieses Artikels - `fuelConsumption[number]`: Die Kraftstoffmenge, die für eine bestimmte Strecke oder Zeitdauer mit dem jeweiligen Fahrzeug verbraucht wird (z. B. Liter pro 100 km) . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) - `fuelType[string]`: Die Art des Kraftstoffs, der für den Motor oder die Motoren des Fahrzeugs geeignet ist. Enum:'Autogas, Biodiesel, Ethanol, cng, Diesel, Elektro, Benzin, Hybrid-Elektro/Diesel, Hybrid-Elektro/Benzin, Wasserstoff, lpg, Benzin, Benzin (bleifrei), Benzin (verbleit), andere' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `height[number]`: Höhe des Fahrzeugs . Model: [https://schema.org/height](https://schema.org/height) - `id[*]`: Eindeutiger Bezeichner der Entität - `image[uri]`: Ein Bild des Artikels . Model: [https://schema.org/URL](https://schema.org/URL) - `location[*]`: Geojson-Referenz auf das Element. Es kann Punkt, LineString, Polygon, MultiPoint, MultiLineString oder MultiPolygon sein - `manufacturerName[string]`: Name des Fahrzeugherstellers . Model: [https://schema.org/Text](https://schema.org/Text) - `modelName[string]`: Modellbezeichnung des Fahrzeugs . Model: [https://schema.org/model](https://schema.org/model) - `name[string]`: Der Name dieses Artikels - `owner[array]`: Eine Liste mit einer JSON-kodierten Zeichenfolge, die auf die eindeutigen Kennungen der Eigentümer verweist - `seeAlso[*]`: Liste von URLs, die auf zusätzliche Ressourcen zu dem Artikel verweisen - `source[string]`: Eine Folge von Zeichen, die die ursprüngliche Quelle der Entitätsdaten als URL angibt. Empfohlen wird der voll qualifizierte Domänenname des Quellanbieters oder die URL des Quellobjekts. - `type[string]`: NGSI-Entitätstyp. Es muss VehicleModel sein - `url[uri]`: URL, die eine Beschreibung dieses Fahrzeugmodells enthält . Model: [https://schema.org/URL](https://schema.org/URL) - `vehicleEngine[string]`: Informationen über den Motor oder die Motoren des Fahrzeugs . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) - `vehicleModelDate[date-time]`: Das Erscheinungsdatum eines Fahrzeugmodells (wird oft zur Unterscheidung von Versionen derselben Marke und desselben Modells verwendet) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) - `vehicleType[string]`: Fahrzeugtyp unter dem Gesichtspunkt seiner strukturellen Merkmale. Dies ist etwas anderes als die Fahrzeugklasse. Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, MotorradMitSeitenwagen, Motorroller, Kehrmaschine, Tankwagen, Dreiradfahrzeug, Anhänger, Straßenbahn, Zweiradfahrzeug, Draisine, Lieferwagen, FahrzeugOhneKatalysator, FahrzeugMitWohnwagen, FahrzeugMitAnhänger, mitGeradeNummernKennzeichen, mitUngeradeNummernKennzeichen, Sonstiges". Die folgenden durch _VehicleTypeEnum_ und _VehicleTypeEnum2_ definierten Werte, [DATEX 2 Version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) - `weight[number]`: Gewicht des Fahrzeugs . Model: [https://schema.org/weigth](https://schema.org/weigth) - `width[number]`: Breite des Fahrzeugs . Model: [https://schema.org/width](https://schema.org/width) - - Erforderliche Eigenschaften -- `brandName` - `id` - `manufacturerName` - `modelName` - `name` - `type` - `vehicleType` - - - - ## Datenmodell Beschreibung der Eigenschaften - Alphabetisch sortiert (für Details anklicken) - - -
full yaml details - ```yaml -VehicleModel: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' - 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 - brandName: - description: Vehicle's brand name - type: string - x-ngsi: - model: https://schema.org/brand - type: Property - cargoVolume: - description: 'The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume' - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/cargoVolume - type: Property - units: Liters - 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 - depth: - description: Vehicle's depth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/depth - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - fuelConsumption: - description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/fuelConsumption - type: Property - units: liters per 100 kilometer - fuelType: - description: 'The type of fuel suitable for the engine or engines of the vehicle. Enum:''autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other''' - enum: - - autogas - - biodiesel - - cng - - diesel - - electric - - ethanol - - gasoline - - hybrid_electric_diesel - - hybrid_electric_petrol - - hydrogen - - lpg - - petrol - - petrol(unleaded) - - petrol(leaded) - - other - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - height: - description: Vehicle's height - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/height - 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 - 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 - manufacturerName: - description: Vehicle's manufacturer name - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - modelName: - description: Vehicle's model name - type: string - x-ngsi: - model: https://schema.org/model - type: Property - 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 - 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 - type: - description: NGSI Entity type. It has to be VehicleModel - enum: - - VehicleModel - type: string - x-ngsi: - type: Property - url: - description: URL which provides a description of this vehicle model - format: uri - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - vehicleEngine: - description: Information about the engine or engines of the vehicle - type: string - x-ngsi: - model: https://schema.org/vehicleEngine - type: Property - vehicleModelDate: - description: The release date of a vehicle model (often used to differentiate versions of the same make and model) - format: date-time - type: string - x-ngsi: - model: https://schema.org/vehicleModelDate - type: Property - vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)' - enum: - - agriculturalVehicle - - bicycle - - binTrolley - - bus - - car - - caravan - - carWithCaravan - - carWithTrailer - - cleaningTrolley - - constructionOrMaintenanceVehicle - - lorry - - minibus - - moped - - motorcycle - - motorcycleWithSideCar - - motorscooter - - sweepingMachine - - tanker - - trailer - - tram - - van - - trolley - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - weight: - description: Vehicle's weigth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/weigth - type: Property - width: - description: Vehicle's width - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/width - type: Property - required: - - id - - name - - type - - vehicleType - - brandName - - modelName - - manufacturerName - 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.Transportation/blob/master/VehicleModel/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json - x-model-tags: "" - x-version: 0.0.1 -``` -
- - - - - ## Beispiel-Nutzlasten - #### VehicleModel NGSI-v2 key-values Beispiel - Hier ist ein Beispiel für ein VehicleModel im JSON-LD-Format als Key-Values. Dies ist mit NGSI-v2 kompatibel, wenn `options=keyValues` verwendet wird und liefert die Kontextdaten einer einzelnen Entität. -
show/hide example - ```json - { + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entität: VehicleModel +==================== + + + + + +[Offene Lizenz](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) + +[Dokument automatisch generiert](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) + + + + + +Global description: **Diese Entität modelliert ein bestimmtes Fahrzeugmodell, einschließlich aller Eigenschaften, die mehreren Fahrzeuginstanzen, die zu einem solchen Modell gehören, gemeinsam sind.** + +version: 0.0.2 + + + + + + +## Liste der Eigenschaften + + +[*] Wenn es in einem Attribut keinen Typ gibt, liegt das daran, dass es mehrere Typen oder unterschiedliche Formate/Muster haben könnte +- `address[object]`: Die Postadresse . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: Das Land. Zum Beispiel Spanien . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: Die Ortschaft, in der sich die Straßenadresse befindet und die in der Region liegt . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: Die Region, in der die Ortschaft liegt und die im Land liegt . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Ein Bezirk ist eine Art von Verwaltungseinheit, die in einigen Ländern von der lokalen Regierung verwaltet wird + - `postOfficeBoxNumber[string]`: Die Postfachnummer für Postfachadressen. Zum Beispiel 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Die Postleitzahl. Zum Beispiel 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: Die Straßenadresse . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Hausnummer, die eine bestimmte Liegenschaft auf einer öffentlichen Straße identifiziert +- `alternateName[string]`: Ein alternativer Name für diesen Artikel +- `annotations[array]`: Anmerkungen zum Artikel . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: Das geografische Gebiet, in dem ein Dienst oder ein angebotenes Produkt bereitgestellt wird . Model: [https://schema.org/Text](https://schema.org/Text) +- `brandName[string]`: Fahrzeugmarke . Model: [https://schema.org/brand](https://schema.org/brand) +- `cargoVolume[number]`: Das verfügbare Volumen für Fracht oder Gepäck. Bei Autos handelt es sich dabei in der Regel um das Kofferraumvolumen. Wenn nur ein einzelner Wert angegeben wird (Typ Zahl), bezieht er sich auf das maximale Volumen . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) +- `color[string]`: Die Farbe des Produkts . Model: [https://schema.org/color](https://schema.org/color) +- `dataProvider[string]`: Eine Folge von Zeichen, die den Anbieter der harmonisierten Datenentität identifiziert +- `dateCreated[date-time]`: Zeitstempel für die Erstellung der Entität. Dieser wird in der Regel von der Speicherplattform zugewiesen +- `dateModified[date-time]`: Zeitstempel der letzten Änderung der Entität. Dieser wird in der Regel von der Speicherplattform zugewiesen +- `depth[number]`: Tiefgang des Fahrzeugs . Model: [https://schema.org/depth](https://schema.org/depth) +- `description[string]`: Eine Beschreibung dieses Artikels +- `fuelConsumption[number]`: Die Menge des für die Backreise einer bestimmten Strecke oder zeitlichen Dauer mit dem gegebenen Fahrzeug verbrauchten Kraftstoffs (z. B. Liter pro 100 km) . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) +- `fuelType[string]`: Die Art des für den Motor oder die Motoren des Fahrzeugs geeigneten Kraftstoffs. Enum:'Autogas, Biodiesel, Ethanol, Erdgas, Diesel, Elektro, Benzin, Hybrid-Elektro/Diesel, Hybrid-Elektro/Benzin, Wasserstoff, LPG, Benzin, Benzin(bleifrei), Benzin(bleihaltig), andere' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `height[number]`: Fahrzeughöhe . Model: [https://schema.org/height](https://schema.org/height) +- `id[*]`: Eindeutiger Identifikator der Entität +- `image[uri]`: Ein Bild des Artikels . Model: [https://schema.org/URL](https://schema.org/URL) +- `location[*]`: Geojson-Referenz zum Artikel. Es kann Punkt, Linienzug, Polygon, MultiPunkt, MultiLinienzug oder MultiPolygon sein +- `manufacturerName[string]`: Fahrzeugherstellername . Model: [https://schema.org/Text](https://schema.org/Text) +- `modelName[string]`: Fahrzeugmodellname . Model: [https://schema.org/model](https://schema.org/model) +- `name[string]`: Der Name dieses Artikels +- `owner[array]`: Eine Liste, die eine JSON-kodierte Sequenz von Zeichen enthält, die auf die eindeutigen IDs des/die Besitzer verweist +- `seeAlso[*]`: Liste von URIs, die auf zusätzliche Ressourcen zum Artikel verweisen +- `source[string]`: Eine Folge von Zeichen, die die ursprüngliche Quelle der Entitätsdaten als URL angibt. Es wird empfohlen, den vollqualifizierten Domänennamen des Quellanbieters oder die URL des Quellobjekts zu verwenden. +- `type[string]`: NGSI-Entitätentyp. Es muss VehicleModel sein +- `url[uri]`: URL, die eine Beschreibung dieses Fahrzeugmodells bereitstellt . Model: [https://schema.org/URL](https://schema.org/URL) +- `vehicleEngine[string]`: Informationen über den Motor oder die Motoren des Fahrzeugs . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) +- `vehicleModelDate[date-time]`: Das Erscheinungsdatum eines Fahrzeugmodells (wird oft verwendet, um Versionen desselben Herstellers und Modells zu unterscheiden) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) +- `vehicleType[string]`: Fahrzeugtyp aus Sicht seiner strukturellen Eigenschaften. Dies ist anders als die Fahrzeugkategorie. Enum: 'LandwirtschaftlichesFahrzeug, jedesFahrzeug, Gelenkfahrzeug, Fahrrad, Mülleimer, Bus, Auto, Wohnwagen, AutoOderLeichtesFahrzeug, AutoMitWohnwagen, AutoMitAnhänger, Reinigungswagen, Baufahrzeug, Allradfahrzeug, Hochseitenfahrzeug, LKW, Minibus, Moped, Motorrad, MotorradMitBeiwagen, Motorroller, Kehrmachine, Tankwagen, Dreiradfahrzeug, Anhänger, Straßenbahn, ZweiRäderFahrzeug, Wagen, FahrzeugOhneKatalysator, FahrzeugMitWohnwagen, FahrzeugMitAnhänger, mitGeradenKennzeichen, mitUngeradenKennzeichen, andere'. Die folgenden Werte sind durch _VehicleTypeEnum_ und _VehicleTypeEnum2_ definiert, [DATEX 2 Version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) +- `weight[number]`: Fahrzeuggewicht . Model: [https://schema.org/weigth](https://schema.org/weigth) +- `width[number]`: Fahrzeugbreite . Model: [https://schema.org/width](https://schema.org/width) + + + + + +Erforderliche Eigenschaften +- `Markenname` +- `id` +- `Herstellername` +- `Modellname` +- `Name` +- `Typ` +- `Fahrzeugtyp` + + + + + + + + + +## Datenmodellbeschreibung von Eigenschaften + +Sortiert alphabetisch (Klicken für Details) + + + + +
full yaml details + +```yaml +VehicleModel: + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. + 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: + description: Eventy element in the annotations + type: string + x-ngsi: + type: Property + 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 + brandName: + description: Vehicle's brand name + type: string + x-ngsi: + model: https://schema.org/brand + type: Property + cargoVolume: + description: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/cargoVolume + type: Property + units: Liters + 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 + depth: + description: Vehicle's depth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/depth + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + fuelConsumption: + description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/fuelConsumption + type: Property + units: liters per 100 kilometer + fuelType: + description: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' + enum: + - autogas + - biodiesel + - cng + - diesel + - electric + - ethanol + - gasoline + - hybrid_electric_diesel + - hybrid_electric_petrol + - hydrogen + - lpg + - petrol + - petrol(unleaded) + - petrol(leaded) + - other + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + height: + description: Vehicle's height + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/height + 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: Relationship + image: + description: An image of the item + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + manufacturerName: + description: Vehicle's manufacturer name + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + modelName: + description: Vehicle's model name + type: string + x-ngsi: + model: https://schema.org/model + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI Entity type. It has to be VehicleModel + enum: + - VehicleModel + type: string + x-ngsi: + type: Property + url: + description: URL which provides a description of this vehicle model + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + vehicleEngine: + description: Information about the engine or engines of the vehicle + type: string + x-ngsi: + model: https://schema.org/vehicleEngine + type: Property + vehicleModelDate: + description: The release date of a vehicle model (often used to differentiate versions of the same make and model) + format: date-time + type: string + x-ngsi: + model: https://schema.org/vehicleModelDate + type: Property + vehicleType: + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) + enum: + - agriculturalVehicle + - bicycle + - binTrolley + - bus + - car + - caravan + - carWithCaravan + - carWithTrailer + - cleaningTrolley + - constructionOrMaintenanceVehicle + - lorry + - minibus + - moped + - motorcycle + - motorcycleWithSideCar + - motorscooter + - sweepingMachine + - tanker + - trailer + - tram + - van + - trolley + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + weight: + description: Vehicle's weigth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/weigth + type: Property + width: + description: Vehicle's width + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/width + type: Property + required: + - id + - name + - type + - vehicleType + - brandName + - modelName + - manufacturerName + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json + x-model-tags: '' + x-version: 0.0.2 +``` +
+ + + + + + + + + +## Beispielnutzlasten + +#### Fahrzeugmodell NGSI-v2 Schlüssel-Wert-Beispiel + +Hier ist ein Beispiel für ein VehicleModel im JSON-Format als Schlüssel-Werte. Dies ist kompatibel mit NGSI-v2, wenn `options=keyValues` verwendet wird und die Kontextdaten einer einzelnen Entität zurückgibt. +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": "MBenz-Econic2014", @@ -547,12 +660,16 @@ VehicleModel: "fuelType": "diesel" } ``` -
- #### VehicleModel NGSI-v2 normalisiert Beispiel - Hier ist ein Beispiel für ein VehicleModel im JSON-LD-Format in normalisierter Form. Dies ist kompatibel mit NGSI-v2, wenn keine Optionen verwendet werden, und liefert die Kontextdaten einer einzelnen Entität. -
show/hide example - ```json - { +
+ +#### Fahrzeugmodell NGSI-v2 normalisiertes Beispiel + +Hier ist ein Beispiel für ein VehicleModel im JSON-Format als normalisiert. Dies ist kompatibel mit NGSI-v2, wenn keine Optionen verwendet werden und es die Kontextdaten einer einzelnen Entität zurückgibt. +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": { @@ -585,12 +702,16 @@ VehicleModel: } } ``` -
- #### VehicleModel NGSI-LD Schlüsselwerte Beispiel - Hier ist ein Beispiel für ein VehicleModel im JSON-LD-Format als Key-Values. Dies ist mit NGSI-LD kompatibel, wenn `options=keyValues` verwendet wird und liefert die Kontextdaten einer einzelnen Entität. -
show/hide example - ```json - { +
+ +#### Fahrzeugmodell NGSI-LD Schlüssel-Wert-Beispiel + +Hier ist ein Beispiel für ein VehicleModel im JSON-LD-Format als Schlüssel-Werte. Dies ist kompatibel mit NGSI-LD, wenn `options=keyValues` verwendet wird und die Kontextdaten einer einzelnen Entität zurückgibt. +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": "Mercedes Benz", @@ -606,12 +727,16 @@ VehicleModel: ] } ``` -
- #### VehicleModel NGSI-LD normalisiert Beispiel - Hier ist ein Beispiel für ein VehicleModel im JSON-LD-Format in normalisierter Form. Dies ist mit NGSI-LD kompatibel, wenn keine Optionen verwendet werden, und liefert die Kontextdaten einer einzelnen Entität. -
show/hide example - ```json - { +
+ +#### Fahrzeugmodell NGSI-LD normalisiertes Beispiel + +Hier ist ein Beispiel für ein VehicleModel im JSON-LD-Format als normalisiert. Dies ist kompatibel mit NGSI-LD, wenn keine Optionen verwendet werden und es die Kontextdaten einer einzelnen Entität zurückgibt. +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": { @@ -648,12 +773,21 @@ VehicleModel: ] } ``` -
- - - - Siehe [FAQ 10] (https://smartdatamodels.org/index.php/faqs/), um eine Antwort auf die Frage zu erhalten, wie man mit Größeneinheiten umgeht - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/VehicleModel/doc/spec_ES.md b/VehicleModel/doc/spec_ES.md index 90ddef563..a24825404 100644 --- a/VehicleModel/doc/spec_ES.md +++ b/VehicleModel/doc/spec_ES.md @@ -1,541 +1,654 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entidad: VehicleModel -===================== - - [Licencia abierta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) - [documento generado automáticamente](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) - - - Descripción global: **Esta entidad modela un modelo de vehículo en particular, incluyendo todas las propiedades que son comunes a múltiples instancias de vehículos pertenecientes a dicho modelo.** - versión: 0.0.1 - - - ## Lista de propiedades - [*] Si no hay un tipo en un atributo es porque puede tener varios tipos o diferentes formatos/patrones. -- `address[object]`: La dirección postal . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: El país. Por ejemplo, España . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: La localidad en la que se encuentra la dirección postal, y que está en la región . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: La región en la que se encuentra la localidad, y que está en el país . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: Un distrito es un tipo de división administrativa que, en algunos países, gestiona el gobierno local - - `postOfficeBoxNumber[string]`: El número del apartado de correos para las direcciones de apartados postales. Por ejemplo, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entidad: VehicleModel +==================== + + + + + +[Licencia Abierta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) + +[documento generado automáticamente](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) + + + + + +Global description: **Esta entidad modela un modelo de vehículo particular, incluyendo todas las propiedades que son comunes a varias instancias de vehículos que pertenecen a dicho modelo.** + +version: 0.0.2 + + + + + + +## Lista de propiedades + + +[*] Si no hay un tipo en un atributo es porque podría tener varios tipos o diferentes formatos/patrones +- `address[object]`: La dirección de correo . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: El país. Por ejemplo, España . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La localidad en la que está la dirección de la calle, y que está en la región . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La región en la que se encuentra la localidad, y que se encuentra en el país . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un distrito es un tipo de división administrativa que, en algunos países, es gestionado por el gobierno local + - `postOfficeBoxNumber[string]`: El número de casilla de correo para las direcciones de casilla de correo. Por ejemplo, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - `postalCode[string]`: El código postal. Por ejemplo, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: La dirección . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: Un nombre alternativo para este artículo - `annotations[array]`: Anotaciones sobre el artículo . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: La zona geográfica en la que se presta un servicio o se ofrece un artículo . Model: [https://schema.org/Text](https://schema.org/Text) - `brandName[string]`: Marca del vehículo . Model: [https://schema.org/brand](https://schema.org/brand) - `cargoVolume[number]`: El volumen disponible para carga o equipaje. En el caso de los automóviles, suele tratarse del volumen del maletero. Si sólo se proporciona un único valor (tipo Número) se referirá al volumen máximo . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) - `color[string]`: El color del producto . Model: [https://schema.org/color](https://schema.org/color) - `dataProvider[string]`: Una secuencia de caracteres que identifica al proveedor de la entidad de datos armonizada - `dateCreated[date-time]`: Fecha de creación de la entidad. Normalmente será asignada por la plataforma de almacenamiento - `dateModified[date-time]`: Marca de tiempo de la última modificación de la entidad. Suele ser asignada por la plataforma de almacenamiento - `depth[number]`: Profundidad del vehículo . Model: [https://schema.org/depth](https://schema.org/depth) - `description[string]`: Descripción de este artículo - `fuelConsumption[number]`: La cantidad de combustible consumido para recorrer una distancia o duración temporal determinada con el vehículo en cuestión (por ejemplo, litros por cada 100 km). . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) - `fuelType[string]`: Tipo de combustible adecuado para el motor o motores del vehículo. Enum:'autogás, biodiésel, etanol, gnc, diésel, eléctrico, gasolina, híbrido eléctrico/diésel, híbrido eléctrico/gasolina, hidrógeno, glp, gasolina, gasolina sin plomo, gasolina con plomo, otro'. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `height[number]`: Altura del vehículo . Model: [https://schema.org/height](https://schema.org/height) - `id[*]`: Identificador único de la entidad - `image[uri]`: Una imagen del artículo . Model: [https://schema.org/URL](https://schema.org/URL) - `location[*]`: Referencia Geojson al elemento. Puede ser Point, LineString, Polygon, MultiPoint, MultiLineString o MultiPolygon. - `manufacturerName[string]`: Nombre del fabricante del vehículo . Model: [https://schema.org/Text](https://schema.org/Text) - `modelName[string]`: Nombre del modelo del vehículo . Model: [https://schema.org/model](https://schema.org/model) - `name[string]`: El nombre de este artículo - `owner[array]`: Una lista que contiene una secuencia de caracteres codificada en JSON que hace referencia a los identificadores únicos de los propietarios. - `seeAlso[*]`: lista de uri que apuntan a recursos adicionales sobre el artículo - `source[string]`: Secuencia de caracteres que indica la fuente original de los datos de la entidad en forma de URL. Se recomienda que sea el nombre de dominio completo del proveedor de origen o la URL del objeto de origen. - `type[string]`: Tipo de entidad NGSI. Tiene que ser VehicleModel - `url[uri]`: URL que proporciona una descripción de este modelo de vehículo . Model: [https://schema.org/URL](https://schema.org/URL) - `vehicleEngine[string]`: Información sobre el motor o motores del vehículo . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) - `vehicleModelDate[date-time]`: La fecha de lanzamiento de un modelo de vehículo (a menudo se utiliza para diferenciar versiones de la misma marca y modelo). . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) - `vehicleType[string]`: Tipo de vehículo desde el punto de vista de sus características estructurales. Es diferente de la categoría de vehículo . Enum:vehículo agrícola, cualquier vehículo, vehículo articulado, bicicleta, carro de basura, autobús, coche, caravana, vehículo ligero, coche con caravana, coche con remolque, carro de limpieza, vehículo de construcción o mantenimiento, tracción a las cuatro ruedas, vehículo de gran altura, camión, minibús, ciclomotor, motocicleta, motocicleta con sidecar, motocarro, barredora, cisterna, vehículo de tres ruedas, remolque, tranvía, vehículo de dos ruedas, carro, furgoneta, vehículo sin convertidor catalítico, vehículo con caravana, vehículo con remolque, con matrícula par, con matrícula impar, otros". Los siguientes valores definidos por _VehicleTypeEnum_ y _VehicleTypeEnum2_, [DATEX 2 versión 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) - `weight[number]`: Peso del vehículo . Model: [https://schema.org/weigth](https://schema.org/weigth) - `width[number]`: Anchura del vehículo . Model: [https://schema.org/width](https://schema.org/width) - - Propiedades requeridas -- `brandName` - `id` - `manufacturerName` - `modelName` - `name` - `type` - `vehicleType` - - - - ## Descripción de las propiedades del modelo de datos - Ordenados alfabéticamente (pulse para más detalles) - - -
full yaml details - ```yaml -VehicleModel: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' - 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 - brandName: - description: Vehicle's brand name - type: string - x-ngsi: - model: https://schema.org/brand - type: Property - cargoVolume: - description: 'The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume' - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/cargoVolume - type: Property - units: Liters - 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 - depth: - description: Vehicle's depth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/depth - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - fuelConsumption: - description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/fuelConsumption - type: Property - units: liters per 100 kilometer - fuelType: - description: 'The type of fuel suitable for the engine or engines of the vehicle. Enum:''autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other''' - enum: - - autogas - - biodiesel - - cng - - diesel - - electric - - ethanol - - gasoline - - hybrid_electric_diesel - - hybrid_electric_petrol - - hydrogen - - lpg - - petrol - - petrol(unleaded) - - petrol(leaded) - - other - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - height: - description: Vehicle's height - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/height - 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 - 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 - manufacturerName: - description: Vehicle's manufacturer name - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - modelName: - description: Vehicle's model name - type: string - x-ngsi: - model: https://schema.org/model - type: Property - 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 - 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 - type: - description: NGSI Entity type. It has to be VehicleModel - enum: - - VehicleModel - type: string - x-ngsi: - type: Property - url: - description: URL which provides a description of this vehicle model - format: uri - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - vehicleEngine: - description: Information about the engine or engines of the vehicle - type: string - x-ngsi: - model: https://schema.org/vehicleEngine - type: Property - vehicleModelDate: - description: The release date of a vehicle model (often used to differentiate versions of the same make and model) - format: date-time - type: string - x-ngsi: - model: https://schema.org/vehicleModelDate - type: Property - vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)' - enum: - - agriculturalVehicle - - bicycle - - binTrolley - - bus - - car - - caravan - - carWithCaravan - - carWithTrailer - - cleaningTrolley - - constructionOrMaintenanceVehicle - - lorry - - minibus - - moped - - motorcycle - - motorcycleWithSideCar - - motorscooter - - sweepingMachine - - tanker - - trailer - - tram - - van - - trolley - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - weight: - description: Vehicle's weigth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/weigth - type: Property - width: - description: Vehicle's width - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/width - type: Property - required: - - id - - name - - type - - vehicleType - - brandName - - modelName - - manufacturerName - 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.Transportation/blob/master/VehicleModel/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json - x-model-tags: "" - x-version: 0.0.1 -``` -
- - - - - ## Ejemplo de carga útil - #### VehicleModel NGSI-v2 key-values Ejemplo - He aquí un ejemplo de VehicleModel en formato JSON-LD como key-values. Esto es compatible con NGSI-v2 cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. -
show/hide example - ```json - { + - `streetAddress[string]`: La dirección de la calle . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Número que identifica una propiedad específica en una calle pública +- `alternateName[string]`: Un nombre alternativo para este artículo +- `annotations[array]`: Anotaciones sobre el artículo . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: El área geográfica donde se proporciona un servicio o artículo ofrecido . Model: [https://schema.org/Text](https://schema.org/Text) +- `brandName[string]`: Nombre de la marca del vehículo . Model: [https://schema.org/brand](https://schema.org/brand) +- `cargoVolume[number]`: El volumen disponible para carga o equipaje. Para automóviles, este suele ser el volumen del maletero. Si solo se proporciona un valor único (tipo Número) se referirá al volumen máximo . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) +- `color[string]`: El color del producto . Model: [https://schema.org/color](https://schema.org/color) +- `dataProvider[string]`: Una secuencia de caracteres que identifica al proveedor de la entidad de datos armonizados +- `dateCreated[date-time]`: Marca de tiempo de creación de entidad. Esto generalmente será asignado por la plataforma de almacenamiento +- `dateModified[date-time]`: Marca de tiempo de la última modificación de la entidad. Esto generalmente será asignado por la plataforma de almacenamiento +- `depth[number]`: Profundidad del vehículo . Model: [https://schema.org/depth](https://schema.org/depth) +- `description[string]`: Una descripción de este artículo +- `fuelConsumption[number]`: La cantidad de combustible consumido para recorrer una distancia o duración temporal determinada con el vehículo dado (por ejemplo, litros por 100 km) . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) +- `fuelType[string]`: El tipo de combustible adecuado para el motor o motores del vehículo. Enum: 'autogas, biodiésel, etanol, cng, diésel, eléctrico, gasolina, híbrido eléctrico/diésel, híbrido eléctrico/gasolina, hidrógeno, glp, gasolina, gasolina(sin plomo), gasolina(con plomo), otro' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `height[number]`: Altura del vehículo . Model: [https://schema.org/height](https://schema.org/height) +- `id[*]`: Identificador único de la entidad +- `image[uri]`: Una imagen del artículo . Model: [https://schema.org/URL](https://schema.org/URL) +- `location[*]`: Referencia Geojson al elemento. Puede ser Punto, LineaString, Poligono, MultiPunto, MultiLineaString o MultiPoligono +- `manufacturerName[string]`: Nombre del fabricante del vehículo . Model: [https://schema.org/Text](https://schema.org/Text) +- `modelName[string]`: Nombre del modelo del vehículo . Model: [https://schema.org/model](https://schema.org/model) +- `name[string]`: El nombre de este artículo +- `owner[array]`: Una lista que contiene una secuencia de caracteres codificada en JSON que hace referencia a los Ids únicos del(los) propietario(s) +- `seeAlso[*]`: Lista de uri que apuntan a recursos adicionales sobre el artículo +- `source[string]`: Una secuencia de caracteres que da la fuente original de los datos de la entidad como una URL. Se recomienda que sea el nombre de dominio completamente calificado del proveedor de la fuente, o la URL del objeto de la fuente. +- `type[string]`: Tipo de entidad NGSI. Tiene que ser VehicleModel +- `url[uri]`: URL que proporciona una descripción de este modelo de vehículo . Model: [https://schema.org/URL](https://schema.org/URL) +- `vehicleEngine[string]`: Información sobre el motor o motores del vehículo . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) +- `vehicleModelDate[date-time]`: La fecha de lanzamiento de un modelo de vehículo (a menudo utilizado para diferenciar versiones del mismo fabricante y modelo) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) +- `vehicleType[string]`: Tipo de vehículo desde el punto de vista de sus características estructurales. Esto es diferente a la categoría de vehículo. Enum: 'agriculturalVehicle, anyVehicle, articulatedVehicle, bicicleta, binTrolley, autobús, coche, caravana, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, camión, minibús, ciclomotor, motocicleta, motorcycleWithSideCar, motorscooter, sweepingMachine, cisterna, threeWheeledVehicle, remolque, tranvía, twoWheeledVehicle, trolley, furgoneta, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, otro'. Los siguientes valores están definidos por _VehicleTypeEnum_ y _VehicleTypeEnum2_, [DATEX 2 versión 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) +- `weight[number]`: Peso del vehículo . Model: [https://schema.org/weigth](https://schema.org/weigth) +- `width[number]`: Anchura del vehículo . Model: [https://schema.org/width](https://schema.org/width) + + + + + +Propiedades requeridas +- `nombreDeMarca` +- `id` +- `nombreDelFabricante` +- `nombreDelModelo` +- `nombre` +- `tipo` +- `tipoDeVehículo` + + + + + + + + + +## Descripción del modelo de datos de propiedades + +Ordenado alfabéticamente (haga clic para detalles) + + + + +
full yaml details + +```yaml +VehicleModel: + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. + 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: + description: Eventy element in the annotations + type: string + x-ngsi: + type: Property + 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 + brandName: + description: Vehicle's brand name + type: string + x-ngsi: + model: https://schema.org/brand + type: Property + cargoVolume: + description: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/cargoVolume + type: Property + units: Liters + 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 + depth: + description: Vehicle's depth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/depth + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + fuelConsumption: + description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/fuelConsumption + type: Property + units: liters per 100 kilometer + fuelType: + description: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' + enum: + - autogas + - biodiesel + - cng + - diesel + - electric + - ethanol + - gasoline + - hybrid_electric_diesel + - hybrid_electric_petrol + - hydrogen + - lpg + - petrol + - petrol(unleaded) + - petrol(leaded) + - other + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + height: + description: Vehicle's height + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/height + 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: Relationship + image: + description: An image of the item + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + manufacturerName: + description: Vehicle's manufacturer name + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + modelName: + description: Vehicle's model name + type: string + x-ngsi: + model: https://schema.org/model + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI Entity type. It has to be VehicleModel + enum: + - VehicleModel + type: string + x-ngsi: + type: Property + url: + description: URL which provides a description of this vehicle model + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + vehicleEngine: + description: Information about the engine or engines of the vehicle + type: string + x-ngsi: + model: https://schema.org/vehicleEngine + type: Property + vehicleModelDate: + description: The release date of a vehicle model (often used to differentiate versions of the same make and model) + format: date-time + type: string + x-ngsi: + model: https://schema.org/vehicleModelDate + type: Property + vehicleType: + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) + enum: + - agriculturalVehicle + - bicycle + - binTrolley + - bus + - car + - caravan + - carWithCaravan + - carWithTrailer + - cleaningTrolley + - constructionOrMaintenanceVehicle + - lorry + - minibus + - moped + - motorcycle + - motorcycleWithSideCar + - motorscooter + - sweepingMachine + - tanker + - trailer + - tram + - van + - trolley + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + weight: + description: Vehicle's weigth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/weigth + type: Property + width: + description: Vehicle's width + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/width + type: Property + required: + - id + - name + - type + - vehicleType + - brandName + - modelName + - manufacturerName + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json + x-model-tags: '' + x-version: 0.0.2 +``` +
+ + + + + + + + + +## Cargas de ejemplo + +#### ModeloDeVehículo ejemplo de valores clave NGSI-v2 + +Aquí hay un ejemplo de un VehicleModel en formato JSON como clave-valor. Esto es compatible con NGSI-v2 cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": "MBenz-Econic2014", @@ -547,12 +660,16 @@ VehicleModel: "fuelType": "diesel" } ``` -
- #### VehicleModel NGSI-v2 normalizado Ejemplo - He aquí un ejemplo de VehicleModel en formato JSON-LD normalizado. Esto es compatible con NGSI-v2 cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. -
show/hide example - ```json - { +
+ +#### ModeloDeVehículo NGSI-v2 normalizado Ejemplo + +Aquí hay un ejemplo de un VehicleModel en formato JSON normalizado. Esto es compatible con NGSI-v2 cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": { @@ -585,12 +702,16 @@ VehicleModel: } } ``` -
- #### VehicleModel NGSI-LD key-values Ejemplo - He aquí un ejemplo de VehicleModel en formato JSON-LD como key-values. Esto es compatible con NGSI-LD cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. -
show/hide example - ```json - { +
+ +#### ModeloDeVehículo claves-valor de ejemplo NGSI-LD + +Aquí hay un ejemplo de un VehicleModel en formato JSON-LD como clave-valor. Esto es compatible con NGSI-LD cuando se utiliza `options=keyValues` y devuelve los datos de contexto de una entidad individual. +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": "Mercedes Benz", @@ -606,12 +727,16 @@ VehicleModel: ] } ``` -
- #### VehicleModel NGSI-LD normalizado Ejemplo - He aquí un ejemplo de VehicleModel en formato JSON-LD normalizado. Esto es compatible con NGSI-LD cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. -
show/hide example - ```json - { +
+ +#### ModeloDeVehículo NGSI-LD normalizado Ejemplo + +Aquí hay un ejemplo de un VehicleModel en formato JSON-LD normalizado. Esto es compatible con NGSI-LD cuando no se utilizan opciones y devuelve los datos de contexto de una entidad individual. +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": { @@ -648,12 +773,21 @@ VehicleModel: ] } ``` -
- - - - Consulte [FAQ 10](https://smartdatamodels.org/index.php/faqs/) para obtener una respuesta sobre cómo tratar las unidades de magnitud. - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/VehicleModel/doc/spec_FR.md b/VehicleModel/doc/spec_FR.md index acf881d4a..7f19966d9 100644 --- a/VehicleModel/doc/spec_FR.md +++ b/VehicleModel/doc/spec_FR.md @@ -1,541 +1,654 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entité : Modèle de véhicule -=========================== - - [Licence ouverte] (https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) - [document généré automatiquement] (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) - - - Description globale : **Cette entité modélise un modèle de véhicule particulier, y compris toutes les propriétés communes à plusieurs instances de véhicules appartenant à ce modèle. - version : 0.0.1 - - - ## Liste des propriétés - [*] S'il n'y a pas de type dans un attribut, c'est parce qu'il peut avoir plusieurs types ou différents formats/modèles. -- `address[object]`: L'adresse postale . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Le pays. Par exemple, l'Espagne . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: La localité dans laquelle se trouve l'adresse postale et qui se trouve dans la région . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: La région dans laquelle se trouve la localité et qui se trouve dans le pays . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: Un district est un type de division administrative qui, dans certains pays, est géré par le gouvernement local. - - `postOfficeBoxNumber[string]`: Le numéro de la boîte postale pour les adresses de boîtes postales. Par exemple, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entité: VehicleModel +==================== + + + + + +[Licence ouverte](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) + +[document généré automatiquement](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) + + + + + +Global description: **Cette entité modélise un modèle de véhicule particulier, y compris toutes les propriétés qui sont communes à plusieurs instances de véhicules appartenant à un tel modèle.** + +version: 0.0.2 + + + + + + +## Liste des propriétés + + +[*] Si il n'y a pas de type dans un attribut, c'est parce qu'il pourrait avoir plusieurs types ou différents formats/modes. +- `address[object]`: L'adresse postale . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: Le pays. Par exemple, l'Espagne . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La localité dans laquelle se trouve l'adresse de la rue, et qui se trouve dans la région . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La région dans laquelle se trouve la localité, et qui se trouve dans le pays . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un district est un type de division administrative qui, dans certains pays, est géré par le gouvernement local + - `postOfficeBoxNumber[string]`: Le numéro de boîte postale pour les adresses de boîte postale. Par exemple, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - `postalCode[string]`: Le code postal. Par exemple, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - `streetAddress[string]`: L'adresse de la rue . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: Un nom alternatif pour ce poste - `annotations[array]`: Annotations sur l'article . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: La zone géographique où un service ou un article est offert . Model: [https://schema.org/Text](https://schema.org/Text) - `brandName[string]`: Marque du véhicule . Model: [https://schema.org/brand](https://schema.org/brand) - `cargoVolume[number]`: Volume disponible pour le chargement ou les bagages. Pour les automobiles, il s'agit généralement du volume du coffre. Si une seule valeur est fournie (type Nombre), elle fera référence au volume maximal. . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) - `color[string]`: La couleur du produit . Model: [https://schema.org/color](https://schema.org/color) - `dataProvider[string]`: Une séquence de caractères identifiant le fournisseur de l'entité de données harmonisées - `dateCreated[date-time]`: Horodatage de la création de l'entité. Celle-ci est généralement attribuée par la plate-forme de stockage - `dateModified[date-time]`: Date de la dernière modification de l'entité. Cette date est généralement attribuée par la plate-forme de stockage - `depth[number]`: Profondeur du véhicule . Model: [https://schema.org/depth](https://schema.org/depth) - `description[string]`: Une description de l'article - `fuelConsumption[number]`: La quantité de carburant consommée pour parcourir une distance ou une durée donnée avec le véhicule en question (par exemple, litres par 100 km). . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) - `fuelType[string]`: Type de carburant adapté au(x) moteur(s) du véhicule. Enum : "autogaz, biodiesel, éthanol, cng, diesel, électrique, essence, hybride électrique/diesel, hybride électrique/essence, hydrogène, lpg, essence, essence (sans plomb), essence (avec plomb), autre". . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `height[number]`: Hauteur du véhicule . Model: [https://schema.org/height](https://schema.org/height) - `id[*]`: Identifiant unique de l'entité - `image[uri]`: Une image de l'objet . Model: [https://schema.org/URL](https://schema.org/URL) - `location[*]`: Référence Geojson à l'élément. Il peut s'agir d'un point, d'une chaîne de ligne, d'un polygone, d'un point multiple, d'une chaîne de ligne multiple ou d'un polygone multiple. - `manufacturerName[string]`: Nom du constructeur du véhicule . Model: [https://schema.org/Text](https://schema.org/Text) - `modelName[string]`: Nom du modèle du véhicule . Model: [https://schema.org/model](https://schema.org/model) - `name[string]`: Le nom de cet élément - `owner[array]`: Une liste contenant une séquence de caractères encodés JSON référençant les identifiants uniques du ou des propriétaires. - `seeAlso[*]`: liste d'uri pointant vers des ressources supplémentaires concernant l'élément - `source[string]`: Séquence de caractères indiquant la source originale des données de l'entité sous forme d'URL. Il est recommandé d'utiliser le nom de domaine complet du fournisseur de la source ou l'URL de l'objet source. - `type[string]`: Type d'entité NGSI. Il doit s'agir de VehicleModel - `url[uri]`: URL qui fournit une description de ce modèle de véhicule . Model: [https://schema.org/URL](https://schema.org/URL) - `vehicleEngine[string]`: Informations sur le ou les moteurs du véhicule . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) - `vehicleModelDate[date-time]`: La date de sortie d'un modèle de véhicule (souvent utilisée pour différencier les versions d'une même marque et d'un même modèle) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) - `vehicleType[string]`: Type de véhicule du point de vue de ses caractéristiques structurelles. Ce type de véhicule est différent de la catégorie de véhicule. Enum :Véhicule agricole, tout véhicule, véhicule articulé, bicyclette, chariot-benne, bus, voiture, caravane, voiture ou véhicule léger, voiture avec caravane, voiture avec remorque, chariot de nettoyage, véhicule de construction ou d'entretien, véhicule à quatre roues motrices, véhicule à hauts flancs, camion, minibus, cyclomoteur, motocyclette, motocyclette avec side-car, scooter, balayeuse, camion-citerne, véhicule à trois roues, remorque, tramway, véhicule à deux roues, chariot, camionnette, véhicule sans convertisseur catalytique, véhicule avec caravane, véhicule avec remorque, avec plaques d'immatriculation à numéro pair, avec plaques d'immatriculation à numéro plus élevé, autre". Les valeurs suivantes définies par _VehicleTypeEnum_ et _VehicleTypeEnum2_, [DATEX 2 version 2.3] (http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) - `weight[number]`: Poids du véhicule . Model: [https://schema.org/weigth](https://schema.org/weigth) - `width[number]`: Largeur du véhicule . Model: [https://schema.org/width](https://schema.org/width) - - Propriétés requises -- `brandName` - `id` - `manufacturerName` - `modelName` - `name` - `type` - `vehicleType` - - - - ## Modèle de données description des propriétés - Classés par ordre alphabétique (cliquez pour plus de détails) - - -
full yaml details - ```yaml -VehicleModel: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' - 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 - brandName: - description: Vehicle's brand name - type: string - x-ngsi: - model: https://schema.org/brand - type: Property - cargoVolume: - description: 'The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume' - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/cargoVolume - type: Property - units: Liters - 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 - depth: - description: Vehicle's depth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/depth - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - fuelConsumption: - description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/fuelConsumption - type: Property - units: liters per 100 kilometer - fuelType: - description: 'The type of fuel suitable for the engine or engines of the vehicle. Enum:''autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other''' - enum: - - autogas - - biodiesel - - cng - - diesel - - electric - - ethanol - - gasoline - - hybrid_electric_diesel - - hybrid_electric_petrol - - hydrogen - - lpg - - petrol - - petrol(unleaded) - - petrol(leaded) - - other - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - height: - description: Vehicle's height - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/height - 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 - 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 - manufacturerName: - description: Vehicle's manufacturer name - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - modelName: - description: Vehicle's model name - type: string - x-ngsi: - model: https://schema.org/model - type: Property - 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 - 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 - type: - description: NGSI Entity type. It has to be VehicleModel - enum: - - VehicleModel - type: string - x-ngsi: - type: Property - url: - description: URL which provides a description of this vehicle model - format: uri - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - vehicleEngine: - description: Information about the engine or engines of the vehicle - type: string - x-ngsi: - model: https://schema.org/vehicleEngine - type: Property - vehicleModelDate: - description: The release date of a vehicle model (often used to differentiate versions of the same make and model) - format: date-time - type: string - x-ngsi: - model: https://schema.org/vehicleModelDate - type: Property - vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)' - enum: - - agriculturalVehicle - - bicycle - - binTrolley - - bus - - car - - caravan - - carWithCaravan - - carWithTrailer - - cleaningTrolley - - constructionOrMaintenanceVehicle - - lorry - - minibus - - moped - - motorcycle - - motorcycleWithSideCar - - motorscooter - - sweepingMachine - - tanker - - trailer - - tram - - van - - trolley - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - weight: - description: Vehicle's weigth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/weigth - type: Property - width: - description: Vehicle's width - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/width - type: Property - required: - - id - - name - - type - - vehicleType - - brandName - - modelName - - manufacturerName - 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.Transportation/blob/master/VehicleModel/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json - x-model-tags: "" - x-version: 0.0.1 -``` -
- - - - - ## Exemples de charges utiles - #### VehicleModel Valeurs-clés de l'INSIG-v2 Exemple - Voici un exemple d'un VehicleModel au format JSON-LD en tant que valeurs clés. Ceci est compatible avec NGSI-v2 lorsque l'on utilise `options=keyValues` et renvoie les données contextuelles d'une entité individuelle. -
show/hide example - ```json - { + - `streetNr[string]`: Numéro identifiant une propriété spécifique sur une rue publique +- `alternateName[string]`: Un nom alternatif pour cet article +- `annotations[array]`: Annotations sur l'article . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: La zone géographique où un service ou un article offert est fourni . Model: [https://schema.org/Text](https://schema.org/Text) +- `brandName[string]`: Nom de la marque du véhicule . Model: [https://schema.org/brand](https://schema.org/brand) +- `cargoVolume[number]`: Le volume disponible pour les marchandises ou les bagages. Pour les automobiles, il s'agit généralement du volume du coffre. Si une seule valeur est fournie (type Nombre), elle fera référence au volume maximum . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) +- `color[string]`: La couleur du produit . Model: [https://schema.org/color](https://schema.org/color) +- `dataProvider[string]`: Une séquence de caractères identifiant le fournisseur de l'entité de données harmonisées +- `dateCreated[date-time]`: Horodatage de création d'entité. Celui-ci sera généralement alloué par la plateforme de stockage +- `dateModified[date-time]`: Horodatage de la dernière modification de l'entité. Ceci sera généralement alloué par la plateforme de stockage +- `depth[number]`: Profondeur du véhicule . Model: [https://schema.org/depth](https://schema.org/depth) +- `description[string]`: Une description de cet article +- `fuelConsumption[number]`: La quantité de carburant consommée pour parcourir une distance ou une durée temporelle particulière avec le véhicule donné (par exemple, litres par 100 km) . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) +- `fuelType[string]`: Le type de carburant adapté au moteur ou aux moteurs du véhicule. Enum:'autogaz, biodiesel, éthanol, gnc, diesel, électrique, essence, hybride électrique/diesel, hybride électrique/essence, hydrogène, gpl, essence, essence(sans plomb), essence(avec plomb), autre' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `height[number]`: Hauteur du véhicule . Model: [https://schema.org/height](https://schema.org/height) +- `id[*]`: Identifiant unique de l'entité +- `image[uri]`: Une image de l'objet . Model: [https://schema.org/URL](https://schema.org/URL) +- `location[*]`: Référence Geojson de l'élément. Il peut s'agir d'un Point, LineString, Polygon, MultiPoint, MultiLineString ou MultiPolygon +- `manufacturerName[string]`: Nom du fabricant du véhicule . Model: [https://schema.org/Text](https://schema.org/Text) +- `modelName[string]`: Nom du modèle du véhicule . Model: [https://schema.org/model](https://schema.org/model) +- `name[string]`: Le nom de cet article +- `owner[array]`: Une liste contenant une séquence de caractères codée en JSON faisant référence aux Ids uniques du ou des propriétaires +- `seeAlso[*]`: Liste d'uri pointant vers des ressources supplémentaires sur l'élément +- `source[string]`: Une séquence de caractères indiquant la source d'origine des données de l'entité sous forme d'URL. Il est recommandé d'utiliser le nom de domaine pleinement qualifié du fournisseur de la source ou l'URL de l'objet source. +- `type[string]`: Type d'entité NGSI. Il doit s'agir de VehicleModel +- `url[uri]`: URL qui fournit une description de ce modèle de véhicule . Model: [https://schema.org/URL](https://schema.org/URL) +- `vehicleEngine[string]`: Informations sur le moteur ou les moteurs du véhicule . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) +- `vehicleModelDate[date-time]`: La date de sortie d'un modèle de véhicule (souvent utilisée pour différencier les versions du même fabricant et modèle) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) +- `vehicleType[string]`: Type de véhicule du point de vue de ses caractéristiques structurelles. Ceci est différent de la catégorie de véhicule. Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. Les valeurs suivantes sont définies par _VehicleTypeEnum_ et _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) +- `weight[number]`: Poids du véhicule . Model: [https://schema.org/weigth](https://schema.org/weigth) +- `width[number]`: Largeur du véhicule . Model: [https://schema.org/width](https://schema.org/width) + + + + + +Propriétés requises +- `nomDeMarque` +- `id` +- `nomDuFabricant` +- `nomDeModèle` +- `nom` +- `type` +- `typeDeVéhicule` + + + + + + + + + +## Description du modèle de données des propriétés + +Classé par ordre alphabétique (cliquez pour plus de détails) + + + + +
full yaml details + +```yaml +VehicleModel: + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. + 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: + description: Eventy element in the annotations + type: string + x-ngsi: + type: Property + 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 + brandName: + description: Vehicle's brand name + type: string + x-ngsi: + model: https://schema.org/brand + type: Property + cargoVolume: + description: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/cargoVolume + type: Property + units: Liters + 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 + depth: + description: Vehicle's depth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/depth + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + fuelConsumption: + description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/fuelConsumption + type: Property + units: liters per 100 kilometer + fuelType: + description: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' + enum: + - autogas + - biodiesel + - cng + - diesel + - electric + - ethanol + - gasoline + - hybrid_electric_diesel + - hybrid_electric_petrol + - hydrogen + - lpg + - petrol + - petrol(unleaded) + - petrol(leaded) + - other + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + height: + description: Vehicle's height + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/height + 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: Relationship + image: + description: An image of the item + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + manufacturerName: + description: Vehicle's manufacturer name + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + modelName: + description: Vehicle's model name + type: string + x-ngsi: + model: https://schema.org/model + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI Entity type. It has to be VehicleModel + enum: + - VehicleModel + type: string + x-ngsi: + type: Property + url: + description: URL which provides a description of this vehicle model + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + vehicleEngine: + description: Information about the engine or engines of the vehicle + type: string + x-ngsi: + model: https://schema.org/vehicleEngine + type: Property + vehicleModelDate: + description: The release date of a vehicle model (often used to differentiate versions of the same make and model) + format: date-time + type: string + x-ngsi: + model: https://schema.org/vehicleModelDate + type: Property + vehicleType: + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) + enum: + - agriculturalVehicle + - bicycle + - binTrolley + - bus + - car + - caravan + - carWithCaravan + - carWithTrailer + - cleaningTrolley + - constructionOrMaintenanceVehicle + - lorry + - minibus + - moped + - motorcycle + - motorcycleWithSideCar + - motorscooter + - sweepingMachine + - tanker + - trailer + - tram + - van + - trolley + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + weight: + description: Vehicle's weigth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/weigth + type: Property + width: + description: Vehicle's width + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/width + type: Property + required: + - id + - name + - type + - vehicleType + - brandName + - modelName + - manufacturerName + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json + x-model-tags: '' + x-version: 0.0.2 +``` +
+ + + + + + + + + +## Exemples de charges utiles + +#### Modèle de véhicule Exemple de valeurs clés NGSI-v2 + +Voici un exemple de VehicleModel au format JSON sous forme de paires clé-valeur. Ceci est compatible avec NGSI-v2 lors de l'utilisation de `options=keyValues` et renvoie les données de contexte d'une entité individuelle. +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": "MBenz-Econic2014", @@ -547,12 +660,16 @@ VehicleModel: "fuelType": "diesel" } ``` -
- #### VehicleModel NGSI-v2 normalisé Exemple - Voici un exemple de modèle de véhicule au format JSON-LD tel qu'il a été normalisé. Ce format est compatible avec les NGSI-v2 lorsqu'il n'utilise pas d'options et renvoie les données contextuelles d'une entité individuelle. -
show/hide example - ```json - { +
+ +#### Modèle de véhicule NGSI-v2 normalisé Exemple + +Voici un exemple de VehicleModel au format JSON normalisé. Ceci est compatible avec NGSI-v2 lorsqu'il n'utilise pas d'options et retourne les données de contexte d'une entité individuelle. +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": { @@ -585,12 +702,16 @@ VehicleModel: } } ``` -
- #### VehicleModel Valeurs clés de l'INS-LD Exemple - Voici un exemple de modèle de véhicule au format JSON-LD en tant que valeurs clés. Ceci est compatible avec NGSI-LD lorsque l'on utilise `options=keyValues` et renvoie les données contextuelles d'une entité individuelle. -
show/hide example - ```json - { +
+ +#### Exemple de valeurs clés VehicleModel NGSI-LD + +Voici un exemple de VehicleModel au format JSON-LD sous forme de paires clé-valeur. Ceci est compatible avec NGSI-LD lors de l'utilisation de `options=keyValues` et retourne les données de contexte d'une entité individuelle. +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": "Mercedes Benz", @@ -606,12 +727,16 @@ VehicleModel: ] } ``` -
- #### Modèle de véhicule NGSI-LD normalisé Exemple - Voici un exemple de modèle de véhicule au format JSON-LD normalisé. Ce format est compatible avec NGSI-LD lorsqu'il n'utilise pas d'options et renvoie les données contextuelles d'une entité individuelle. -
show/hide example - ```json - { +
+ +#### Modèle de véhicule NGSI-LD exemple normalisé + +Voici un exemple d'un VehicleModel au format JSON-LD normalisé. Ceci est compatible avec NGSI-LD lorsqu'il n'utilise pas d'options et retourne les données de contexte d'une entité individuelle. +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": { @@ -648,12 +773,21 @@ VehicleModel: ] } ``` -
- - - - Voir [FAQ 10] (https://smartdatamodels.org/index.php/faqs/) pour obtenir une réponse à la question de savoir comment traiter les unités de magnitude. - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/VehicleModel/doc/spec_IT.md b/VehicleModel/doc/spec_IT.md index c75108cc4..ddd16a1f5 100644 --- a/VehicleModel/doc/spec_IT.md +++ b/VehicleModel/doc/spec_IT.md @@ -1,541 +1,654 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entità: Modello di veicolo -========================== - - [Licenza aperta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/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: **Questa entità modella un particolare modello di veicolo, comprese tutte le proprietà che sono comuni a più istanze di veicoli appartenenti a tale modello.** - versione: 0.0.1 - - - ## 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) + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +Entità: VehicleModel +==================== + + + + + +[Licenza aperta](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/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) + + + + + +Global description: **Questa entità modella un particolare modello di veicolo, comprese tutte le proprietà che sono comuni a più istanze di veicoli appartenenti a tale modello.** + +version: 0.0.2 + + + + + + +## Elenco delle proprietà + + +[*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o formati/modello diversi +- `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 di via, 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. + - `district[string]`: Un distretto è un tipo di divisione amministrativa che, in alcuni paesi, è gestito 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) - `brandName[string]`: Marchio del veicolo . Model: [https://schema.org/brand](https://schema.org/brand) - `cargoVolume[number]`: Il volume disponibile per il carico o i bagagli. Per le automobili, di solito si tratta del volume del bagagliaio. Se viene fornito un solo valore (tipo Numero), questo si riferisce al volume massimo. . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) - `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 - `depth[number]`: Profondità del veicolo . Model: [https://schema.org/depth](https://schema.org/depth) - `description[string]`: Descrizione dell'articolo - `fuelConsumption[number]`: La quantità di carburante consumata per percorrere una determinata distanza o durata temporale con il veicolo in questione (ad esempio, litri per 100 km). . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) - `fuelType[string]`: Il tipo di carburante adatto al motore o ai motori del veicolo. Enum:'autogas, biodiesel, etanolo, cng, diesel, elettrico, benzina, ibrido elettrico/gasolio, ibrido elettrico/benzina, idrogeno, gpl, benzina, benzina (senza piombo), benzina (con piombo), altro'. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `height[number]`: Altezza del veicolo . Model: [https://schema.org/height](https://schema.org/height) - `id[*]`: Identificatore univoco dell'entità - `image[uri]`: Un'immagine dell'articolo . Model: [https://schema.org/URL](https://schema.org/URL) - `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. - `manufacturerName[string]`: Nome del costruttore del veicolo . Model: [https://schema.org/Text](https://schema.org/Text) - `modelName[string]`: Nome del modello del veicolo . Model: [https://schema.org/model](https://schema.org/model) - `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. - `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. - `type[string]`: Tipo di entità NGSI. Deve essere VehicleModel - `url[uri]`: URL che fornisce una descrizione di questo modello di veicolo . Model: [https://schema.org/URL](https://schema.org/URL) - `vehicleEngine[string]`: Informazioni sul motore o sui motori del veicolo . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) - `vehicleModelDate[date-time]`: La data di uscita di un modello di veicolo (spesso utilizzata per differenziare le versioni della stessa marca e dello stesso modello) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) - `vehicleType[string]`: Tipo di veicolo dal punto di vista delle sue caratteristiche strutturali. È diverso dalla categoria del veicolo. Enum:'veicolo agricolo, qualsiasi veicolo, veicolo articolato, bicicletta, carrello portarifiuti, autobus, automobile, roulotte, autovettura o veicolo leggero, autovettura con roulotte, autovettura con rimorchio, carrello per le pulizie, veicolo da costruzione o manutenzione, quattro ruote motrici, veicolo a ruote alte, autocarro, minibus, ciclomotore, motocicletta, motociclo con auto laterale, motoscooter, macchina spazzatrice, autocisterna, veicolo a tre ruote, rimorchio, tram, veicolo a due ruote, carrello, furgone, veicolo senza convertitore catalitico, veicolo con roulotte, veicolo con rimorchio, con targhe pari, con targhe dispari, altro". I seguenti valori definiti da _VehicleTypeEnum_ e _VehicleTypeEnum2_, [DATEX 2 versione 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) - `weight[number]`: Peso del veicolo . Model: [https://schema.org/weigth](https://schema.org/weigth) - `width[number]`: Larghezza del veicolo . Model: [https://schema.org/width](https://schema.org/width) - - Proprietà richieste -- `brandName` - `id` - `manufacturerName` - `modelName` - `name` - `type` - `vehicleType` - - - - ## Modello di dati descrizione delle proprietà - Ordinati in ordine alfabetico (clicca per i dettagli) - - -
full yaml details - ```yaml -VehicleModel: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' - 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 - brandName: - description: Vehicle's brand name - type: string - x-ngsi: - model: https://schema.org/brand - type: Property - cargoVolume: - description: 'The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume' - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/cargoVolume - type: Property - units: Liters - 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 - depth: - description: Vehicle's depth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/depth - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - fuelConsumption: - description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/fuelConsumption - type: Property - units: liters per 100 kilometer - fuelType: - description: 'The type of fuel suitable for the engine or engines of the vehicle. Enum:''autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other''' - enum: - - autogas - - biodiesel - - cng - - diesel - - electric - - ethanol - - gasoline - - hybrid_electric_diesel - - hybrid_electric_petrol - - hydrogen - - lpg - - petrol - - petrol(unleaded) - - petrol(leaded) - - other - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - height: - description: Vehicle's height - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/height - 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 - 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 - manufacturerName: - description: Vehicle's manufacturer name - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - modelName: - description: Vehicle's model name - type: string - x-ngsi: - model: https://schema.org/model - type: Property - 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 - 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 - type: - description: NGSI Entity type. It has to be VehicleModel - enum: - - VehicleModel - type: string - x-ngsi: - type: Property - url: - description: URL which provides a description of this vehicle model - format: uri - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - vehicleEngine: - description: Information about the engine or engines of the vehicle - type: string - x-ngsi: - model: https://schema.org/vehicleEngine - type: Property - vehicleModelDate: - description: The release date of a vehicle model (often used to differentiate versions of the same make and model) - format: date-time - type: string - x-ngsi: - model: https://schema.org/vehicleModelDate - type: Property - vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)' - enum: - - agriculturalVehicle - - bicycle - - binTrolley - - bus - - car - - caravan - - carWithCaravan - - carWithTrailer - - cleaningTrolley - - constructionOrMaintenanceVehicle - - lorry - - minibus - - moped - - motorcycle - - motorcycleWithSideCar - - motorscooter - - sweepingMachine - - tanker - - trailer - - tram - - van - - trolley - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - weight: - description: Vehicle's weigth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/weigth - type: Property - width: - description: Vehicle's width - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/width - type: Property - required: - - id - - name - - type - - vehicleType - - brandName - - modelName - - manufacturerName - 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.Transportation/blob/master/VehicleModel/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json - x-model-tags: "" - x-version: 0.0.1 -``` -
- - - - - ## Esempi di payload - #### Modello di veicolo NGSI-v2 valori-chiave Esempio - Ecco un esempio di un modello di veicolo 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 - { + - `streetAddress[string]`: L'indirizzo di via . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Numero che identifica una proprietà specifica in una strada pubblica +- `alternateName[string]`: Un nome alternativo per questo elemento +- `annotations[array]`: Annotazioni sull'articolo . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: L'area geografica in cui viene fornito un servizio o un articolo offerto . Model: [https://schema.org/Text](https://schema.org/Text) +- `brandName[string]`: Nome del marchio del veicolo . Model: [https://schema.org/brand](https://schema.org/brand) +- `cargoVolume[number]`: Il volume disponibile per il carico o i bagagli. Per le automobili, si tratta solitamente del volume del bagagliaio. Se viene fornito solo un valore (tipo Numero) si riferirà al volume massimo . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) +- `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 armonizzati +- `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 verrà solitamente assegnato dalla piattaforma di archiviazione +- `depth[number]`: Profondità del veicolo . Model: [https://schema.org/depth](https://schema.org/depth) +- `description[string]`: Una descrizione di questo articolo +- `fuelConsumption[number]`: La quantità di carburante consumato per percorrere una determinata distanza o durata temporale con il veicolo dato (ad esempio litri per 100 km) . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) +- `fuelType[string]`: Il tipo di carburante adatto al motore o ai motori del veicolo. Enum: 'autogas, biodiesel, etanolo, cng, diesel, elettrico, benzina, ibrido elettrico/diesel, ibrido elettrico/benzina, idrogeno, gpl, benzina, benzina(senza piombo), benzina(con piombo), altro' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `height[number]`: Altezza del veicolo . Model: [https://schema.org/height](https://schema.org/height) +- `id[*]`: Identificatore univoco dell'entità +- `image[uri]`: Un'immagine dell'oggetto . Model: [https://schema.org/URL](https://schema.org/URL) +- `location[*]`: Riferimento Geojson all'elemento. Può essere Punto, LineString, Poligono, MultiPunto, MultiLineString o MultiPoligono +- `manufacturerName[string]`: Nome del produttore del veicolo . Model: [https://schema.org/Text](https://schema.org/Text) +- `modelName[string]`: Nome del modello del veicolo . Model: [https://schema.org/model](https://schema.org/model) +- `name[string]`: Il nome di questo elemento +- `owner[array]`: Una lista contenente una sequenza di caratteri codificata in JSON che fa riferimento agli Id univoci del/dei proprietario/i +- `seeAlso[*]`: Elenco di uri che puntano a risorse aggiuntive sull'elemento +- `source[string]`: Una sequenza di caratteri che fornisce la fonte originale dei dati dell'entità come URL. Si consiglia di utilizzare il nome di dominio completamente qualificato del fornitore di origine o l'URL dell'oggetto di origine +- `type[string]`: Tipo di entità NGSI. Deve essere VehicleModel +- `url[uri]`: URL che fornisce una descrizione di questo modello di veicolo . Model: [https://schema.org/URL](https://schema.org/URL) +- `vehicleEngine[string]`: Informazioni sul motore o sui motori del veicolo . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) +- `vehicleModelDate[date-time]`: La data di rilascio di un modello di veicolo (spesso utilizzato per differenziare le versioni dello stesso marchio e modello) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) +- `vehicleType[string]`: Tipo di veicolo dal punto di vista delle sue caratteristiche strutturali. Questo è diverso dalla categoria di veicolo. Enum: 'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. I seguenti valori definiti da _VehicleTypeEnum_ e _VehicleTypeEnum2_, [DATEX 2 versione 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) +- `weight[number]`: Peso del veicolo . Model: [https://schema.org/weigth](https://schema.org/weigth) +- `width[number]`: Larghezza del veicolo . Model: [https://schema.org/width](https://schema.org/width) + + + + + +Proprietà richieste +- `nomeMarchio` +- `id` +- `nomeDelFabricante` +- `nomeModello` +- `nome` +- `tipo` +- `tipoDiVeicolo` + + + + + + + + + +## Descrizione del modello di dati delle proprietà + +Ordinati in ordine alfabetico (clicca per i dettagli) + + + + +
full yaml details + +```yaml +VehicleModel: + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. + 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: + description: Eventy element in the annotations + type: string + x-ngsi: + type: Property + 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 + brandName: + description: Vehicle's brand name + type: string + x-ngsi: + model: https://schema.org/brand + type: Property + cargoVolume: + description: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/cargoVolume + type: Property + units: Liters + 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 + depth: + description: Vehicle's depth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/depth + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + fuelConsumption: + description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/fuelConsumption + type: Property + units: liters per 100 kilometer + fuelType: + description: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' + enum: + - autogas + - biodiesel + - cng + - diesel + - electric + - ethanol + - gasoline + - hybrid_electric_diesel + - hybrid_electric_petrol + - hydrogen + - lpg + - petrol + - petrol(unleaded) + - petrol(leaded) + - other + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + height: + description: Vehicle's height + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/height + 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: Relationship + image: + description: An image of the item + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + manufacturerName: + description: Vehicle's manufacturer name + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + modelName: + description: Vehicle's model name + type: string + x-ngsi: + model: https://schema.org/model + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI Entity type. It has to be VehicleModel + enum: + - VehicleModel + type: string + x-ngsi: + type: Property + url: + description: URL which provides a description of this vehicle model + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + vehicleEngine: + description: Information about the engine or engines of the vehicle + type: string + x-ngsi: + model: https://schema.org/vehicleEngine + type: Property + vehicleModelDate: + description: The release date of a vehicle model (often used to differentiate versions of the same make and model) + format: date-time + type: string + x-ngsi: + model: https://schema.org/vehicleModelDate + type: Property + vehicleType: + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) + enum: + - agriculturalVehicle + - bicycle + - binTrolley + - bus + - car + - caravan + - carWithCaravan + - carWithTrailer + - cleaningTrolley + - constructionOrMaintenanceVehicle + - lorry + - minibus + - moped + - motorcycle + - motorcycleWithSideCar + - motorscooter + - sweepingMachine + - tanker + - trailer + - tram + - van + - trolley + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + weight: + description: Vehicle's weigth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/weigth + type: Property + width: + description: Vehicle's width + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/width + type: Property + required: + - id + - name + - type + - vehicleType + - brandName + - modelName + - manufacturerName + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json + x-model-tags: '' + x-version: 0.0.2 +``` +
+ + + + + + + + + +## Esempi di payload + +#### ModelloVeicolo esempio di valori chiave NGSI-v2 + +Ecco un esempio di VehicleModel in formato JSON come chiavi-valori. Ciò è compatibile con NGSI-v2 quando si utilizza `options=keyValues` e restituisce i dati di contesto di un'entità individuale. +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": "MBenz-Econic2014", @@ -547,12 +660,16 @@ VehicleModel: "fuelType": "diesel" } ``` -
- #### Modello di veicolo NGSI-v2 normalizzato Esempio - Ecco un esempio di modello di veicolo in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si usano le opzioni e restituisce i dati di contesto di una singola entità. -
show/hide example - ```json - { +
+ +#### ModelloVeicolo Esempio normalizzato NGSI-v2 + +Ecco un esempio di VehicleModel in formato JSON come normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano opzioni e restituisce i dati di contesto di un'entità individuale. +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": { @@ -585,12 +702,16 @@ VehicleModel: } } ``` -
- #### Modello di veicolo Valori chiave NGSI-LD Esempio - Ecco un esempio di un modello di veicolo 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 - { +
+ +#### ModelloVeicolo chiavi-valori esempio NGSI-LD + +Ecco un esempio di VehicleModel in formato JSON-LD come chiavi-valori. Ciò è compatibile con NGSI-LD quando si utilizza `options=keyValues` e restituisce i dati di contesto di un'entità individuale. +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": "Mercedes Benz", @@ -606,12 +727,16 @@ VehicleModel: ] } ``` -
- #### Modello del veicolo NGSI-LD normalizzato Esempio - Ecco un esempio di modello di veicolo in formato JSON-LD normalizzato. Questo è compatibile con NGSI-LD quando non si usano opzioni e restituisce i dati di contesto di una singola entità. -
show/hide example - ```json - { +
+ +#### ModelloVeicolo Esempio normalizzato NGSI-LD + +Ecco un esempio di VehicleModel in formato JSON-LD normalizzato, compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati di contesto di un'entità individuale. +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": { @@ -648,12 +773,21 @@ VehicleModel: ] } ``` -
- - - - 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) +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/VehicleModel/doc/spec_JA.md b/VehicleModel/doc/spec_JA.md index d36c8b532..95b6875c0 100644 --- a/VehicleModel/doc/spec_JA.md +++ b/VehicleModel/doc/spec_JA.md @@ -1,541 +1,654 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - エンティティ車両モデル -=========== - - [オープン・ライセンス](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) - [文書は自動的に生成される](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) - - - グローバルな記述：**このエンティティは、そのようなモデルに属する複数の車両インスタンスに共通するすべてのプロパティを含む、特定の車両モデルをモデル化する。 - バージョン: 0.0.1 - - - ## プロパティのリスト - [*] 属性に型がない場合は、複数の型があるか、異なるフォーマット/パターンがある可能性があるためです。 -- `address[object]`: 郵送先住所 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国。例えば、スペイン . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 番地がある地域と、その地域に含まれる地域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: その地域がある地域、またその国がある地域 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: 地区とは行政区画の一種で、国によっては地方自治体によって管理されている。 - - `postOfficeBoxNumber[string]`: 私書箱の住所のための私書箱番号。例：03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: 郵便番号。例：24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: 番地 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: この項目の別名 - `annotations[array]`: アイテムに関する注釈 . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: サービスまたは提供品が提供される地理的地域 . Model: [https://schema.org/Text](https://schema.org/Text) - `brandName[string]`: 車のブランド名 . Model: [https://schema.org/brand](https://schema.org/brand) - `cargoVolume[number]`: 貨物や荷物のために利用できる容積。自動車の場合、これは通常トランクの容積である。単一の値のみが指定された場合（Number型）、それは最大容積を指す。 . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) - `color[string]`: 製品の色 . Model: [https://schema.org/color](https://schema.org/color) - `dataProvider[string]`: ハーモナイズされたデータ・エンティティの提供者を識別する一連の文字。 - `dateCreated[date-time]`: エンティティの作成タイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられます。 - `dateModified[date-time]`: エンティティの最終変更のタイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられる。 - `depth[number]`: 車体の奥行き . Model: [https://schema.org/depth](https://schema.org/depth) - `description[string]`: この商品の説明 - `fuelConsumption[number]`: 指定された車両で特定の距離または時間を走行する際に消費される燃料の量（例：100km走行あたりリットル）。 . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) - `fuelType[string]`: 車両のエンジンに適した燃料の種類。Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other'. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `height[number]`: 車高 . Model: [https://schema.org/height](https://schema.org/height) - `id[*]`: エンティティの一意識別子 - `image[uri]`: 商品の画像 . Model: [https://schema.org/URL](https://schema.org/URL) - `location[*]`: アイテムへの Geojson 参照。Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon のいずれか。 - `manufacturerName[string]`: 自動車メーカー名 . Model: [https://schema.org/Text](https://schema.org/Text) - `modelName[string]`: 車種名 . Model: [https://schema.org/model](https://schema.org/model) - `name[string]`: このアイテムの名前 - `owner[array]`: 所有者の固有IDを参照するJSONエンコードされた文字列を含むリスト。 - `seeAlso[*]`: アイテムに関する追加リソースを指すURIのリスト - `source[string]`: エンティティ・データの元のソースを URL として示す一連の文字。ソース・プロバイダの完全修飾ドメイン名、またはソース・オブジェクトの URL を推奨する。 - `type[string]`: NGSI エンティティタイプ。これは VehicleModel でなければなりません。 - `url[uri]`: この車種の説明を提供するURL . Model: [https://schema.org/URL](https://schema.org/URL) - `vehicleEngine[string]`: エンジンに関する情報 . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) - `vehicleModelDate[date-time]`: 自動車モデルの発売日（同じメーカーやモデルのバージョンを区別するために使用されることが多い） . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) - `vehicleType[string]`: 車両の構造的特徴から見た車両のタイプ。これは車両カテゴリーとは異なる。列挙する：agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle、motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'.VehicleTypeEnum_および_VehicleTypeEnum2_、[DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)で定義される以下の値。 . Model: [https://schema.org/Text](https://schema.org/Text) - `weight[number]`: 車両重量 . Model: [https://schema.org/weigth](https://schema.org/weigth) - `width[number]`: 車幅 . Model: [https://schema.org/width](https://schema.org/width) - - 必須プロパティ -- `brandName` - `id` - `manufacturerName` - `modelName` - `name` - `type` - `vehicleType` - - - - ## プロパティのデータモデル記述 - アルファベット順（クリックで詳細表示） - - -
full yaml details - ```yaml -VehicleModel: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' - 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 - brandName: - description: Vehicle's brand name - type: string - x-ngsi: - model: https://schema.org/brand - type: Property - cargoVolume: - description: 'The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume' - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/cargoVolume - type: Property - units: Liters - 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 - depth: - description: Vehicle's depth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/depth - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - fuelConsumption: - description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/fuelConsumption - type: Property - units: liters per 100 kilometer - fuelType: - description: 'The type of fuel suitable for the engine or engines of the vehicle. Enum:''autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other''' - enum: - - autogas - - biodiesel - - cng - - diesel - - electric - - ethanol - - gasoline - - hybrid_electric_diesel - - hybrid_electric_petrol - - hydrogen - - lpg - - petrol - - petrol(unleaded) - - petrol(leaded) - - other - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - height: - description: Vehicle's height - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/height - 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 - 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 - manufacturerName: - description: Vehicle's manufacturer name - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - modelName: - description: Vehicle's model name - type: string - x-ngsi: - model: https://schema.org/model - type: Property - 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 - 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 - type: - description: NGSI Entity type. It has to be VehicleModel - enum: - - VehicleModel - type: string - x-ngsi: - type: Property - url: - description: URL which provides a description of this vehicle model - format: uri - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - vehicleEngine: - description: Information about the engine or engines of the vehicle - type: string - x-ngsi: - model: https://schema.org/vehicleEngine - type: Property - vehicleModelDate: - description: The release date of a vehicle model (often used to differentiate versions of the same make and model) - format: date-time - type: string - x-ngsi: - model: https://schema.org/vehicleModelDate - type: Property - vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)' - enum: - - agriculturalVehicle - - bicycle - - binTrolley - - bus - - car - - caravan - - carWithCaravan - - carWithTrailer - - cleaningTrolley - - constructionOrMaintenanceVehicle - - lorry - - minibus - - moped - - motorcycle - - motorcycleWithSideCar - - motorscooter - - sweepingMachine - - tanker - - trailer - - tram - - van - - trolley - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - weight: - description: Vehicle's weigth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/weigth - type: Property - width: - description: Vehicle's width - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/width - type: Property - required: - - id - - name - - type - - vehicleType - - brandName - - modelName - - manufacturerName - 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.Transportation/blob/master/VehicleModel/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json - x-model-tags: "" - x-version: 0.0.1 -``` -
- - - - - ## ペイロードの例 - #### VehicleModel NGSI-v2 キー値の例 - 以下はVehicleModelをJSON-LD形式でkey-valuesとした例です。これは NGSI-v2 と互換性があり、`options=keyValues` を使用すると、個々のエンティティのコンテキストデータを返します。 -
show/hide example - ```json - { + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +実体: VehicleModel +==================== + + + + + +[オープンライセンス](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) + +[自動生成された文書](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) + + + + + +Global description: **このエンティティは、特定の車両モデルをモデル化し、そのようなモデルに属する複数の車両インスタンスに共通するすべてのプロパティを含む。** + +version: 0.0.2 + + + + + + +## プロパティの一覧 + + +[*] 属性に型がないのは、それが複数の型や異なる形式/パターンを持つ可能性があるためです。 +- `address[object]`: 郵送先住所 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: その国。例えば、スペイン . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 住所が存在する地域、およびその地域が存在する地域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: その地域は、自治体が存在し、かつその国に位置する地域です。 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 地区は、行政区画の一種であり、一部の国では地方自治体によって管理される + - `postOfficeBoxNumber[string]`: ポストオフィスボックス番号は、ポストオフィスボックス住所の場合。たとえば、03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 郵便番号。例えば、24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 住所 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 公道上の特定の物件を識別する番号 +- `alternateName[string]`: このアイテムの別名 +- `annotations[array]`: アイテムに関する注釈 . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: サービスまたは提供されるアイテムが提供される地理的な地域 . Model: [https://schema.org/Text](https://schema.org/Text) +- `brandName[string]`: 車のブランド名 . Model: [https://schema.org/brand](https://schema.org/brand) +- `cargoVolume[number]`: 貨物または手荷物のために利用可能な容積。自動車の場合、これは通常トランクの容積です。単一の値のみが提供される場合（タイプ Number）は、最大容積を参照します。 . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) +- `color[string]`: 製品の色 . Model: [https://schema.org/color](https://schema.org/color) +- `dataProvider[string]`: 調和データエンティティの提供者を識別する文字列のシーケンス +- `dateCreated[date-time]`: エンティティ作成タイムスタンプ。このタイムスタンプは通常、ストレージプラットフォームによって割り当てられる +- `dateModified[date-time]`: エンティティの最後の変更のタイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられます。 +- `depth[number]`: 車両の深さ . Model: [https://schema.org/depth](https://schema.org/depth) +- `description[string]`: このアイテムの説明 +- `fuelConsumption[number]`: 特定の距離または時間間隔を移動するために与えられた車両（例：100kmあたりのリットル）で消費される燃料の量 . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) +- `fuelType[string]`: 車両のエンジンまたはエンジンに適した燃料の種類。 Enum:'オートガス、バイオディーゼル、エタノール、CNG、ディーゼル、電気、ガソリン、ハイブリッド電気/ディーゼル、ハイブリッド電気/ガソリン、水素、LPG、ガソリン、無鉛ガソリン、有鉛ガソリン、その他' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `height[number]`: 車両の高さ . Model: [https://schema.org/height](https://schema.org/height) +- `id[*]`: エンティティの固有識別子 +- `image[uri]`: アイテムの画像 . Model: [https://schema.org/URL](https://schema.org/URL) +- `location[*]`: アイテムへのGeojson参照。Point、LineString、Polygon、MultiPoint、MultiLineString、またはMultiPolygonのいずれかになります。 +- `manufacturerName[string]`: 車の製造元名 . Model: [https://schema.org/Text](https://schema.org/Text) +- `modelName[string]`: 車のモデル名 . Model: [https://schema.org/model](https://schema.org/model) +- `name[string]`: このアイテムの名前 +- `owner[array]`: 所有者のユニークIDを参照する文字シーケンスのJSONエンコードされたシーケンスを含むリスト +- `seeAlso[*]`: アイテムに関する追加のリソースを指すURIのリスト +- `source[string]`: エンティティデータの元の情報源をURLとして表す文字列のシーケンス。情報源プロバイダーの完全修飾ドメイン名、または情報源オブジェクトへのURLであることが推奨される。 +- `type[string]`: NGSIエンティティタイプ。VehicleModelでなければなりません。 +- `url[uri]`: この車両モデルについての説明を提供するURL . Model: [https://schema.org/URL](https://schema.org/URL) +- `vehicleEngine[string]`: 車両のエンジンまたはエンジンの情報 . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) +- `vehicleModelDate[date-time]`: 自動車のモデル（同一メーカー・同一モデルのバージョンを区別するためによく使用される）発売日 . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) +- `vehicleType[string]`: 車両の構造的特性からの車両の種類。これは、車両カテゴリとは異なる。列挙型：'農業車両、任意の車両、連節車両、自転車、ごみ収集トロリー、バス、乗用車、キャラバン、乗用車または軽車両、キャラバン付車両、トレーラー付車両、清掃トロリー、建設またはメンテナンス車両、四輪駆動車、高床車、トラック、ミニバス、原動機付自転車、オートバイ、サイドカー付オートバイ、モペッド、清掃機、タンカー、三輪車、トレーラー、路面電車、สอง輪車、トロリー、バン、触媒コンバータなし車両、キャラバン付車両、トレーラー付車両、偶数のナンバープレート、奇数のナンバープレート、その他'。以下の値は、_VehicleTypeEnum_および_VehicleTypeEnum2_によって定義され、[DATEX 2バージョン2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)によって参照される。 . Model: [https://schema.org/Text](https://schema.org/Text) +- `weight[number]`: 車両重量 . Model: [https://schema.org/weigth](https://schema.org/weigth) +- `width[number]`: 車両の幅 . Model: [https://schema.org/width](https://schema.org/width) + + + + + +必須プロパティ +- `ブランド名` +- `ID` +- `manufacturerName` → メーカー名 +- `モデル名` +- `名前` +- `タイプ` +- `車両タイプ` + + + + + + + + + +## データモデルのプロパティの説明 + +アルファベット順に並べ替え（詳細） + + + + +
full yaml details + +```yaml +VehicleModel: + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. + 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: + description: Eventy element in the annotations + type: string + x-ngsi: + type: Property + 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 + brandName: + description: Vehicle's brand name + type: string + x-ngsi: + model: https://schema.org/brand + type: Property + cargoVolume: + description: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/cargoVolume + type: Property + units: Liters + 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 + depth: + description: Vehicle's depth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/depth + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + fuelConsumption: + description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/fuelConsumption + type: Property + units: liters per 100 kilometer + fuelType: + description: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' + enum: + - autogas + - biodiesel + - cng + - diesel + - electric + - ethanol + - gasoline + - hybrid_electric_diesel + - hybrid_electric_petrol + - hydrogen + - lpg + - petrol + - petrol(unleaded) + - petrol(leaded) + - other + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + height: + description: Vehicle's height + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/height + 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: Relationship + image: + description: An image of the item + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + manufacturerName: + description: Vehicle's manufacturer name + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + modelName: + description: Vehicle's model name + type: string + x-ngsi: + model: https://schema.org/model + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI Entity type. It has to be VehicleModel + enum: + - VehicleModel + type: string + x-ngsi: + type: Property + url: + description: URL which provides a description of this vehicle model + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + vehicleEngine: + description: Information about the engine or engines of the vehicle + type: string + x-ngsi: + model: https://schema.org/vehicleEngine + type: Property + vehicleModelDate: + description: The release date of a vehicle model (often used to differentiate versions of the same make and model) + format: date-time + type: string + x-ngsi: + model: https://schema.org/vehicleModelDate + type: Property + vehicleType: + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) + enum: + - agriculturalVehicle + - bicycle + - binTrolley + - bus + - car + - caravan + - carWithCaravan + - carWithTrailer + - cleaningTrolley + - constructionOrMaintenanceVehicle + - lorry + - minibus + - moped + - motorcycle + - motorcycleWithSideCar + - motorscooter + - sweepingMachine + - tanker + - trailer + - tram + - van + - trolley + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + weight: + description: Vehicle's weigth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/weigth + type: Property + width: + description: Vehicle's width + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/width + type: Property + required: + - id + - name + - type + - vehicleType + - brandName + - modelName + - manufacturerName + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json + x-model-tags: '' + x-version: 0.0.2 +``` +
+ + + + + + + + + +## 例のペイロード + +#### VehicleModel NGSI-v2 キー値の例 + +ここでは、キーと値のペアとしてのJSON形式のVehicleModelの例を示します。これは、`options=keyValues`を使用してNGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": "MBenz-Econic2014", @@ -547,12 +660,16 @@ VehicleModel: "fuelType": "diesel" } ``` -
- #### 車両モデル NGSI-v2 正規化例 - 以下は正規化された JSON-LD フォーマットの VehicleModel の例です。これは、オプションを使用しない場合、NGSI-v2 と互換性があり、個々のエンティティのコンテキストデータを返します。 -
show/hide example - ```json - { +
+ +#### VehicleModel NGSI-v2 正規化例 + +ここでは、正規化されたJSON形式のVehicleModelの例を示します。これは、オプションを使用しない場合にNGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": { @@ -585,12 +702,16 @@ VehicleModel: } } ``` -
- #### VehicleModel NGSI-LD キー値の例 - 以下は、VehicleModel を JSON-LD フォーマットの key-values で表した例です。これは NGSI-LD と互換性があり、`options=keyValues` を使用すると、個々のエンティティのコンテキストデータを返します。 -
show/hide example - ```json - { +
+ +#### VehicleModel NGSI-LD キー値の例 + +ここでは、JSON-LD形式のキーワード値のVehicleModelの例を示します。これは、`options=keyValues`を使用してNGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": "Mercedes Benz", @@ -606,12 +727,16 @@ VehicleModel: ] } ``` -
- #### 車両モデル NGSI-LD 正規化例 - 以下は、正規化された JSON-LD フォーマットの VehicleModel の例です。これは、オプションを使用しない場合、NGSI-LD と互換性があり、個々のエンティティのコンテキストデータを返します。 -
show/hide example - ```json - { +
+ +#### VehicleModel NGSI-LD 正規化例 + +ここでは、正規化されたJSON-LD形式のVehicleModelの例を示します。これは、オプションを使用しない場合、NGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。 +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": { @@ -648,12 +773,21 @@ VehicleModel: ] } ``` -
- - - - マグニチュード単位の扱い方については、[FAQ 10](https://smartdatamodels.org/index.php/faqs/)を参照のこと。 - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/VehicleModel/doc/spec_KO.md b/VehicleModel/doc/spec_KO.md index 86f6c1b23..b44a91bdd 100644 --- a/VehicleModel/doc/spec_KO.md +++ b/VehicleModel/doc/spec_KO.md @@ -1,542 +1,654 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - 엔티티: 차량 모델 -========== - - [오픈 라이선스](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) - [문서 자동 생성](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) - - - 글로벌 설명: **이 엔터티는 해당 모델에 속한 여러 차량 인스턴스에 공통으로 적용되는 모든 속성을 포함하여 특정 차량 모델을 모델링합니다.** - 버전: 0.0.1 - - - ## 속성 목록 - [*] 속성에 유형이 없는 것은 여러 유형 또는 다른 형식/패턴을 가질 수 있기 때문입니다. -- `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 국가. 예를 들어, 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 도로명 주소가 있는 지역 및 해당 지역에 속한 지역 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: 해당 지역이 위치한 지역과 해당 국가의 지역 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: 지구는 일부 국가에서는 지방 정부에서 관리하는 행정 구역의 일종입니다. - - `postOfficeBoxNumber[string]`: 사서함 주소의 우체국 사서함 번호입니다. 예: 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: 우편 번호입니다. 예: 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: 거리 주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) - - `streetNr[string]`: 공공 도로의 특정 건물을 식별하는 번호 -- `alternateName[string]`: 이 항목의 대체 이름 - `annotations[array]`: 항목에 대한 주석 . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: 서비스 또는 제공 품목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) - `brandName[string]`: 차량의 브랜드 이름 . Model: [https://schema.org/brand](https://schema.org/brand) - `cargoVolume[number]`: 화물 또는 수하물에 사용할 수 있는 부피입니다. 자동차의 경우 일반적으로 트렁크 용량입니다. 단일 값만 제공된 경우(숫자 유형) 최대 볼륨을 참조합니다. . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) - `color[string]`: 제품의 색상 . Model: [https://schema.org/color](https://schema.org/color) - `dataProvider[string]`: 조화된 데이터 엔티티의 공급자를 식별하는 일련의 문자 - `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateModified[date-time]`: 엔티티의 마지막 수정 타임스탬프입니다. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `depth[number]`: 차량의 깊이 . Model: [https://schema.org/depth](https://schema.org/depth) - `description[string]`: 이 항목에 대한 설명 - `fuelConsumption[number]`: 지정된 차량으로 특정 거리 또는 시간 동안 이동하는 데 소비된 연료의 양(예: 100km당 리터) . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) - `fuelType[string]`: 차량의 엔진에 적합한 연료의 종류입니다. 열거형: '오토가스, 바이오디젤, 에탄올, CNG, 디젤, 전기, 가솔린, 하이브리드 전기/디젤, 하이브리드 전기/휘발유, 수소, LPG, 휘발유, 휘발유(무연), 휘발유(납), 기타' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `height[number]`: 차량 높이 . Model: [https://schema.org/height](https://schema.org/height) - `id[*]`: 엔티티의 고유 식별자 - `image[uri]`: 항목 이미지 . Model: [https://schema.org/URL](https://schema.org/URL) - `location[*]`: 항목에 대한 지오숀 참조입니다. 포인트, 라인 문자열, 다각형, 멀티포인트, 멀티라인 문자열 또는 멀티폴리곤일 수 있습니다. - `manufacturerName[string]`: 차량의 제조사 이름 . Model: [https://schema.org/Text](https://schema.org/Text) - `modelName[string]`: 차량 모델명 . Model: [https://schema.org/model](https://schema.org/model) - `name[string]`: 이 항목의 이름 - `owner[array]`: 소유자의 고유 ID를 참조하는 JSON 인코딩된 문자 시퀀스가 포함된 목록입니다. - `seeAlso[*]`: 항목에 대한 추가 리소스를 가리키는 URL 목록 - `source[string]`: 엔티티 데이터의 원본 소스를 URL로 제공하는 문자 시퀀스입니다. 소스 공급자의 정규화된 도메인 이름 또는 소스 개체에 대한 URL을 사용하는 것이 좋습니다. - `type[string]`: NGSI 엔티티 유형입니다. VehicleModel이어야 합니다. - `url[uri]`: 이 차량 모델에 대한 설명을 제공하는 URL . Model: [https://schema.org/URL](https://schema.org/URL) - `vehicleEngine[string]`: 차량의 엔진에 대한 정보 . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) - `vehicleModelDate[date-time]`: 차량 모델의 출시일(동일한 제조사 및 모델의 버전을 구분하는 데 자주 사용됨) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) - `vehicleType[string]`: 구조적 특성의 관점에서 본 차량 유형. 이는 차량 카테고리와는 다릅니다. Enum:'농업용차량, 모든차량, 굴절식차량, 자전거, 빈트롤리, 버스, 자동차, 카라반, 자동차Or경량차량, 자동차With카라반, 자동차With트레일러, 청소트롤리, 건설용차량, 4륜구동, 하이사이드차량, 트럭, 미니버스, 오토바이, 오토바이, 모터사이클, 모터스쿠터, 청소차, 유조차, 삼륜차, 트레일러, 트램, 이륜차, 트롤리, 밴, 차량무촉매변환기, 차량위드카라반, 차량위드트레일러, 짝수번호등록번호판, 홀수번호등록번호판, 기타'. 차량 유형에 따라 정의되는 값은 다음과 같습니다. _VehicleTypeEnum_ 및 _VehicleTypeEnum2_, [DATEX 2 버전 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm). . Model: [https://schema.org/Text](https://schema.org/Text) - `weight[number]`: 차량 무게 . Model: [https://schema.org/weigth](https://schema.org/weigth) - `width[number]`: 차량 폭 . Model: [https://schema.org/width](https://schema.org/width) - - 필수 속성 -- `brandName` - `id` - `manufacturerName` - `modelName` - `name` - `type` - `vehicleType` - - - - ## 속성에 대한 데이터 모델 설명 - 알파벳순으로 정렬(자세한 내용을 보려면 클릭) - - -
full yaml details - ```yaml -VehicleModel: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' - 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 - brandName: - description: Vehicle's brand name - type: string - x-ngsi: - model: https://schema.org/brand - type: Property - cargoVolume: - description: 'The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume' - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/cargoVolume - type: Property - units: Liters - 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 - depth: - description: Vehicle's depth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/depth - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - fuelConsumption: - description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/fuelConsumption - type: Property - units: liters per 100 kilometer - fuelType: - description: 'The type of fuel suitable for the engine or engines of the vehicle. Enum:''autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other''' - enum: - - autogas - - biodiesel - - cng - - diesel - - electric - - ethanol - - gasoline - - hybrid_electric_diesel - - hybrid_electric_petrol - - hydrogen - - lpg - - petrol - - petrol(unleaded) - - petrol(leaded) - - other - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - height: - description: Vehicle's height - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/height - 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 - 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 - manufacturerName: - description: Vehicle's manufacturer name - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - modelName: - description: Vehicle's model name - type: string - x-ngsi: - model: https://schema.org/model - type: Property - 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 - 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 - type: - description: NGSI Entity type. It has to be VehicleModel - enum: - - VehicleModel - type: string - x-ngsi: - type: Property - url: - description: URL which provides a description of this vehicle model - format: uri - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - vehicleEngine: - description: Information about the engine or engines of the vehicle - type: string - x-ngsi: - model: https://schema.org/vehicleEngine - type: Property - vehicleModelDate: - description: The release date of a vehicle model (often used to differentiate versions of the same make and model) - format: date-time - type: string - x-ngsi: - model: https://schema.org/vehicleModelDate - type: Property - vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)' - enum: - - agriculturalVehicle - - bicycle - - binTrolley - - bus - - car - - caravan - - carWithCaravan - - carWithTrailer - - cleaningTrolley - - constructionOrMaintenanceVehicle - - lorry - - minibus - - moped - - motorcycle - - motorcycleWithSideCar - - motorscooter - - sweepingMachine - - tanker - - trailer - - tram - - van - - trolley - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - weight: - description: Vehicle's weigth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/weigth - type: Property - width: - description: Vehicle's width - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/width - type: Property - required: - - id - - name - - type - - vehicleType - - brandName - - modelName - - manufacturerName - 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.Transportation/blob/master/VehicleModel/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json - x-model-tags: "" - x-version: 0.0.1 -``` -
- - - - - ## 페이로드 예시 - #### 차량 모델 NGSI-v2 키 값 예시 - 다음은 키-값으로 JSON-LD 형식의 VehicleModel의 예입니다. 이는 `옵션=키값`을 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. -
show/hide example - ```json - { + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +엔티티: VehicleModel +==================== + + + + + +[오픈 라이선스](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) + +[자동으로 생성된 문서](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) + + + + + +Global description: **이 엔티티는 특정 차량 모델을 모델링하며, 해당 모델에 속하는 여러 차량 인스턴스에 공통되는 모든 속성을 포함한다.** + +version: 0.0.2 + + + + + + +## 속성 목록 + + +[*] 속성에 유형이 없다면, 그것은 여러 유형이나 서로 다른 형식/패턴을 가질 수 있기 때문입니다. +- `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: 그 국가. 예를 들어 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 그 거리 주소가 있는 지역 및 그 지역에 있는 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 그 지역은 현지에 있으며, 그 국가에 있습니다 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 구는 일부 국가에서 지방 정부가 관리하는 유형의 행정 구역입니다 + - `postOfficeBoxNumber[string]`: 우체국 사서함 번호(PO 박스 주소용). 예를 들어, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 우편번호. 예를 들어, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 우편주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 공공 도로상 특정 부동산을 식별하는 번호 +- `alternateName[string]`: 이 항목의 대체 이름 +- `annotations[array]`: 아이템에 대한 주석 . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: 서비스나 제공된 항목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) +- `brandName[string]`: 차량의 브랜드 이름 . Model: [https://schema.org/brand](https://schema.org/brand) +- `cargoVolume[number]`: 화물이나 수하물에 사용할 수 있는 볼륨입니다. 자동차의 경우 일반적으로 트렁크 볼륨을 말합니다. 단일 값만 제공되는 경우(타입 Number) 최대 볼륨을 나타냅니다. . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) +- `color[string]`: 제품의 색상 . Model: [https://schema.org/color](https://schema.org/color) +- `dataProvider[string]`: 조화된 데이터 엔티티의 제공자를 식별하는 문자열 시퀀스 +- `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이것은 일반적으로 저장소 플랫폼에 의해 할당됩니다. +- `dateModified[date-time]`: 엔티티의 마지막 수정 시간戳. 이것은 일반적으로 저장 플랫폼에 의해 할당됩니다. +- `depth[number]`: 차량의 깊이 . Model: [https://schema.org/depth](https://schema.org/depth) +- `description[string]`: 이 항목에 대한 설명 +- `fuelConsumption[number]`: 특정 거리 또는 시간 동안 주어진 차량(예: 100km당 리터)으로 여행하는 데 소비되는 연료의 양 . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) +- `fuelType[string]`: 차량의 엔진이나 엔진들에 적합한 연료의 종류. Enum: '자동가스, 바이오디젤, 에탄올, 천연가스, 디젤, 전기, 가솔린, 하이브리드 전기/디젤, 하이브리드 전기/휘발유, 수소, LPG, 휘발유, 무연휘발유, 유연휘발유, 기타' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `height[number]`: 차량의 높이 . Model: [https://schema.org/height](https://schema.org/height) +- `id[*]`: 개체의 고유 식별자 +- `image[uri]`: 아이템의 이미지 . Model: [https://schema.org/URL](https://schema.org/URL) +- `location[*]`: Geojson 아이템 참조입니다. Point, LineString, Polygon, MultiPoint, MultiLineString 또는 MultiPolygon 중 하나가 될 수 있습니다. +- `manufacturerName[string]`: 차량 제조업체 이름 . Model: [https://schema.org/Text](https://schema.org/Text) +- `modelName[string]`: 차량 모델명 . Model: [https://schema.org/model](https://schema.org/model) +- `name[string]`: 이 항목의 이름 +- `owner[array]`: 소유자(들)의 고유 ID를 참조하는 문자열 시퀀스를 JSON으로 인코딩한 문자열을 포함하는 목록 +- `seeAlso[*]`: 아이템에 대한 추가 리소스에 대한 URI 목록 +- `source[string]`: 엔티티 데이터의 원래 출처를 URL로 제공하는 문자열 시퀀스. 출처 제공자의 완전한 도메인 이름이나 소스 객체에 대한 URL로 지정하는 것을 권장합니다. +- `type[string]`: NGSI 엔티티 유형. VehicleModel이어야 합니다. +- `url[uri]`: 이 차량 모델에 대한 설명을 제공하는 URL . Model: [https://schema.org/URL](https://schema.org/URL) +- `vehicleEngine[string]`: 차량의 엔진이나 엔진들에 대한 정보 . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) +- `vehicleModelDate[date-time]`: 차량 모델의 출시일(같은 메이커와 모델의 버전을 구별하기 위해 자주 사용됨) . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) +- `vehicleType[string]`: 차량의 구조적 특성에 따른 차량 유형입니다. 이것은 차량 카테고리와 다릅니다. Enum:'농업용차량, 모든차량, 관절차량, 자전거, 쓰레기수거차, 버스, 자동차, 카라반, 자동차또는경차, 자동차와카라반, 자동차와트레일러, 청소용수레, 건설또는유지보수차량, 4륜구동, 높은측면차량, 트럭, 미니버스, 모터사이클, 오토바이와사이드카, 모터스쿠터, 청소기, 탱크트럭, 3륜차량, 트레일러, 전차, 2륜차량, 수레, 밴, 촉매변환기없는차량, 카라반있는차량, 트레일러있는차량, 짝수등록번호판, 홀수등록번호판, 기타'. 다음 값은 _VehicleTypeEnum_ 및 _VehicleTypeEnum2_에 의해 정의되며, [DATEX 2 버전 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) 참조. . Model: [https://schema.org/Text](https://schema.org/Text) +- `weight[number]`: 차량의 무게 . Model: [https://schema.org/weigth](https://schema.org/weigth) +- `width[number]`: 차량의 너비 . Model: [https://schema.org/width](https://schema.org/width) + + + + + +필수 속성 +- `브랜드명` +- `id` +- `제조업체 이름` +- `모델 이름` +- `이름` +- `유형` +- `차량 유형` + + + + + + + + + +## 데이터 모델의 속성 설명 + +가나다순으로 정렬 (자세한 내용은 클릭) + + + + +
full yaml details + +```yaml +VehicleModel: + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. + 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: + description: Eventy element in the annotations + type: string + x-ngsi: + type: Property + 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 + brandName: + description: Vehicle's brand name + type: string + x-ngsi: + model: https://schema.org/brand + type: Property + cargoVolume: + description: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/cargoVolume + type: Property + units: Liters + 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 + depth: + description: Vehicle's depth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/depth + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + fuelConsumption: + description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/fuelConsumption + type: Property + units: liters per 100 kilometer + fuelType: + description: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' + enum: + - autogas + - biodiesel + - cng + - diesel + - electric + - ethanol + - gasoline + - hybrid_electric_diesel + - hybrid_electric_petrol + - hydrogen + - lpg + - petrol + - petrol(unleaded) + - petrol(leaded) + - other + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + height: + description: Vehicle's height + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/height + 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: Relationship + image: + description: An image of the item + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + manufacturerName: + description: Vehicle's manufacturer name + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + modelName: + description: Vehicle's model name + type: string + x-ngsi: + model: https://schema.org/model + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI Entity type. It has to be VehicleModel + enum: + - VehicleModel + type: string + x-ngsi: + type: Property + url: + description: URL which provides a description of this vehicle model + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + vehicleEngine: + description: Information about the engine or engines of the vehicle + type: string + x-ngsi: + model: https://schema.org/vehicleEngine + type: Property + vehicleModelDate: + description: The release date of a vehicle model (often used to differentiate versions of the same make and model) + format: date-time + type: string + x-ngsi: + model: https://schema.org/vehicleModelDate + type: Property + vehicleType: + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) + enum: + - agriculturalVehicle + - bicycle + - binTrolley + - bus + - car + - caravan + - carWithCaravan + - carWithTrailer + - cleaningTrolley + - constructionOrMaintenanceVehicle + - lorry + - minibus + - moped + - motorcycle + - motorcycleWithSideCar + - motorscooter + - sweepingMachine + - tanker + - trailer + - tram + - van + - trolley + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + weight: + description: Vehicle's weigth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/weigth + type: Property + width: + description: Vehicle's width + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/width + type: Property + required: + - id + - name + - type + - vehicleType + - brandName + - modelName + - manufacturerName + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json + x-model-tags: '' + x-version: 0.0.2 +``` +
+ + + + + + + + + +## 예제 페이로드 + +#### 차량 모델 NGSI-v2 키-값 예시 + +여기에는 키-값으로 JSON 형식의 VehicleModel 예가 있습니다. 이것은 `options=keyValues`를 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": "MBenz-Econic2014", @@ -548,12 +660,16 @@ VehicleModel: "fuelType": "diesel" } ``` -
- #### VehicleModel NGSI-v2 정규화 예제 - 다음은 정규화된 JSON-LD 형식의 VehicleModel 예제입니다. 이는 옵션을 사용하지 않을 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. -
show/hide example - ```json - { +
+ +#### 차량 모델 NGSI-v2 정규화 예시 + +여기에는 JSON 형식으로 정규화된 VehicleModel의 예가 나와 있습니다. 옵션을 사용하지 않을 때 NGSI-v2와 호환되며 개별 엔터티의 컨텍스트 데이터를 반환합니다. +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": { @@ -586,12 +702,16 @@ VehicleModel: } } ``` -
- #### 차량 모델 NGSI-LD 키 값 예시 - 다음은 키-값으로 JSON-LD 형식의 VehicleModel의 예입니다. 이는 `옵션=키값`을 사용할 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. -
show/hide example - ```json - { +
+ +#### 차량 모델 NGSI-LD 키-값 예시 + +여기에는 JSON-LD 형식의 키-값으로 된 VehicleModel의 예가 있습니다. 이것은 `options=keyValues`를 사용하고 개별 엔티티의 컨텍스트 데이터를 반환할 때 NGSI-LD와 호환됩니다. +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": "Mercedes Benz", @@ -607,12 +727,16 @@ VehicleModel: ] } ``` -
- #### 차량 모델 NGSI-LD 정규화 예제 - 다음은 정규화된 JSON-LD 형식의 VehicleModel 예시입니다. 이는 옵션을 사용하지 않을 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. -
show/hide example - ```json - { +
+ +#### 차량 모델 NGSI-LD 정규화 예시 + +여기에는 JSON-LD 형식으로 정규화된 VehicleModel의 예가 있습니다. 이것은 옵션을 사용하지 않을 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": { @@ -649,12 +773,21 @@ VehicleModel: ] } ``` -
- - - - [FAQ 10](https://smartdatamodels.org/index.php/faqs/)을 참조하여 규모 단위를 다루는 방법에 대한 답변을 확인하세요. - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/VehicleModel/doc/spec_ZH.md b/VehicleModel/doc/spec_ZH.md index 13e7f0d7a..63536983a 100644 --- a/VehicleModel/doc/spec_ZH.md +++ b/VehicleModel/doc/spec_ZH.md @@ -1,541 +1,654 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - 实体：车辆模型 -======= - - [开放许可](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) - [文件自动生成](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) - - - 全局描述：**该实体模拟一个特定的车辆模型，包括属于该模型的多个车辆实例所共有的所有属性。 - 版本： 0.0.1 - - - ## 属性列表 - [*] 如果属性中没有类型，是因为它可能有多个类型或不同的格式/模式。 -- `address[object]`: 邮寄地址 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 国家。例如，西班牙 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: 街道地址所在的地点，以及该地点所在的区域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: 地点所在的地区，以及该地区位于哪个国家 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: 地区是一种行政区划，在一些国家由地方政府管理 - - `postOfficeBoxNumber[string]`: 用于邮政信箱地址的邮政信箱号码。例如：03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: 邮政编码。例如：24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + +实体: VehicleModel +==================== + + + + + +[开放许可证](https://github.com/smart-data-models//dataModel.Transportation/blob/master/VehicleModel/LICENSE.md) + +[自动生成文档](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) + + + + + +Global description: **该实体模拟一种特定的车辆型号，包括所有属于此型号的多个车辆实例的共同属性。** + +version: 0.0.2 + + + + + + +## 属性列表 + + +[*] 如果一个属性中没有指定类型，是因为它可能有多种类型或不同的格式/模式 +- `address[object]`: 邮寄地址 . Model: [https://schema.org/address](https://schema.org/address) + - `addressCountry[string]`: 这个国家。例如，西班牙 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 街道地址所在的地区，以及该地区所在的区域 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 该地所在的地区，以及该国所在的地区 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 區域是一種行政區劃類型，在一些國家由地方政府管理 + - `postOfficeBoxNumber[string]`: 邮政信箱的邮政信箱编号。例如，03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 邮政编码。例如，24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - `streetAddress[string]`: 街道地址 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: 该项目的替代名称 - `annotations[array]`: 项目说明 . Model: [https://schema.org/Text](https://schema.org/Text) - `areaServed[string]`: 提供服务或提供物品的地理区域 . Model: [https://schema.org/Text](https://schema.org/Text) - `brandName[string]`: 车辆品牌名称 . Model: [https://schema.org/brand](https://schema.org/brand) - `cargoVolume[number]`: 可容纳货物或行李的空间。对于汽车来说，这通常是后备箱容积。如果只提供一个值（数值类型），则指最大容积。 . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) - `color[string]`: 产品的颜色 . Model: [https://schema.org/color](https://schema.org/color) - `dataProvider[string]`: 标识统一数据实体提供者的字符序列 - `dateCreated[date-time]`: 实体创建时间戳。通常由存储平台分配 - `dateModified[date-time]`: 实体最后一次修改的时间戳。通常由存储平台分配 - `depth[number]`: 车辆深度 . Model: [https://schema.org/depth](https://schema.org/depth) - `description[string]`: 项目描述 - `fuelConsumption[number]`: 特定车辆行驶特定距离或时间所消耗的燃料量（如每 100 公里升数） . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) - `fuelType[string]`: 适用于车辆发动机的燃料类型。枚举："自动燃气、生物柴油、乙醇、压缩天然气、柴油、电动、汽油、电动/柴油混合动力、电动/汽油混合动力、氢气、液化石油气、汽油、汽油（无铅）、汽油（含铅）、其他"。 . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `height[number]`: 车辆高度 . Model: [https://schema.org/height](https://schema.org/height) - `id[*]`: 实体的唯一标识符 - `image[uri]`: 物品的图片 . Model: [https://schema.org/URL](https://schema.org/URL) - `location[*]`: 项目的 Geojson 引用。它可以是点、线条字符串、多边形、多点、多线条字符串或多多边形 - `manufacturerName[string]`: 车辆制造商名称 . Model: [https://schema.org/Text](https://schema.org/Text) - `modelName[string]`: 车辆型号名称 . Model: [https://schema.org/model](https://schema.org/model) - `name[string]`: 该项目的名称 - `owner[array]`: 包含一个 JSON 编码字符序列的列表，其中引用了所有者的唯一 Ids - `seeAlso[*]`: 指向有关该项目的其他资源的 uri 列表 - `source[string]`: 以 URL 形式给出实体数据原始来源的字符串。建议使用源提供者的完全合格域名或源对象的 URL - `type[string]`: NGSI 实体类型。必须是 VehicleModel - `url[uri]`: 提供该车型说明的 URL . Model: [https://schema.org/URL](https://schema.org/URL) - `vehicleEngine[string]`: 有关车辆发动机的信息 . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) - `vehicleModelDate[date-time]`: 车型的发布日期（通常用于区分同一品牌和车型的不同版本） . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) - `vehicleType[string]`: 从结构特征的角度来看的车辆类型。这与车辆类别不同。枚举'农用车、任何车辆、铰接式车辆、自行车、垃圾车、公共汽车、轿车、大篷车、轻型车、带大篷车的车、带拖车的车、清洁车、建筑或维护车辆、四轮驱动、高边车、货车、小客车、轻便摩托车、摩托车、摩托车、带侧车的摩托车、摩托艇、扫地机、油罐车、三轮汽车、拖车、电车、两轮汽车、手推车、面包车、无催化转换器的车辆、带大篷车的车辆、带拖车的车辆、带偶数登记牌照的车辆、带奇数登记牌照的车辆、其他"。下列由 _VehicleTypeEnum_ 和 _VehicleTypeEnum2_ 定义的值[DATEX 2 2.3 版](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) - `weight[number]`: 车辆重量 . Model: [https://schema.org/weigth](https://schema.org/weigth) - `width[number]`: 车辆宽度 . Model: [https://schema.org/width](https://schema.org/width) - - 所需属性 -- `brandName` - `id` - `manufacturerName` - `modelName` - `name` - `type` - `vehicleType` - - - - ## 属性的数据模型描述 - 按字母顺序排列（点击查看详情） - - -
full yaml details - ```yaml -VehicleModel: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' - 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 - brandName: - description: Vehicle's brand name - type: string - x-ngsi: - model: https://schema.org/brand - type: Property - cargoVolume: - description: 'The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume' - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/cargoVolume - type: Property - units: Liters - 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 - depth: - description: Vehicle's depth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/depth - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - fuelConsumption: - description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/fuelConsumption - type: Property - units: liters per 100 kilometer - fuelType: - description: 'The type of fuel suitable for the engine or engines of the vehicle. Enum:''autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other''' - enum: - - autogas - - biodiesel - - cng - - diesel - - electric - - ethanol - - gasoline - - hybrid_electric_diesel - - hybrid_electric_petrol - - hydrogen - - lpg - - petrol - - petrol(unleaded) - - petrol(leaded) - - other - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - height: - description: Vehicle's height - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/height - 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 - 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 - manufacturerName: - description: Vehicle's manufacturer name - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - modelName: - description: Vehicle's model name - type: string - x-ngsi: - model: https://schema.org/model - type: Property - 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 - 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 - type: - description: NGSI Entity type. It has to be VehicleModel - enum: - - VehicleModel - type: string - x-ngsi: - type: Property - url: - description: URL which provides a description of this vehicle model - format: uri - type: string - x-ngsi: - model: https://schema.org/URL - type: Property - vehicleEngine: - description: Information about the engine or engines of the vehicle - type: string - x-ngsi: - model: https://schema.org/vehicleEngine - type: Property - vehicleModelDate: - description: The release date of a vehicle model (often used to differentiate versions of the same make and model) - format: date-time - type: string - x-ngsi: - model: https://schema.org/vehicleModelDate - type: Property - vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)' - enum: - - agriculturalVehicle - - bicycle - - binTrolley - - bus - - car - - caravan - - carWithCaravan - - carWithTrailer - - cleaningTrolley - - constructionOrMaintenanceVehicle - - lorry - - minibus - - moped - - motorcycle - - motorcycleWithSideCar - - motorscooter - - sweepingMachine - - tanker - - trailer - - tram - - van - - trolley - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - weight: - description: Vehicle's weigth - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/weigth - type: Property - width: - description: Vehicle's width - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/width - type: Property - required: - - id - - name - - type - - vehicleType - - brandName - - modelName - - manufacturerName - 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.Transportation/blob/master/VehicleModel/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json - x-model-tags: "" - x-version: 0.0.1 -``` -
- - - - - ## 有效载荷示例 - #### VehicleModel NGSI-v2 关键值示例 - 下面是一个以 JSON-LD 格式作为键值的 VehicleModel 示例。当使用 `options=keyValues` 时，它与 NGSI-v2 兼容，并返回单个实体的上下文数据。 -
show/hide example - ```json - { + - `streetNr[string]`: 公共街道上特定房产的编号 +- `alternateName[string]`: 该物品的另一个名称 +- `annotations[array]`: 关于该项的注释 . Model: [https://schema.org/Text](https://schema.org/Text) +- `areaServed[string]`: 提供服务或商品的地域范围 . Model: [https://schema.org/Text](https://schema.org/Text) +- `brandName[string]`: 车辆的品牌名称 . Model: [https://schema.org/brand](https://schema.org/brand) +- `cargoVolume[number]`: 货物或行李的可用体积。对于汽车，这通常是行李厢的体积。如果只提供一个值（类型为Number），则它将指最大体积 . Model: [https://schema.org/cargoVolume](https://schema.org/cargoVolume) +- `color[string]`: 产品的颜色 . Model: [https://schema.org/color](https://schema.org/color) +- `dataProvider[string]`: 识别和谐数据实体提供者的字符序列 +- `dateCreated[date-time]`: 实体创建时间戳。这通常由存储平台分配 +- `dateModified[date-time]`: 实体最后修改的时间戳。这通常由存储平台分配 +- `depth[number]`: 车辆的深度 . Model: [https://schema.org/depth](https://schema.org/depth) +- `description[string]`: 对此项的描述 +- `fuelConsumption[number]`: 行駛特定距離或時間所消耗的燃料量（例如每100公里的升數） . Model: [https://schema.org/fuelConsumption](https://schema.org/fuelConsumption) +- `fuelType[string]`: 车辆发动机或发动机所适用的燃料类型。枚举：'汽车气体，生物柴油，乙醇，压缩天然气，柴油，电动，汽油，混合动力电动/柴油，混合动力电动/汽油，氢，液化石油气，汽油，汽油（无铅），汽油（有铅），其他' . Model: [https://schema.org/DateTime](https://schema.org/DateTime) +- `height[number]`: 车辆高度 . Model: [https://schema.org/height](https://schema.org/height) +- `id[*]`: 实体的唯一标识符 +- `image[uri]`: 该物品的图像 . Model: [https://schema.org/URL](https://schema.org/URL) +- `location[*]`: GeoJSON指向该项的引用。它可以是Point、LineString、Polygon、MultiPoint、MultiLineString或MultiPolygon +- `manufacturerName[string]`: 车辆制造商名称 . Model: [https://schema.org/Text](https://schema.org/Text) +- `modelName[string]`: 車輛的型號名稱 . Model: [https://schema.org/model](https://schema.org/model) +- `name[string]`: 该物品的名称 +- `owner[array]`: 一个包含JSON编码序列的列表，该序列引用了所有者（们）的唯一ID的字符序列 +- `seeAlso[*]`: 关于该项目的其他资源的URI列表 +- `source[string]`: 实体数据的原始来源的字符序列，以URL的形式给出。建议使用源提供者的全限定域名，或源对象的URL。 +- `type[string]`: NGSI 实体类型。它必须是 VehicleModel +- `url[uri]`: 提供此車型描述的URL . Model: [https://schema.org/URL](https://schema.org/URL) +- `vehicleEngine[string]`: 关于车辆的发动机或发动机的信息 . Model: [https://schema.org/vehicleEngine](https://schema.org/vehicleEngine) +- `vehicleModelDate[date-time]`: 车辆型号的发布日期（通常用于区分同一品牌和型号的不同版本） . Model: [https://schema.org/vehicleModelDate](https://schema.org/vehicleModelDate) +- `vehicleType[string]`: 从结构特征的角度来看的车辆类型。这与车辆类别不同。枚举：'农业车辆、任何车辆、半挂车、自行车、手推车、公共汽车、汽车、拖车、汽车或轻型车辆、带拖车的汽车、带拖车的汽车、清洁手推车、建筑或维护车辆、四轮驱动车、高边车、卡车、小巴、摩托车、带侧车的摩托车、摩托车、扫地机、油罐车、三轮车、拖车、有轨电车、两轮车、手推车、货车、没有催化转换器的车辆、带拖车的车辆、带拖车的车辆、带有偶数注册牌的车辆、带有奇数注册牌的车辆、其他'。以下值由_VehicleTypeEnum_和_VehicleTypeEnum2_定义，[DATEX 2版本2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) . Model: [https://schema.org/Text](https://schema.org/Text) +- `weight[number]`: 车辆重量 . Model: [https://schema.org/weigth](https://schema.org/weigth) +- `width[number]`: 车辆宽度 . Model: [https://schema.org/width](https://schema.org/width) + + + + + +所需属性 +- `品牌名称` +- `id` +- `manufacturerName` 制造商名称 +- `模型名称` +- `名称` +- `类型` +车辆类型 + + + + + + + + + +## 数据模型属性描述 + +按字母顺序排列（点击查看详细信息） + + + + +
full yaml details + +```yaml +VehicleModel: + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. + 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: + description: Eventy element in the annotations + type: string + x-ngsi: + type: Property + 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 + brandName: + description: Vehicle's brand name + type: string + x-ngsi: + model: https://schema.org/brand + type: Property + cargoVolume: + description: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/cargoVolume + type: Property + units: Liters + 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 + depth: + description: Vehicle's depth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/depth + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + fuelConsumption: + description: The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km) + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/fuelConsumption + type: Property + units: liters per 100 kilometer + fuelType: + description: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' + enum: + - autogas + - biodiesel + - cng + - diesel + - electric + - ethanol + - gasoline + - hybrid_electric_diesel + - hybrid_electric_petrol + - hydrogen + - lpg + - petrol + - petrol(unleaded) + - petrol(leaded) + - other + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + height: + description: Vehicle's height + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/height + 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: Relationship + image: + description: An image of the item + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + 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: + description: BBox of the Point + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Point + items: + type: number + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the LineString + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the Polygon + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the Polygon + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MulitPoint + items: + items: + type: number + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: BBox coordinates of the LineString + items: + type: number + minItems: 4 + type: array + x-ngsi: + type: Property + coordinates: + description: Coordinates of the MultiLineString + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + x-ngsi: + type: Property + 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: + description: Coordinates of the MultiPolygon + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + x-ngsi: + type: Property + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + manufacturerName: + description: Vehicle's manufacturer name + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + modelName: + description: Vehicle's model name + type: string + x-ngsi: + model: https://schema.org/model + type: Property + 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: Relationship + type: array + x-ngsi: + type: Property + 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 + type: + description: NGSI Entity type. It has to be VehicleModel + enum: + - VehicleModel + type: string + x-ngsi: + type: Property + url: + description: URL which provides a description of this vehicle model + format: uri + type: string + x-ngsi: + model: https://schema.org/URL + type: Property + vehicleEngine: + description: Information about the engine or engines of the vehicle + type: string + x-ngsi: + model: https://schema.org/vehicleEngine + type: Property + vehicleModelDate: + description: The release date of a vehicle model (often used to differentiate versions of the same make and model) + format: date-time + type: string + x-ngsi: + model: https://schema.org/vehicleModelDate + type: Property + vehicleType: + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) + enum: + - agriculturalVehicle + - bicycle + - binTrolley + - bus + - car + - caravan + - carWithCaravan + - carWithTrailer + - cleaningTrolley + - constructionOrMaintenanceVehicle + - lorry + - minibus + - moped + - motorcycle + - motorcycleWithSideCar + - motorscooter + - sweepingMachine + - tanker + - trailer + - tram + - van + - trolley + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + weight: + description: Vehicle's weigth + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/weigth + type: Property + width: + description: Vehicle's width + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/width + type: Property + required: + - id + - name + - type + - vehicleType + - brandName + - modelName + - manufacturerName + type: object + x-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... + x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json + x-model-tags: '' + x-version: 0.0.2 +``` +
+ + + + + + + + + +## 示例有效载荷 + +#### 车辆模型NGSI-v2键值示例 + +这里是一个以JSON格式的键值对表示的VehicleModel示例。当使用`options=keyValues`时，它与NGSI-v2兼容，并返回单个实体的上下文数据。 +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": "MBenz-Econic2014", @@ -547,12 +660,16 @@ VehicleModel: "fuelType": "diesel" } ``` -
- #### 车辆模型 NGSI-v2 标准化示例 - 下面是一个规范化 JSON-LD 格式的 VehicleModel 示例。当不使用选项时，它与 NGSI-v2 兼容，并返回单个实体的上下文数据。 -
show/hide example - ```json - { +
+ +#### 车辆模型NGSI-v2标准化示例 + +这是一个VehicleModel在JSON格式的标准化示例。当不使用选项时，它与NGSI-v2兼容，并返回单个实体的上下文数据。 +
show/hide example + +```json + +{ "id": "vehiclemodel:econic", "type": "VehicleModel", "name": { @@ -585,12 +702,16 @@ VehicleModel: } } ``` -
- #### VehicleModel NGSI-LD 关键值 示例 - 下面是一个以 JSON-LD 格式作为键值的 VehicleModel 示例。当使用 `options=keyValues` 时，它与 NGSI-LD 兼容，并返回单个实体的上下文数据。 -
show/hide example - ```json - { +
+ +#### 车辆模型NGSI-LD键值示例 + +这是一个以JSON-LD格式的VehicleModel示例，以键值对的形式表示。当使用`options=keyValues`时，它与NGSI-LD兼容，并返回单个实体的上下文数据。 +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": "Mercedes Benz", @@ -606,12 +727,16 @@ VehicleModel: ] } ``` -
- #### 车辆模型 NGSI-LD 标准化示例 - 下面是一个规范化 JSON-LD 格式的 VehicleModel 示例。当不使用选项时，它与 NGSI-LD 兼容，并返回单个实体的上下文数据。 -
show/hide example - ```json - { +
+ +#### 车辆模型NGSI-LD标准化示例 + +这是一个以JSON-LD格式标准化的VehicleModel示例。当不使用选项时，它与NGSI-LD兼容，并返回个体实体的上下文数据。 +
show/hide example + +```json + +{ "id": "urn:ngsi-ld:VehicleModel:vehiclemodel:econic", "type": "VehicleModel", "brandName": { @@ -648,12 +773,21 @@ VehicleModel: ] } ``` -
- - - - 请参阅 [FAQ 10](https://smartdatamodels.org/index.php/faqs/)，获取如何处理幅度单位的答案。 - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + + + + + +See [FAQ 10](https://smartdatamodels.org/index.php/faqs/) to get an answer on how to deal with magnitude units + + + + +--- + +[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) + diff --git a/VehicleModel/model.yaml b/VehicleModel/model.yaml index 9fc3a66a5..262245721 100644 --- a/VehicleModel/model.yaml +++ b/VehicleModel/model.yaml @@ -1,40 +1,40 @@ VehicleModel: - description: 'This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model.' + description: This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. properties: address: description: The mailing address properties: addressCountry: - description: 'The country. For example, Spain' + 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' + 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' + 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' + 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' + 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' + description: The postal code. For example, 24004 type: string x-ngsi: model: https://schema.org/https://schema.org/postalCode @@ -62,7 +62,10 @@ VehicleModel: annotations: description: Annotations about the item items: + description: Eventy element in the annotations type: string + x-ngsi: + type: Property type: array x-ngsi: model: https://schema.org/Text @@ -80,7 +83,7 @@ VehicleModel: model: https://schema.org/brand type: Property cargoVolume: - description: 'The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume' + description: The available volume for cargo or luggage. For automobiles, this is usually the trunk volume. If only a single value is provided (type Number) it will refer to the maximum volume minimum: 0 type: number x-ngsi: @@ -131,7 +134,7 @@ VehicleModel: type: Property units: liters per 100 kilometer fuelType: - description: 'The type of fuel suitable for the engine or engines of the vehicle. Enum:''autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other''' + description: The type of fuel suitable for the engine or engines of the vehicle. Enum:'autogas, biodiesel, ethanol, cng, diesel, electric, gasoline, hybrid electric/diesel, hybrid electric/petrol, hydrogen, lpg, petrol, petrol(unleaded), petrol(leaded), other' enum: - autogas - biodiesel @@ -175,7 +178,7 @@ VehicleModel: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship image: description: An image of the item format: uri @@ -184,20 +187,26 @@ VehicleModel: model: https://schema.org/URL type: Property location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + 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: + description: BBox of the Point items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Point items: type: number minItems: 2 type: array + x-ngsi: + type: Property type: enum: - Point @@ -212,11 +221,15 @@ VehicleModel: - description: Geojson reference to the item. LineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the LineString items: items: type: number @@ -224,6 +237,8 @@ VehicleModel: type: array minItems: 2 type: array + x-ngsi: + type: Property type: enum: - LineString @@ -238,11 +253,15 @@ VehicleModel: - description: Geojson reference to the item. Polygon properties: bbox: + description: BBox coordinates of the Polygon items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the Polygon items: items: items: @@ -252,6 +271,8 @@ VehicleModel: minItems: 4 type: array type: array + x-ngsi: + type: Property type: enum: - Polygon @@ -266,17 +287,23 @@ VehicleModel: - description: Geojson reference to the item. MultiPoint properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MulitPoint items: items: type: number minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiPoint @@ -291,11 +318,15 @@ VehicleModel: - description: Geojson reference to the item. MultiLineString properties: bbox: + description: BBox coordinates of the LineString items: type: number minItems: 4 type: array + x-ngsi: + type: Property coordinates: + description: Coordinates of the MultiLineString items: items: items: @@ -305,6 +336,8 @@ VehicleModel: minItems: 2 type: array type: array + x-ngsi: + type: Property type: enum: - MultiLineString @@ -324,6 +357,7 @@ VehicleModel: minItems: 4 type: array coordinates: + description: Coordinates of the MultiPolygon items: items: items: @@ -335,6 +369,8 @@ VehicleModel: type: array type: array type: array + x-ngsi: + type: Property type: enum: - MultiPolygon @@ -383,7 +419,7 @@ VehicleModel: type: Property description: Unique identifier of the entity x-ngsi: - type: Property + type: Relationship type: array x-ngsi: type: Property @@ -400,7 +436,7 @@ VehicleModel: 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' + 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 @@ -432,7 +468,7 @@ VehicleModel: model: https://schema.org/vehicleModelDate type: Property vehicleType: - description: 'Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:''agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other''. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm)' + description: Type of vehicle from the point of view of its structural characteristics. This is different than the vehicle category . Enum:'agriculturalVehicle, anyVehicle, articulatedVehicle, bicycle, binTrolley, bus, car, caravan, carOrLightVehicle, carWithCaravan, carWithTrailer, cleaningTrolley, constructionOrMaintenanceVehicle, fourWheelDrive, highSidedVehicle, lorry, minibus, moped, motorcycle, motorcycleWithSideCar, motorscooter, sweepingMachine, tanker, threeWheeledVehicle, trailer, tram, twoWheeledVehicle, trolley, van, vehicleWithoutCatalyticConverter, vehicleWithCaravan, vehicleWithTrailer, withEvenNumberedRegistrationPlates, withOddNumberedRegistrationPlates, other'. The following values defined by _VehicleTypeEnum_ and _VehicleTypeEnum2_, [DATEX 2 version 2.3](http://d2docs.ndwcloud.nu/_static/umlmodel/v2.3/index.htm) enum: - agriculturalVehicle - bicycle @@ -483,9 +519,9 @@ VehicleModel: - modelName - manufacturerName 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-derived-from: '' + x-disclaimer: Redistribution and use in source and binary forms... x-license-url: https://github.com/smart-data-models/dataModel.Transportation/blob/master/VehicleModel/LICENSE.md x-model-schema: https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json - x-model-tags: "" - x-version: 0.0.1 + x-model-tags: '' + x-version: 0.0.2 \ No newline at end of file diff --git a/VehicleModel/schema.json b/VehicleModel/schema.json index 6a309b2f0..82f27b8c2 100644 --- a/VehicleModel/schema.json +++ b/VehicleModel/schema.json @@ -1,6 +1,6 @@ { "$schema": "https://json-schema.org/draft/2020-12/schema", - "$schemaVersion": "0.0.1", + "$schemaVersion": "0.0.2", "modelTags": "", "$id": "https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/schema.json", "title": " - Vehicle / Vehicle Model", @@ -142,4 +142,4 @@ "modelName", "manufacturerName" ] -} \ No newline at end of file +} diff --git a/VehicleModel/schema.sql b/VehicleModel/schema.sql index 8e94a60b8..1e61d2770 100644 --- a/VehicleModel/schema.sql +++ b/VehicleModel/schema.sql @@ -1,3 +1,39 @@ -/* (Beta) Export of data model VehicleModel of the subject dataModel.Transportation for a PostgreSQL database. Pending translation of enumerations and multityped attributes */ -CREATE TYPE fuelType_type AS ENUM ('autogas','biodiesel','cng','diesel','electric','ethanol','gasoline','hybrid_electric_diesel','hybrid_electric_petrol','hydrogen','lpg','petrol','petrol(unleaded)','petrol(leaded)','other');CREATE TYPE VehicleModel_type AS ENUM ('VehicleModel');CREATE TYPE vehicleType_type AS ENUM ('agriculturalVehicle','bicycle','binTrolley','bus','car','caravan','carWithCaravan','carWithTrailer','cleaningTrolley','constructionOrMaintenanceVehicle','lorry','minibus','moped','motorcycle','motorcycleWithSideCar','motorscooter','sweepingMachine','tanker','trailer','tram','van','trolley'); -CREATE TABLE VehicleModel (address JSON, alternateName TEXT, annotations JSON, areaServed TEXT, brandName TEXT, cargoVolume NUMERIC, color TEXT, dataProvider TEXT, dateCreated TIMESTAMP, dateModified TIMESTAMP, depth NUMERIC, description TEXT, fuelConsumption NUMERIC, fuelType fuelType_type, height NUMERIC, id TEXT PRIMARY KEY, image TEXT, location JSON, manufacturerName TEXT, modelName TEXT, name TEXT, owner JSON, seeAlso JSON, source TEXT, type VehicleModel_type, url TEXT, vehicleEngine TEXT, vehicleModelDate TIMESTAMP, vehicleType vehicleType_type, weight NUMERIC, width NUMERIC); \ No newline at end of file +/* (Beta) Export of data model VehicleModel of the subject dataModel.Transportation +for a PostgreSQL database. Pending translation of enumerations and multityped attributes */ +CREATE TYPE fuelType_type AS ENUM ('autogas', 'biodiesel', 'cng', 'diesel', 'electric', 'ethanol', 'gasoline', 'hybrid_electric_diesel', 'hybrid_electric_petrol', 'hydrogen', 'lpg', 'petrol', 'petrol(unleaded)', 'petrol(leaded)', 'other'); +CREATE TYPE VehicleModel_type AS ENUM ('VehicleModel'); +CREATE TYPE vehicleType_type AS ENUM ('agriculturalVehicle', 'bicycle', 'binTrolley', 'bus', 'car', 'caravan', 'carWithCaravan', 'carWithTrailer', 'cleaningTrolley', 'constructionOrMaintenanceVehicle', 'lorry', 'minibus', 'moped', 'motorcycle', 'motorcycleWithSideCar', 'motorscooter', 'sweepingMachine', 'tanker', 'trailer', 'tram', 'van', 'trolley'); + +CREATE TABLE VehicleModel ( + address JSON, + alternateName TEXT, + annotations JSON, + areaServed TEXT, + brandName TEXT, + cargoVolume NUMERIC, + color TEXT, + dataProvider TEXT, + dateCreated TIMESTAMP, + dateModified TIMESTAMP, + depth NUMERIC, + description TEXT, + fuelConsumption NUMERIC, + fuelType fuelType_type, + height NUMERIC, + id TEXT PRIMARY KEY, + image TEXT, + location JSON, + manufacturerName TEXT, + modelName TEXT, + name TEXT, + owner JSON, + seeAlso JSON, + source TEXT, + type VehicleModel_type, + url TEXT, + vehicleEngine TEXT, + vehicleModelDate TIMESTAMP, + vehicleType vehicleType_type, + weight NUMERIC, + width NUMERIC +); \ No newline at end of file diff --git a/VehicleModel/swagger.yaml b/VehicleModel/swagger.yaml index 593944367..f95b2a60e 100644 --- a/VehicleModel/swagger.yaml +++ b/VehicleModel/swagger.yaml @@ -1,17 +1,17 @@ --- # Copyleft (c) 2022 Contributors to Smart Data Models initiative -# +# components: - schemas: - VehicleModel: - $ref: "https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/model.yaml#/VehicleModel" + schemas: + VehicleModel: + $ref: "https://smart-data-models.github.io/dataModel.Transportation/VehicleModel/model.yaml#VehicleModel" info: - description: | + description: | This entity models a particular vehicle model, including all properties which are common to multiple vehicle instances belonging to such model. title: VehicleModel - version: "0.0.1" + version: "0.0.2" openapi: "3.0.0" paths: @@ -49,4 +49,4 @@ paths: tags: - description: "NGSI-LD Linked-data Format" - name: ngsi-ld + name: ngsi-ld \ No newline at end of file diff --git a/context.jsonld b/context.jsonld index a5fb3c9f5..cb2005ab3 100644 --- a/context.jsonld +++ b/context.jsonld @@ -8,11 +8,13 @@ "CityWork": "https://smartdatamodels.org/dataModel.Transportation/CityWork", "CrowdFlowObserved": "https://smartdatamodels.org/dataModel.Transportation/CrowdFlowObserved", "EVChargingStation": "https://smartdatamodels.org/dataModel.Transportation/EVChargingStation", + "ElectricVehicleMobility": "https://smartdatamodels.org/dataModel.Transportation/ElectricVehicleMobility", "FareCollectionSystem": "https://smartdatamodels.org/dataModel.Transportation/FareCollectionSystem", "FleetVehicle": "https://smartdatamodels.org/dataModel.Transportation/FleetVehicle", "FleetVehicleOperation": "https://smartdatamodels.org/dataModel.Transportation/FleetVehicleOperation", "FleetVehicleStatus": "https://smartdatamodels.org/dataModel.Transportation/FleetVehicleStatus", "ItemFlowObserved": "https://smartdatamodels.org/dataModel.Transportation/ItemFlowObserved", + "OriginDestinationFlow": "https://smartdatamodels.org/dataModel.Transportation/OriginDestinationFlow", "PlatformType": "https://smartdatamodels.org/dataModel.Transportation/PlatformType", "RestrictedTrafficArea": "https://smartdatamodels.org/dataModel.Transportation/RestrictedTrafficArea", "RestrictionException": "https://smartdatamodels.org/dataModel.Transportation/RestrictionException", @@ -40,6 +42,7 @@ "agency_fare_url": "https://smartdatamodels.org/dataModel.Transportation/agency_fare_url", "agency_name": "https://smartdatamodels.org/dataModel.Transportation/agency_name", "agency_url": "https://smartdatamodels.org/dataModel.Transportation/agency_url", + "aggregationDateType": "https://smartdatamodels.org/dataModel.Transportation/aggregationDateType", "algorithm": "https://smartdatamodels.org/dataModel.Transportation/algorithm", "allowedVehicle": "https://smartdatamodels.org/dataModel.Transportation/allowedVehicle", "allowedVehicleType": "https://smartdatamodels.org/dataModel.Transportation/allowedVehicleType", @@ -55,6 +58,7 @@ "availableCapacity": "https://smartdatamodels.org/dataModel.Transportation/availableCapacity", "availableLanguage": "https://smartdatamodels.org/availableLanguage", "averageCrowdSpeed": "https://smartdatamodels.org/dataModel.Transportation/averageCrowdSpeed", + "averageDistanceKm": "https://smartdatamodels.org/dataModel.Transportation/averageDistanceKm", "averageGapDistance": "https://smartdatamodels.org/dataModel.Transportation/averageGapDistance", "averageHeadwayTime": "https://smartdatamodels.org/dataModel.Transportation/averageHeadwayTime", "averageLength": "https://smartdatamodels.org/dataModel.Transportation/averageLength", @@ -64,7 +68,7 @@ "battery": "https://smartdatamodels.org/dataModel.Transportation/battery", "bbox": { "@container": "@list", - "@id": "geojson:bbox" + "@id": "https://purl.org/geojson/vocab#bbox" }, "bearing": "https://smartdatamodels.org/dataModel.Transportation/bearing", "binaryContent": "https://smartdatamodels.org/dataModel.Transportation/binaryContent", @@ -100,7 +104,7 @@ "contractingCompany": "https://smartdatamodels.org/dataModel.Transportation/contractingCompany", "coordinates": { "@container": "@list", - "@id": "geojson:coordinates" + "@id": "https://purl.org/geojson/vocab#coordinates" }, "countOfBusLineImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfBusLineImpacted", "countOfDerogation": "https://smartdatamodels.org/dataModel.Transportation/countOfDerogation", @@ -113,6 +117,7 @@ "countOfSubwayLineImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfSubwayLineImpacted", "countOfTramwayLineImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfTramwayLineImpacted", "country": "https://smartdatamodels.org/dataModel.Transportation/country", + "countryCode": "https://smartdatamodels.org/dataModel.Transportation/countryCode", "creator": "https://smartdatamodels.org/dataModel.Transportation/creator", "culvertCount": "https://smartdatamodels.org/dataModel.Transportation/culvertCount", "currencyAccepted": "https://smartdatamodels.org/dataModel.Transportation/currencyAccepted", @@ -145,10 +150,14 @@ "derogationType": "https://smartdatamodels.org/dataModel.Transportation/derogationType", "description": "http://purl.org/dc/terms/description", "dest": "https://smartdatamodels.org/dataModel.Transportation/dest", + "destinationLocation": "https://smartdatamodels.org/dataModel.Transportation/destinationLocation", + "destinationLocationCode": "https://smartdatamodels.org/dataModel.Transportation/destinationLocationCode", + "destinationLocationName": "https://smartdatamodels.org/dataModel.Transportation/destinationLocationName", "destinationStopCategory": "https://smartdatamodels.org/dataModel.Transportation/destinationStopCategory", "destinationStopId": "https://smartdatamodels.org/dataModel.Transportation/destinationStopId", "destinationStopName": "https://smartdatamodels.org/dataModel.Transportation/destinationStopName", "deviceBatteryStatus": "https://smartdatamodels.org/dataModel.Transportation/deviceBatteryStatus", + "deviceBrand": "https://smartdatamodels.org/dataModel.Transportation/deviceBrand", "deviceSimNumber": "https://smartdatamodels.org/dataModel.Transportation/deviceSimNumber", "dimension": "https://smartdatamodels.org/dataModel.Transportation/dimension", "direction": "https://smartdatamodels.org/dataModel.Transportation/direction", @@ -189,6 +198,8 @@ "fleetVehicleOperation": "https://smartdatamodels.org/dataModel.Transportation/fleetVehicleOperation", "fleetVehicleStatus": "https://smartdatamodels.org/dataModel.Transportation/fleetVehicleStatus", "fleetVehicleType": "https://smartdatamodels.org/dataModel.Transportation/fleetVehicleType", + "flowCount": "https://smartdatamodels.org/dataModel.Transportation/flowCount", + "flowType": "https://smartdatamodels.org/dataModel.Transportation/flowType", "freeSlotNumber": "https://smartdatamodels.org/dataModel.Transportation/freeSlotNumber", "fuelConsumption": "https://smartdatamodels.org/dataModel.Transportation/fuelConsumption", "fuelEfficiency": "https://smartdatamodels.org/dataModel.Transportation/fuelEfficiency", @@ -237,7 +248,8 @@ "lineName": "https://smartdatamodels.org/dataModel.Transportation/lineName", "linesConnected": "https://smartdatamodels.org/dataModel.Transportation/linesConnected", "localId": "https://smartdatamodels.org/dataModel.Transportation/localId", - "location": "ngsi-ld:location", + "location": "https://uri.etsi.org/ngsi-ld/location", + "locationCode": "https://smartdatamodels.org/dataModel.Transportation/locationCode", "locationType": "https://smartdatamodels.org/dataModel.Transportation/locationType", "mainContractingCompany": "https://smartdatamodels.org/dataModel.Transportation/mainContractingCompany", "manufacturerName": "https://smartdatamodels.org/dataModel.Transportation/manufacturerName", @@ -258,8 +270,12 @@ "minimumAllowedSpeed": "https://smartdatamodels.org/dataModel.Transportation/minimumAllowedSpeed", "model": "https://smartdatamodels.org/dataModel.Transportation/model", "modelName": "https://smartdatamodels.org/dataModel.Transportation/modelName", + "municipality": "https://smartdatamodels.org/dataModel.Transportation/municipality", "municipalityInfo": "https://smartdatamodels.org/dataModel.Transportation/municipalityInfo", + "n": "https://smartdatamodels.org/dataModel.Transportation/n", "name": "https://smartdatamodels.org/name", + "nationality": "https://smartdatamodels.org/dataModel.Transportation/nationality", + "nationalityName": "https://smartdatamodels.org/dataModel.Transportation/nationalityName", "nbOfIOPoint": "https://smartdatamodels.org/dataModel.Transportation/nbOfIOPoint", "nbOfLane": "https://smartdatamodels.org/dataModel.Transportation/nbOfLane", "nbOfPlatform": "https://smartdatamodels.org/dataModel.Transportation/nbOfPlatform", @@ -274,8 +290,8 @@ "observationEndDateTime": "https://smartdatamodels.org/dataModel.Transportation/observationEndDateTime", "observationStartDateTime": "https://smartdatamodels.org/dataModel.Transportation/observationStartDateTime", "observedAt": { - "@id": "ngsi-ld:observedAt", - "@type": "DateTime" + "@id": "https://uri.etsi.org/ngsi-ld/observedAt", + "@type": "https://uri.etsi.org/ngsi-ld/DateTime" }, "observedBy": "https://smartdatamodels.org/dataModel.Transportation/observedBy", "observedCredentialCharacterConfidence": "https://smartdatamodels.org/dataModel.Transportation/observedCredentialCharacterConfidence", @@ -309,6 +325,9 @@ "operator": "https://smartdatamodels.org/dataModel.Transportation/operator", "orig": "https://smartdatamodels.org/dataModel.Transportation/orig", "originDestinationCode": "https://smartdatamodels.org/dataModel.Transportation/originDestinationCode", + "originLocation": "https://smartdatamodels.org/dataModel.Transportation/originLocation", + "originLocationCode": "https://smartdatamodels.org/dataModel.Transportation/originLocationCode", + "originLocationName": "https://smartdatamodels.org/dataModel.Transportation/originLocationName", "originStopCategory": "https://smartdatamodels.org/dataModel.Transportation/originStopCategory", "originStopId": "https://smartdatamodels.org/dataModel.Transportation/originStopId", "originStopName": "https://smartdatamodels.org/dataModel.Transportation/originStopName", @@ -327,6 +346,9 @@ "pedestrianPathRightWidth": "https://smartdatamodels.org/dataModel.Transportation/pedestrianPathRightWidth", "pedestriansInvolved": "https://smartdatamodels.org/dataModel.Transportation/pedestriansInvolved", "peopleCount": "https://smartdatamodels.org/dataModel.Transportation/peopleCount", + "peopleCountAway": "https://smartdatamodels.org/dataModel.Transportation/peopleCountAway", + "peopleCountTowards": "https://smartdatamodels.org/dataModel.Transportation/peopleCountTowards", + "plateColor": "https://smartdatamodels.org/dataModel.Transportation/plateColor", "platformCode": "https://smartdatamodels.org/dataModel.Transportation/platformCode", "postOfficeBoxNumber": "https://smartdatamodels.org/postOfficeBoxNumber", "postalCode": "https://smartdatamodels.org/postalCode", @@ -346,6 +368,7 @@ "refRoad": "https://smartdatamodels.org/dataModel.Transportation/refRoad", "refRoadSegment": "https://smartdatamodels.org/dataModel.Transportation/refRoadSegment", "refVehicleModel": "https://smartdatamodels.org/dataModel.Transportation/refVehicleModel", + "region": "https://smartdatamodels.org/dataModel.Transportation/region", "regulation": "https://smartdatamodels.org/dataModel.Transportation/regulation", "reportId": "https://smartdatamodels.org/dataModel.Transportation/reportId", "resolvedAt": "https://smartdatamodels.org/dataModel.Transportation/resolvedAt", @@ -407,7 +430,7 @@ "stationLocation": "https://smartdatamodels.org/dataModel.Transportation/stationLocation", "stationName": "https://smartdatamodels.org/dataModel.Transportation/stationName", "stationType": "https://smartdatamodels.org/dataModel.Transportation/stationType", - "status": "ngsi-ld:status", + "status": "https://uri.etsi.org/ngsi-ld/status", "statusDescription": "https://smartdatamodels.org/dataModel.Transportation/statusDescription", "streetAddress": "https://smartdatamodels.org/streetAddress", "streetNr": "https://smartdatamodels.org/streetNr", diff --git a/context2.jsonld b/context2.jsonld deleted file mode 100644 index 3ce6c9796..000000000 --- a/context2.jsonld +++ /dev/null @@ -1,474 +0,0 @@ -{ - "@context": { - "APDSObservation": "https://smartdatamodels.org/dataModel.Transportation/APDSObservation", - "AnonymousCommuterId": "https://smartdatamodels.org/dataModel.Transportation/AnonymousCommuterId", - "AnprFlowObserved": "https://smartdatamodels.org/dataModel.Transportation/AnprFlowObserved", - "BikeHireDockingStation": "https://smartdatamodels.org/dataModel.Transportation/BikeHireDockingStation", - "BikeLane": "https://smartdatamodels.org/dataModel.Transportation/BikeLane", - "CityWork": "https://smartdatamodels.org/dataModel.Transportation/CityWork", - "CrowdFlowObserved": "https://smartdatamodels.org/dataModel.Transportation/CrowdFlowObserved", - "EVChargingStation": "https://smartdatamodels.org/dataModel.Transportation/EVChargingStation", - "FareCollectionSystem": "https://smartdatamodels.org/dataModel.Transportation/FareCollectionSystem", - "FleetVehicle": "https://smartdatamodels.org/dataModel.Transportation/FleetVehicle", - "FleetVehicleOperation": "https://smartdatamodels.org/dataModel.Transportation/FleetVehicleOperation", - "FleetVehicleStatus": "https://smartdatamodels.org/dataModel.Transportation/FleetVehicleStatus", - "ItemFlowObserved": "https://smartdatamodels.org/dataModel.Transportation/ItemFlowObserved", - "PlatformType": "https://smartdatamodels.org/dataModel.Transportation/PlatformType", - "RestrictedTrafficArea": "https://smartdatamodels.org/dataModel.Transportation/RestrictedTrafficArea", - "RestrictionException": "https://smartdatamodels.org/dataModel.Transportation/RestrictionException", - "Road": "https://smartdatamodels.org/dataModel.Transportation/Road", - "RoadAccident": "https://smartdatamodels.org/dataModel.Transportation/RoadAccident", - "RoadSegment": "https://smartdatamodels.org/dataModel.Transportation/RoadSegment", - "SpecialRestriction": "https://smartdatamodels.org/dataModel.Transportation/SpecialRestriction", - "TrafficFlowObserved": "https://smartdatamodels.org/dataModel.Transportation/TrafficFlowObserved", - "TrafficViolation": "https://smartdatamodels.org/dataModel.Transportation/TrafficViolation", - "TransportStation": "https://smartdatamodels.org/dataModel.Transportation/TransportStation", - "URL": "https://smartdatamodels.org/dataModel.Transportation/URL", - "Vehicle": "https://smartdatamodels.org/dataModel.Transportation/Vehicle", - "VehicleFault": "https://smartdatamodels.org/dataModel.Transportation/VehicleFault", - "VehicleModel": "https://smartdatamodels.org/dataModel.Transportation/VehicleModel", - "acceptedPaymentMethod": "https://smartdatamodels.org/dataModel.Transportation/acceptedPaymentMethod", - "accidentDate": "https://smartdatamodels.org/dataModel.Transportation/accidentDate", - "accidentDescription": "https://smartdatamodels.org/dataModel.Transportation/accidentDescription", - "accidentLocation": "https://smartdatamodels.org/dataModel.Transportation/accidentLocation", - "accidentStatisticalDate": "https://smartdatamodels.org/dataModel.Transportation/accidentStatisticalDate", - "accidentType": "https://smartdatamodels.org/dataModel.Transportation/accidentType", - "address": "https://smartdatamodels.org/address", - "addressCountry": "https://smartdatamodels.org/addressCountry", - "addressLocality": "https://smartdatamodels.org/addressLocality", - "addressRegion": "https://smartdatamodels.org/addressRegion", - "agency_fare_url": "https://smartdatamodels.org/dataModel.Transportation/agency_fare_url", - "agency_name": "https://smartdatamodels.org/dataModel.Transportation/agency_name", - "agency_url": "https://smartdatamodels.org/dataModel.Transportation/agency_url", - "algorithm": "https://smartdatamodels.org/dataModel.Transportation/algorithm", - "allowedVehicle": "https://smartdatamodels.org/dataModel.Transportation/allowedVehicle", - "allowedVehicleType": "https://smartdatamodels.org/dataModel.Transportation/allowedVehicleType", - "alternateName": "https://smartdatamodels.org/alternateName", - "amountCollected": "https://smartdatamodels.org/dataModel.Transportation/amountCollected", - "amperage": "https://smartdatamodels.org/dataModel.Transportation/amperage", - "annotations": "https://smartdatamodels.org/annotations", - "anonymizedId": "https://smartdatamodels.org/dataModel.Transportation/anonymizedId", - "areaServed": "https://smartdatamodels.org/areaServed", - "availabilityRestriction": "https://smartdatamodels.org/availabilityRestriction", - "availableBikeNumber": "https://smartdatamodels.org/dataModel.Transportation/availableBikeNumber", - "availableCapacity": "https://smartdatamodels.org/dataModel.Transportation/availableCapacity", - "availableLanguage": "https://smartdatamodels.org/availableLanguage", - "averageCrowdSpeed": "https://smartdatamodels.org/dataModel.Transportation/averageCrowdSpeed", - "averageGapDistance": "https://smartdatamodels.org/dataModel.Transportation/averageGapDistance", - "averageHeadwayTime": "https://smartdatamodels.org/dataModel.Transportation/averageHeadwayTime", - "averageLength": "https://smartdatamodels.org/dataModel.Transportation/averageLength", - "averageSpeed": "https://smartdatamodels.org/dataModel.Transportation/averageSpeed", - "averageVehicleLength": "https://smartdatamodels.org/dataModel.Transportation/averageVehicleLength", - "averageVehicleSpeed": "https://smartdatamodels.org/dataModel.Transportation/averageVehicleSpeed", - "battery": "https://smartdatamodels.org/dataModel.Transportation/battery", - "bbox": { - "@container": "@list", - "@id": "https://purl.org/geojson/vocab#bbox" - }, - "bearing": "https://smartdatamodels.org/dataModel.Transportation/bearing", - "binaryContent": "https://smartdatamodels.org/dataModel.Transportation/binaryContent", - "brand": "https://smartdatamodels.org/dataModel.Transportation/brand", - "brandName": "https://smartdatamodels.org/dataModel.Transportation/brandName", - "bridgeCount": "https://smartdatamodels.org/dataModel.Transportation/bridgeCount", - "busImpacted": "https://smartdatamodels.org/dataModel.Transportation/busImpacted", - "camId": "https://smartdatamodels.org/dataModel.Transportation/camId", - "capacity": "https://smartdatamodels.org/dataModel.Transportation/capacity", - "cardId": "https://smartdatamodels.org/dataModel.Transportation/cardId", - "cargoVolume": "https://smartdatamodels.org/dataModel.Transportation/cargoVolume", - "cargoWeight": "https://smartdatamodels.org/dataModel.Transportation/cargoWeight", - "carriagewayLength": "https://smartdatamodels.org/dataModel.Transportation/carriagewayLength", - "carriagewayWidth": "https://smartdatamodels.org/dataModel.Transportation/carriagewayWidth", - "category": "https://smartdatamodels.org/dataModel.Transportation/category", - "chargeType": "https://smartdatamodels.org/dataModel.Transportation/chargeType", - "chargingUnitId": "https://smartdatamodels.org/dataModel.Transportation/chargingUnitId", - "cityId": "https://smartdatamodels.org/dataModel.Transportation/cityId", - "cityName": "https://smartdatamodels.org/dataModel.Transportation/cityName", - "closes": "https://smartdatamodels.org/closes", - "code": "https://smartdatamodels.org/dataModel.Transportation/code", - "color": "https://smartdatamodels.org/color", - "comment": "https://smartdatamodels.org/dataModel.Transportation/comment", - "confidence": "https://smartdatamodels.org/dataModel.Transportation/confidence", - "congested": "https://smartdatamodels.org/dataModel.Transportation/congested", - "contactOption": "https://smartdatamodels.org/contactOption", - "contactPoint": "https://smartdatamodels.org/contactPoint", - "contactType": "https://smartdatamodels.org/contactType", - "contentType": "https://smartdatamodels.org/dataModel.Transportation/contentType", - "contractingAuthority": "https://smartdatamodels.org/dataModel.Transportation/contractingAuthority", - "contractingCompany": "https://smartdatamodels.org/dataModel.Transportation/contractingCompany", - "coordinates": { - "@container": "@list", - "@id": "https://purl.org/geojson/vocab#coordinates" - }, - "countOfBusLineImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfBusLineImpacted", - "countOfDerogation": "https://smartdatamodels.org/dataModel.Transportation/countOfDerogation", - "countOfEventImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfEventImpacted", - "countOfRailwayLineImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfRailwayLineImpacted", - "countOfRoadImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfRoadImpacted", - "countOfSchoolBusLineImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfSchoolBusLineImpacted", - "countOfSchoolImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfSchoolImpacted", - "countOfStationImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfStationImpacted", - "countOfSubwayLineImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfSubwayLineImpacted", - "countOfTramwayLineImpacted": "https://smartdatamodels.org/dataModel.Transportation/countOfTramwayLineImpacted", - "country": "https://smartdatamodels.org/dataModel.Transportation/country", - "creator": "https://smartdatamodels.org/dataModel.Transportation/creator", - "culvertCount": "https://smartdatamodels.org/dataModel.Transportation/culvertCount", - "currentOperative": "https://smartdatamodels.org/dataModel.Transportation/currentOperative", - "currentStatus": "https://smartdatamodels.org/dataModel.Transportation/currentStatus", - "currentTripCount": "https://smartdatamodels.org/dataModel.Transportation/currentTripCount", - "cyclePathLeftHeight": "https://smartdatamodels.org/dataModel.Transportation/cyclePathLeftHeight", - "cyclePathLeftWidth": "https://smartdatamodels.org/dataModel.Transportation/cyclePathLeftWidth", - "cyclePathMaterial": "https://smartdatamodels.org/dataModel.Transportation/cyclePathMaterial", - "cyclePathPlacement": "https://smartdatamodels.org/dataModel.Transportation/cyclePathPlacement", - "cyclePathRightHeight": "https://smartdatamodels.org/dataModel.Transportation/cyclePathRightHeight", - "cyclePathRightWidth": "https://smartdatamodels.org/dataModel.Transportation/cyclePathRightWidth", - "dataDescriptor": "https://smartdatamodels.org/dataModel.Transportation/dataDescriptor", - "dataProvider": "https://smartdatamodels.org/dataProvider", - "date": "https://smartdatamodels.org/dataModel.Transportation/date", - "dateCreated": "https://smartdatamodels.org/dateCreated", - "dateFirstUsed": "https://smartdatamodels.org/dataModel.Transportation/dateFirstUsed", - "dateLastReported": "https://smartdatamodels.org/dataModel.Transportation/dateLastReported", - "dateModified": "https://smartdatamodels.org/dateModified", - "dateObserved": "https://smartdatamodels.org/dateObserved", - "dateObservedFrom": "https://smartdatamodels.org/dataModel.Transportation/dateObservedFrom", - "dateObservedTo": "https://smartdatamodels.org/dataModel.Transportation/dateObservedTo", - "dateReceived": "https://smartdatamodels.org/dataModel.Transportation/dateReceived", - "dateVehicleFirstRegistered": "https://smartdatamodels.org/dataModel.Transportation/dateVehicleFirstRegistered", - "dayOfWeek": "https://smartdatamodels.org/dayOfWeek", - "decrees": "https://smartdatamodels.org/dataModel.Transportation/decrees", - "depth": "https://smartdatamodels.org/dataModel.Transportation/depth", - "derogation": "https://smartdatamodels.org/dataModel.Transportation/derogation", - "derogationType": "https://smartdatamodels.org/dataModel.Transportation/derogationType", - "description": "http://purl.org/dc/terms/description", - "dest": "https://smartdatamodels.org/dataModel.Transportation/dest", - "destinationStopCategory": "https://smartdatamodels.org/dataModel.Transportation/destinationStopCategory", - "destinationStopId": "https://smartdatamodels.org/dataModel.Transportation/destinationStopId", - "destinationStopName": "https://smartdatamodels.org/dataModel.Transportation/destinationStopName", - "deviceBatteryStatus": "https://smartdatamodels.org/dataModel.Transportation/deviceBatteryStatus", - "deviceSimNumber": "https://smartdatamodels.org/dataModel.Transportation/deviceSimNumber", - "dimension": "https://smartdatamodels.org/dataModel.Transportation/dimension", - "direction": "https://smartdatamodels.org/dataModel.Transportation/direction", - "direction_id": "https://smartdatamodels.org/dataModel.Transportation/direction_id", - "disposition": "https://smartdatamodels.org/dataModel.Transportation/disposition", - "distance": "https://smartdatamodels.org/dataModel.Transportation/distance", - "district": "https://smartdatamodels.org/district", - "dtCode": "https://smartdatamodels.org/dataModel.Transportation/dtCode", - "email": "https://smartdatamodels.org/email", - "emergencyVehicleType": "https://smartdatamodels.org/dataModel.Transportation/emergencyVehicleType", - "encroachment": "https://smartdatamodels.org/dataModel.Transportation/encroachment", - "endDate": "https://smartdatamodels.org/endDate", - "endDateTime": "https://smartdatamodels.org/dataModel.Transportation/endDateTime", - "endKilometer": "https://smartdatamodels.org/dataModel.Transportation/endKilometer", - "endPoint": "https://smartdatamodels.org/dataModel.Transportation/endPoint", - "endedAt": "https://smartdatamodels.org/dataModel.Transportation/endedAt", - "entryAreaCode": "https://smartdatamodels.org/dataModel.Transportation/entryAreaCode", - "equipmentCompanyCode": "https://smartdatamodels.org/dataModel.Transportation/equipmentCompanyCode", - "equipmentId": "https://smartdatamodels.org/dataModel.Transportation/equipmentId", - "equipmentSequenceNumber": "https://smartdatamodels.org/dataModel.Transportation/equipmentSequenceNumber", - "equipmentStopId": "https://smartdatamodels.org/dataModel.Transportation/equipmentStopId", - "equipmentType": "https://smartdatamodels.org/dataModel.Transportation/equipmentType", - "equipmentTypeCode": "https://smartdatamodels.org/dataModel.Transportation/equipmentTypeCode", - "eventType": "https://smartdatamodels.org/dataModel.Transportation/eventType", - "eventsImpacted": "https://smartdatamodels.org/dataModel.Transportation/eventsImpacted", - "exceptionValidityHours": "https://smartdatamodels.org/dataModel.Transportation/exceptionValidityHours", - "exitAreaCode": "https://smartdatamodels.org/dataModel.Transportation/exitAreaCode", - "expiryDateTime": "https://smartdatamodels.org/dataModel.Transportation/expiryDateTime", - "fareForAdult": "https://smartdatamodels.org/dataModel.Transportation/fareForAdult", - "fareForChild": "https://smartdatamodels.org/dataModel.Transportation/fareForChild", - "faultLog": "https://smartdatamodels.org/dataModel.Transportation/faultLog", - "faxNumber": "https://smartdatamodels.org/faxNumber", - "feature": "https://smartdatamodels.org/dataModel.Transportation/feature", - "fleetVehicle": "https://smartdatamodels.org/dataModel.Transportation/fleetVehicle", - "fleetVehicleId": "https://smartdatamodels.org/dataModel.Transportation/fleetVehicleId", - "fleetVehicleOperation": "https://smartdatamodels.org/dataModel.Transportation/fleetVehicleOperation", - "fleetVehicleStatus": "https://smartdatamodels.org/dataModel.Transportation/fleetVehicleStatus", - "fleetVehicleType": "https://smartdatamodels.org/dataModel.Transportation/fleetVehicleType", - "freeSlotNumber": "https://smartdatamodels.org/dataModel.Transportation/freeSlotNumber", - "fuelConsumption": "https://smartdatamodels.org/dataModel.Transportation/fuelConsumption", - "fuelEfficiency": "https://smartdatamodels.org/dataModel.Transportation/fuelEfficiency", - "fuelFilled": "https://smartdatamodels.org/dataModel.Transportation/fuelFilled", - "fuelType": "https://smartdatamodels.org/dataModel.Transportation/fuelType", - "givenName": "https://smartdatamodels.org/givenName", - "heading": "https://smartdatamodels.org/dataModel.Transportation/heading", - "height": "https://smartdatamodels.org/dataModel.Transportation/height", - "hour": "https://smartdatamodels.org/dataModel.Transportation/hour", - "id": "@id", - "identifier": "https://smartdatamodels.org/dataModel.Transportation/identifier", - "ignitionStatus": "https://smartdatamodels.org/dataModel.Transportation/ignitionStatus", - "image": "https://smartdatamodels.org/image", - "imageContent": "https://smartdatamodels.org/dataModel.Transportation/imageContent", - "imageType": "https://smartdatamodels.org/dataModel.Transportation/imageType", - "images": "https://smartdatamodels.org/dataModel.Transportation/images", - "inRestrictedArea": "https://smartdatamodels.org/dataModel.Transportation/inRestrictedArea", - "infrastructureFunction": "https://smartdatamodels.org/dataModel.Transportation/infrastructureFunction", - "initiatingLocation": "https://smartdatamodels.org/dataModel.Transportation/initiatingLocation", - "installationMode": "https://smartdatamodels.org/dataModel.Transportation/installationMode", - "intensity": "https://smartdatamodels.org/dataModel.Transportation/intensity", - "inventory": "https://smartdatamodels.org/dataModel.Transportation/inventory", - "isMainRoadImpactedHTR": "https://smartdatamodels.org/dataModel.Transportation/isMainRoadImpactedHTR", - "isMobile": "https://smartdatamodels.org/dataModel.Transportation/isMobile", - "itemSubType": "https://smartdatamodels.org/dataModel.Transportation/itemSubType", - "itemType": "https://smartdatamodels.org/dataModel.Transportation/itemType", - "jobTitle": "https://smartdatamodels.org/dataModel.Transportation/jobTitle", - "laneDirection": "https://smartdatamodels.org/dataModel.Transportation/laneDirection", - "laneId": "https://smartdatamodels.org/dataModel.Transportation/laneId", - "laneInfo": "https://smartdatamodels.org/dataModel.Transportation/laneInfo", - "laneLength": "https://smartdatamodels.org/dataModel.Transportation/laneLength", - "laneOccupancy": "https://smartdatamodels.org/dataModel.Transportation/laneOccupancy", - "laneUsage": "https://smartdatamodels.org/dataModel.Transportation/laneUsage", - "laneWidth": "https://smartdatamodels.org/dataModel.Transportation/laneWidth", - "lastFuellingAmount": "https://smartdatamodels.org/dataModel.Transportation/lastFuellingAmount", - "lastKnownPosition": "https://smartdatamodels.org/dataModel.Transportation/lastKnownPosition", - "lastKnownPositionUpdatedAt": "https://smartdatamodels.org/dataModel.Transportation/lastKnownPositionUpdatedAt", - "length": "https://smartdatamodels.org/dataModel.Transportation/length", - "levelId": "https://smartdatamodels.org/dataModel.Transportation/levelId", - "licensePlate": "https://smartdatamodels.org/dataModel.Transportation/licensePlate", - "license_plate": "https://smartdatamodels.org/dataModel.Transportation/license_plate", - "lineId": "https://smartdatamodels.org/dataModel.Transportation/lineId", - "lineLocation": "https://smartdatamodels.org/dataModel.Transportation/lineLocation", - "lineName": "https://smartdatamodels.org/dataModel.Transportation/lineName", - "linesConnected": "https://smartdatamodels.org/dataModel.Transportation/linesConnected", - "localId": "https://smartdatamodels.org/dataModel.Transportation/localId", - "location": "https://uri.etsi.org/ngsi-ld/location", - "locationType": "https://smartdatamodels.org/dataModel.Transportation/locationType", - "mainContractingCompany": "https://smartdatamodels.org/dataModel.Transportation/mainContractingCompany", - "manufacturerName": "https://smartdatamodels.org/dataModel.Transportation/manufacturerName", - "maxAuthorizedTonnage": "https://smartdatamodels.org/dataModel.Transportation/maxAuthorizedTonnage", - "maxSpeed": "https://smartdatamodels.org/dataModel.Transportation/maxSpeed", - "maxTonnage": "https://smartdatamodels.org/dataModel.Transportation/maxTonnage", - "maximumAllowedHeight": "https://smartdatamodels.org/dataModel.Transportation/maximumAllowedHeight", - "maximumAllowedSpeed": "https://smartdatamodels.org/dataModel.Transportation/maximumAllowedSpeed", - "maximumAllowedWeight": "https://smartdatamodels.org/dataModel.Transportation/maximumAllowedWeight", - "maximumAllowedWidth": "https://smartdatamodels.org/dataModel.Transportation/maximumAllowedWidth", - "mediaURL": "https://smartdatamodels.org/dataModel.Transportation/mediaURL", - "medianHeight": "https://smartdatamodels.org/dataModel.Transportation/medianHeight", - "medianLength": "https://smartdatamodels.org/dataModel.Transportation/medianLength", - "medianWidth": "https://smartdatamodels.org/dataModel.Transportation/medianWidth", - "mileageFromOdometer": "https://smartdatamodels.org/dataModel.Transportation/mileageFromOdometer", - "minSpeed": "https://smartdatamodels.org/dataModel.Transportation/minSpeed", - "minimumAllowedSpeed": "https://smartdatamodels.org/dataModel.Transportation/minimumAllowedSpeed", - "model": "https://smartdatamodels.org/dataModel.Transportation/model", - "modelName": "https://smartdatamodels.org/dataModel.Transportation/modelName", - "municipalityInfo": "https://smartdatamodels.org/dataModel.Transportation/municipalityInfo", - "name": "https://smartdatamodels.org/name", - "nbOfIOPoint": "https://smartdatamodels.org/dataModel.Transportation/nbOfIOPoint", - "nbOfLane": "https://smartdatamodels.org/dataModel.Transportation/nbOfLane", - "nbOfPlatform": "https://smartdatamodels.org/dataModel.Transportation/nbOfPlatform", - "network": "https://smartdatamodels.org/dataModel.Transportation/network", - "ngsi-ld": "https://uri.etsi.org/ngsi-ld/", - "notAllowedVehicleType": "https://smartdatamodels.org/dataModel.Transportation/notAllowedVehicleType", - "numPassengersDead": "https://smartdatamodels.org/dataModel.Transportation/numPassengersDead", - "numPassengersInjured": "https://smartdatamodels.org/dataModel.Transportation/numPassengersInjured", - "numPedestrianDead": "https://smartdatamodels.org/dataModel.Transportation/numPedestrianDead", - "numPedestrianInjured": "https://smartdatamodels.org/dataModel.Transportation/numPedestrianInjured", - "observationDateTime": "https://smartdatamodels.org/dataModel.Transportation/observationDateTime", - "observationEndDateTime": "https://smartdatamodels.org/dataModel.Transportation/observationEndDateTime", - "observationStartDateTime": "https://smartdatamodels.org/dataModel.Transportation/observationStartDateTime", - "observedAt": { - "@id": "https://uri.etsi.org/ngsi-ld/observedAt", - "@type": "https://uri.etsi.org/ngsi-ld/DateTime" - }, - "observedBy": "https://smartdatamodels.org/dataModel.Transportation/observedBy", - "observedCredentialCharacterConfidence": "https://smartdatamodels.org/dataModel.Transportation/observedCredentialCharacterConfidence", - "observedCredentialConfidence": "https://smartdatamodels.org/dataModel.Transportation/observedCredentialConfidence", - "observedCredentialCountry": "https://smartdatamodels.org/dataModel.Transportation/observedCredentialCountry", - "observedCredentialId": "https://smartdatamodels.org/dataModel.Transportation/observedCredentialId", - "observedCredentialType": "https://smartdatamodels.org/dataModel.Transportation/observedCredentialType", - "observedHeading": "https://smartdatamodels.org/dataModel.Transportation/observedHeading", - "observedLocation": "https://smartdatamodels.org/dataModel.Transportation/observedLocation", - "observedLocationPDOP": "https://smartdatamodels.org/dataModel.Transportation/observedLocationPDOP", - "observedMethod": "https://smartdatamodels.org/dataModel.Transportation/observedMethod", - "observedSpeed": "https://smartdatamodels.org/dataModel.Transportation/observedSpeed", - "observedVehicle": "https://smartdatamodels.org/dataModel.Transportation/observedVehicle", - "observedVehicleColour": "https://smartdatamodels.org/dataModel.Transportation/observedVehicleColour", - "observedVehicleMake": "https://smartdatamodels.org/dataModel.Transportation/observedVehicleMake", - "observedVehicleType": "https://smartdatamodels.org/dataModel.Transportation/observedVehicleType", - "observer": "https://smartdatamodels.org/dataModel.Transportation/observer", - "observerCameras": "https://smartdatamodels.org/dataModel.Transportation/observerCameras", - "observerDescription": "https://smartdatamodels.org/dataModel.Transportation/observerDescription", - "observerHeading": "https://smartdatamodels.org/dataModel.Transportation/observerHeading", - "observerLocation": "https://smartdatamodels.org/dataModel.Transportation/observerLocation", - "observerLocationPDOP": "https://smartdatamodels.org/dataModel.Transportation/observerLocationPDOP", - "observerSpeed": "https://smartdatamodels.org/dataModel.Transportation/observerSpeed", - "occupancy": "https://smartdatamodels.org/dataModel.Transportation/occupancy", - "occupancyLevel": "https://smartdatamodels.org/dataModel.Transportation/occupancyLevel", - "openingHours": "https://smartdatamodels.org/openingHours", - "openingHoursSpecification": "https://smartdatamodels.org/openingHoursSpecification", - "opens": "https://smartdatamodels.org/opens", - "operatingCompany": "https://smartdatamodels.org/dataModel.Transportation/operatingCompany", - "operationType": "https://smartdatamodels.org/dataModel.Transportation/operationType", - "operator": "https://smartdatamodels.org/dataModel.Transportation/operator", - "orig": "https://smartdatamodels.org/dataModel.Transportation/orig", - "originDestinationCode": "https://smartdatamodels.org/dataModel.Transportation/originDestinationCode", - "originStopCategory": "https://smartdatamodels.org/dataModel.Transportation/originStopCategory", - "originStopId": "https://smartdatamodels.org/dataModel.Transportation/originStopId", - "originStopName": "https://smartdatamodels.org/dataModel.Transportation/originStopName", - "othersContractingCompany": "https://smartdatamodels.org/dataModel.Transportation/othersContractingCompany", - "outOfServiceSlotNumber": "https://smartdatamodels.org/dataModel.Transportation/outOfServiceSlotNumber", - "owner": "https://smartdatamodels.org/owner", - "parentStation": "https://smartdatamodels.org/dataModel.Transportation/parentStation", - "passengerCount": "https://smartdatamodels.org/dataModel.Transportation/passengerCount", - "paymentStatus": "https://smartdatamodels.org/dataModel.Transportation/paymentStatus", - "pedestrianPathLeftHeight": "https://smartdatamodels.org/dataModel.Transportation/pedestrianPathLeftHeight", - "pedestrianPathLeftWidth": "https://smartdatamodels.org/dataModel.Transportation/pedestrianPathLeftWidth", - "pedestrianPathMaterial": "https://smartdatamodels.org/dataModel.Transportation/pedestrianPathMaterial", - "pedestrianPathPlacement": "https://smartdatamodels.org/dataModel.Transportation/pedestrianPathPlacement", - "pedestrianPathRightHeight": "https://smartdatamodels.org/dataModel.Transportation/pedestrianPathRightHeight", - "pedestrianPathRightWidth": "https://smartdatamodels.org/dataModel.Transportation/pedestrianPathRightWidth", - "pedestriansInvolved": "https://smartdatamodels.org/dataModel.Transportation/pedestriansInvolved", - "peopleCount": "https://smartdatamodels.org/dataModel.Transportation/peopleCount", - "platformCode": "https://smartdatamodels.org/dataModel.Transportation/platformCode", - "postOfficeBoxNumber": "https://smartdatamodels.org/postOfficeBoxNumber", - "postalCode": "https://smartdatamodels.org/postalCode", - "powerConsumption": "https://smartdatamodels.org/dataModel.Transportation/powerConsumption", - "previousLocation": "https://smartdatamodels.org/dataModel.Transportation/previousLocation", - "processingType": "https://smartdatamodels.org/dataModel.Transportation/processingType", - "productSupported": "https://smartdatamodels.org/productSupported", - "provider": "https://smartdatamodels.org/dataModel.Transportation/provider", - "purchaseDate": "https://smartdatamodels.org/dataModel.Transportation/purchaseDate", - "quarter": "https://smartdatamodels.org/dataModel.Transportation/quarter", - "railwayImpacted": "https://smartdatamodels.org/dataModel.Transportation/railwayImpacted", - "refDevice": "https://smartdatamodels.org/dataModel.Transportation/refDevice", - "refImages": "https://smartdatamodels.org/dataModel.Transportation/refImages", - "refPointOfInterest": "https://smartdatamodels.org/dataModel.Transportation/refPointOfInterest", - "refRestrictedTrafficArea": "https://smartdatamodels.org/dataModel.Transportation/refRestrictedTrafficArea", - "refRoad": "https://smartdatamodels.org/dataModel.Transportation/refRoad", - "refRoadSegment": "https://smartdatamodels.org/dataModel.Transportation/refRoadSegment", - "refVehicleModel": "https://smartdatamodels.org/dataModel.Transportation/refVehicleModel", - "regulation": "https://smartdatamodels.org/dataModel.Transportation/regulation", - "reportId": "https://smartdatamodels.org/dataModel.Transportation/reportId", - "resolvedAt": "https://smartdatamodels.org/dataModel.Transportation/resolvedAt", - "responseTime": "https://smartdatamodels.org/dataModel.Transportation/responseTime", - "responsible": "https://smartdatamodels.org/dataModel.Transportation/responsible", - "restFuelAmount": "https://smartdatamodels.org/dataModel.Transportation/restFuelAmount", - "restrictionExceptions": "https://smartdatamodels.org/dataModel.Transportation/restrictionExceptions", - "restrictionValidityHours": "https://smartdatamodels.org/dataModel.Transportation/restrictionValidityHours", - "result": "https://smartdatamodels.org/dataModel.Transportation/result", - "reverseLane": "https://smartdatamodels.org/dataModel.Transportation/reverseLane", - "reversedLane": "https://smartdatamodels.org/dataModel.Transportation/reversedLane", - "rightOfWayWidth": "https://smartdatamodels.org/dataModel.Transportation/rightOfWayWidth", - "roadClass": "https://smartdatamodels.org/dataModel.Transportation/roadClass", - "roadDirection": "https://smartdatamodels.org/dataModel.Transportation/roadDirection", - "roadId": "https://smartdatamodels.org/dataModel.Transportation/roadId", - "roadImpacted": "https://smartdatamodels.org/dataModel.Transportation/roadImpacted", - "roadImpactedMT": "https://smartdatamodels.org/dataModel.Transportation/roadImpactedMT", - "roadImpactedSA": "https://smartdatamodels.org/dataModel.Transportation/roadImpactedSA", - "roadIntersection": "https://smartdatamodels.org/dataModel.Transportation/roadIntersection", - "roadLocation": "https://smartdatamodels.org/dataModel.Transportation/roadLocation", - "roadMaterial": "https://smartdatamodels.org/dataModel.Transportation/roadMaterial", - "roadName": "https://smartdatamodels.org/dataModel.Transportation/roadName", - "roadPaving": "https://smartdatamodels.org/dataModel.Transportation/roadPaving", - "roadSign": "https://smartdatamodels.org/dataModel.Transportation/roadSign", - "roadSurface": "https://smartdatamodels.org/dataModel.Transportation/roadSurface", - "roadTrunk": "https://smartdatamodels.org/dataModel.Transportation/roadTrunk", - "roadWork": "https://smartdatamodels.org/dataModel.Transportation/roadWork", - "route_id": "https://smartdatamodels.org/dataModel.Transportation/route_id", - "schoolBusImpacted": "https://smartdatamodels.org/dataModel.Transportation/schoolBusImpacted", - "schoolImpacted": "https://smartdatamodels.org/dataModel.Transportation/schoolImpacted", - "security": "https://smartdatamodels.org/dataModel.Transportation/security", - "seeAlso": "https://smartdatamodels.org/seeAlso", - "segmentId": "https://smartdatamodels.org/dataModel.Transportation/segmentId", - "segmentLocation": "https://smartdatamodels.org/dataModel.Transportation/segmentLocation", - "segmentName": "https://smartdatamodels.org/dataModel.Transportation/segmentName", - "serviceOnDuty": "https://smartdatamodels.org/dataModel.Transportation/serviceOnDuty", - "serviceProvided": "https://smartdatamodels.org/dataModel.Transportation/serviceProvided", - "serviceStatus": "https://smartdatamodels.org/dataModel.Transportation/serviceStatus", - "shiftOfOperation": "https://smartdatamodels.org/dataModel.Transportation/shiftOfOperation", - "socketNumber": "https://smartdatamodels.org/dataModel.Transportation/socketNumber", - "socketType": "https://smartdatamodels.org/dataModel.Transportation/socketType", - "source": "https://smartdatamodels.org/source", - "specialRestrictions": "https://smartdatamodels.org/dataModel.Transportation/specialRestrictions", - "speed": "https://smartdatamodels.org/dataModel.Transportation/speed", - "stage": "https://smartdatamodels.org/dataModel.Transportation/stage", - "startDate": "https://smartdatamodels.org/startDate", - "startDateTime": "https://smartdatamodels.org/dataModel.Transportation/startDateTime", - "startKilometer": "https://smartdatamodels.org/dataModel.Transportation/startKilometer", - "startPoint": "https://smartdatamodels.org/dataModel.Transportation/startPoint", - "startedAt": "https://smartdatamodels.org/dataModel.Transportation/startedAt", - "stateName": "https://smartdatamodels.org/dataModel.Transportation/stateName", - "stationCode": "https://smartdatamodels.org/dataModel.Transportation/stationCode", - "stationConnected": "https://smartdatamodels.org/dataModel.Transportation/stationConnected", - "stationId": "https://smartdatamodels.org/dataModel.Transportation/stationId", - "stationImpacted": "https://smartdatamodels.org/dataModel.Transportation/stationImpacted", - "stationLocation": "https://smartdatamodels.org/dataModel.Transportation/stationLocation", - "stationName": "https://smartdatamodels.org/dataModel.Transportation/stationName", - "stationType": "https://smartdatamodels.org/dataModel.Transportation/stationType", - "status": "https://uri.etsi.org/ngsi-ld/status", - "statusDescription": "https://smartdatamodels.org/dataModel.Transportation/statusDescription", - "streetAddress": "https://smartdatamodels.org/streetAddress", - "streetNr": "https://smartdatamodels.org/streetNr", - "subwayImpacted": "https://smartdatamodels.org/dataModel.Transportation/subwayImpacted", - "taxAmountCollected": "https://smartdatamodels.org/dataModel.Transportation/taxAmountCollected", - "telephone": "https://smartdatamodels.org/telephone", - "territorialArea": "https://smartdatamodels.org/dataModel.Transportation/territorialArea", - "ticketTypeCode": "https://smartdatamodels.org/dataModel.Transportation/ticketTypeCode", - "titleCode": "https://smartdatamodels.org/dataModel.Transportation/titleCode", - "totalCyclePathWidth": "https://smartdatamodels.org/dataModel.Transportation/totalCyclePathWidth", - "totalDeadPeopleWithin24Hours": "https://smartdatamodels.org/dataModel.Transportation/totalDeadPeopleWithin24Hours", - "totalDeadPeopleWithin30Days": "https://smartdatamodels.org/dataModel.Transportation/totalDeadPeopleWithin30Days", - "totalInjured": "https://smartdatamodels.org/dataModel.Transportation/totalInjured", - "totalLaneNumber": "https://smartdatamodels.org/dataModel.Transportation/totalLaneNumber", - "totalPedestrianPathLength": "https://smartdatamodels.org/dataModel.Transportation/totalPedestrianPathLength", - "totalPedestrianPathWidth": "https://smartdatamodels.org/dataModel.Transportation/totalPedestrianPathWidth", - "totalSlotNumber": "https://smartdatamodels.org/dataModel.Transportation/totalSlotNumber", - "towardsObserver": "https://smartdatamodels.org/dataModel.Transportation/towardsObserver", - "tramwayImpacted": "https://smartdatamodels.org/dataModel.Transportation/tramwayImpacted", - "transactionDateTime": "https://smartdatamodels.org/dataModel.Transportation/transactionDateTime", - "transactionId": "https://smartdatamodels.org/dataModel.Transportation/transactionId", - "transactionType": "https://smartdatamodels.org/dataModel.Transportation/transactionType", - "transactionTypeDescription": "https://smartdatamodels.org/dataModel.Transportation/transactionTypeDescription", - "transactionVehicleNum": "https://smartdatamodels.org/dataModel.Transportation/transactionVehicleNum", - "transportTime": "https://smartdatamodels.org/dataModel.Transportation/transportTime", - "travelDistance": "https://smartdatamodels.org/dataModel.Transportation/travelDistance", - "tripNetWeightCollected": "https://smartdatamodels.org/dataModel.Transportation/tripNetWeightCollected", - "trip_id": "https://smartdatamodels.org/dataModel.Transportation/trip_id", - "type": "@type", - "typeOfInterventionRequest": "https://smartdatamodels.org/dataModel.Transportation/typeOfInterventionRequest", - "ulbName": "https://smartdatamodels.org/dataModel.Transportation/ulbName", - "url": "https://smartdatamodels.org/url", - "validFrom": "https://smartdatamodels.org/validFrom", - "validThrough": "https://smartdatamodels.org/validThrough", - "validityEndDate": "https://smartdatamodels.org/dataModel.Transportation/validityEndDate", - "validityStartDate": "https://smartdatamodels.org/dataModel.Transportation/validityStartDate", - "vehicle": "https://smartdatamodels.org/dataModel.Transportation/vehicle", - "vehicleAltitude": "https://smartdatamodels.org/dataModel.Transportation/vehicleAltitude", - "vehicleConfiguration": "https://smartdatamodels.org/dataModel.Transportation/vehicleConfiguration", - "vehicleEngine": "https://smartdatamodels.org/dataModel.Transportation/vehicleEngine", - "vehicleIdentificationNumber": "https://smartdatamodels.org/dataModel.Transportation/vehicleIdentificationNumber", - "vehicleModelDate": "https://smartdatamodels.org/dataModel.Transportation/vehicleModelDate", - "vehiclePlateIdentifier": "https://smartdatamodels.org/dataModel.Transportation/vehiclePlateIdentifier", - "vehiclePlateNotRead": "https://smartdatamodels.org/dataModel.Transportation/vehiclePlateNotRead", - "vehicleRunningStatus": "https://smartdatamodels.org/dataModel.Transportation/vehicleRunningStatus", - "vehicleSpecialUsage": "https://smartdatamodels.org/dataModel.Transportation/vehicleSpecialUsage", - "vehicleSubType": "https://smartdatamodels.org/dataModel.Transportation/vehicleSubType", - "vehicleTrackerDevice": "https://smartdatamodels.org/dataModel.Transportation/vehicleTrackerDevice", - "vehicleType": "https://smartdatamodels.org/dataModel.Transportation/vehicleType", - "vehicle_label": "https://smartdatamodels.org/dataModel.Transportation/vehicle_label", - "vehiclesInvolved": "https://smartdatamodels.org/dataModel.Transportation/vehiclesInvolved", - "voltage": "https://smartdatamodels.org/dataModel.Transportation/voltage", - "wardId": "https://smartdatamodels.org/dataModel.Transportation/wardId", - "wardName": "https://smartdatamodels.org/dataModel.Transportation/wardName", - "wardNum": "https://smartdatamodels.org/dataModel.Transportation/wardNum", - "weakestSubject": "https://smartdatamodels.org/dataModel.Transportation/weakestSubject", - "weatherConditions": "https://smartdatamodels.org/dataModel.Transportation/weatherConditions", - "webSite": "https://smartdatamodels.org/dataModel.Transportation/webSite", - "weekday": "https://smartdatamodels.org/dataModel.Transportation/weekday", - "weight": "https://smartdatamodels.org/dataModel.Transportation/weight", - "wheelChairAccessible": "https://smartdatamodels.org/dataModel.Transportation/wheelChairAccessible", - "width": "https://smartdatamodels.org/dataModel.Transportation/width", - "workDate": "https://smartdatamodels.org/dataModel.Transportation/workDate", - "workDisposition": "https://smartdatamodels.org/dataModel.Transportation/workDisposition", - "workLastDateUpdate": "https://smartdatamodels.org/dataModel.Transportation/workLastDateUpdate", - "workLevel": "https://smartdatamodels.org/dataModel.Transportation/workLevel", - "workNature": "https://smartdatamodels.org/dataModel.Transportation/workNature", - "workNumber": "https://smartdatamodels.org/dataModel.Transportation/workNumber", - "workOtherImpact": "https://smartdatamodels.org/dataModel.Transportation/workOtherImpact", - "workReason": "https://smartdatamodels.org/dataModel.Transportation/workReason", - "workState": "https://smartdatamodels.org/dataModel.Transportation/workState", - "workTarget": "https://smartdatamodels.org/dataModel.Transportation/workTarget", - "workZone": "https://smartdatamodels.org/dataModel.Transportation/workZone", - "year": "https://smartdatamodels.org/dataModel.Transportation/year", - "zoneId": "https://smartdatamodels.org/dataModel.Transportation/zoneId", - "zoneName": "https://smartdatamodels.org/dataModel.Transportation/zoneName", - "zonesServed": "https://smartdatamodels.org/dataModel.Transportation/zonesServed" - } -} \ No newline at end of file