Beskrivning

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

Livscykelstatus

Produktion

Lösningsbeskrivning

<Lägg till>

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.

Notera att dokumentationen är work in progress, så nedanstående URL:ar är inte helt korrekta eller uppsatta än.

Badplatser

type: Beach

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

Badtemperatur

type: WaterQualityObserved

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

Lufttemperatur

type: WeatherObserved

attrs: temperature

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

Snödjup

type: WeatherObserved

attrs: snowHeight

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

Trafikflöde

type: TrafficFlowObserved

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

Vägsegment

type: RoadSegment

Exempel: https://api.sundsvall.se/ngsi-ld/1.0v1/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>