KielRegion Dokumentation Mobility Live Access (MLA)

Dokumentation für die Plattform MLA der KielRegion in NGSI-v2

Der MLA ist eine Plattform mit regionalen Mobilitätsdaten und dient als zentrale Schnittstelle bei der Umsetzung von innovativen Mobilitätslösungen. Die Beschreibung der auf der Plattform vorhandenen Datenmodelle wird kontinuierlich ausgebaut und stellt aktuell nur einen Auszug dar.

https://mobility.kielregion.de/datenplattform/

Account Token
- Get Token
Entitäten

Account Token 1

Nachdem ein Account eingerichtet wurde, kann man sich mit seinen Zugangsdaten einen Token holen. Mit diesem Token müssen die Abfragen dann autorisiert werden.

urlencoded

Get Token | POST {{account_host}}/oauth2/password

Description

Den Token und den refresh Token mittels Email und Passwort erhalten

Headers

Key	Value	Description
Content-Type	application/x-www-form-urlencoded

Body

Key	Value	Description
grant_type	password	Anfrage Type
username	{{EMAIL}}	Username ist die EMail
password	{{PASSWORT}}	Das Passwort des Users
client_id	{{TOKEN_SERVICE_CLIENT_ID}}	Cient ID wird dem Nutzer nach Anmeldung zugesendet
client_secret	{{TOKEN_SERVICE_CLIENT_SECRET}}	Cient Secret wird dem Nutzer nach Anmeldung zugesendet

Entitäten 7

Die Beschreibung der auf der Plattform vorhandenen Datenmodelle wird kontinuierlich ausgebaut und stellt aktuell nur einen Auszug dar.

SprottenFlotte | GET {{host}}/v2/entities

Description

Die SprottenFlotte ist ein regionales BikeSharing-Angebot.

Die Stationen der SprottenFlotte werden unter dem Datenmodell BikeHireDockingStation aufgeführt.

Headers

Key	Value	Description
fiware-service	{{fiware-service}}	Der NGSI Tenant
fiware-servicepath	{{fiware-servicepath}}	Der NGSI Service Path (hier immer “/”)

Query

Key	Value	Description
type	BikeHireDockingStation	Das Datenmodell
georel	near;maxDistance:100	GeoLocation Abfrage, Umgebung um Point mit einer maximalen Entfernung vom 100m
geometry	point	GeoLocation Type, hier Point
coords	54.33377,10.152124	Die GeoLocation als Bezugspunkt

Example Request

URL: https://context.fiware-staging.kielregion.addix.io/v2/entities?type=BikeHireDockingStation&georel=near;maxDistance:100&geometry=point&coords=54.33377,10.152124

Headers

Key	Value	Description
fiware-service	testfrank001
fiware-servicepath	/

Query

Key	Value	Description
type	BikeHireDockingStation	Das Datenmodell
georel	near;maxDistance:100	GeoLocation Abfrage Umgebung um Point mit einer maximalen Entfernung vom 100m
geometry	point	GeoLocation Type, hier Point
coords	54.33377,10.152124	die Koordinaten

Example Response

Body

[ { "id": "urn:ngsi:BikeHireDockingStation:KielRegion:24371", "type": "BikeHireDockingStation", "address": { "type": "PostalAddress", "value": { "addressLocality": "Kiel", "postalCode": "24105", "streetAddress": "Kiellinie " }, "metadata": {} }, "agency_fare_url": { "type": "Text", "value": "https://www.donkey.bike/pricing/", "metadata": {} }, "agency_name": { "type": "Text", "value": "Donkey Republic Kiel", "metadata": {} }, "agency_url": { "type": "Text", "value": "https://www.donkey.bike/cities/bike-rental-kiel/", "metadata": {} }, "areaServed": { "type": "Text", "value": "866", "metadata": {} }, "availableBikeNumber": { "type": "Number", "value": 8, "metadata": {} }, "bike_racks": { "type": "Number", "value": 30, "metadata": {} }, "contactPoint": { "type": "StructuredValue", "value": { "url": "https://www.donkey.bike/cities/bike-rental-kiel/", "email": "support@donkeyrepublic.com", "telephone": "+49 30 255 585617", "name": "Donkey Republic Kiel" }, "metadata": {} }, "freeSlotNumber": { "type": "Number", "value": 4, "metadata": {} }, "location": { "type": "geo:json", "value": { "type": "Point", "coordinates": [ 10.15225, 54.333833 ] }, "metadata": {} }, "mediaURL": { "type": "Text", "value": "", "metadata": {} }, "name": { "type": "Text", "value": "Anleger Reventlou", "metadata": {} }, "observationDateTime": { "type": "DateTime", "value": "2023-02-07T12:29:12.000Z", "metadata": {} }, "owner": { "type": "StructuredValue", "value": [ "urn:ngsi:Owner:KielRegion" ], "metadata": {} }, "totalSlotNumber": { "type": "Number", "value": 30, "metadata": {} } } ]

