Speed limits
The API gives returns the speed limit for the closest road segment to given coordinates. Additionally, returns also the street or road name and the surface value.
API URL
The request URL should match the following pattern:
https://api.kartes.lv/v3//speed_limit?
The response is given in the JSON.
The HTTP GET request method is used.
- klienta_atslega: Your authorisation key.
Query parameters
There are three ways to define coordinates:
Parameter | Description |
---|---|
lat | Latitude coordinate in the WGS-84 projection (EPSG:4326) |
lon | Longitude coordinate in the WGS-84 projection (EPSG:4326) |
x | x-coordinate in the TM Baltic93 CRS (EPSG:25884). |
y | y-coordinate in the TM Baltic93 CRS (EPSG:25884). |
p | Array of coordinate pairs (e.g., [[510427,6308643],[514276,6304829]]). |
wgs84 | Should be used in case of p parameter, if the WGS coordinates are used. |
Error codes
Status code | Description |
---|---|
200 | Missing input data. |
200 | Wrong input data format. |
404 | No location found. The URL is not recognized; the resource does not exist. |
5xx | Server error. |
Response parameters
The response consists of an array of objects, each of them having two elements. Each element consists of following parameters:
Parameter | Description |
---|---|
name | Street or road name |
populated_place | Populated place (city, town or other settlement; only for named streets) |
teritorial_unit | Territorial unit (only for named streets) |
administrative_unit | Administrative unit (only for named streets) |
surface | Surface |
speed_limit | Speed limit |
is_populated_place | Is this a populated place? |
distance | Distance to the closest road segment |
Examples
Input:
https://api.kartes.lv/v3//speed_limit?p=[[510427,6308643],[514276,6304829]]
Response:
[
[
{
"name": "Maskavas iela",
"populated_place": "Rīga",
"teritotial_unit": null,
"administrative_unit": "Rīgas pilsēta",
"surface": "paved",
"speed_limit": "50",
"is_populated_place": "1",
"distance": 0.43
},
{
"name": null,
"populated_place": null,
"teritotial_unit": null,
"administrative_unit": null,
"surface": "paved",
"speed_limit": "20",
"is_populated_place": "1",
"distance": 32.28
}
],
[
{
"name": "Maskavas iela",
"populated_place": "Rīga",
"teritotial_unit": null,
"administrative_unit": "Rīgas pilsēta",
"surface": "paved",
"speed_limit": "50",
"is_populated_place": "1",
"distance": 4.53
},
{
"name": null,
"populated_place": null,
"teritotial_unit": null,
"administrative_unit": null,
"surface": "gravel",
"speed_limit": "50",
"is_populated_place": "1",
"distance": 42.3
}
]
]
Input:
https://api.kartes.lv/v3//speed_limit?lat=56.9213439&lon=24.1712888
Response:
[
{
"name": "Maskavas iela",
"populated_place": "Rīga",
"teritotial_unit": null,
"administrative_unit": "Rīgas pilsēta",
"surface": "paved",
"speed_limit": "50",
"is_populated_place": "1",
"distance": 0.43
},
{
"name": null,
"populated_place": null,
"teritotial_unit": null,
"administrative_unit": null,
"surface": "paved",
"speed_limit": "20",
"is_populated_place": "1",
"distance": 32.28
}
]