Ceļa km serviss

Serviss ļauj iegūt informāciju par ceļu kilometru atrašanās vietu.

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 Ceļa indekss
distance Ceļa kilometrs

Kļūdu 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"
      }
    }
  ]
}