Migrer depuis l'API Directions ou l'API Distance Matrix

Ce guide explique comment migrer des applications qui utilisent l'API Directions ou Distance Matrix vers l'API Routes. Pour en savoir plus sur l'API Routes, consultez la présentation du produit.

Mettre à jour les points de terminaison de l'API REST

Mettez à jour votre code pour utiliser les nouveaux points de terminaison de l'API Routes.

Depuis l'API Directions

API Directions https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
API Routes https://routes.googleapis.com/directions/v2:computeRoutes

Depuis l'API Distance Matrix

API Distance Matrix https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
API Routes https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

Convertir les paramètres d'URL pour utiliser un corps de requête HTTPS

Avec les API Directions et Distance Matrix, vous transmettez les propriétés de configuration en tant que paramètres d'URL à une requête HTTP GET. Par exemple, pour l'API Directions:

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

Avec l'API Routes, vous transmettez des paramètres dans un corps de requête ou dans des en-têtes dans le cadre d'une requête HTTP POST. Pour obtenir des exemples, consultez les pages suivantes:

Convertir des points de cheminement encodés en polylignes en points de cheminement de position

L'API Directions permet de spécifier des points de cheminement en tant que polylignes encodées. Cela permet de les adapter à un grand nombre de points de cheminement, dans la limite de 16 384 caractères de l'URL. Cette fonctionnalité n'est pas nécessaire dans l'API Routes, car les points de cheminement peuvent être transmis dans le corps de la requête REST ou gRPC en tant que coordonnées de latitude/longitude. Pour obtenir des exemples, consultez l'exemple HTTP dans le document Calculer une matrice de routage ou Définir un point de cheminement intermédiaire dans le document Spécifier des points de cheminement intermédiaires.

Convertir les paramètres

Les tableaux suivants répertorient les paramètres des API Directions et Distance Matrix qui ont été renommés ou modifiés, ou ceux qui ne sont pas compatibles avec la version en disponibilité générale. Mettez à jour votre code si vous utilisez l'un de ces paramètres.

Demander les conversions de paramètres

Paramètre Directions ou Distance Matrix Paramètre de l'API Routes Remarques
alternatives computeAlternativeRoutes
arrival_time arrivalTime Disponible en mode TRANSIT uniquement et non en même temps que departureTime.
avoid routeModifiers
departure_time departureTime Ne peut pas être utilisé en même temps que arrivalTime.
language languageCode Compatible uniquement avec Compute Routes.
mode travelMode

Ajout de la prise en charge de TWO_WHEELER et TRANSIT.

region regionCode
traffic_model trafficModel En savoir plus
transit_mode "travelMode": "TRANSIT" Dans l'API Directions, dans un itinéraire en transports en commun, chaque segment d'un trajet associé au même mode de transport (à pied ou en transports en commun, par exemple) est considéré comme une étape, et les itinéraires individuels pour ce mode de transport sont des sous-étapes. En revanche, dans l'API Routes, les étapes constituent systématiquement une instruction de navigation pour tous les types de trajets. Ainsi, chaque instruction de navigation est une étape. Pour plusieurs étapes dans un mode de transport, l'API Routes fournit des métadonnées contenant un résumé des étapes pour ce mode de transport, dans "stepsOverview". Pour demander ces métadonnées, utilisez le masque de champ "routes.legs.stepsOverview". En savoir plus
transit_routing_preference transitRoutingPreference En savoir plus
units Non disponible pour la matrice des itinéraires.
waypoints intermediates Suppression de la compatibilité avec les polylignes encodées.
optimize=true pour les points de cheminement "optimizeWaypointOrder": "true" En savoir plus

Conversions avec les paramètres de réponse

Paramètre Directions ou Distance Matrix Paramètre de l'API Routes Remarques
copyrights

Non inclus dans la réponse. Vous devez inclure l'instruction suivante lorsque vous présentez les résultats à vos utilisateurs:

Powered by Google, ©YEAR Google

Exemple :

Powered by Google, ©2022 Google

distance distanceMeters La distance n'est disponible qu'en mètres.
duration_in_traffic duration Supprimé de l'API Routes, utilisez duration.
status Non disponible. Utilisez les codes de réponse HTTP pour les erreurs signalées par l'API. Pour en savoir plus, consultez Gérer les erreurs de requête.
geocoded_waypoints geocoding_results Compatible uniquement avec Compute Routes. Ne contient des informations de réponse de geocoding que pour les points de cheminement spécifiés en tant qu'adresses.
bounds viewport
legs.end_address Non disponible.
legs.start_address Non disponible.
overview_polyline polyligne
summary description
waypoint_order optimizedIntermediateWaypointIndex