Code:

200

Taxistände | GET {{host}}/v2/entities/

Description

Taxistände in der KielRegion. Die Daten wurden aus OpenStreetMap (OSM) importiert.

Das Datenmodell ist PublicTransportStop und der Parameter zur Auswahl von Taxiständen ist transportationType==1500.

Headers

Key	Value	Description
fiware-service	{{fiware-service}}	Der NGSI Tenant
fiware-servicepath	{{fiware-servicepath}}	Der NGSI Service Path (hier immer “/”)

Query

Key	Value	Description
q	transportationType==1500	Query, hier auf transportationType eq 1500
idPattern	PublicTransportStop	Das Datenmodell ist immer in der ID angegeben
type	PublicTransportStop	Das Datenmodell
georel	near;maxDistance:1000	GeoLocation Abfrage, Umgebung um Point mit einer maximalen Entfernung vom 1000m
geometry	point	GeoLocation Type, hier Point
coords	54.302378,9.670224	Die GeoLocation als Bezugspunkt

Example Request

URL: https://context.fiware-staging.kielregion.addix.io/v2/entities/?q=transportationType==1500&idPattern=PublicTransportStop&type=PublicTransportStop&georel=near;maxDistance:1000&geometry=point&coords=54.302378,9.670224

Headers

Key	Value	Description
fiware-service	testfrank001
fiware-servicepath	/

Query

Key	Value	Description
q	transportationType==1500
idPattern	PublicTransportStop
type	PublicTransportStop
georel	near;maxDistance:1000
geometry	point
coords	54.302378,9.670224

Example Response

Body

[ { "id": "urn:ngsi:PublicTransportStop:KielRegion:Taxi:1", "type": "PublicTransportStop", "address": { "type": "PostalAddress", "value": { "addressLocality": " Rendsburg", "postalCode": "24768", "streetAddress": "Am Bhf 20" }, "metadata": {} }, "description": { "type": "Text", "value": "Fähranleger", "metadata": {} }, "location": { "type": "geo:json", "value": { "type": "Point", "coordinates": [ 9.670224, 54.302378 ] }, "metadata": {} }, "name": { "type": "Text", "value": "Taxistand Hauptbahnhof Rendsburg ", "metadata": {} }, "owner": { "type": "StructuredValue", "value": [ "urn:ngsi:Owner:KielRegion" ], "metadata": {} }, "peopleCount": { "type": "Number", "value": 0, "metadata": {} }, "stopCode": { "type": "Text", "value": "", "metadata": {} }, "transportationType": { "type": "Number", "value": 1500, "metadata": {} }, "wheelChairAccessible": { "type": "Text", "value": 2, "metadata": {} } }, { "id": "urn:ngsi:PublicTransportStop:OSM:Taxi:407445504", "type": "PublicTransportStop", "capacity": { "type": "Number", "value": 0, "metadata": {} }, "description": { "type": "Text", "value": "Taxistand", "metadata": {} }, "location": { "type": "geo:json", "value": { "type": "Polygon", "coordinates": [ [ [ 9.6703748, 54.3020288 ], [ 9.6704107, 54.3020306 ], [ 9.6703808, 54.3021757 ], [ 9.6703119, 54.3022929 ], [ 9.670144, 54.302431 ], [ 9.6701141, 54.3024153 ], [ 9.6702729, 54.3022789 ], [ 9.6703358, 54.302174 ], [ 9.6703748, 54.3020288 ] ] ] }, "metadata": {} }, "name": { "type": "Text", "value": "Taxistand", "metadata": {} }, "owner": { "type": "StructuredValue", "value": [ "urn:ngsi:Owner:OSM" ], "metadata": {} }, "transportationType": { "type": "Number", "value": 1500, "metadata": {} }, "wheelChairAccessible": { "type": "Text", "value": 0, "metadata": {} } }, { "id": "urn:ngsi:PublicTransportStop:OSM:Taxi:648482814", "type": "PublicTransportStop", "capacity": { "type": "Number", "value": 0, "metadata": {} }, "description": { "type": "Text", "value": "Taxistand", "metadata": {} }, "location": { "type": "geo:json", "value": { "type": "Point", "coordinates": [ 9.6620591, 54.3063419 ] }, "metadata": {} }, "name": { "type": "Text", "value": "Taxistand", "metadata": {} }, "owner": { "type": "StructuredValue", "value": [ "urn:ngsi:Owner:OSM" ], "metadata": {} }, "transportationType": { "type": "Number", "value": 1500, "metadata": {} }, "wheelChairAccessible": { "type": "Text", "value": 0, "metadata": {} } } ]

Code:

200

Mitfahrbänke | GET {{host}}/v2/entities/

Description

Die Mitfahrbänke der Region. (Idee der Mitfahrbank: Autofahrende, die Sitzplätze frei haben, nehmen diejenigen mit, die auf einer Mitfahrbank warten.)

Das Datenmodell ist HitchhikingBench.

Headers

Key	Value	Description
fiware-service	{{fiware-service}}	Der NGSI Tenant
fiware-servicepath	{{fiware-servicepath}}	Der NGSI Service Path (hier immer “/”)

Query

Key	Value	Description
limit	1000	Ohne Limit werden nur 20 Objekte zurück geliefert
geometry	point	GeoLocation Type, hier Point
type	HitchhikingBench	Das Datenmodell
georel	near;maxDistance:2000	GeoLocation Abfrage, Umgebung um Point mit einer maximalen Entfernung vom 2000m
coords	54.33377,10.152124	Die GeoLocation als Bezugspunkt

Key	Value	Description
limit	1000
geometry	point
type	HitchhikingBench
georel	near;maxDistance:2000
coords	54.33377,10.152124

Haltestellen ÖPNV | GET {{host}}/v2/entities/

Description

Alle Haltestellen ÖPNV (bzw. Stationen) im Datenmodell PublicTransportStation.

Das Attribut transportationType definiert den Typ der Haltestelle nach GTFS:

2 Schienenverkehr
3 Bus
4 Fähre

Headers

Key	Value	Description
fiware-service	{{fiware-service}}	Der NGSI Tenant
fiware-servicepath	{{fiware-servicepath}}	Der NGSI Service Path (hier immer “/”)

Query

Key	Value	Description
idPattern	PublicTransportStation	Eine Teil der ID welches als RegEx genutzt wird
type	PublicTransportStation	Das Datemnodell
georel	near;maxDistance:100	GeoLocation Abfrage, Umgebung um Point mit einer maximalen Entfernung vom 100m
geometry	point	GeoLocation Type, hier Point
coords	54.302378,9.670224	Die GeoLocation als Bezugspunkt

Example Request

URL: https://context.fiware-staging.kielregion.addix.io/v2/entities/?idPattern=PublicTransportStation&type=PublicTransportStation&georel=near;maxDistance:100&geometry=point&coords=54.302378,9.670224

Headers

Key	Value	Description
fiware-service	testfrank001
fiware-servicepath	/

Query

Key	Value	Description
idPattern	PublicTransportStation
type	PublicTransportStation
georel	near;maxDistance:100
geometry	point
coords	54.302378,9.670224

Example Response

Body

