Requête et réponse de l'ancienne API Distance Matrix

Introduction

Une requête de l'API Distance Matrix (ancienne) se présente sous la forme suivante :

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

où outputFormat peut correspondre à l'une des valeurs suivantes :

• json (recommandé) indique une sortie au format JSON (JavaScript Object Notation).
• xml indique que la sortie est au format XML.

Certains paramètres sont obligatoires, d'autres sont facultatifs. Comme c'est la norme pour les URL, les différents paramètres sont séparés par une esperluette (&). Tous les caractères réservés (par exemple, le signe plus "+") doivent être encodés au format URL. La liste des paramètres et leurs valeurs possibles sont énumérées ci-dessous.

Paramètres obligatoires

• destinations

  Un ou plusieurs lieux à utiliser comme point d'arrivée pour calculer la distance et le temps de trajet. Les options du paramètre "destinations" sont les mêmes que celles du paramètre "origins".

• origines

  Point de départ pour calculer la distance et le temps de trajet. Vous pouvez fournir un ou plusieurs lieux séparés par une barre verticale (|), sous la forme d'un ID de lieu, d'une adresse ou de coordonnées de latitude/longitude :

  • ID de lieu : si vous fournissez un ID de lieu, vous devez le faire précéder de place_id:.
  • Adresse : si vous transmettez une adresse, le service géocode la chaîne et la convertit en coordonnées de latitude/longitude pour calculer la distance. Cette coordonnée peut être différente de celle renvoyée par l'API Geocoding (par exemple, l'entrée d'un bâtiment plutôt que son centre).
    Remarque : Il est préférable d'utiliser des ID de lieu plutôt que des adresses ou des coordonnées de latitude/longitude. L'utilisation de coordonnées entraîne toujours l'alignement du point sur la route la plus proche de ces coordonnées, qui peut ne pas être un point d'accès à la propriété, ni même une route qui mène rapidement ou en toute sécurité à la destination. L'utilisation de l'adresse permet d'obtenir la distance jusqu'au centre du bâtiment, et non jusqu'à l'entrée du bâtiment.
  • Coordonnées : si vous transmettez des coordonnées de latitude/longitude, elles seront alignées sur la route la plus proche. Il est préférable de transmettre un ID de lieu. Si vous transmettez des coordonnées, assurez-vous qu'il n'y a pas d'espace entre les valeurs de latitude et de longitude.
  • Les Plus Codes doivent être au format d'un code global ou d'un code composé. Mettez en forme les Plus Codes comme indiqué ici (les signes plus sont échappés dans l'URL par %2B et les espaces par %20) :
    • Le code global est un indicatif de zone de 4 caractères et un code local à 6 caractères ou plus (849VCWC8+R9 est encodé en 849VCWC8%2BR9).
    • Le code composé est un code local à six caractères ou plus associé à un emplacement explicite (CWC8+R9 Mountain View, CA, USA est encodé en CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Polyligne encodée : vous pouvez également fournir un ensemble de coordonnées encodées à l'aide de l'algorithme de polyligne encodée. Cela est particulièrement utile si vous avez un grand nombre de points de départ, car l'URL est beaucoup plus courte lorsque vous utilisez une polyligne encodée.
    • Les polylignes encodées doivent être précédées de enc: et suivies d'un deux-points :. Exemple : origins=enc:gfo}EtohhU:
    • Vous pouvez également inclure plusieurs polylignes encodées, séparées par une barre verticale |. Exemple :

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

Paramètres facultatifs

• arrival_time

  Spécifie l'heure d'arrivée souhaitée pour les itinéraires en transports en commun, en secondes depuis minuit le 1er janvier 1970 UTC. Vous pouvez spécifier departure_time ou arrival_time, mais pas les deux. Notez que arrival_time doit être spécifié sous forme d'entier.

• éviter

  Il est possible de calculer des distances qui respectent des restrictions données. Les restrictions sont indiquées par l'utilisation du paramètre "avoid" et d'un argument de ce paramètre indiquant la restriction à éviter. Les restrictions suivantes sont acceptées :

  • tolls indique que l'itinéraire calculé doit éviter les routes et les ponts à péage.
  • highways indique que l'itinéraire calculé doit éviter les autoroutes.
  • ferries indique que l'itinéraire calculé doit éviter les ferries.
  • indoor indique que l'itinéraire calculé doit éviter les escaliers intérieurs pour les itinéraires à pied et en transports en commun.

  Il est possible de demander un itinéraire qui évite toute combinaison de péages, d'autoroutes et de ferries en transmettant les deux restrictions au paramètre "avoid". Exemple : avoid=tolls|highways|ferries.

  Remarque : L'ajout de restrictions n'exclut pas les itinéraires qui incluent la caractéristique restreinte. Il oriente le résultat vers des itinéraires plus favorables.

• departure_time

  Spécifie l'heure de départ souhaitée. Vous pouvez spécifier l'heure sous la forme d'un entier en secondes depuis minuit, le 1er janvier 1970 UTC. Si un departure_time postérieur au 31/12/9999 à 23:59:59.999999999Z est spécifié, l'API rétablit le departure_time au 31/12/9999 à 23:59:59.999999999Z. Vous pouvez également spécifier la valeur "now", qui définit l'heure de départ sur l'heure actuelle (à la seconde près). L'heure de départ peut être spécifiée dans deux cas :

  • Pour les requêtes où le mode de transport est "transit" : vous pouvez éventuellement spécifier departure_time ou arrival_time. Si aucune heure n'est spécifiée, departure_time est défini par défaut sur "now" (c'est-à-dire que l'heure de départ est définie par défaut sur l'heure actuelle).
  • Pour les requêtes où le mode de transport est la conduite : vous pouvez spécifier departure_time pour recevoir un itinéraire et une durée de trajet (champ de réponse : duration_in_traffic) qui tiennent compte des conditions de circulation. departure_time doit être défini sur l'heure actuelle ou sur une heure ultérieure, mais pas sur une heure passée.
  Remarque : Si l'heure de départ n'est pas spécifiée, l'itinéraire et la durée sont déterminés en fonction du réseau routier et des conditions de circulation moyennes toutes heures confondues. Les résultats d'une requête donnée peuvent varier au fil du temps en raison des modifications du réseau routier, de l'évolution des conditions de circulation moyennes et de la nature décentralisée du service. Les résultats peuvent également varier entre plusieurs itinéraires presque équivalents à tout moment et à n'importe quelle fréquence.
  Remarque : Les requêtes Matrice des distances spécifiant departure_time lorsque mode=driving sont limitées à un maximum de 100 éléments par requête. Le nombre d'éléments est défini par le nombre de points de départ multiplié par le nombre de destinations.

• language

  Langue dans laquelle les résultats doivent être renvoyés.

  • Consultez la liste des langues acceptées. Google met souvent à jour les langues acceptées. Cette liste n'est donc pas exhaustive.
  • Si language n'est pas fourni, l'API tente d'utiliser la langue préférée spécifiée dans l'en-tête Accept-Language.
  • L'API s'efforce de fournir une adresse postale lisible à la fois pour l'utilisateur et pour les habitants. Pour atteindre cet objectif, elle renvoie les adresses postales dans la langue locale, translittérées dans un script lisible par l'utilisateur si nécessaire, en respectant la langue préférée. Toutes les autres adresses sont renvoyées dans la langue préférée. Les composants d'adresse sont tous renvoyés dans la même langue, qui est choisie à partir du premier composant.
  • Si aucun nom n'est disponible dans la langue préférée, l'API utilise la correspondance la plus proche.
  • La langue préférée a une légère influence sur l'ensemble des résultats que l'API choisit de renvoyer et sur l'ordre dans lequel ils sont renvoyés. Le geocoder interprète les abréviations différemment selon la langue, par exemple les abréviations des types de rues ou les synonymes qui peuvent être valides dans une langue, mais pas dans une autre. Par exemple, utca et tér sont des synonymes de "rue" en hongrois.

• mode

  Pour calculer les distances et les itinéraires, vous pouvez spécifier le mode de transport à utiliser. Par défaut, le mode DRIVING est utilisé. Par défaut, les itinéraires sont calculés pour les trajets en voiture. Les modes de transport suivants sont acceptés :

  • driving (par défaut) indique un itinéraire en voiture standard ou une distance via le réseau routier.
  • walking demande un itinéraire à pied ou une distance via les voies piétonnes et les trottoirs (dans la mesure du possible).
  • bicycling demande un itinéraire à vélo ou une distance à vélo via les pistes cyclables et les rues à privilégier (dans la mesure du possible).
  • transit demande un itinéraire ou une distance via les réseaux de transports en commun (dans la mesure du possible). Si vous définissez le mode sur "transit", vous pouvez éventuellement spécifier un departure_time ou un arrival_time. Si aucune heure n'est spécifiée, departure_time est défini par défaut sur "now" (c'est-à-dire que l'heure de départ est définie par défaut sur l'heure actuelle). Vous pouvez également inclure un transit_mode et/ou un transit_routing_preference.
  Remarque : Les itinéraires à pied et les itinéraires à vélo peuvent parfois ne pas inclure de voies piétonnes ou de pistes cyclables claires. Dans ce cas, ces itinéraires renvoient des avertissements dans le résultat renvoyé que vous devez afficher pour l'utilisateur.
  Remarque : Les trajets en transports en commun sont disponibles jusqu'à sept jours dans le passé ou jusqu'à 100 jours dans le futur, sous réserve de la disponibilité des informations sur les transports en commun fournies par les fournisseurs de données. Les horaires des transports en commun changent fréquemment, les trajets disponibles peuvent changer au fil du temps et il n'est pas garanti que les prédictions soient cohérentes longtemps à l'avance.

