Ceļa km serviss

Serviss ļauj iegūt informāciju par Latvijas valsts autoceļu tīkla ceļu kilometru atrašanās vietu. Šis serviss atgriež faktiskās kilometra atrašanās vietas, nevis kilometru stabiņu atrašanās vietas, kuras nodrošina Kilometru zīmju serviss.

Servisa URL

Servisa saitei jāatbilst šādai formai:

https://api.kartes.lv/v3//roadkm?

Atgriezto datu formāts ir JSON.

HTTP metode ir GET.

Pieprasījuma parametri

Iespējams padot šādus GET parametrus:

Parametrs	Skaidrojums
km	Interesējošais ceļa kilometrs
index	Ceļa indekss
x	Koordinātas X komponente (lks)
y	Koordinātas Y komponente (lks)
d	Ar kādu precizitāti metros meklēt datus (pēc noklusējuma - 10 m)

Atbildes parametri

Atbildē tiek atgriezts GeoJSON datu masīvs. Masīva "geometry" objektā redzamas punkta koordinātas. Objekta "properties" masīvā ir šādi parametri:

Parametrs	Skaidrojums
km	Interesējošais ceļa kilometrs
index	Valsts autoceļa numurs
distance	Ceļa kilometrs

Statusa kodi

Kods	Skaidrojums
404	No location found. Tiek atgriezts, ja nekas nav ticis atrasts.
5xx	Servera kļūda.

Paraugi

Pieprasījums:

https://api.kartes.lv/v3//roadkm?km=15.5&index=A1

Atbilde:

{
  "type": "FeatureCollection",
  "name": "Road KM",
  "crs": {
    "type": "name",
    "properties": {
      "name": "urn:ogc:def:crs:EPSG::3857"
    }
  },
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          2709418,
          7789529
        ]
      },
      "properties": {
        "km": "15.50",
        "index": "A1"
      }
    }
  ]
}

Pieprasījums:

https://api.kartes.lv/v3//roadkm?x=2684086.2482303474&y=7713776.474187665&d=100

Atbilde:

{
  "type": "FeatureCollection",
  "name": "Road KM",
  "crs": {
    "type": "name",
    "properties": {
      "name": "urn:ogc:def:crs:EPSG::3857"
    }
  },
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "crs": {
          "type": "name",
          "properties": {
            "name": "EPSG:3857"
          }
        },
        "coordinates": [
          2684067,
          7713870
        ]
      },
      "properties": {
        "km": "7.69",
        "index": "V7",
        "distance": "16972.592676429493"
      }
    }
  ]
}