Cum se utilizează TomTom Routing API pentru timpul estimat de sosire

Un tutorial despre utilizarea API-ului nostru pentru a calcula o oră exactă de sosire

(Bre Teiko) (22 oct. 2020)

O REZUMAT RAPID A API-ului DE RUTARE

API-ul de rutare este un instrument puternic care poate fi utilizat pentru a obține direcții exacte pentru diverse tipuri de vehicule – cu trasee precum cel mai rapid, cel mai scurt, cel mai interesant, etc. Vă poate oferi, de asemenea, forma geometrică a traseului dorit și instrucțiuni.

Dar o caracteristică ignorată din API este opțiunea de a prelua un rezumat al rutelor solicitate. Este util să afișăm posibilități utilizatorului, ca în acest exemplu: trebuie să găsim cel mai apropiat spital sau farmacie. Obținând rezumate, putem oferi o selecție mai bună utilizând Exemplul de rutare a matricei găsit aici .

Un alt caz de utilizare clasic pentru aceasta este o aplicație Ride Sharing. Calculul unui șofer cu cea mai bună alegere dintr-o listă de furnizori răspândiți în jurul unei zone devine dificil atunci când nu este necesar să creăm rute de comparat, deoarece avem nevoie doar de distanță de conducere sau de ETA. Acesta este momentul în care Rezumatul își face magia.

Rezumatul este solicitat cu următorul parametru:

Valoarea „polilinie” va returna reprezentarea grafică a rutei într-o matrice de perechi LatLng, în timp ce sumarulOnly vă va oferi o secțiune JSON suplimentară în răspunsul ca acesta :

Există câteva date interesante aici care diferențiază acest API în sine în special de altele:

  1. Puteți vedea că există ETA-uri diferite fără trafic, trafic live și trafic istoric.
  2. Puteți obține rute alternative și vedeți câtă abatere este față de cea originală.

NOTĂ: Abaterile și rutele alternative sunt disponibile numai atunci când o rută inițială este calculat mai întâi.

NOTA 2: consumul de combustibil on este estimat. Dar dacă trecem modele de consum – fie pentru vehiculele electrice, fie pentru cele cu motor cu combustie – calculul devine mult mai precis.

Acum să mergem să verificăm un real- exemplu de viață …

DIFERITE TIPURI, DIFERITE ETAS

Vom verifica câteva ETA-uri diferite de la hotelul nostru din centrul orașului Chicago – ce zici de „La Quinta Inn”? Pentru acest hotel, vom folosi locația:

De la hotel, ne-ar plăcea să găsim un restaurant în apropiere, un restaurant în stil creol Cajun. Pentru aceasta putem folosi API-ul de căutare a categoriilor [ https://developer.tomtom.com/search-api/search-api-documentation-search/category-search] pentru a obține o listă de posibile restaurante în jurul hotelului (folosind LatLng-ul hotelului ca poziție de înclinare).

Eliminând datele neutilizate, vom obține o listă mică. Acesta este primul element:

Deci puteți vedea, de asemenea, obținem distanța până la hotelul nostru ca parte a rezultatului. Dar această valoare – în metri – este o distanță directă a punctului de vedere, nu distanța reală prin conducere sau mers pe jos. Puteți replica rezultatele mele executând această comandă Curl.

Pentru distanța reală de conducere folosim API-ul de rutare, solicitând doar Rezumatul și adăugând opțiunea de calcul pentru diferiți timpi de călătorie. Acesta este punctul final API pe care îl putem utiliza:

Ceea ce ne oferă:

Deși acest lucru este suficient de bun deocamdată, trebuie să obținem și MAI MULTE rute de comparat, iar pentru asta nimic nu este mai bun decât utilizarea Matrix Routing API.

OBȚINEREA TOATE RUTELE POSIBILE / RUTE LA MULTE DESTINAȚII

Din documentația din portalul nostru pentru dezvoltatori:

Serviciul de rutare a matricei permite calcularea unei matrice de rezumate de rute pentru un set de rute definite cu locațiile de origine și destinație.

  • Pentru fiecare origine dată, acest serviciu calculează costul rutării de la acea origine la fiecare destinație dată. Setul de origini și setul de destinații poate fi considerat ca antetele de coloană și rând ale unui tabel, în timp ce fiecare celulă din tabel conține costurile de rutare din origine la destinația pentru celula respectivă.

Următoarele costuri sunt calculate pentru fiecare rută:

  • Timpi de călătorie
  • Distanțe

Verificați aici documentația completă: https://developer.tomtom.com/routing-api/routing-api-documentation-matrix-routing/synchronous-matrix

Arată exact ceea ce avem nevoie.

În cazul nostru vom calcula rezumate de conducere și pietoni, astfel încât să putem decide dacă vrem să mergem pe jos sau cu mașina și întrucât cererile sunt suficient de simple – nu există trasee complicate aici – deci putem folosi versiunea sincronă: va aștepta un răspuns odată ce toate rutele au fost calculate.

NOTĂ: Versiunea sincronă a API-ului de rutare a matricei va expira af după 60 de secunde, deci asigurați-vă că îl utilizați numai cu rute mici.

Punctul final este o solicitare HTTP-POST. Aceasta este adresa URL pe care o vom folosi:

Corpul POST: aici vom seta cererile pentru diferite rute (aceeași origine, destinații diferite). Urmează acest format:

Deci, în cazul nostru acesta este corpul nostru POST:

Cu această solicitare obținem următorul rezultat, trunchiat în scopuri editoriale:

Pentru fiecare destinație primim un obiect de răspuns și RouteSummary cu aceleași informații necesare obținute de la executarea unui apel simplu. Aici vedem că restaurantul „Cajun Grill” este cel mai apropiat de noi pentru conducere. Cu aceasta putem completa o listă sau un afișaj pentru utilizator. Încercați să schimbați modul de călătorie în Pieton dacă doriți un traseu de mers pe jos. Ex. Pentru traseele pietonale:

Utilizarea acestei cereri , vedem că restaurantul „Cajun Grill” este, de asemenea, cel mai apropiat de noi la distanță de mers pe jos, dar în cazul în care avem diferite restaurante din care să alegem, putem folosi oricând API-ul Batch Routing pentru a crea toate rutele necesare folosind un singur apel: https://developer.tomtom.com/routing-api/routing-api-documentation/batch-routing

În acest fel creăm doar rutele pe care trebuie să le afișăm utilizatorului.

ÎN REZUMAT

În acest articol am aruncat o privire asupra API-ului de rutare și despre cum să aducem ETA-urile și conducerea reală sau distanțe de mers pe jos prin obiectul Rezumat în răspunsul API-ului Matrix Routing.

API Matrix Routing ne permite să aducem rezumate diferite cu un singur apel, de unde putem obține astfel de ETA-uri din diferite destinații.

Sper că acest articol vă va ajuta să înțelegeți mai bine API-ul de rutare TomTom – vă mulțumesc pentru re Ading and Happy Mapping!

Pentru a afla mai multe despre serviciile și soluțiile TomTom pentru serviciile de mobilitate și transport pe ultimul kilometru, consultați pagina Mobilitate și la cerere aici .

Acest articol a apărut inițial pe https://developer.tomtom.com/blog . Autorul original este Jose Jose Rojas.

Lasă un răspuns

Adresa ta de email nu va fi publicată. Câmpurile obligatorii sunt marcate cu *