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/v1

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

Svar

Hämta information om enskilt spår som GeoJSON

Förfrågan

Svar

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>