Road kilometre API
The API returns location and additional information about the given kilometre of the specific Latvian state road.
API URL
The request URL should match the following pattern:
https://api.kartes.lv/v3//roadkm?
The response is given in JSON.
The HTTP GET request method is used.
Query parameters
The request consists of the following GET parameters:
| Parameter | Description |
|---|---|
| km | Road kilometre (float) |
| index | Road number |
| x | x-coordinate |
| y | y-coordinate |
| d | Error margin in metres (default value — 10 m) |
Response parameters
The response consists of an GeoJSON arrway, where each object properties consist of the following parameters:
| Parameter | Description |
|---|---|
| km | Road kilometre (float) |
| index | Road number |
Error codes
| Status code | Description |
|---|---|
| 400 | Wrong input data. Server can’t respond due to client error. |
| 404 | No location found. The URL is not recognized; the resource does not exist. |
| 5xx | Server error. |
Examples
Input:
https://api.kartes.lv/v3//roadkm?km=15.5&index=A1
Response:
{
"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"
}
}
]
}
Input:
https://api.kartes.lv/v3//roadkm?x=2684086.2482303474&y=7713776.474187665&d=100
Response:
{
"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"
}
}
]
}