Ce guide explique comment migrer les applications qui utilisent l'API Directions ou l'API Distance Matrix vers l'API Routes. Pour en savoir plus sur l'API Routes, consultez la présentation du produit.
Bonnes pratiques de facturation pour la migration
Ces conseils s'appliquent si votre utilisation de l'API est suffisamment élevée pour passer à la tarification de deuxième niveau. Lorsque vous migrez vers une version plus récente d'une API, vous êtes également facturé pour un autre SKU. Pour éviter une augmentation des coûts au cours du mois de votre transition, nous vous recommandons de passer aux nouvelles API en production le plus tôt possible dans le mois. Cela vous permettra d'atteindre les niveaux de prix mensuels les plus rentables au cours du mois de la migration. Pour en savoir plus sur les niveaux de tarification, consultez la page des tarifs et les questions fréquentes sur les tarifs.
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.
À 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 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 le corps d'une requête ou dans des en-têtes dans le cadre d'une requête HTTP POST. Pour obtenir des exemples, consultez les articles suivants :
Convertir les points de cheminement encodés en polyligne en points de cheminement de localisation
La spécification de points de cheminement sous forme de polylignes encodées est disponible dans l'ancienne API Directions pour insérer 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 waypoints peuvent être transmis dans le corps de la requête REST ou gRPC sous forme de coordonnées de latitude/longitude. Pour obtenir des exemples, consultez Exemple HTTP dans le document Calculer une matrice de routes ou Définir un point de cheminement intermédiaire dans le document Spécifier des points de cheminement intermédiaires.
Convertir des paramètres
Le tableau suivant liste les paramètres des API Directions et Distance Matrix qui ont été renommés ou modifiés, ou 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.
Conversions des paramètres de requête
| Paramètre Directions ou Distance Matrix | Paramètre de l'API Routes | Remarques |
|---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Disponible uniquement en mode TRANSIT, et non en même temps que departureTime. |
avoid |
routeModifiers |
|
departure_time |
departureTime |
Cet argument 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'ancienne API Directions, dans un itinéraire en transports en commun, chaque segment d'un trajet avec le même mode de déplacement (par exemple, "À pied" ou "Transports en commun") est considéré comme une étape, et les instructions individuelles pour ce mode de déplacement se trouvent dans les sous-étapes. En revanche, dans l'API Routes, les étapes correspondent toujours à une instruction de navigation, quel que soit le mode de déplacement. Chaque instruction de navigation est une étape. Pour plusieurs étapes dans un même mode de déplacement, l'API Routes fournit des métadonnées contenant un récapitulatif des étapes pour ce mode de déplacement, 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 |
Conversions 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. Contient des informations sur la réponse du géocodage uniquement 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 |
polyline | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |