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
Mettre à jour votre code pour utiliser les nouveaux points de terminaison de l'API Routes
À partir de 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 des 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 polyligne en points de cheminement de position
L'option permettant de spécifier des points de cheminement en tant que polylignes encodées est disponible dans l'API Directions pour adapter un grand nombre de points de cheminement à 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 du document Calculer une matrice d'itinéraires 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 de l'API Directions et de l'API Distance Matrix qui ont été renommés ou modifiés, ou les paramètres non compatibles avec la version GA. Si vous utilisez l'un de ces paramètres, mettez à jour votre code.
Demander des 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 pas 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 |
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 avec le 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 une seule instruction de navigation pour tous les types de trajets. Ainsi, chaque instruction de navigation est une étape. Pour plusieurs étapes d'un mode de transport, l'API Routes fournit des métadonnées contenant un résumé des étapes de 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 |
units |
En savoir plus |
waypoints |
intermediates |
Suppression de la compatibilité avec les polylignes encodées. |
optimize=true pour les points de cheminement |
"optimizeWaypointOrder": "true" |
En savoir plus |
Conversion des 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 la déclaration suivante lorsque vous affichez les résultats à vos utilisateurs :
Exemple :
|
|
distance |
distanceMeters |
La distance n'est disponible qu'en mètres. |
duration_in_traffic |
duration |
Supprimé dans 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 les 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 |