Wyznacz pojedynczą trasę
Routes.route
Wyznacza trasę przez uporządkowaną listę punktów GPS. Obsługuje manewry, traffic, opłaty i ograniczenia ciężarowe.
Parametry body
| Treść żądania | Typ | Opis |
|---|---|---|
points | double[][] WYMAGANE | Uporządkowana lista punktów [x, y], przez które ma przebiegać trasa. |
route | object WYMAGANE | Obiekt ustawień sposobu wyznaczania trasy. |
start | string | Czas rozpoczęcia jako "YYYY-MM-DD HH:MM" albo "NOW"; domyślnie NOW. |
type | string | Typ trasy: quick, short albo optimal; domyślnie optimal. |
traffic | bool | Określa, czy uwzględniać aktualne dane o ruchu; tylko PL, domyślnie true. |
desc | bool | Określa, czy zwrócić listę manewrów w desc; domyślnie false. |
onlyLengthAndETA | bool | Określa, czy odpowiedź ma zawierać wyłącznie długość trasy i przewidywany czas przejazdu. |
avoidTolls | bool | Określa, czy unikać dróg płatnych. |
avoidFerries | bool | Określa, czy unikać połączeń promowych. |
avoidHighways | bool | Określa, czy unikać autostrad i dróg ekspresowych. |
calculateTolls | bool | Określa, czy obliczyć opłaty drogowe dla trasy. |
vehicleCatForEToll | integer | Kategoria pojazdu e-Toll od 1 do 5; tylko PL i wymaga calculateTolls=true. |
object | object WYMAGANE | Obiekt konfiguracji pojazdu używanej przy wyznaczaniu trasy. |
type | string | Typ pojazdu lub podróży: car, truck albo rozszerzony (R) taxi, privileged, bike lub walk. |
truckParams | object | Parametry ciężarówki używane, gdy object.type ma wartość "truck". |
axleLoad | double | Nacisk na oś w tonach, z dokładnością ±0,5 t. |
truckWeight | double | Masa całkowita pojazdu w tonach, z dokładnością ±0,5 t. |
truckLength | double | Długość pojazdu w metrach, z dokładnością ±0,5 m. |
truckWidth | double | Szerokość pojazdu w metrach, z dokładnością ±0,5 m. |
truckHeight | double | Wysokość pojazdu w metrach, z dokładnością ±0,5 m. |
euroNormForToll | integer | Norma emisji Euro od 1 do 6 używana przy obliczaniu opłat. |
Przykładowe żądanie
{
"points": [
[
20.6350676,
52.1044404
],
[
20.8102593,
52.0933647
],
[
21.0230905,
52.2318032
]
],
"route": {
"calculateTolls": true,
"vehicleCatForEToll": 2,
"start": "NOW",
"type": "short",
"traffic": false,
"desc": true,
"avoidTolls": false,
"avoidFerries": false,
"avoidHighways": false
},
"object": {
"type": "truck",
"truckParams": {
"axleLoad": 2.1,
"truckWeight": 3.5,
"truckLength": 7.2,
"truckWidth": 2.5,
"truckHeight": 3.4,
"euroNormForToll": 5
}
}
}Przykładowa odpowiedź
{
"result": {
"length": 37640,
"eta": 60,
"routePoints": [
[
20.6350445,
52.1044257
],
[
20.6382422,
52.1024025
],
[
21.0228726,
52.2318902
]
],
"desc": [
{
"location": "Książenice",
"road": "Mazowiecka",
"roadType": "city_main",
"distance": 5862,
"eta": 10,
"routePoint": [
20.7018437,
52.073707
],
"maneuver": "Roundabout"
},
{
"location": "Warszawa",
"road": "",
"roadType": "internal",
"distance": 22,
"eta": 60,
"routePoint": [
21.022875,
52.2318984
]
}
],
"mapurl": "https://mapa.targeo.pl/trasa_api,1652773689.6283533948f568.51828173"
}
}pola result
| pola result | Typ | Opis |
|---|---|---|
length | integer | Całkowita długość trasy w metrach. |
eta | integer | Przewidywany czas przejazdu w minutach; zwracany tylko dla route.desc=true. |
mapurl | string | Adres URL mapy z wyrenderowaną trasą. |
routePoints | double[][] | Geometria trasy jako linia złożona z punktów [x, y]. |
desc[].location | string | Czytelna nazwa lokalizacji manewru. |
desc[].road | string | Nazwa drogi lub ulicy dla manewru. |
desc[].roadType | string | Typ drogi zgodny z wartościami enum roadType. |
desc[].distance | integer | Odległość od poprzedniego punktu manewru w metrach. |
desc[].eta | integer | Skumulowany czas przejazdu od początku trasy do tego punktu w minutach. |
desc[].maneuver | string | Tekstowy opis manewru. |
desc[].routePoint | number[] | Współrzędne [longitude, latitude] (WGS84), jeśli są dostępne. Tablica desc może być nieobecna. |
tolls.systems | object | Łączne kwoty opłat drogowych pogrupowane według operatora. |