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
languagejson
[
  {
    "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
languagejson
{
  "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
languagejson
{
  "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>