Una richiesta di matrice delle rotte accetta come input un array di waypoint di origine e 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 waypoint di destinazione, l'API calcola quattro percorsi separati.
La risposta dell'API contiene un array in cui ogni elemento corrisponde alla rotta da un waypoint di partenza a un waypoint di destinazione. Pertanto, se specifichi due tappe di partenza e due tappe di destinazione, l'array di risposta contiene quattro elementi, uno per ogni percorso calcolato.
Utilizzando la risposta, puoi fornire ai tuoi clienti diverse opzioni di percorso e poi lasciare che l'utente selezioni il percorso più adatto alle sue esigenze.
Informazioni sulle maschere di campo
Quando chiami un metodo per calcolare un itinerario, devi specificare una maschera del campo che definisce 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 risposta senza prendere in considerazione le maschere di campo. In un ambiente di produzione, la risposta includerebbe solo i campi specificati esplicitamente nella maschera del campo.
Per saperne di più, vedi Scegliere le informazioni da restituire.
Informazioni sulla visualizzazione dei copyright
Quando mostri i risultati agli utenti, devi includere la seguente dichiarazione sul copyright:
Powered by Google, ©YEAR Google
Ad esempio:
Powered by Google, ©2023 Google
Identificare l'itinerario 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 origine e 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 0 dell'array.
Ad esempio, un itinerario nella risposta contiene:
"originIndex": 1, "destinationIndex": 0
Queste proprietà indicano che il percorso è stato calcolato dal waypoint di partenza all'indice 1 dell'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 partenza 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 partenza a un waypoint di destinazione.
Oltre alle proprietà originIndex e destinationIndex, ogni percorso
contiene informazioni specifiche, 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) } } … ]