• région

  Code régional, spécifié sous la forme d'une valeur ccTLD (domaine de premier niveau) à deux caractères. La plupart des codes ccTLD sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").

• traffic_model

  Spécifie les hypothèses à utiliser pour calculer le temps de trajet. Ce paramètre influe sur la valeur renvoyée dans le champ "duration_in_traffic" de la réponse, qui contient le temps de trajet prévu en fonction des moyennes historiques. Le paramètre traffic_model ne peut être spécifié que pour les itinéraires en voiture lorsque la requête inclut un departure_time. Les valeurs disponibles pour ce paramètre sont les suivantes :

  • best_guess (par défaut) indique que la valeur duration_in_traffic renvoyée doit correspondre à la meilleure estimation du temps de trajet compte tenu des conditions de circulation historiques et en temps réel. Plus departure_time est proche de l'heure actuelle, plus la circulation en temps réel devient importante.
  • pessimistic indique que la valeur duration_in_traffic renvoyée doit être supérieure à la durée réelle du trajet la plupart du temps. Toutefois, les jours où la circulation est particulièrement difficile, le temps de trajet peut être plus long.
  • optimistic indique que la valeur duration_in_traffic renvoyée doit être inférieure à la durée réelle du trajet la plupart du temps. Toutefois, les jours où la circulation est particulièrement fluide, le temps de trajet peut être plus court.

  La valeur par défaut de best_guess fournit les prédictions les plus utiles pour la grande majorité des cas d'utilisation. Il est possible que la prédiction du temps de trajet best_guess soit plus courte que optimistic ou, à l'inverse, plus longue que pessimistic, en raison de la manière dont le modèle prédictif best_guess intègre les informations sur la circulation en temps réel.