[ { "id": "urn:ngsi:PublicTransportStation:REGIO:8000312", "type": "PublicTransportStation", "areaServed": { "type": "Text", "value": "KielRegion", "metadata": {} }, "dateCreated": { "type": "DateTime", "value": "2022-12-09T10:34:20.860Z", "metadata": {} }, "dateFirstUsed": { "type": "DateTime", "value": "2022-12-09T10:34:20.860Z", "metadata": {} }, "description": { "type": "Text", "value": "", "metadata": {} }, "location": { "type": "geo:json", "value": { "type": "Point", "coordinates": [ 9.671134, 54.302262 ] }, "metadata": {} }, "name": { "type": "Text", "value": "Rendsburg", "metadata": {} }, "owner": { "type": "Array", "value": [ "urn:ngsi:Owner:REGIO" ], "metadata": {} }, "refStops": { "type": "Array", "value": [ "urn:ngsi:PublicTransportStop:REGIO:10506", "urn:ngsi:PublicTransportStop:REGIO:3833", "urn:ngsi:PublicTransportStop:REGIO:5174", "urn:ngsi:PublicTransportStop:REGIO:9268" ], "metadata": {} }, "seeAlso": { "type": "Array", "value": [ "urn:ngsi:PTISBoard:REGIO:8000312:0", "urn:ngsi:PTISBoard:REGIO:8000312:1", "urn:ngsi:PTISBoard:REGIO:8000312:2", "urn:ngsi:PTISBoard:REGIO:8000312:3", "urn:ngsi:PTISBoard:REGIO:8000312:4" ], "metadata": {} }, "stationID": { "type": "Text", "value": "5223", "metadata": {} }, "stopCode": { "type": "Text", "value": "8000312", "metadata": {} }, "transportationType": { "type": "Array", "value": [ 2 ], "metadata": {} }, "wheelChairAccessible": { "type": "Number", "value": 0, "metadata": {} } }, { "id": "urn:ngsi:PublicTransportStation:FERN:8000312", "type": "PublicTransportStation", "areaServed": { "type": "Text", "value": "KielRegion", "metadata": {} }, "location": { "type": "geo:json", "value": { "type": "Point", "coordinates": [ 9.671134, 54.302262 ] }, "metadata": {} }, "name": { "type": "Text", "value": "Rendsburg", "metadata": {} }, "refStops": { "type": "Array", "value": [ "urn:ngsi:PublicTransportStop:REGIO:10506", "urn:ngsi:PublicTransportStop:REGIO:3833", "urn:ngsi:PublicTransportStop:REGIO:5174", "urn:ngsi:PublicTransportStop:REGIO:9268", "urn:ngsi:PublicTransportStop:FERN:1342" ], "metadata": {} }, "seeAlso": { "type": "Array", "value": [ "urn:ngsi:PTISBoard:FERN:8000312:0", "urn:ngsi:PTISBoard:FERN:8000312:1", "urn:ngsi:PTISBoard:FERN:8000312:2", "urn:ngsi:PTISBoard:FERN:8000312:3", "urn:ngsi:PTISBoard:FERN:8000312:4" ], "metadata": {} }, "stopCode": { "type": "Text", "value": "8000312", "metadata": {} } } ]

Code:

200

eRoller TIER | GET {{host}}/v2/entities/

Description

Das Datenmodell ist immer Vehicle. Das idPattern unterscheidet den Anbieter (siehe weitere Einträge für eRoller)

Headers

Key	Value	Description
fiware-service	{{fiware-service}}	Der NGSI Tenant
fiware-servicepath	{{fiware-servicepath}}	Der NGSI Service Path (hier immer “/”)

Query

Key	Value	Description
idPattern	Vehicle:TIER	Eine Teil der ID welches als RegEx genutzt wird
type	Vehicle	Das Datemnodell
georel	near;maxDistance:100	GeoLocation Abfrage, Umgebung um Point mit einer maximalen Entfernung vom 100m
geometry	point	GeoLocation Type, hier Point
coords	54.315323,10.132924	Die GeoLocation als Bezugspunkt

Example Request

URL: https://context.fiware-staging.kielregion.addix.io/v2/entities/?idPattern=Vehicle:TIER&type=Vehicle&georel=near;maxDistance:100&geometry=point&coords=54.315323,10.132924

Headers

Key	Value	Description
fiware-service	testfrank001
fiware-servicepath	/

Query

Key	Value	Description
idPattern	Vehicle:TIER
type	Vehicle
georel	near;maxDistance:100
geometry	point
coords	54.315323,10.132924

Example Response

Body

