L'API Routes offre de meilleures performances pour calculer les itinéraires, la distance et le temps de trajet. Il est donc intéressant de remplacer les applications qui utilisent les API Directions et Distance Matrix. La plupart des fonctionnalités de l'API Routes sont rétrocompatibles avec les API Directions et Distance Matrix.
Utilisez ce guide pour comprendre les principales différences entre l'API Routes et les produits qu'elle remplace, ainsi que pour savoir comment gérer les modifications nécessaires. Pour en savoir plus sur les autres fonctionnalités de l'API Routes, consultez la présentation du produit.
Principales améliorations
Cette section décrit certaines des améliorations auxquelles vous pouvez vous attendre lorsque vous utilisez l'API Routes dans vos applications.
Augmentation des limites de requêtes
| API Routes Compute Route Matrix |
|
| API Distance Matrix |
|
Temps de réponse plus rapides
La fonctionnalité Compute Route Matrix offre les améliorations de latence suivantes :
- Recevez les éléments de flux de la réponse avant que la matrice entière n'ait été calculée.
- Utilisez des masques de champ pour personnaliser les détails de la réponse en ne demandant que les données dont vous avez besoin. Il s'agit d'une bonne pratique qui permet également de réduire vos coûts.
- Calculs d'itinéraire améliorés pour le trafic, afin que vous puissiez faire le compromis entre la qualité des données et le temps de réponse.
Améliorations du routage
La fonctionnalité de calcul d'itinéraire offre les améliorations de routage suivantes :
- Informations sur les péages, en plus de la distance et de l'heure d'arrivée prévue
- Itinéraires pour deux-roues
- Qualifiez vos points de cheminement d'escale pour la sécurité.
- Précision accrue de l'heure d'arrivée prévue en définissant le sens de circulation et le côté de la route pour les points de cheminement.
Ne demandez que les données dont vous avez besoin.
Vous pouvez désormais spécifier les champs à renvoyer, ce qui réduit le temps de traitement et les frais de facturation.
| API Routes Compute Routes Compute Route Matrix |
Vos requêtes doivent utiliser un masque de champ pour spécifier les champs que vous souhaitez voir renvoyés dans la réponse. Le masquage de champ vous permet de ne pas demander de données inutiles, ce qui évite un temps de traitement et des frais de facturation inutiles.
Pour en savoir plus, consultez Choisir les champs à renvoyer. |
| API Directions API Distance Matrix |
Renvoie une liste de champs par défaut, même si votre application n'en a pas strictement besoin. Cela peut entraîner un temps de traitement et des frais de facturation inutiles. |
Calculs d'itinéraire améliorés pour le trafic
L'API Routes est compatible avec trois préférences de routage que vous pouvez utiliser pour trouver un équilibre entre la latence de réponse et la qualité des données lorsque vous demandez des informations sur le trafic.
Pour en savoir plus, consultez Configurer la qualité par rapport à la latence.
TRAFFIC_UNAWARE (par défaut) |
Utilise des données de trafic moyennes indépendantes du temps, et non des données de trafic en temps réel, pour calculer l'itinéraire, ce qui entraîne la latence de réponse la plus faible. Ce paramètre est équivalent à celui qui est utilisé lorsque le trafic n'est pas utilisé dans les API Directions et Distance Matrix. |
TRAFFIC_AWARE (nouveau) |
Qualité du trafic en direct optimisée pour les performances afin de réduire la latence. Contrairement à TRAFFIC_AWARE_OPTIMAL, ce paramètre applique des optimisations pour réduire considérablement la latence.
Ce paramètre est également nouveau pour l'API Routes et n'a pas d'équivalent dans l'API Directions ni dans l'API Distance Matrix.
|
TRAFFIC_AWARE_OPTIMAL |
Des données de trafic complètes et de haute qualité. Ce paramètre génère la latence la plus élevée et équivaut au paramètre departure_time dans les API Directions et Distance Matrix. Cette préférence est équivalente au mode utilisé par maps.google.com et par l'application mobile Google Maps. |
Comparaison du calcul des itinéraires
Le tableau suivant compare les options de routage entre l'API Routes et les services API Directions et API Distance Matrix.
| Option de trafic | API Routes | API Directions API Distance Matrix |
Latence |
|---|---|---|---|
| Aucun trafic en temps réel | TRAFFIC_UNAWARE |
departure_time propriété non définie |
Latence la plus faible des trois modes. |
| Conditions de circulation en temps réel appliquées | TRAFFIC_AWARE |
Aucun équivalent | Nouveau mode ajouté par l'API Routes. Elle offre une latence légèrement supérieure à celle de Sa latence est beaucoup plus faible que celle de |
| Données de trafic en temps réel complètes et de haute qualité appliquées | TRAFFIC_AWARE_OPTIMAL |
Ensemble de propriétés departure_time |
Équivalent au mode utilisé par maps.google.com et par l'application mobile Google Maps. Pour Compute Route Matrix, le nombre d'éléments dans une requête (nombre d'origines x nombre de destinations) ne peut pas dépasser 100. |
Principales différences
Cette section présente les principales différences entre l'API Routes et les services qu'elle remplace. Elle explique également comment les gérer lorsque vous migrez depuis ces services dans vos applications existantes.
Appeler un seul service au lieu de deux
| API Routes | N'activez qu'un seul service dans la console API pour que votre application puisse utiliser Compute Routes et Compute Route Matrix.
Pour en savoir plus, consultez Configurer dans la console API Google. |
| API Directions API Distance Matrix |
Activez les API Directions et Distance Matrix en tant que services distincts dans la console d'API. |
Utilise les requêtes HTTPS POST
| API Routes | Transmettez les paramètres dans le corps de la requête ou dans les en-têtes dans le cadre d'une requête HTTP POST. Pour obtenir des exemples, consultez : - Calculer un itinéraire - Calculer une matrice de routes |
| API Directions API Distance Matrix |
Transmettez les paramètres d'URL à l'aide d'une requête HTTP GET. |
Différences de réponse concernant l'ETA
L'API Routes renvoie l'heure d'arrivée estimée et utilise la propriété de réponse duration différemment des services API Directions et API Distance Matrix, comme indiqué dans le tableau ci-dessous.
| Type d'heure d'arrivée prévue | API Routes | API Directions API Distance Matrix |
|---|---|---|
| Heure d'arrivée prévue indépendante du temps et du trafic. | Définissez-le à l'aide de
|
Correspond à
|
| Heure d'arrivée prévue qui tient compte du trafic en temps réel. | Définissez-le à l'aide de
|
Définissez-le à l'aide de
|
Points de cheminement de polyligne
Avec ce service, vous n'avez plus besoin de convertir vos coordonnées de latitude/longitude en waypoints de polyligne. Il est compatible avec un corps de requête POST et n'est donc plus affecté par les limites de chaînes d'URL. Certains utilisateurs de l'API Distance Matrix ont résolu le problème des limites de requêtes en convertissant les points de latitude/longitude en points de cheminement de polylignes.
Adresses formatées (géocodage inversé)
L'API Routes ne fournit pas d'adresses mises en forme dans la réponse. Pour obtenir des adresses mises en forme, utilisez l'API Geocoding, qui est conçue pour ce cas d'utilisation et fournit des résultats de meilleure qualité.
Modes de transport disponibles
Comme l'API Directions, l'API Routes utilise DRIVE comme mode par défaut lorsqu'une requête d'itinéraire ne spécifie pas de mode de transport. Toutefois, lorsqu'une requête spécifie un mode de transport pour un itinéraire, l'API Routes ne renvoie pas de tableau des modes de transport disponibles comme choix alternatifs pour la requête. Si votre cas d'utilisation repose sur cette fonctionnalité, signalez un problème en décrivant comment vous l'utilisez afin que nous puissions vous recontacter.
XML comme format de réponse
L'API Routes ne fournit pas de format de réponse XML. Vous trouverez en ligne de nombreux convertisseurs JSON vers XML qui devraient répondre à vos besoins.