Hogyan használjuk a TomTom Routing API-t az érkezés várható idejére

Oktatóanyag az API használatáról a pontos érkezési idő kiszámításához

(Bre Teiko) (2020.10.22.)

RÖVID ÖSSZEFOGLALÓ AZ ÚTVONALI API-ról

A Routing API egy hatékony eszköz, amellyel pontos útmutatásokat kaphatunk különféle típusú járművekhez – olyan útvonalakkal, mint a leggyorsabb, a legrövidebb, a legizgalmasabb stb. Ezenkívül megadhatja a kívánt útvonal geometriai alakját és utasítások.

De az API egyik figyelmen kívül hagyott funkciója a kért útvonalak összefoglalójának lekérése. Hasznos megjeleníteni a lehetőségeket a felhasználó számára, például ebben a példában: meg kell találnunk a legközelebbi kórházat vagy gyógyszertárat. Az összefoglalók megszerzésével jobb választást tudunk ajánlani a mátrix útválasztási példa használatával. itt található.

Ennek másik klasszikus használati esete a Túramegosztó alkalmazás. A legjobb választási illesztőprogram kiszámítása egy adott területre elosztott szolgáltatók listájából nehézkessé válik, amikor nincs szükségünk útvonalak létrehozására az összehasonlításhoz, mivel csak vezetési távolságra vagy ETA-ra van szükségünk. Ekkor működik az Összegzés varázslata.

Az összefoglalót a következő paraméterrel kérik:

A vonallánc érték visszaadja az útvonal grafikus ábrázolását egy LatLng pár tömbben, míg az összefoglaló Csak egy extra JSON szakaszt kap az ilyen válaszban :

Itt található néhány érdekes adat amely megkülönbözteti magát ezt az API-t, különösen a többitől:

  1. Láthatja, hogy különböző ETA-k vannak forgalom nélküli, élő forgalmi és előzetes forgalmi szempontok mellett.
  2. Alternatív útvonalakat kaphat és nézze meg, mennyi eltérés van az eredetitől.

MEGJEGYZÉS: Az eltérések és az alternatív útvonalak csak akkor állnak rendelkezésre, ha egy kezdeti útvonal először kiszámítva.

2. MEGJEGYZÉS: Az üzemanyag-fogyasztás becsült. De ha elhaladunk a fogyasztási modellek mellett – akár elektromos, akár égésű motorral rendelkező járművek esetében – a számítás sokkal pontosabbá válik.

Most menjünk és nézzünk meg egy valós modellt életpélda…

KÜLÖNBÖZŐ TÍPUSOK, KÜLÖNBÖZŐ ETAS

Ellenőrizni fogunk néhány különböző ETA-t a Chicago belvárosában lévő szállodánkból – mit szólna a „La Quinta Inn” -hez? Ehhez a szállodához a következő helyet használjuk:

