Ce guide explique comment migrer des applications qui utilisent : l'API Directions ou Distance Matrix, afin d'utiliser les API Routes. Pour en savoir plus sur l'API Routes, consultez product présentation.
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 |
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 pouvez
transmettre 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 articles suivants :
Convertir des points de cheminement encodés en polyligne en points de cheminement de lieu
La spécification des points de cheminement sous forme de polylignes encodées est disponible dans l'API Directions pour l'adapter à un grand de points de cheminement dans la limite de 16 384 caractères pour l'URL. Cette fonctionnalité n'est pas nécessaire dans l'API Routes, car les points de cheminement peuvent être transmis dans Corps de 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 routes ou Définir un point de cheminement intermédiaire dans le document Spécifier des points de cheminement intermédiaires.
Paramètres de conversion
Les tableaux suivants répertorient les paramètres les API Directions et Distance Matrix dont ont été renommés ou modifiés, ou des paramètres incompatibles avec Google Analytics. de sortie. Mettez à jour votre code si vous utilisez l'un de ces paramètres.
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 |
Impossible d'utiliser en même temps que arrivalTime. |
language |
languageCode |
Compatible uniquement avec les routes Compute. |
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 utilisant le même mode de transport (marche ou transports en commun) est considéré comme une étape, et un itinéraire individuel pour le mode de transport sont des sous-étapes. En revanche, dans l'API Routes, les étapes correspondent toujours à une instruction de navigation pour tous les types de trajets. Chaque instruction de navigation correspond donc à une étape. Pour plusieurs étapes dans un mode de transport, l'API Routes fournit des métadonnées qui contiennent un résumé des étapes pour ce mode de transport, sous `stepsOverview`. Pour demander ces métadonnées, utilisez la méthode Masque de champ "routes.legs.stepsOverview". En savoir plus |
transit_routing_preference |
transitRoutingPreference |
En savoir plus |
units |
Non disponible pour la matrice de routes. | |
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 le paramètre 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 les éléments suivants : lors de la présentation des résultats à vos utilisateurs:
Exemple :
|
|
distance |
distanceMeters |
La distance est uniquement disponible 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 signalées par l'API. Pour en savoir plus, consultez la section Gérer les erreurs de requête. | |
geocoded_waypoints |
geocoding_results |
Compatible uniquement avec les routes Compute. 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 |