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, et 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 présente certaines des améliorations que vous pouvez attendre lorsque vous utilisez l'API Routes dans vos applications.
Limites de requêtes plus élevées
| API Routes Compute Route Matrix |
|
| API Distance Matrix |
|
Réponses plus rapides aux demandes
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. Cette bonne pratique permet également de réduire vos coûts.
- Calculs d'itinéraires améliorés pour le trafic, afin que vous puissiez trouver le bon 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 suivantes :
- Informations sur les péages en plus de la distance et de l'heure d'arrivée prévue.
- Itinéraires pour les deux-roues
- Qualifiez vos points de cheminement intermédiaires pour la sécurité.
- Amélioration de la précision 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 les temps de traitement et les 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. |
Calcul amélioré des itinéraires 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 se traduit par une latence de réponse minimale. Ce paramètre équivaut à l'absence d'utilisation du trafic dans les API Directions et API 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. Il n'a pas d'équivalent dans l'API Directions ni dans l'API Distance Matrix.
|
TRAFFIC_AWARE_OPTIMAL |
Des données de trafic exhaustives et de haute qualité. Ce paramètre produit la latence la plus élevée et équivaut au paramètre departure_time dans l'API Directions et l'API Distance Matrix. Cette préférence équivaut 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 les services API Routes, 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 rapide 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 exhaustives 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 × nombre de destinations) ne peut pas dépasser 100. |
Différences majeures
Cette section présente les principales différences entre l'API Routes et les services qu'elle remplace, ainsi que les moyens de résoudre ces différences lors de la migration depuis ces services dans vos applications existantes.
Appeler un service au lieu de deux
| API Routes | N'activez qu'un seul service dans la console d'API pour que votre application utilise Compute Routes et Compute Route Matrix.
Pour en savoir plus, consultez Configurer dans la console Google APIs. |
| API Directions API Distance Matrix |
Activez deux services : l'API Directions et l'API 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 d'une requête HTTP POST. Pour obtenir des exemples, consultez : - Calculer un itinéraire - Calculer une matrice d'itinéraires |
| API Directions API Distance Matrix |
Transmettez les paramètres d'URL à l'aide d'une requête HTTP GET. |
Différences de réponse pour l'heure d'arrivée prévue
L'API Routes renvoie l'heure d'arrivée prévue et utilise la propriété de réponse duration différemment des services de l'API Directions et de l'API Distance Matrix, comme indiqué dans le tableau ci-dessous.
| Type d'ETA | API Routes | API Directions API Distance Matrix |
|---|---|---|
| Heure d'arrivée prévue indépendante du trafic et du temps. | Définissez cette option à l'aide de
|
Correspond à
|
| une heure d'arrivée prévue qui tient compte du trafic en temps réel. | Définissez-le sur
|
Définissez-le à l'aide de
|
Points de cheminement de polyligne
Vous n'avez plus besoin de convertir vos coordonnées de latitude/longitude en points de cheminement de polyligne avec ce service, qui accepte un corps de requête POST et n'est donc plus affecté par les limites de chaîne d'URL. Certains utilisateurs de l'API Distance Matrix ont résolu le problème de limites de requêtes en convertissant les points de latitude/longitude en points de cheminement de polyligne.
Adresses formatées (géocodage inversé)
L'API Routes ne fournit pas d'adresses formatées dans la réponse. Pour obtenir des adresses formatées, 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 réponse au format XML. Vous trouverez en ligne un certain nombre de convertisseurs JSON vers XML qui devraient répondre à vos besoins.