Richiesta e risposta dell'API Distance Matrix

Introduzione

Una richiesta dell'API Distance Matrix ha il seguente formato:

https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters

dove outputFormat può avere uno dei seguenti valori:

• json (consigliato) indica l'output in JavaScript Object Notation (JSON).
• xml indica l'output in formato XML.

Alcuni parametri sono obbligatori, mentre altri sono facoltativi. Come di consueto negli URL, tutti i parametri sono separati dal carattere e commerciale (&). Tutti i caratteri riservati (ad esempio il segno più "+") devono essere codificati nell'URL. L'elenco dei parametri e dei relativi valori possibili è riportato di seguito.

Parametri obbligatori

• destinazioni

  Una o più località da utilizzare come punto di arrivo per il calcolo della distanza e del tempo di percorrenza. Le opzioni per il parametro delle destinazioni sono le stesse del parametro delle origini.

• origini

  Il punto di partenza per il calcolo della distanza e del tempo di percorrenza. Puoi fornire una o più località separate dal carattere barra verticale (|), sotto forma di ID luogo, indirizzo o coordinate di latitudine/longitudine:

  • ID luogo: se fornisci un ID luogo, devi anteporre place_id:.
  • Indirizzo: se passi un indirizzo, il servizio esegue la geocodifica della stringa e la converte in una coordinata di latitudine/longitudine per calcolare la distanza. Questa coordinata potrebbe essere diversa da quella restituita dall'API Geocoding, ad esempio l'ingresso di un edificio anziché il suo centro.
    Nota: l'utilizzo degli ID luogo è preferibile rispetto all'utilizzo di indirizzi o coordinate di latitudine/longitudine. L'utilizzo delle coordinate comporterà sempre l'aggancio del punto alla strada più vicina a quelle coordinate, che potrebbe non essere un punto di accesso alla proprietà o addirittura una strada che conduce rapidamente o in sicurezza alla destinazione. L'utilizzo dell'indirizzo fornirà la distanza dal centro dell'edificio, anziché da un ingresso dell'edificio.
  • Coordinate: se passi le coordinate di latitudine/longitudine, queste verranno allineate alla strada più vicina. È preferibile passare un ID luogo. Se trasmetti le coordinate, assicurati che non ci siano spazi tra i valori di latitudine e longitudine.
  • I Plus Code devono essere formattati come codice globale o codice composto. Formatta i plus code come mostrato qui (i segni più vengono codificati come %2B e gli spazi come %20 nell'URL):
    • Un codice globale è un prefisso di 4 caratteri e un codice locale di almeno 6 caratteri (849VCWC8+R9 è codificato in 849VCWC8%2BR9).
    • Un codice composto è un codice locale di almeno sei caratteri con una posizione esplicita (CWC8+R9 Mountain View, CA, USA è codificato come CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Polilinea codificata. In alternativa, puoi fornire un insieme di coordinate codificate utilizzando l'algoritmo di codifica polilinea. Ciò è particolarmente utile se hai un numero elevato di punti di origine, perché l'URL è molto più breve quando utilizzi una polilinea codificata.
    • Le polilinee codificate devono essere precedute da enc: e seguite da due punti :. Ad esempio: origins=enc:gfo}EtohhU:
    • Puoi anche includere più polilinee codificate, separate dal carattere pipe |. Ad esempio:

      origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:
      

Parametri facoltativi

• arrival_time

  Specifica l'orario di arrivo preferito per le indicazioni stradali per il trasporto pubblico, in secondi dalla mezzanotte del 1° gennaio 1970 UTC. Puoi specificare departure_time o arrival_time, ma non entrambi. Tieni presente che arrival_time deve essere specificato come numero intero.

• evita

  Le distanze potrebbero essere calcolate in modo da rispettare determinate limitazioni. Le limitazioni sono indicate dall'utilizzo del parametro avoid e da un argomento per quel parametro che indica la limitazione da evitare. Sono supportate le seguenti limitazioni:

  • tolls indica che il percorso calcolato deve evitare strade/ponti a pedaggio.
  • highways indica che il percorso calcolato deve evitare le autostrade.
  • ferries indica che il percorso calcolato deve evitare i traghetti.
  • indoor indica che il percorso calcolato deve evitare le scale interne per le indicazioni a piedi e con il trasporto pubblico.

  È possibile richiedere un percorso che eviti qualsiasi combinazione di pedaggi, autostrade e traghetti passando entrambe le limitazioni al parametro avoid. Ad esempio avoid=tolls|highways|ferries.

  Nota: l'aggiunta di limitazioni non esclude i percorsi che includono la funzionalità limitata, ma orienta il risultato verso percorsi più favorevoli.

• departure_time

  Specifica l'orario di partenza preferito. Puoi specificare l'ora come numero intero in secondi dalla mezzanotte del 1° gennaio 1970 UTC. Se viene specificato un departure_time successivo al 31/12/9999T23:59:59.999999999Z, l'API ripristinerà il departure_time al 31/12/9999T23:59:59.999999999Z. In alternativa, puoi specificare un valore di now, che imposta l'ora di partenza sull'ora corrente (corretta al secondo più vicino). L'orario di partenza può essere specificato in due casi:

  • Per le richieste in cui la modalità di viaggio è il trasporto pubblico, puoi specificare facoltativamente departure_time o arrival_time. Se non viene specificato alcun orario, il valore predefinito di departure_time è l'ora attuale (ovvero l'orario di partenza predefinito è l'ora attuale).
  • Per le richieste in cui la modalità di trasporto è la guida: puoi specificare departure_time per ricevere un percorso e la durata del viaggio (campo di risposta: duration_in_traffic) che tengano conto delle condizioni del traffico. Il parametro departure_time deve essere impostato sull'ora corrente o su un orario futuro. Non può essere antecedente alla data corrente.
  Nota: se l'orario di partenza non è specificato, la scelta del percorso e della durata si basa sulla rete stradale e sulle condizioni del traffico medie indipendenti dal tempo. I risultati di una determinata richiesta possono variare nel tempo a causa di modifiche alla rete stradale, aggiornamenti delle condizioni di traffico medie e della natura distribuita del servizio. I risultati possono variare anche tra percorsi quasi equivalenti in qualsiasi momento o frequenza.
  Nota: le richieste di Distance Matrix che specificano departure_time quando mode=driving sono limitate a un massimo di 100 elementi per richiesta. Il numero di origini moltiplicato per il numero di destinazioni definisce il numero di elementi.

• language

  La lingua in cui restituire i risultati.

  • Consulta l'elenco delle lingue supportate. Google aggiorna spesso le lingue supportate, pertanto questo elenco potrebbe non essere esaustivo.
  • Se language non viene fornito, l'API tenta di utilizzare la lingua preferita specificata nell'intestazione Accept-Language.
  • L'API fa del suo meglio per fornire un indirizzo stradale leggibile sia per l'utente sia per gli abitanti del luogo. Per raggiungere questo obiettivo, restituisce gli indirizzi stradali nella lingua locale, traslitterati in un sistema di scrittura leggibile dall'utente, se necessario, rispettando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. Tutti i componenti dell'indirizzo vengono restituiti nella stessa lingua, scelta dal primo componente.
  • Se un nome non è disponibile nella lingua preferita, l'API utilizza la corrispondenza più vicina.
  • La lingua preferita ha una piccola influenza sull'insieme di risultati che l'API sceglie di restituire e sull'ordine in cui vengono restituiti. Il geocodificatore interpreta le abbreviazioni in modo diverso a seconda della lingua, ad esempio le abbreviazioni per i tipi di strade o i sinonimi che potrebbero essere validi in una lingua ma non in un'altra. Ad esempio, utca e tér sono sinonimi di strada in ungherese.

• modalità

  Per il calcolo delle distanze e delle indicazioni stradali, puoi specificare la modalità di trasporto da utilizzare. Per impostazione predefinita, viene utilizzata la modalità DRIVING. Per impostazione predefinita, le indicazioni stradali vengono calcolate come indicazioni stradali in auto. Sono supportate le seguenti modalità di viaggio:

  • driving (predefinito) indica le indicazioni stradali standard o la distanza utilizzando la rete stradale.
  • walking richiede indicazioni stradali o distanza a piedi utilizzando percorsi pedonali e marciapiedi (se disponibili).
  • bicycling richiede indicazioni stradali o distanza in bicicletta utilizzando piste ciclabili e strade preferite (se disponibili).
  • transit richiede indicazioni stradali o distanza utilizzando gli itinerari del trasporto pubblico (se disponibili). Se imposti la modalità su trasporto pubblico, puoi specificare facoltativamente un departure_time o un arrival_time. Se non viene specificato alcun orario, departure_time il valore predefinito è ora (ovvero l'orario di partenza è l'ora attuale). Se vuoi, puoi anche includere un transit_mode e/o un transit_routing_preference.
  Nota: a volte le indicazioni a piedi e in bicicletta potrebbero non includere percorsi pedonali o ciclabili chiari, pertanto queste indicazioni restituiranno avvisi nel risultato restituito che devi mostrare all'utente.
  Nota: i viaggi con il trasporto pubblico sono disponibili fino a 7 giorni nel passato o fino a 100 giorni nel futuro, a seconda della disponibilità delle informazioni sul trasporto pubblico fornite dai fornitori di dati. Gli orari del trasporto pubblico cambiano spesso, i viaggi disponibili possono variare nel tempo e non è garantita la coerenza dei risultati per le previsioni con largo anticipo.

• regione

  Il codice regione, specificato come valore di due caratteri ccTLD ("top-level domain"). La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il TLD specifico per paese del Regno Unito è "uk" (.co.uk), mentre il suo codice ISO 3166-1 è"gb " (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord").

• traffic_model

  Specifica i presupposti da utilizzare per calcolare il tempo nel traffico. Questa impostazione influisce sul valore restituito nel campo duration_in_traffic della risposta, che contiene il tempo previsto nel traffico in base alle medie storiche. Il parametro traffic_model può essere specificato solo per le indicazioni stradali in cui la richiesta include un departure_time. I valori disponibili per questo parametro sono:

  • best_guess (valore predefinito) indica che la durata_nel_traffico restituita deve essere la migliore stima del tempo di viaggio in base a ciò che è noto sulle condizioni del traffico storico e in tempo reale. Il traffico in tempo reale diventa più importante quanto più departure_time è vicino al presente.
  • pessimistic indica che la durata_nel_traffico restituita dovrebbe essere superiore al tempo di percorrenza effettivo nella maggior parte dei giorni, anche se in alcuni giorni con condizioni di traffico particolarmente difficili questo valore potrebbe essere superato.
  • optimistic indica che la durata_nel_traffico restituita deve essere inferiore al tempo di percorrenza effettivo nella maggior parte dei giorni, anche se in alcuni giorni con condizioni di traffico particolarmente buone potrebbe essere inferiore a questo valore.

  Il valore predefinito di best_guess fornirà le previsioni più utili per la stragrande maggioranza dei casi d'uso. È possibile che la previsione del tempo di percorrenza best_guess sia più breve di optimistic o, in alternativa, più lunga di pessimistic, a causa del modo in cui il modello di previsione best_guess integra le informazioni sul traffico in tempo reale.

• transit_mode

  Specifica una o più modalità di trasporto preferite. Questo parametro può essere specificato solo per le indicazioni stradali per il trasporto pubblico. Il parametro supporta i seguenti argomenti:

  • bus indica che l'itinerario calcolato deve preferire il viaggio in autobus.
  • subway indica che l'itinerario calcolato deve preferire gli spostamenti in metropolitana.
  • train indica che l'itinerario calcolato deve dare la precedenza al viaggio in treno.
  • tram indica che l'itinerario calcolato deve preferire gli spostamenti in tram e metropolitana leggera.
  • rail indica che l'itinerario calcolato deve dare la precedenza agli spostamenti in treno, tram, metropolitana leggera e metropolitana. Equivalente a transit_mode=train|tram|subway.

• transit_routing_preference

  Specifica le preferenze per i percorsi con il trasporto pubblico. Utilizzando questo parametro, puoi influenzare le opzioni restituite, anziché accettare il percorso migliore predefinito scelto dall'API. Questo parametro può essere specificato solo per le indicazioni di trasporto pubblico. Il parametro supporta i seguenti argomenti:

  • less_walking indica che il percorso calcolato deve privilegiare tratti a piedi limitati.
  • fewer_transfers indica che l'itinerario calcolato deve preferire un numero limitato di trasferimenti.

• unità

  Specifica il sistema di unità da utilizzare per visualizzare i risultati.

  Nota: questa impostazione del sistema di unità di misura influisce solo sul testo visualizzato all'interno dei campi della distanza. I campi della distanza contengono anche valori sempre espressi in metri.

Esempi di richieste

Questo esempio utilizza le coordinate di latitudine/longitudine per specificare le coordinate della destinazione:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626
  &origins=40.6655101%2C-73.89188969999998
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626&key=YOUR_API_KEY'

Questo esempio utilizza i plus code per specificare le coordinate della destinazione:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=San%20Francisco
  &origins=849VCWC8%2BR9
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=849VCWC8%2BR9&destinations=San%20Francisco&key=YOUR_API_KEY'

Questo esempio mostra la stessa richiesta utilizzando una polilinea codificata:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A
  &origins=40.6655101%2C-73.89188969999998
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A&key=YOUR_API_KEY'

Informazioni sul traffico

Le informazioni sul traffico vengono utilizzate quando si verificano tutte le seguenti condizioni (queste sono le condizioni necessarie per ricevere il campo duration_in_traffic nella risposta di Distance Matrix):

• Il parametro di viaggio mode è driving o non è specificato (driving è la modalità di viaggio predefinita).
• La richiesta include un departure_time parametro valido. Il departure_time può essere impostato sull'ora corrente o su un'ora futura. Non può essere antecedente alla data corrente.

Se vuoi, puoi includere il parametro traffic_model nella richiesta per specificare i presupposti da utilizzare per il calcolo del tempo nel traffico.

Il seguente URL avvia una richiesta di matrice delle distanze per le distanze in auto tra Boston, MA o Charlestown, MA, e Lexington, MA e Concord, MA. La richiesta include un orario di partenza, soddisfacendo tutti i requisiti per restituire il campo duration_in_traffic nella risposta Distance Matrix.

https://maps.googleapis.com/maps/api/distancematrix/json
  ?departure_time=now
  &destinations=Lexington%2CMA%7CConcord%2CMA
  &origins=Boston%2CMA%7CCharlestown%2CMA
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Boston%2CMA%7CCharlestown%2CMA&destinations=Lexington%2CMA%7CConcord%2CMA&departure_time=now&key=YOUR_API_KEY'

{
  "destination_addresses": ["Lexington, MA, USA", "Concord, MA, USA"],
  "origin_addresses": ["Boston, MA, USA", "Charlestown, Boston, MA, USA"],
  "rows":
    [
      {
        "elements":
          [
            {
              "distance": { "text": "33.3 km", "value": 33253 },
              "duration": { "text": "27 mins", "value": 1620 },
              "duration_in_traffic": { "text": "34 mins", "value": 2019 },
              "status": "OK",
            },
            {
              "distance": { "text": "41.5 km", "value": 41491 },
              "duration": { "text": "33 mins", "value": 1981 },
              "duration_in_traffic": { "text": "39 mins", "value": 2342 },
              "status": "OK",
            },
          ],
      },
      {
        "elements":
          [
            {
              "distance": { "text": "31.1 km", "value": 31100 },
              "duration": { "text": "26 mins", "value": 1543 },
              "duration_in_traffic": { "text": "29 mins", "value": 1754 },
              "status": "OK",
            },
            {
              "distance": { "text": "39.3 km", "value": 39338 },
              "duration": { "text": "32 mins", "value": 1904 },
              "duration_in_traffic": { "text": "35 mins", "value": 2077 },
              "status": "OK",
            },
          ],
      },
    ],
  "status": "OK",
}

 OK
 Boston, MA, USA
 Charlestown, Boston, MA, USA
 Lexington, MA, USA
 Concord, MA, USA
 
  
   OK
   
    1620
    27 mins
   
   
    33253
    33.3 km
   
   
    2018
    34 mins
   
  
  
   OK
   
    1981
    33 mins
   
   
    41491
    41.5 km
   
   
    2342
    39 mins
   
  
 
 
  
   OK
   
    1543
    26 mins
   
   
    31100
    31.1 km
   
   
    1759
    29 mins
   
  
  
   OK
   
    1904
    32 mins
   
   
    39338
    39.3 km
   
   
    2077
    35 mins
   
  
 

Modificatori dei luoghi

Puoi utilizzare i modificatori di posizione per indicare ai conducenti come avvicinarsi a una determinata posizione, utilizzando il modificatore side_of_road per specificare il lato della strada da utilizzare o specificando una direzione per indicare la direzione di marcia corretta.

Specifica che i percorsi calcolati devono passare su un lato specifico della strada

Quando specifichi una località, puoi richiedere che l'itinerario calcolato passi dal lato della strada verso cui è orientato il waypoint utilizzando il prefisso side_of_road:. Ad esempio, questa richiesta restituirà la distanza per un percorso lungo in modo che il veicolo si fermi sul lato della strada verso cui è stato orientato il waypoint:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=side_of_road%3A37.7663444%2C-122.4412006
  &origins=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=37.7680296%2C-122.4375126&destinations=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

Quando utilizzi side_of_road: con polilinee codificate, il modificatore viene applicato a ogni località lungo la polilinea. Ad esempio, le due destinazioni in questa richiesta utilizzano entrambe il parametro:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A
  &origins=San%20Francisco%20City%20hall
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=San%20Francisco%20City%20hall&destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A&key=YOUR_API_KEY'

Il modificatore side_of_road: può essere utilizzato solo con questa limitazione:

• Il parametro di viaggio mode è driving o non è specificato (driving è la modalità di viaggio predefinita).

Specifica che le route calcolate devono avere una determinata direzione

Quando specifichi una località, puoi richiedere che l'itinerario calcolato passi per la località in una direzione particolare. Questa intestazione è specificata con il prefisso heading=X:, dove X è un valore intero di gradi compreso tra 0 (incluso) e 360 (escluso). Una direzione di 0 indica il nord, 90 indica l'est, e così via in senso orario. Ad esempio, in questa richiesta il percorso calcolato va a est dall'origine, poi fa un'inversione a U:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=37.773245%2C-122.469502
  &origins=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=heading%3D90%3A37.773279%2C-122.468780&destinations=37.773245%2C-122.469502&key=YOUR_API_KEY'

Il modificatore heading=X: può essere utilizzato solo con queste limitazioni:

• Il parametro viaggi mode è driving, bicycling o non è specificato (driving è la modalità di viaggio predefinita).
• Il modificatore side_of_road non è specificato per la stessa posizione.
• La posizione è specificata con un valore di latitudine/longitudine. Non puoi utilizzare heading con indirizzi, ID luogo o polilinee codificate.

Richieste e risposte di Distance Matrix

Di seguito è riportato un esempio di richiesta HTTP che richiede la distanza e la durata da Vancouver, BC, Canada e da Seattle, WA, USA, a San Francisco, CA, USA e a Victoria, BC, Canada.

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=San%20Francisco%7CVictoria%20BC
  &language=fr-FR
  &mode=bicycling
  &origins=Vancouver%20BC%7CSeattle
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Vancouver%20BC%7CSeattle&destinations=San%20Francisco%7CVictoria%20BC&mode=bicycling&language=fr-FR&key=YOUR_API_KEY'

Questa richiesta restituirà quattro elementi: due origini e due destinazioni:

I risultati vengono restituiti in righe, ognuna contenente un'origine accoppiata a ogni destinazione.

{
  "destination_addresses":
    ["San Francisco, Californie, États-Unis", "Victoria, BC, Canada"],
  "origin_addresses":
    ["Vancouver, BC, Canada", "Seattle, Washington, États-Unis"],
  "rows":
    [
      {
        "elements":
          [
            {
              "distance": { "text": "1 712 km", "value": 1711765 },
              "duration": { "text": "3 jours 16 heures", "value": 318119 },
              "status": "OK",
            },
            {
              "distance": { "text": "140 km", "value": 139695 },
              "duration": { "text": "6 heures 49 minutes", "value": 24567 },
              "status": "OK",
            },
          ],
      },
      {
        "elements":
          [
            {
              "distance": { "text": "1 452 km", "value": 1451704 },
              "duration": { "text": "3 jours 2 heures", "value": 266680 },
              "status": "OK",
            },
            {
              "distance": { "text": "146 km", "value": 146500 },
              "duration": { "text": "2 heures 53 minutes", "value": 10374 },
              "status": "OK",
            },
          ],
      },
    ],
  "status": "OK",
}

 OK
 Vancouver, BC, Canada
 Seattle, Washington, États-Unis
 San Francisco, Californie, États-Unis
 Victoria, BC, Canada
 
  
   OK
   
    318119
    3 jours 16 heures
   
   
    1711765
    1 712 km
   
  
  
   OK
   
    24567
    6 heures 49 minutes
   
   
    139695
    140 km
   
  
 
 
  
   OK
   
    266680
    3 jours 2 heures
   
   
    1451704
    1 452 km
   
  
  
   OK
   
    10374
    2 heures 53 minutes
   
   
    146500
    146 km
   
  
 

DistanceMatrixResponse

DistanceMatrixStatus

Codici di stato restituiti dal servizio.

• OK indica che la risposta contiene un risultato valido.
• INVALID_REQUEST indica che la richiesta fornita non è valida.
• MAX_ELEMENTS_EXCEEDED indica che il prodotto di origini e destinazioni supera il limite per query.
• MAX_DIMENSIONS_EXCEEDED indica che il numero di origini o destinazioni supera il limite per query.
• OVER_DAILY_LIMIT indica una delle seguenti opzioni:
  • La chiave API è mancante o non valida.
  • La fatturazione non è stata abilitata sul tuo account.
  • È stato superato un limite di utilizzo autoimposto.
  • Il metodo di pagamento fornito non è più valido (ad esempio, una carta di credito è scaduta).
• OVER_QUERY_LIMIT indica che il servizio ha ricevuto troppe richieste dalla tua applicazione nel periodo di tempo consentito.
• REQUEST_DENIED indica che il servizio ha negato l'utilizzo del servizio Distance Matrix da parte della tua applicazione.
• UNKNOWN_ERROR indica che una richiesta Distance Matrix non è stato possibile elaborarla a causa di un errore del server. Se riprovi, la richiesta potrebbe andare a buon fine.

DistanceMatrixRow

DistanceMatrixElement

Tariffa

La tariffa totale per l'itinerario.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}

DistanceMatrixElementStatus

• OK indica che la risposta contiene un risultato valido.
• NOT_FOUND indica che l'origine e/o la destinazione di questo accoppiamento non è stato possibile geocodificarle.
• ZERO_RESULTS indica che non è stato possibile trovare un percorso tra l'origine e la destinazione.
• MAX_ROUTE_LENGTH_EXCEEDED indica che l'itinerario richiesto è troppo lungo e non può essere elaborato.

TextValueObject

Un oggetto contenente un valore numerico e la relativa rappresentazione di testo formattato.