A szállodától szeretnénk egy közeli éttermet, egy Cajun kreol stílusú éttermet találni. Ehhez használhatjuk a Kategória keresési API-t [ https://developer.tomtom.com/search-api/search-api-documentation-search/category-search] a szálloda környékén található lehetséges éttermek listájának megszerzéséhez (a szálloda LatLng-jét használva Pozíciós elfogultságként).

A fel nem használt adatok eltávolításával kapunk egy kis listát. Ez az első elem:

Tehát láthatja, az eredmények részeként megkapjuk a távolságot is a szállodánkig. De ez az érték – méterben – a nézőpont közvetlen távolsága, nem pedig a vezetés vagy gyaloglás valódi távolsága. Megismételheti az eredményeimet a Curl parancs végrehajtásával.

A valódi vezetési távolsághoz az Routing API-t használjuk, csak az Összegzést kérve, és hozzáadva a lehetőséget a különböző utazási idők kiszámításához. Ez az az API végpont, amelyet használhatunk:

Amitől kapunk:

Bár ez egyelőre elég jó, még TÖBB útvonalat kell beszereznünk az összehasonlításhoz, és ehhez semmi sem jobb, mint a Matrix Routing API használata.

MINDEN LEHETSÉGES ÚT / ÚT ELÉRÉSE SOK CÉLRA

Fejlesztői portálunk dokumentációjából kiindulva:

A Matrix Routing szolgáltatás lehetővé teszi az útvonal-összefoglalók mátrixának kiszámítását egy olyan útvonalkészlethez, amelynek kezdő- és célhelye van megadva. >

  • Minden adott származási helynél ez a szolgáltatás kiszámítja az adott származási helytől az egyes célállomásokig vezető útvonal költségeit.
  • Az origók és a célok halmaza felfogható egy tábla oszlop- és sorfejléceként, míg a táblázat minden cellája tartalmazza a eredete az adott cella céljához.

Az egyes útvonalakhoz a következő költségeket számítják ki:

  • Utazási idők
  • Távolságok

A teljes dokumentációt itt ellenőrizheti: https://developer.tomtom.com/routing-api/routing-api-documentation-matrix-routing/synchronous-matrix

Ez pontosan úgy néz ki, amire szükségünk van.

Esetünkben kiszámoljuk a vezetési és gyalogos összefoglalókat, hogy eldönthessük, gyalogolni vagy vezetni akarunk-e, és mivel a kérések elég egyszerűek – itt nincsenek bonyolult útvonalak -, ezért használhatjuk a szinkron verziót: várni fog a válaszra, amint az összes útvonal kiszámításra került.

MEGJEGYZÉS: A mátrix útválasztási API szinkron verziója időtúllép 60 másodpercig, ezért mindenképpen csak kis útvonalak esetén használja.

A végpont egy HTTP-POST kérés. Ezt az URL-t fogjuk használni:

A POST Body: Itt állíthatjuk be a különböző útvonalakat (azonos eredet, különböző célállomások). Ezt a formátumot követi:

Szóval esetünk ez a POST törzsünk:

Ezzel a kéréssel a következő, szerkesztési célokra csonkított eredményt kapjuk:

Minden úticélhoz kapunk egy válaszobjektumot és annak RouteSummary-ját ugyanazzal a szükséges információval, amelyet egy egyszerű hívás végrehajtásakor kaptunk. Itt látjuk, hogy a „Cajun Grill” étterem áll a legközelebb hozzánk vezetéshez. Ezzel feltölthetünk egy listát vagy egy kijelzőt a felhasználó számára. Ha gyalogos útvonalat szeretne, próbálja meg megváltoztatni az utazási módot Gyalogosra. Volt. Gyalogos útvonalak esetén:

A kérés használata , azt látjuk, hogy a „Cajun Grill” étterem IS a legközelebb áll hozzánk sétatávolságon keresztül, de abban az esetben, ha különböző éttermek közül választhatunk, mindig használhatjuk a Batch Routing API-t az összes szükséges útvonal létrehozásához egyetlen hívás: https://developer.tomtom.com/routing-api/routing-api-documentation/batch-routing

Így csak azokat az útvonalakat készítjük, amelyeket meg kell jelenítenünk a felhasználó számára.

ÖSSZEFOGLALÓ

Ebben a cikkben áttekintettük az Útválasztás API-t, valamint az ETA-k és a valós vezetés ill. gyalogolási távolságok az Összegzés objektumon keresztül a Matrix Routing API válaszában.

A Matrix Routing API lehetővé teszi, hogy egyetlen hívással különféle összefoglalókat lehívhassunk, ahol különböző ETA-kat kaphatunk különböző célállomásokról.

Remélem, hogy ez a cikk segít jobban megérteni a TomTom Routing API-t – köszönöm a választ ading és boldog térképezés!

Ha többet szeretne megtudni a TomTom szolgáltatásairól és a legutóbbi mérföldes mobilitási és szállítási szolgáltatásokkal kapcsolatos megoldásokról, nézze meg a Mobilitás és Igény szerinti oldalt itt .

Ez a cikk eredetileg a https://developer.tomtom.com/blog . Az eredeti szerző Jose Jose Rojas.

Vélemény, hozzászólás?

Az email címet nem tesszük közzé. A kötelező mezőket * karakterrel jelöltük