• transit_mode

  Spécifie un ou plusieurs modes de transport à privilégier. Ce paramètre ne peut être spécifié que pour les itinéraires en transports en commun. Le paramètre accepte les arguments suivants :

  • bus indique que l'itinéraire calculé doit privilégier les trajets en bus.
  • subway indique que l'itinéraire calculé doit privilégier les trajets en métro.
  • train indique que l'itinéraire calculé doit privilégier les trajets en train.
  • tram indique que l'itinéraire calculé doit privilégier les trajets en tramway et en métro léger.
  • rail indique que l'itinéraire calculé doit privilégier les trajets en train, en tramway, en métro léger et en métro. Cela équivaut à transit_mode=train|tram|subway.

• transit_routing_preference

  Spécifie les préférences pour les itinéraires en transports en commun. Ce paramètre vous permet d'ajuster les options renvoyées plutôt que d'accepter le meilleur itinéraire choisi par défaut par l'API. Ce paramètre ne peut être spécifié que pour les itinéraires en transports en commun. Il prend en charge les arguments suivants :

  • less_walking indique que l'itinéraire calculé doit limiter le plus possible la marche.
  • fewer_transfers indique que l'itinéraire calculé doit utiliser un nombre limité de correspondances.

• unités

  Spécifie le système d'unités à utiliser lors de l'affichage des résultats.

  Remarque : Ce paramètre de système d'unités n'influe que sur le texte affiché dans les champs de distance. Les champs de distance contiennent également des valeurs qui sont toujours exprimées en mètres.

Exemples de requêtes

Cet exemple utilise des coordonnées de latitude/longitude pour spécifier les coordonnées de destination :

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'

Cet exemple utilise des Plus Codes pour spécifier les coordonnées de destination :

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'

Cet exemple montre la même requête à l'aide d'une polyligne encodée :

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'

Information sur l'état de la circulation

Les informations sur le trafic sont utilisées lorsque toutes les conditions suivantes s'appliquent (à savoir celles requises pour recevoir le champ duration_in_traffic dans la réponse Matrice des distances) :

• Le paramètre de transport mode est driving ou n'est pas spécifié (driving est le mode de transport par défaut).
• La requête inclut un paramètre departure_time valide. departure_time peut être défini sur l'heure actuelle ou sur une heure ultérieure, mais pas sur une heure passée.

Vous pouvez éventuellement inclure le paramètre traffic_model dans votre requête pour spécifier les hypothèses à utiliser pour calculer le temps de trajet selon le trafic.

L'URL suivante lance une requête Matrice des distances pour obtenir les distances en voiture entre Boston, MA ou Charlestown, MA, et Lexington, MA et Concord, MA. La requête inclut une heure de départ, ce qui répond à toutes les exigences pour renvoyer le champ duration_in_traffic dans la réponse matrice des distances.

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
   
  
 

