Ce guide explique comment migrer des applications utilisant 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
Depuis l'API Directions
| API Directions | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
| API Routes | https://routes.googleapis.com/directions/v2:computeRoutes |
Source : Distance Matrix API
| API Distance Matrix | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
| API Routes | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
Convertir des 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 une requête HTTP POST. Voici quelques exemples:
Convertir des points de cheminement représentés en tant que polylignes encodées en points de cheminement intermédiaires
La spécification de points de cheminement en tant que polylignes encodées est disponible dans l'API Directions pour que de nombreux points de cheminement soient autorisés dans la limite d'URL (8 192). Cette fonctionnalité n'est pas nécessaire dans l'API Routes, car les points de cheminement peuvent être transmis dans le corps des requêtes REST ou gRPC en tant que points de cheminement intermédiaires.
Convertir les paramètres existants en paramètres de l'API Routes
Le tableau suivant répertorie les paramètres de l'API Directions et de l'API 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.
| Paramètre de matrice Routes ou Distance | Paramètre de l'API Routes | Remarques |
|---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
Non disponible, car le mode TRANSIT n'est pas disponible. |
|
avoid |
routeModifiers |
|
copyrights |
Non inclus dans la réponse. Vous devez inclure l'instruction suivante lorsque vous affichez les résultats pour vos utilisateurs:
Exemple :
|
|
departure_time |
departureTime |
|
distance |
distanceMeters |
La distance n'est disponible qu'en mètres. |
duration_in_traffic |
|
Suppression de duration dans l'API Routes. Pour en savoir plus, consultez Changements de fonctionnalité pour la nouvelle API Routes ci-dessus. |
language |
languageCode |
Compatible uniquement avec les routes Compute. |
mode |
travelMode |
Ajout de la prise en charge de Mode |
region |
regionCode |
|
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. | |
traffic_model |
Non disponible. | |
transit_mode |
Non disponible, car le mode TRANSIT n'est pas disponible. |
|
transit_routing_preference |
Non disponible, car le mode TRANSIT n'est pas disponible. |
|
units |
Non disponible pour la matrice de routage. | |
waypoints |
intermediates |
Suppression de la compatibilité avec les polylignes encodées. |
optimize=true pour les points de cheminement |
Non disponible. |