Una richiesta di matrice di route prende come input un array di origine e destinazione tappe. L'API Routes calcola quindi il percorso da ciascuna origine tappa fino a ciascuna tappa di destinazione. Ad esempio, se specifichi due origini e due di destinazione, l'API calcola quattro tappe separate route.
La risposta dell'API contiene un array, in cui ogni elemento corrisponde al percorso da una tappa di partenza a una tappa di destinazione. Pertanto, se specificare due tappe di partenza e due di destinazione, l'array di risposta contiene quattro elementi, uno per ogni percorso calcolato.
Utilizzando la risposta, puoi fornire ai clienti diverse opzioni di percorso e lasciare che l'utente selezioni il percorso appropriato per le sue esigenze.
Informazioni sulle maschere dei campi
Quando chiami un metodo per calcolare una route, devi specificare un campo che definisce i campi da restituire nella risposta. Non esiste elenco predefinito dei campi restituiti. Se ometti questo elenco, i metodi restituiscono un valore .
Gli esempi in questo documento mostrano l'intero oggetto risposta senza prendere maschere di campo. In un ambiente di produzione, la risposta includi solo i campi specificati esplicitamente nella maschera dei campi.
Per ulteriori informazioni, 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 la route nella risposta
Utilizza le proprietà di risposta originIndex e destinationIndex per identificare
ogni route nella risposta. Queste proprietà contengono l'indice in base zero di
le tappe origin di input e destination di input utilizzate per calcolare il
percorso. Ciò significa la prima tappa di partenza e la prima tappa di destinazione.
nella richiesta sono con un indice della matrice pari a 0.
Ad esempio, una route nella risposta contiene:
"originIndex": 1, "destinationIndex": 0
Queste proprietà indicano che il percorso è stato calcolato dall'origine tappa all'indice 1 nella matrice di input e dalla tappa di destinazione in indice 0.
Per il percorso successivo:
"originIndex": 4, "destinationIndex": 1
La rotta è stata calcolata dal waypoint di origine all'indice 4 nell'input e dal waypoint di destinazione all'indice 1 nella matrice di input.
Informazioni sulla risposta
La Oggetto JSON che rappresenta la risposta dell'API, contiene un array, in cui ogni elemento di array definisce il percorso da una tappa di partenza a una tappa di destinazione.
Insieme alle proprietà originIndex e destinationIndex, ogni percorso
contiene informazioni specifiche per il percorso, ad esempio 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) } } … ]