api.automapa.comv3 - wszystkie systemy działają

Wyznacz pojedynczą trasę

Routes.route

Wyznacza trasę przez uporządkowaną listę punktów GPS. Obsługuje manewry, traffic, opłaty i ograniczenia ciężarowe.

POST/v3/Routes/routeapi.automapa.com

Parametry body

Treść żądaniaTypOpis
pointsdouble[][] WYMAGANEUporządkowana lista punktów [x, y], przez które ma przebiegać trasa.
routeobject WYMAGANEObiekt ustawień sposobu wyznaczania trasy.
startstringCzas rozpoczęcia jako "YYYY-MM-DD HH:MM" albo "NOW"; domyślnie NOW.
typestringTyp trasy: quick, short albo optimal; domyślnie optimal.
trafficboolOkreśla, czy uwzględniać aktualne dane o ruchu; tylko PL, domyślnie true.
descboolOkreśla, czy zwrócić listę manewrów w desc; domyślnie false.
onlyLengthAndETAboolOkreśla, czy odpowiedź ma zawierać wyłącznie długość trasy i przewidywany czas przejazdu.
avoidTollsboolOkreśla, czy unikać dróg płatnych.
avoidFerriesboolOkreśla, czy unikać połączeń promowych.
avoidHighwaysboolOkreśla, czy unikać autostrad i dróg ekspresowych.
calculateTollsboolOkreśla, czy obliczyć opłaty drogowe dla trasy.
vehicleCatForETollintegerKategoria pojazdu e-Toll od 1 do 5; tylko PL i wymaga calculateTolls=true.
objectobject WYMAGANEObiekt konfiguracji pojazdu używanej przy wyznaczaniu trasy.
typestringTyp pojazdu lub podróży: car, truck albo rozszerzony (R) taxi, privileged, bike lub walk.
truckParamsobjectParametry ciężarówki używane, gdy object.type ma wartość "truck".
axleLoaddoubleNacisk na oś w tonach, z dokładnością ±0,5 t.
truckWeightdoubleMasa całkowita pojazdu w tonach, z dokładnością ±0,5 t.
truckLengthdoubleDługość pojazdu w metrach, z dokładnością ±0,5 m.
truckWidthdoubleSzerokość pojazdu w metrach, z dokładnością ±0,5 m.
truckHeightdoubleWysokość pojazdu w metrach, z dokładnością ±0,5 m.
euroNormForTollintegerNorma 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 resultTypOpis
lengthintegerCałkowita długość trasy w metrach.
etaintegerPrzewidywany czas przejazdu w minutach; zwracany tylko dla route.desc=true.
mapurlstringAdres URL mapy z wyrenderowaną trasą.
routePointsdouble[][]Geometria trasy jako linia złożona z punktów [x, y].
desc[].locationstringCzytelna nazwa lokalizacji manewru.
desc[].roadstringNazwa drogi lub ulicy dla manewru.
desc[].roadTypestringTyp drogi zgodny z wartościami enum roadType.
desc[].distanceintegerOdległość od poprzedniego punktu manewru w metrach.
desc[].etaintegerSkumulowany czas przejazdu od początku trasy do tego punktu w minutach.
desc[].maneuverstringTekstowy opis manewru.
desc[].routePointnumber[]Współrzędne [longitude, latitude] (WGS84), jeśli są dostępne. Tablica desc może być nieobecna.
tolls.systemsobjectŁączne kwoty opłat drogowych pogrupowane według operatora.