[ { "id": "urn:ngsi:Vehicle:TIER:bb1e24cf-c2f2-45ea-b541-f486cff3d6b9", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "current_range_meters:29000", "batteryLevel:67", "isRentable:true", "hasHelmetBox:false", "hasHelmet:false", "maxSpeed:20" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-05T20:14:09.000Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.132924, 54.315323 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "TIER:eScooter:598WZW", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:TIER:escooter", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "598WZW", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:TIER:c67d5384-159b-4a4a-ad00-6e90473047b6", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "current_range_meters:36000", "batteryLevel:79", "isRentable:true", "hasHelmetBox:false", "hasHelmet:false", "maxSpeed:20" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-07T01:00:09.000Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.132074, 54.316071 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "TIER:eScooter:685WVW", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:TIER:escooter", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "685WVW", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:TIER:6bed26dc-229d-4145-8c7a-794103aeafb4", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "current_range_meters:35000", "batteryLevel:77", "isRentable:true", "hasHelmetBox:false", "hasHelmet:false", "maxSpeed:20" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-05T21:39:03.000Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.13282, 54.315324 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "TIER:eScooter:458WZW", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:TIER:escooter", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "458WZW", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:TIER:d8d922f2-4c77-4acb-a126-c096921faf11", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "current_range_meters:8000", "batteryLevel:29", "isRentable:true", "hasHelmetBox:false", "hasHelmet:false", "maxSpeed:20" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-02T00:50:11.000Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.132009, 54.315607 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "TIER:eScooter:486WVW", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:TIER:escooter", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "486WVW", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:TIER:6e252447-f652-48a2-ad4e-77ebb5342205", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "current_range_meters:36000", "batteryLevel:80", "isRentable:true", "hasHelmetBox:false", "hasHelmet:false", "maxSpeed:20" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-05T00:31:58.000Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.133679, 54.31528 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "TIER:eScooter:342WVW", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:TIER:escooter", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "342WVW", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:TIER:612cb23d-e643-4a96-bd61-905ebe56170e", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "current_range_meters:15000", "batteryLevel:42", "isRentable:true", "hasHelmetBox:false", "hasHelmet:false", "maxSpeed:20" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-02T13:31:52.000Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.133247, 54.316114 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "TIER:eScooter:267WZW", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:TIER:escooter", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "267WZW", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:TIER:f133605f-0334-4ff5-8ee5-601854587855", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "current_range_meters:22000", "batteryLevel:54", "isRentable:true", "hasHelmetBox:false", "hasHelmet:false", "maxSpeed:20" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-04T00:50:55.000Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.132239, 54.316039 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "TIER:eScooter:649WZW", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:TIER:escooter", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "649WZW", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } } ]

Code:

200

eRoller BOLT | GET {{host}}/v2/entities/

Description

Das Datenmodell ist immer Vehicle. Das idPattern unterscheidet den Anbieter (siehe weitere Einträge für eRoller)

Headers

Key	Value	Description
fiware-service	{{fiware-service}}	Der NGSI Tenant
fiware-servicepath	{{fiware-servicepath}}	Der NGSI Service Path (hier immer “/”)

Query

Key	Value	Description
idPattern	Vehicle:BOLT	Eine Teil der ID welches als RegEx genutzt wird
type	Vehicle	Das Datemnodell
georel	near;maxDistance:100	GeoLocation Abfrage, Umgebung um Point mit einer maximalen Entfernung vom 100m
geometry	point	GeoLocation Type, hier Point
coords	54.315323,10.132924	Die GeoLocation als Bezugspunkt

Example Request

URL: {{host}}/v2/entities/?idPattern=Vehicle:BOLT&type=Vehicle&georel=near;maxDistance:100&geometry=point&coords=54.315323,10.132924

Headers

Key	Value	Description
fiware-service	{{fiware-service}}
fiware-servicepath	{{fiware-servicepath}}

Query

Key	Value	Description
idPattern	Vehicle:BOLT
type	Vehicle
georel	near;maxDistance:100
geometry	point
coords	54.315323,10.132924

Example Response

Body

[ { "id": "urn:ngsi:Vehicle:BOLT:GBFS:4aff1f22-f77b-446c-bc3d-74e7c9e20f48", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "pricing_plan_id:5959b310-f7ed-55f9-bd65-01e2ced234c2", "current_range_meters:22320" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-07T12:20:11.625Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.132136345, 54.316051483 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "BOLT:eScooter:4aff1f22-f77b-446c-bc3d-74e7c9e20f48", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:4aff1f22-f77b-446c-bc3d-74e7c9e20f48", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:BOLT:GBFS:8acfc582-b2f8-4df4-9859-a807ef03829d", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "pricing_plan_id:5959b310-f7ed-55f9-bd65-01e2ced234c2", "current_range_meters:21600" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-07T12:20:11.633Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.132993698, 54.315795898 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "BOLT:eScooter:8acfc582-b2f8-4df4-9859-a807ef03829d", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:8acfc582-b2f8-4df4-9859-a807ef03829d", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:BOLT:GBFS:ba1467b1-7ccf-469d-90f7-dd55c3e87acb", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "pricing_plan_id:5959b310-f7ed-55f9-bd65-01e2ced234c2", "current_range_meters:26280" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-07T12:20:11.640Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.133201599, 54.315380096 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "BOLT:eScooter:ba1467b1-7ccf-469d-90f7-dd55c3e87acb", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:ba1467b1-7ccf-469d-90f7-dd55c3e87acb", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:BOLT:GBFS:5e1b5d03-24a9-40c9-a962-9e89f31ab49e", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "pricing_plan_id:5959b310-f7ed-55f9-bd65-01e2ced234c2", "current_range_meters:2880" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-07T12:20:11.641Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.132983208, 54.315258026 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "BOLT:eScooter:5e1b5d03-24a9-40c9-a962-9e89f31ab49e", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:5e1b5d03-24a9-40c9-a962-9e89f31ab49e", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:BOLT:GBFS:25dd5d9f-6f4d-4207-807c-1980cf3787d8", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "pricing_plan_id:5959b310-f7ed-55f9-bd65-01e2ced234c2", "current_range_meters:25560" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-07T12:20:11.648Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.132638931, 54.315258026 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "BOLT:eScooter:25dd5d9f-6f4d-4207-807c-1980cf3787d8", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:25dd5d9f-6f4d-4207-807c-1980cf3787d8", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } }, { "id": "urn:ngsi:Vehicle:BOLT:GBFS:58e9a86f-5358-4a85-bb3c-f2f2210d643f", "type": "Vehicle", "annotations": { "type": "StructuredValue", "value": [ "pricing_plan_id:5959b310-f7ed-55f9-bd65-01e2ced234c2", "current_range_meters:27000" ], "metadata": {} }, "bearing": { "type": "Number", "value": 0, "metadata": {} }, "category": { "type": "StructuredValue", "value": [ "private" ], "metadata": {} }, "dateModified": { "type": "DateTime", "value": "2023-02-07T12:20:11.645Z", "metadata": {} }, "location": { "type": "geo:json", "value": { "coordinates": [ 10.133056641, 54.315723419 ], "type": "Point" }, "metadata": {} }, "name": { "type": "Text", "value": "BOLT:eScooter:58e9a86f-5358-4a85-bb3c-f2f2210d643f", "metadata": {} }, "refVehicleModel": { "type": "Text", "value": "urn:ngsi:VehicleModel:58e9a86f-5358-4a85-bb3c-f2f2210d643f", "metadata": {} }, "serviceStatus": { "type": "Text", "value": "parked", "metadata": {} }, "speed": { "type": "Number", "value": 0, "metadata": {} }, "vehiclePlateIdentifier": { "type": "Text", "value": "", "metadata": {} }, "vehicleType": { "type": "Text", "value": "escooter", "metadata": {} } } ]

Code:

200

eRoller LIME | GET {{host}}/v2/entities/

Description

Das Datenmodell ist immer Vehicle. Das idPattern unterscheidet den Anbieter (siehe weitere Einträge für eRoller)

Headers

Key	Value	Description
fiware-service	{{fiware-service}}	Der NGSI Tenant
fiware-servicepath	{{fiware-servicepath}}	Der NGSI Service Path (hier immer “/”)

Query

Key	Value	Description
idPattern	Vehicle:LIME	Eine Teil der ID welches als RegEx genutzt wird
type	Vehicle	Das Datemnodell
georel	near;maxDistance:100	GeoLocation Abfrage, Umgebung um Point mit einer maximalen Entfernung vom 100m
geometry	point	GeoLocation Type, hier Point
coords	54.315323,10.132924	Die GeoLocation als Bezugspunkt