Una richiesta di matrice di percorsi accetta come input un array di waypoint di origine e di destinazione. L'API Routes calcola quindi il percorso da ogni waypoint di origine a ogni waypoint di destinazione. Ad esempio, se specifichi due waypoint di origine e due di destinazione, l'API calcola quattro percorsi separati.
La risposta dell'API contiene un array, in cui ogni elemento dell'array corrisponde al percorso da un waypoint di origine a un waypoint di destinazione. Pertanto, se specifichi due waypoint di origine e due di destinazione, l'array di risposte contiene quattro elementi, uno per ogni percorso calcolato.
Utilizzando la risposta, puoi fornire ai tuoi clienti diverse opzioni di percorso e consentire all'utente di selezionare il percorso appropriato per le sue esigenze.
Informazioni sulle maschere di campo
Quando chiami un metodo per calcolare un percorso, devi specificare una maschera di campo che definisca i campi che vuoi che vengano restituiti nella risposta. Non esiste un elenco predefinito di campi restituiti. Se ometti questo elenco, i metodi restituiscono un errore.
Gli esempi in questo documento mostrano l'intero oggetto di risposta senza tenere conto delle maschere di campo. In un ambiente di produzione, la risposta includerebbe solo i campi che hai specificato esplicitamente nella maschera di campo.
Per ulteriori informazioni, vedi Scegliere le informazioni da restituire.
Informazioni sulla visualizzazione dei copyright
Devi includere la seguente dichiarazione di copyright quando mostri i risultati agli utenti:
Powered by Google, ©YEAR Google
Ad esempio:
Powered by Google, ©2023 Google
Identificare il percorso nella risposta
Utilizza le proprietà di risposta originIndex e destinationIndex per identificare ogni percorso nella risposta. Queste proprietà contengono l'indice basato su zero dei waypoint di origine e di destinazione di input utilizzati per calcolare il percorso. Ciò significa che il primo waypoint di origine e il primo waypoint di destinazione nella richiesta si trovano all'indice dell'array 0.
Ad esempio, un percorso nella risposta contiene:
"originIndex": 1, "destinationIndex": 0
Queste proprietà indicano che il percorso è stato calcolato dal waypoint di origine all'indice 1 nell'array di input e dal waypoint di destinazione all'indice 0.
Per il percorso successivo:
"originIndex": 4, "destinationIndex": 1
Il percorso è stato calcolato dal waypoint di origine all'indice 4 nell'array di input e dal waypoint di destinazione all'indice 1 nell'array di input.
Informazioni sulla risposta
L' oggetto JSON che rappresenta la risposta dell'API contiene un array, in cui ogni elemento dell'array definisce il percorso da un waypoint di origine a un waypoint di destinazione.
Oltre alle proprietà originIndex e destinationIndex, ogni percorso contiene informazioni specifiche per quel percorso, come distanceMeters, duration e travelAdvisory.
La risposta ha il seguente formato:
[ // One array element for each combination of origin and destination waypoints. { // The route for source waypoint 0 and destination waypoint 0. "originIndex": 0, "destinationIndex": 0, "status": { object (Status) }, "condition": enum (RouteMatrixElementCondition), "distanceMeters": integer, "duration": string, "staticDuration": string, "travelAdvisory": { object (RouteTravelAdvisory) }, "fallbackInfo": { object (FallbackInfo) } } { // The route for source waypoint 0 and destination waypoint 1. "originIndex": 0, "destinationIndex": 1, "status": { object (Status) }, "condition": enum (RouteMatrixElementCondition), "distanceMeters": integer, "duration": string, "staticDuration": string, "travelAdvisory": { object (RouteTravelAdvisory) }, "fallbackInfo": { object (FallbackInfo) } } … ]