Jak korzystać z interfejsu TomTom Routing API do szacowanego czasu przybycia

Samouczek dotyczący korzystania z naszego interfejsu API w celu obliczenia dokładnego czasu przybycia

(Bre Teiko) (22 października 2020 r.)

SZYBKIE PODSUMOWANIE API ROUTINGU

Routing API to potężne narzędzie, które może być używane do uzyskiwania dokładnych wskazówek dla różnych typów pojazdów – z trasami takimi jak najszybsza, najkrótsza, najbardziej ekscytująca itp. Może również zapewnić geometryczny kształt żądanej trasy i instrukcje.

Jedną z przeoczonych funkcji API jest opcja pobierania podsumowania żądanych tras. Przydatne jest wyświetlenie użytkownikowi możliwości, jak w tym przykładzie: musimy znaleźć najbliższy szpital lub aptekę. Pobierając podsumowania, możemy zaoferować lepszy wybór, korzystając z Przykładu routingu macierzy znajdującego się tutaj .

Innym klasycznym przypadkiem użycia jest aplikacja Ride Sharing. Obliczenie najlepszego kierowcy z listy dostawców rozsianych po okolicy jest trudne, gdy nie musimy w rzeczywistości tworzyć tras do porównania, ponieważ potrzebujemy tylko odległości przejechania lub szacowanego czasu przybycia. To wtedy Podsumowanie działa magicznie.

Żądanie podsumowania jest wymagane za pomocą następującego parametru:

Wartość „polyline” zwróci graficzną reprezentację trasy w tablicy par LatLng, podczas gdy summaryOnly dostarczy dodatkową sekcję JSON w odpowiedzi takiej jak ta :

Jest tutaj kilka interesujących danych który odróżnia ten interfejs API w szczególności od innych:

  1. Możesz zobaczyć, że istnieją różne ETA bez ruchu, aktualnego ruchu i historycznego ruchu.
  2. Możesz uzyskać alternatywne trasy i zobacz, jakie jest odchylenie od pierwotnej trasy.

UWAGA: Odchylenia i trasy alternatywne są dostępne tylko wtedy, gdy trasa początkowa jest obliczone jako pierwsze.

UWAGA 2: Zużycie paliwa szacuje się. Ale jeśli przejdziemy modele zużycia – dla pojazdów z silnikiem elektrycznym lub spalinowym – obliczenia stają się znacznie dokładniejsze.

Teraz przejdźmy do rzeczywistego- przykład z życia…

RÓŻNE RODZAJE, RÓŻNE ETAS

Zamierzamy sprawdzić kilka różnych ETA z naszego hotelu w centrum Chicago – co powiesz na „La Quinta Inn”? W przypadku tego hotelu użyjemy lokalizacji:

Z hotelu chcielibyśmy znaleźć w pobliżu restaurację, restaurację w stylu kreolskim Cajun. W tym celu możemy użyć API wyszukiwania kategorii [ https://developer.tomtom.com/search-api/search-api-documentation-search/category-search] aby uzyskać listę możliwych restauracji w pobliżu hotelu (używając LatLng hotelu jako odchylenia pozycji).

Usuwając nieużywane dane, otrzymujemy małą listę. To jest pierwszy element:

Więc widać, jako część wyniku obliczamy również odległość do naszego hotelu. Ale ta wartość – w metrach – jest bezpośrednim punktem widzenia na odległość, a nie rzeczywistą odległością podczas jazdy lub chodzenia. Możesz powtórzyć moje wyniki, wykonując to polecenie Curl.

W przypadku rzeczywistej odległości jazdy korzystamy z interfejsu API routingu, żądając tylko Podsumowania i dodając opcję obliczania dla różnych czasów podróży. Oto punkt końcowy API, którego możemy użyć:

Co daje nam:

Chociaż na razie jest to wystarczająco dobre, musimy uzyskać jeszcze WIĘCEJ tras do porównania, a do tego nie ma nic lepszego niż użycie interfejsu API Matrix Routing.

POBIERANIE WSZYSTKICH MOŻLIWYCH TRAS / TRAS DO WIELU MIEJSC DOCELOWYCH

Z dokumentacji w naszym portalu dla programistów:

Usługa Matrix Routing umożliwia obliczenie macierzy podsumowań tras dla zestawu tras zdefiniowanych z lokalizacjami początkowymi i docelowymi.

  • Dla każdego podanego źródła ta usługa oblicza koszt trasowania z tego miejsca do każdego miejsca docelowego.
  • Zbiór początków i zbiór miejsc docelowych można traktować jako nagłówki kolumn i wierszy tabeli, podczas gdy każda komórka w tabeli zawiera koszty trasowania z początek do miejsca docelowego dla tej komórki.

Dla każdej trasy obliczane są następujące koszty:

  • Czasy podróży
  • Odległości

Tutaj znajdziesz pełną dokumentację: https://developer.tomtom.com/routing-api/routing-api-documentation-matrix-routing/synchronous-matrix

To wygląda dokładnie na to, czego potrzebujemy.

W naszym przypadku zamierzamy obliczyć podsumowania jazdy i pieszych, abyśmy mogli zdecydować, czy chcemy iść, czy jechać, a ponieważ żądania są dość proste – tutaj nie ma skomplikowanych tras – możemy więc użyć wersji synchronicznej: będzie czekać na odpowiedź, gdy wszystkie trasy zostaną obliczone.

UWAGA: Wersja synchroniczna interfejsu API routingu macierzy przekroczy limit czasu af co 60 sekund, więc upewnij się, że używasz go tylko z małymi trasami.

Punktem końcowym jest żądanie HTTP-POST. To jest adres URL, którego będziemy używać:

Treść POST: Tutaj ustawimy różne trasy (to samo miejsce pochodzenia, różne miejsca docelowe). Ma następujący format:

A więc w naszym przypadku jest to nasza treść POST:

Z tym żądaniem otrzymujemy następujący wynik, obcięty ze względów redakcyjnych:

Dla każdego miejsca docelowego otrzymujemy obiekt odpowiedzi i jego podsumowanie RouteS summary z tymi samymi potrzebnymi informacjami, które otrzymaliśmy po wykonaniu prostego wywołania. Tutaj widzimy, że restauracja „Cajun Grill” jest najbliżej nas do jazdy. Dzięki temu możemy wypełnić listę lub ekran dla użytkownika. Spróbuj zmienić tryb podróży na Pieszy, jeśli chcesz wybrać trasę pieszą. Dawny. W przypadku tras dla pieszych:

Korzystanie z tego żądania widzimy, że restauracja „ Cajun Grill jest RÓWNIEŻ najbliżej nas w odległości spaceru, ale w przypadku, gdy mamy do wyboru różne restauracje, zawsze możemy użyć Batch Routing API, aby stworzyć wszystkie potrzebne trasy za pomocą jednego zadzwoń: https://developer.tomtom.com/routing-api/routing-api-documentation/batch-routing

W ten sposób tworzymy tylko trasy, które musimy wyświetlić użytkownikowi.

PODSUMOWANIE

W tym artykule przyjrzeliśmy się interfejsowi API routingu i sposobowi pobierania ETA i rzeczywistej jazdy lub odległości piesze przez obiekt Summary w odpowiedzi Matrix Routing API.

Matrix Routing API pozwala nam pobierać różne podsumowania za pomocą jednego wywołania, gdzie możemy uzyskać takie ETA z różnych miejsc docelowych.

Mam nadzieję, że ten artykuł pomoże Ci lepiej zrozumieć interfejs TomTom Routing API – dziękuję za ponowne ading i szczęśliwego tworzenia map!

Aby dowiedzieć się więcej o usługach i rozwiązaniach TomTom w zakresie mobilności ostatniej mili i usług transportowych, odwiedź stronę Mobilność i na żądanie tutaj .

Ten artykuł pojawił się pierwotnie w https://developer.tomtom.com/blog . Oryginalnym autorem jest Jose Jose Rojas.

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Pola, których wypełnienie jest wymagane, są oznaczone symbolem *