Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Samla info om skidspår här, samt Mitt Sundsvall 2.1 med uppdateraringar (som behöver flyttas till Mitt Sundsvall Confluence)
Nabohund.no är bara test/utvecklingsmiljö
Längdspår.se = kommunens
Skidspår.se = föreningarnas
Sundsvall.se, mitt Sundsvall, skärmar (infoskärm).
Anläggningsinformation (facilities) kopplas ihop med aktuell status från skidspår.se för att visa prepareringsstatus på skidspåren som finns i anläggningsregistret (facilities).
Våra externa kanaler behöver då konsumera ett API för att få allt från oss istället för att sköta det själva.
Nuvarande konsumenter: Sundsvall.se, Mitt Sundsvall och Infoskärmar vid spåren.
Beskrivning
Informationen om skidspår och dess prepareringsstatus hanteras via diwise som integrerar data från facilities respektive längdspår.se.
Livscykelstatus
Under utveckling.
Lösningsbeskrivning
<Infoga en Gliffy-bild som visuellt beskriver lösningen>
Hantering av personuppgifter
Tjänsten hanterar inga egna personuppgifter, men exponerar de uppgifter som eventuellt skulle kunna förekomma i facilities.
API specifikation
Informationen om motionsspår är en delmängd av NGSI-LD och hämtas därför som entitetstypen ExerciseTrail
via https://api.sundsvall.se/ngsi-ld/v1v1
Informationen levereras som standard på formatet application/ld+json, men kan med hjälp av headern Accept begäras på formatet application/geo+json i stället för enklare visualisering i kartlager.
Hämta information om alla spår som JSON-LD
Förfrågan
GET https://api.sundsvall.se/ngsi-ld/v1/entities?type=ExerciseTrail
Svar
Förfrågan genererar en array av objekt med samtliga publicerade spår. Location nedan är förkortat för att hålla nere storleken på exemplet.
Code Block | ||
---|---|---|
| ||
[ { "id": "urn:ngsi-ld:ExerciseTrail:se:sundsvall:facilities:650", "type": "ExerciseTrail", "name": { "type": "Property", "value": "Motion 1 km Kallaspåret" }, "description": { "type": "Property", "value": "Motionsspår med 3 meter bred asfalt för rullskidor, samt 1,5 meter bred grusbädd för promenad\\/löpning\\/cykling. Vintertid enbart skidåkning, med 3 meter skateyta och dubbla klassiska spår. Konstsnöbeläggs." }, "length": { "type": "Property", "value": 0.9 }, "areaServed": { "type": "Property", "value": "Motionsspår Södra spårområdet" }, "category": { "type": "Property", "value": [ "floodlit", "ski-classic", "ski-skate" ] }, "status": { "type": "Property", "value": "open" }, "dateCreated": { "type": "Property", "value": { "@type": "DateTime", "@value": "2019-01-23T09:19:21Z" } }, "dateLastPreparation": { "type": "Property", "value": { "@type": "DateTime", "@value": "2022-01-07T01:34:06Z" } }, "dateModified": { "type": "Property", "value": { "@type": "DateTime", "@value": "2021-12-03T14:55:16Z" } }, "location": { "type": "GeoProperty", "value": { "coordinates": [ [ 17.308707161238566, 62.36635873125322 ], [ 17.30876459011519, 62.36642793916341 ] ], "type": "LineString" } }, "source": { "type": "Property", "value": "https://api.sundsvall.se/facilities/2.1/get/650" }, "@context": [ "https://schema.lab.fiware.org/ld/context", "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld" ] } ] |
Hämta information om alla spår som GeoJSON
Förfrågan
GET https://api.sundsvall.se/ngsi-ld/v1/entities?type=ExerciseTrail
Accept: application/geo+json
Svar
Svaret levereras som en FeatureCollection med en array där varje spår representeras som en GeoJSON Feature.
Hämta information om enskilt spår som GeoJSON
Förfrågan
GET https://api.sundsvall.se/ngsi-ld/v1/entities/urn:ngsi-ld:ExerciseTrail:se:sundsvall:facilities:650
Accept: application/geo+json
Svar
Code Block | ||
---|---|---|
| ||
{
"id": "urn:ngsi-ld:ExerciseTrail:se:sundsvall:facilities:650",
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[
17.308707161238566,
62.36635873125322
],
[
17.30876459011519,
62.36642793916341
]
]
},
"properties": {
"areaServed": {
"type": "Property",
"value": "Motionsspår Södra spårområdet"
},
"category": {
"type": "Property",
"value": [
"floodlit",
"ski-classic",
"ski-skate"
]
},
"dateCreated": {
"type": "Property",
"value": {
"@type": "DateTime",
"@value": "2019-01-23T09:19:21Z"
}
},
"dateLastPreparation": {
"type": "Property",
"value": {
"@type": "DateTime",
"@value": "2022-01-10T04:56:09Z"
}
},
"dateModified": {
"type": "Property",
"value": {
"@type": "DateTime",
"@value": "2021-12-03T14:55:16Z"
}
},
"description": {
"type": "Property",
"value": "Motionsspår med 3 meter bred asfalt för rullskidor, samt 1,5 meter bred grusbädd för promenad\\/löpning\\/cykling. Vintertid enbart skidåkning, med 3 meter skateyta och dubbla klassiska spår. Konstsnöbeläggs."
},
"length": {
"type": "Property",
"value": 0.9
},
"location": {
"type": "GeoProperty",
"value": {
"coordinates": [
[
17.308707161238566,
62.36635873125322
],
[
17.30876459011519,
62.36642793916341
]
],
"type": "LineString"
}
},
"name": {
"type": "Property",
"value": "Motion 1 km Kallaspåret"
},
"source": {
"type": "Property",
"value": "https://api.sundsvall.se/facilities/2.1/get/650"
},
"status": {
"type": "Property",
"value": "open"
},
"type": "ExerciseTrail"
}
} |
Hämta information om enskilt spår som GeoJSON med data som nyckelvärdepar
Förfrågan
GET https://api.sundsvall.se/ngsi-ld/v1/entities/urn:ngsi-ld:ExerciseTrail:se:sundsvall:facilities:650?options=keyValues
Accept: application/geo+json
Svar
Svaret levereras som en GeoJSON Feature, men där varje property hanteras som ett nyckelvärdepar och inte som en JSON-LD property.
Code Block | ||
---|---|---|
| ||
{
"id": "urn:ngsi-ld:ExerciseTrail:se:sundsvall:facilities:650",
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[
17.308707161238566,
62.36635873125322
],
[
17.30876459011519,
62.36642793916341
]
]
},
"properties": {
"areaServed": "Motionsspår Södra spårområdet",
"category": [
"floodlit",
"ski-classic",
"ski-skate"
],
"dateCreated": "2019-01-23T09:19:21Z",
"dateLastPreparation": "2022-01-10T04:56:09Z",
"dateModified": "2021-12-03T14:55:16Z",
"description": "Motionsspår med 3 meter bred asfalt för rullskidor, samt 1,5 meter bred grusbädd för promenad\\/löpning\\/cykling. Vintertid enbart skidåkning, med 3 meter skateyta och dubbla klassiska spår. Konstsnöbeläggs.",
"length": 0.9,
"location": {
"coordinates": [
[
17.308707161238566,
62.36635873125322
],
[
17.30876459011519,
62.36642793916341
]
],
"type": "LineString"
},
"name": "Motion 1 km Kallaspåret",
"source": "https://api.sundsvall.se/facilities/2.1/get/650",
"status": "open",
"type": "ExerciseTrail"
}
} |
Säkerhetsklassning
Säkerhetsklass: 0
Autentiseringsmetod: API Key
(Ref: Säkerhetsklassning av APIer )
API-ägare
<Kontaktuppgifter till den verksamhet som äger APIets livscykel>
Teknisk ägare
isak.styf@sundsvall.se
Länkar
<Länkar till dev-portal;
Test
Sandbox
Produktion>
FAQ
<FAQ>