Modificateurs de position

Vous pouvez utiliser des modificateurs d'emplacement pour indiquer comment les conducteurs doivent se diriger vers un lieu donné, en utilisant le modificateur side_of_road pour spécifier le côté de la route à utiliser ou en spécifiant un cap pour indiquer la bonne direction.

Spécifier que les itinéraires calculés doivent passer par un côté particulier de la route

Lorsque vous spécifiez un lieu, vous pouvez demander que l'itinéraire calculé passe par le côté de la route vers lequel le point de cheminement est orienté en utilisant le préfixe side_of_road:. Par exemple, cette requête renvoie la distance pour un long itinéraire afin que le véhicule se retrouve du côté de la route vers lequel le point de cheminement a été orienté :

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'

Lorsque vous utilisez side_of_road: avec des polylignes encodées, le modificateur est appliqué à chaque emplacement le long de la polyligne. Par exemple, les deux destinations de cette requête utilisent toutes deux le paramètre :

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'

Le modificateur side_of_road: ne peut être utilisé qu'avec la restriction suivante :

• Le paramètre de transport mode est driving ou n'est pas spécifié (driving est le mode de transport par défaut).

Spécifier que les itinéraires calculés doivent avoir un cap particulier

Lorsque vous spécifiez un lieu, vous pouvez demander à ce que l'itinéraire calculé passe par ce lieu dans un cap particulier. Ce cap est spécifié avec le préfixe heading=X:, où X est une valeur entière en degrés comprise entre 0 (inclus) et 360 (exclus). Un cap de 0 indique le nord, 90 indique l'est, et ainsi de suite dans le sens des aiguilles d'une montre. Par exemple, dans cette requête, l'itinéraire calculé va vers l'est à partir du point de départ, puis fait demi-tour :

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'

Le modificateur heading=X: ne peut être utilisé qu'avec les restrictions suivantes :

• Le paramètre de transport mode est driving, bicycling ou n'est pas spécifié (driving est le mode de transport par défaut).
• Le modificateur side_of_road n'est pas spécifié pour le même emplacement.
• L'emplacement est spécifié avec une valeur de latitude/longitude. Vous ne pouvez pas utiliser heading avec des adresses, des ID de lieu ou des polylignes encodées.

Requêtes et réponses Distance Matrix

L'exemple de requête HTTP ci-dessous demande la distance et la durée entre Vancouver (Colombie-Britannique, Canada) et Seattle (Washington, États-Unis), d'une part, et San Francisco (Californie, États-Unis) et Victoria (Colombie-Britannique, Canada), d'autre part.

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'

Cette requête renvoie quatre éléments (les quatre trajets possibles avec les deux points de départ et les deux destinations) :

Les résultats sont renvoyés sous forme de lignes, chacune contenant un point de départ associé à chaque destination.

{
  "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

Codes d'état renvoyés par le service.

• OK indique que la réponse contient un résultat valide.
• INVALID_REQUEST indique que la requête fournie n'était pas valide.
• MAX_ELEMENTS_EXCEEDED indique que le produit du nombre de points de départ par le nombre de destinations dépasse la limite par requête.
• MAX_DIMENSIONS_EXCEEDED indique que le nombre de points de départ ou de destinations dépasse la limite par requête.
• OVER_DAILY_LIMIT indique l'un des éléments suivants :
  • La clé API est manquante ou non valide.
  • La facturation n'a pas été activée sur votre compte.
  • La limite d'utilisation que vous avez définie vous-même a été dépassée.
  • Le mode de facturation fourni n'est plus valide (une carte de crédit est arrivée à expiration, par exemple).
• OVER_QUERY_LIMIT indique que le service a reçu trop de requêtes de votre application au cours de la période autorisée.
• REQUEST_DENIED indique que le service a refusé l'utilisation du service Matrice des distances par votre application.
• UNKNOWN_ERROR indique qu'une requête Distance Matrix n'a pas pu être traitée en raison d'une erreur du serveur. Si vous essayez à nouveau, la requête pourrait aboutir.

DistanceMatrixRow

DistanceMatrixElement

Fare

Tarif total de l'itinéraire.

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

DistanceMatrixElementStatus

• OK indique que la réponse contient un résultat valide.
• NOT_FOUND indique que le point de départ et/ou la destination de cet élément n'ont pas pu être géocodés.
• ZERO_RESULTS indique qu'aucun itinéraire n'a été trouvé entre le point de départ et la destination.
• MAX_ROUTE_LENGTH_EXCEEDED indique que l'itinéraire demandé est trop long et ne peut pas être traité.

TextValueObject

Objet contenant une valeur numérique et sa représentation textuelle mise en forme.