Come utilizzare lAPI TomTom Routing per lorario di arrivo stimato

Un tutorial sullutilizzo della nostra API per calcolare un orario di arrivo preciso

(Bre Teiko) (22 ottobre 2020)

UN RAPIDO SOMMARIO DELLAPI DI ROUTING

LAPI Routing è uno strumento potente che può essere utilizzato per ottenere indicazioni precise per diversi tipi di veicoli – con percorsi come il più veloce, il più breve, il più emozionante, ecc. Può anche fornire la forma geometrica del percorso desiderato e istruzioni.

Ma una caratteristica trascurata dallAPI è lopzione per recuperare un riepilogo delle rotte richieste. È utile per mostrare le possibilità allutente, come in questo esempio: dobbiamo trovare lospedale o la farmacia più vicini. Ottenendo i riepiloghi, possiamo offrire una selezione migliore utilizzando lesempio di instradamento della matrice trovato qui .

Un altro classico caso di utilizzo di questa applicazione è lapplicazione Ride Sharing. Calcolare un autista migliore da un elenco di fornitori sparsi in unarea diventa complicato quando non abbiamo bisogno di creare effettivamente percorsi da confrontare, poiché abbiamo solo bisogno della distanza di guida o dellETA. È qui che il Riepilogo fa la sua magia.

Il riepilogo viene richiesto con il seguente parametro:

Il valore polyline restituirà la rappresentazione grafica del percorso in un array di coppie LatLng, mentre summaryOnly ti darà una sezione JSON extra nella risposta come questa :

Ci sono alcuni dati interessanti qui che differenzia questa stessa API in particolare dalle altre:

  1. Puoi vedere che ci sono diversi orari di arrivo previsti senza traffico, traffico in tempo reale e traffico storico.
  2. Puoi ottenere percorsi alternativi e vedere quanta deviazione cè da quella originale.

NOTA: le deviazioni e le rotte alternative sono disponibili solo quando una rotta iniziale è calcolato per primo.

NOTA 2: il consumo di carburante è stimato. Ma se passiamo i modelli di consumo – per veicoli elettrici o con motore a combustione – il calcolo diventa molto più accurato.

Ora andiamo a controllare un vero e proprio esempio di vita…

DIVERSI TIPI, DIVERSI ETAS

Stiamo per controllare alcuni diversi orari di arrivo stimato del nostro hotel nel centro di Chicago – che ne dici di “La Quinta Inn”? Per questo hotel, utilizzeremo la posizione:

Dallhotel, vorremmo trovare un vicino ristorante, un ristorante in stile creolo cajun. Per questo possiamo utilizzare lAPI di ricerca per categoria [ https://developer.tomtom.com/search-api/search-api-documentation-search/category-search] per ottenere un elenco di possibili ristoranti intorno allhotel (utilizzando la LatLng dellhotel come Position Bias).

Rimuovendo i dati non utilizzati, otteniamo un piccolo elenco. Questo è il primo elemento:

Quindi come puoi vedere, otteniamo anche la distanza dal nostro hotel come parte del risultato. Ma questo valore – in metri – è una distanza dal punto di vista diretto, non la distanza reale in auto o camminando. Puoi replicare i miei risultati eseguendo questo comando Curl.

Per la distanza di percorrenza reale utilizziamo le Routing API, richiedendo solo il Riepilogo e aggiungendo lopzione per calcolare tempi di percorrenza diversi. Questo è lendpoint API che possiamo utilizzare:

Il che ci dà:

Anche se per ora è abbastanza buono, abbiamo bisogno di ottenere ancora PIÙ rotte da confrontare, e per questo niente è meglio che usare lAPI Matrix Routing.

OTTENERE TUTTE LE ROTTE POSSIBILI / ROTTE PER MOLTE DESTINAZIONI

Dalla documentazione nel nostro Portale per sviluppatori:

Il servizio Matrix Routing consente il calcolo di una matrice di riepiloghi dei percorsi per un insieme di percorsi definiti con le posizioni di origine e destinazione.

  • Per ogni data origine, questo servizio calcola il costo del percorso da tale origine a ogni data destinazione.
  • Linsieme di origini e linsieme di destinazioni possono essere pensati come le intestazioni di colonna e di riga di una tabella, mentre ogni cella della tabella contiene i costi di instradamento dal origine alla destinazione per quella cella.

I seguenti costi vengono calcolati per ogni percorso:

  • Tempi di viaggio
  • Distanze

Controlla la documentazione completa qui: https://developer.tomtom.com/routing-api/routing-api-documentation-matrix-routing/synchronous-matrix

Questo sembra esattamente ciò di cui abbiamo bisogno.

Nel nostro caso calcoleremo i riepiloghi di guida e pedoni in modo da poter decidere se vogliamo camminare o guidare e poiché le richieste sono abbastanza semplici – nessun percorso complicato qui – quindi possiamo usare la versione sincrona: Noi aspetterà una risposta una volta che tutti i percorsi sono stati calcolati.

NOTA: la versione sincrona dellAPI di instradamento a matrice andrà in timeout af per 60 secondi, quindi assicurati di usarlo solo con piccole rotte.

Il punto finale è una richiesta HTTP-POST. Questo è lURL che utilizzeremo:

The POST Body: Qui imposteremo le diverse richieste di route (stessa origine, diverse destinazioni). Segue questo formato:

Quindi in il nostro caso questo è il nostro POST Body:

Con questa richiesta otteniamo il seguente risultato, troncato per scopi editoriali:

Per ogni destinazione otteniamo un oggetto risposta e il relativo RouteSummary con le stesse informazioni necessarie ottenute dallesecuzione di una semplice chiamata. Qui vediamo che il ristorante “Cajun Grill” è il più vicino a noi per la guida. Con questo possiamo popolare un elenco o un display per lutente. Prova a cambiare la modalità di viaggio in Pedonale se desideri un percorso a piedi. Ex. Per percorsi pedonali:

Utilizzando questa richiesta , vediamo che il ristorante Cajun Grill è ANCHE il più vicino a noi a pochi passi, ma nel caso in cui abbiamo diversi ristoranti tra cui scegliere, possiamo sempre utilizzare lAPI Batch Routing per creare tutti i percorsi necessari utilizzando un unico chiama: https://developer.tomtom.com/routing-api/routing-api-documentation/batch-routing

In questo modo creiamo solo i percorsi che dobbiamo mostrare allutente.

IN SOMMARIO

In questo articolo abbiamo esaminato lAPI di routing e come recuperare ETA e guida reale o distanze a piedi tramite loggetto Summary nella risposta dellAPI Matrix Routing.

LAPI Matrix Routing ci consente di recuperare diversi riepiloghi con una singola chiamata da cui possiamo ottenere tali ETA da diverse destinazioni.

Spero che questo articolo ti aiuti a comprendere meglio lAPI di instradamento TomTom, grazie per re ading e Happy Mapping!

Per ulteriori informazioni sui servizi e le soluzioni di TomTom per la mobilità e i servizi di trasporto dellultimo miglio, visita la pagina Mobilità e on demand qui .

Questo articolo è apparso originariamente su https://developer.tomtom.com/blog . Lautore originale è Jose Jose Rojas.

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *