Beskrivning

Den här sidan beskriver på en hög nivå de API:er som tillhandahålls via diwise context broker.

Livscykelstatus

Produktion 

Lösningsbeskrivning

Extern dokumentation

Hantering av personuppgifter

Diwise hanterar i dagsläget inga personuppgifter.

API specifikation

NGSI-LD

Diwise implementerar ett subset av NGSI-LD, eller ETSI GS CIM 009 som det också heter, och använder sig av datamodeller från Smart Datamodels (tidigare FIWARE) för att ta emot och leverera ut data.

Vilken data som kan hämtas ut styrs med entitetstyp och eventuellt attribut. Det finns även stöd för att göra utsökningar baserat på geografiskt område och tidsspann.

Exempel; Hämta temperaturdata från sensorer inom 2km från stora torget för tiden 12-13 den 7/10 2021
https://api.sundsvall.se/ngsi-ld/v1/entities?type=WeatherObserved&attrs=temperature&georel=near;maxDistance==2000&geometry=Point&coordinates=[17.3051555,62.3908926]&timerel=between&timeAt=2021-10-07T10:00:00Z&endTimeAt=2021-10-07T11:00:00Z

Versionshanteringen av API specificeras av avsnitt 6.2 i standarden som säger att versionen på nuvarande API är v1. Här skiljer sig alltså hanteringen av versionsnummer från de API:er som vi utvecklar själva inom kommunen.

Badplatser

type: Beach

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=Beach

Badtemperatur

type: WaterQualityObserved

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=WaterQualityObserved

Livbojar

type: Lifebuoy

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=Lifebuoy

Lufttemperatur

type: WeatherObserved

attrs: temperature

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=WeatherObserved&attrs=temperature

Lufttemperatur - inomhus

type: IndoorEnvironmentObserved

attrs: temperature

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=IndoorEnvironmentObserved&attrs=temperature

Markfuktighet

type: GreenspaceRecord

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=GreenspaceRecord

Motionsspår

type: ExerciseTrail

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=ExerciseTrail

Trafikolyckor

type: RoadAccident

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=RoadAccident

Planerade vägarbeten

type: CityWork

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=CityWork

Snödjup

type: WeatherObserved

attrs: snowHeight

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=WeatherObserved&attrs=snowHeight

Trafikflöde

type: TrafficFlowObserved

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=TrafficFlowObserved

Vägsegment

type: RoadSegment

Exempel: https://api.sundsvall.se/ngsi-ld/v1/entities?type=RoadSegment

Öppen Data

Vissa av våra levererade API:er har även DCAT-AP-SE-formaterat metadata exponerat via en dcat-endpoint, som kan användas av Sveriges Dataportal för skördning. Respektive dataset i den exponerade katalogen pekar i sin tur på en proxytjänst för öppet data som tar hand om att hämta data via NGSI-LD och transformera det till det format som önskas av klienten.

<bild>