Jak používat rozhraní TomTom Routing API pro odhadovanou dobu příjezdu

Výukový program k používání našeho API k výpočtu přesného času příjezdu

(Bre Teiko) (22. října 2020)

RYCHLÉ SHRNUTÍ ROUTING API

Routing API je výkonný nástroj, který lze použít k získání přesných pokynů pro různé typy vozidel – s trasami, jako jsou nejrychlejší, nejkratší, nejzajímavější atd. Může vám také poskytnout geometrický tvar požadované trasy a pokyny.

Jedinou přehlíženou funkcí z API je však možnost načíst souhrn požadovaných tras. Je užitečné zobrazit možnosti uživateli, jako v tomto příkladu: musíme najít nejbližší nemocnici nebo lékárnu. Získáním souhrnů můžeme nabídnout lepší výběr pomocí příkladu směrování matice, který najdete zde .

Dalším klasickým případem použití je aplikace Ride Sharing. Výpočet ovladače nejlepší volby ze seznamu poskytovatelů rozmístěných po určité oblasti je obtížný, když nepotřebujeme skutečně vytvářet trasy k porovnání, protože potřebujeme pouze vzdálenost jízdy nebo ETA. To je okamžik, kdy Souhrn funguje jako kouzlo.

Souhrn je vyžadován pomocí následujícího parametru:

Hodnota polyline vrátí grafickou reprezentaci trasy v poli párů LatLng, zatímco SummaryOnly vám v takové odpovědi poskytne další sekci JSON :

Zde jsou zajímavá data který odlišuje toto API samotné, zejména od ostatních:

  1. Můžete vidět, že existují různá ETA bez ohledu na žádný provoz, živý provoz a historický provoz.
  2. Můžete získat alternativní trasy a zjistěte, jak velká je odchylka od původní.

POZNÁMKA: Odchylky a alternativní trasy jsou k dispozici, pouze když je výchozí trasa vypočítáno jako první.

POZNÁMKA 2: Spotřeba paliva Odhaduje se. Pokud ale projdeme modely spotřeby – u vozidel s elektrickým nebo spalovacím motorem – výpočet bude mnohem přesnější.

Pojďme se podívat na skutečný životní příklad…

RŮZNÉ TYPY, RŮZNÉ ETAS

Budeme kontrolovat několik různých ETA z našeho hotelu v centru Chicaga – co třeba „La Quinta Inn“? U tohoto hotelu použijeme umístění:

Z hotelu bychom chtěli najít blízkou restauraci, kreolskou restauraci Cajun. K tomu můžeme použít API pro vyhledávání kategorií [ https://developer.tomtom.com/search-api/search-api-documentation-search/category-search] pro získání seznamu možných restaurací v okolí hotelu (s využitím LatLng hotelu jako zkreslení polohy).

Odstraněním nevyužitých dat získáme malý seznam. Toto je první prvek:

Takže můžete vidět, že jako výsledek dostaneme také vzdálenost do našeho hotelu. Ale tato hodnota – v metrech – je přímou vzdáleností pohledu, nikoli skutečnou vzdáleností při řízení nebo chůzi. Moje výsledky můžete replikovat provedením tohoto příkazu Curl.

Pro skutečnou dojezdovou vzdálenost používáme Routing API, požadujeme pouze Souhrn a přidáváme možnost výpočtu pro různé doby jízdy. Toto je koncový bod API, který můžeme použít:

Což nám dává:

I když je to prozatím dost dobré, potřebujeme k porovnání ještě VÍCE cest, a proto není nic lepšího než používat Matrix Routing API.

ZÍSKÁNÍ VŠECH MOŽNÝCH TRAS / TRAS K MNOHÝM CÍLŮM

Z dokumentace na našem portálu pro vývojáře:

Služba Matrix Routing umožňuje výpočet matice souhrnů tras pro sadu tras definovaných s počátky a cílovými umístěními.

  • Pro každý daný původ tato služba vypočítá náklady na směrování z tohoto původu do každého daného cíle.
  • Sadu počátků a sadu cílů lze považovat za záhlaví sloupců a řádků tabulky, přičemž každá buňka v tabulce obsahuje náklady na směrování z původ do cíle pro tuto buňku.

Pro každou trasu se počítají následující náklady:

  • Cestovní časy
  • Vzdálenosti

Úplnou dokumentaci najdete zde: https://developer.tomtom.com/routing-api/routing-api-documentation-matrix-routing/synchronous-matrix

Vypadá to, co přesně potřebujeme.

V našem případě budeme počítat souhrny řízení a chodců, abychom se mohli rozhodnout, zda chceme jít pěšky nebo řídit, a protože požadavky jsou dostatečně jednoduché – zde nejsou žádné komplikované trasy – takže můžeme použít synchronní verzi: po výpočtu všech tras počká na odpověď.

POZNÁMKA: Synchronní verze API pro směrování matice vyprší časový limit af ter 60 s, takže se ujistěte, že jej používáte pouze s malými trasami.

Koncovým bodem je požadavek HTTP-POST. Toto je adresa URL, kterou budeme používat:

Tělo POST: Zde nastavíme požadavky na různé trasy (stejný původ, různé cíle). Vyplývá z tohoto formátu:

Takže v v našem případě toto je naše POST Body:

S tímto požadavkem získáme následující výsledek, zkrácený pro redakční účely:

Pro každý cíl dostaneme objekt odpovědi a jeho RouteSummary se stejnými potřebnými informacemi, které jsme dostali od provedení jednoduchého volání. Zde vidíme, že restaurace „Cajun Grill“ je nám k řízení nejblíže. S tímto můžeme naplnit seznam nebo zobrazení pro uživatele. Pokud chcete pěší trasu, zkuste změnit režim cestování na Pěší. Př. Pro pěší trasy:

Použití tohoto požadavku , vidíme, že restaurace Cajun Grill je také nejblíže k nám v docházkové vzdálenosti, ale v případě, že máme na výběr z různých restaurací, můžeme vždy použít API Batch Routing k vytvoření všech potřebných tras pomocí jediné volání: https://developer.tomtom.com/routing-api/routing-api-documentation/batch-routing

Tímto způsobem vytváříme pouze trasy, které musíme uživateli zobrazit.

SOUHRN

V tomto článku jsme se podívali na Routing API a jak načíst ETA a skutečné řízení nebo pěší vzdálenosti pomocí objektu Summary v reakci rozhraní Matrix Routing API.

Rozhraní Matrix Routing API nám umožňuje načíst různé souhrny jediným hovorem, kde můžeme získat takové ETA z různých cílů.

Doufám, že vám tento článek pomůže lépe porozumět TomTom Routing API – děkuji za opětovné vydání ading and Happy Mapping!

Chcete-li se dozvědět více o službách a řešeních TomTom pro mobilitu a dopravní služby na poslední míli, podívejte se na stránku Mobility and On-Demand zde .

Tento článek se původně objevil na https://developer.tomtom.com/blog . Původním autorem je Jose Jose Rojas.

Napsat komentář

Vaše e-mailová adresa nebude zveřejněna. Vyžadované informace jsou označeny *