L'API Routes offre de meilleures performances de calcul d'itinéraires, de distances et de temps de trajet. Il est donc intéressant de remplacer les applications qui utilisent actuellement 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 découvrir comment gérer les modifications nécessaires. Pour en savoir plus sur d'autres fonctionnalités de l'API Routes, consultez la présentation du produit.
Principales améliorations
Cette section présente 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 |
|
| API Distance Matrix |
|
Réponses aux requêtes plus rapides
La fonctionnalité de matrice de routage de calcul offre les améliorations de latence suivantes:
- Recevez les éléments de diffusion en flux continu de la réponse avant que la matrice entière ne soit calculée.
- Utilisez des masques de champ pour personnaliser les détails de la réponse et ne demandez que les données dont vous avez besoin. Cette bonne pratique vous aide également à réduire vos coûts.
- Des calculs de routage améliorés pour le trafic, afin que vous puissiez trouver un compromis entre la qualité des données et le temps de réponse.
Améliorations du routage
La fonctionnalité Compute Route 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 de deux-roues.
- Assurez la sécurité de vos points de cheminement avec arrêt.
- Meilleure précision de l'heure d'arrivée prévue en définissant la direction et le côté de la route pour les points de cheminement.
Demander uniquement les données dont vous avez besoin
Spécifiez maintenant les champs à renvoyer, ce qui réduit le temps de traitement et les frais facturés.
| API Routes | Vos requêtes doivent utiliser un masque de champ pour spécifier les champs à renvoyer dans la réponse. Le masquage de champ vous permet de ne pas demander de données inutiles, ce qui évite des délais 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 des délais de traitement et des frais de facturation inutiles. |
Amélioration du calcul des routes pour le trafic
L'API Routes est compatible avec trois préférences de routage que vous pouvez utiliser pour équilibrer la latence de réponse et la qualité des données lorsque vous demandez des informations sur le trafic.
Pour en savoir plus, consultez la section Configurer la qualité ou 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 la route, ce qui se traduit par une latence de réponse la plus faible possible. Ce paramètre est équivalent lorsque le trafic n'est pas utilisé dans les API Directions et Distance Matrix. |
TRAFFIC_AWARE (nouveau) |
Qualité du trafic en temps réel optimisée pour une latence réduite 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, sans équivalent dans l'API Directions ni dans l'API Distance Matrix.
|
TRAFFIC_AWARE_OPTIMAL |
Données de trafic complètes et de haute qualité. Ce paramètre produit la latence la plus élevée et est équivalent au paramètre departure_time de l'API Directions et de l'API Distance Matrix. Cette préférence équivaut au mode utilisé par maps.google.com et par l'application mobile Google Maps. |
Comparaison des calculs de routes
Le tableau suivant compare les options de routage entre l'API Routes, l'API Directions et l'API Distance Matrix.
| Option de trafic | API Routes | API Directions API Distance Matrix |
Latence |
|---|---|---|---|
| Pas de trafic en temps réel | TRAFFIC_UNAWARE |
Propriété departure_time 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 à Sa latence est beaucoup plus faible que |
| Application de données de trafic en temps réel complètes et de haute qualité | 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, et explique comment les corriger lors de la migration depuis ces services dans vos applications existantes.
Appeler un seul service au lieu de deux
| API Routes | Activez un seul service dans la console API pour que votre application utilise Compute Routes et Compute Route Matrix.
Pour en savoir plus, consultez Configurer votre projet 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 API. |
Utilise des requêtes HTTPS POST
| API Routes | Transmettez des 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 les sections suivantes: - Calculer une route - Calculer une matrice de route |
| API Directions API Distance Matrix |
Transmettez des paramètres d'URL à l'aide d'une requête HTTP GET. |
Différences entre les réponses de 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'heure d'arrivée prévue | API Routes | API Directions API Distance Matrix |
|---|---|---|
| Heure d'arrivée prévue non basée sur le trafic et indépendante de l'heure. | Défini à l'aide de
|
Correspond au fait que
|
| Heure d'arrivée prévue qui tient compte du trafic en temps réel. | Définissez-le à l'aide de
|
Défini à l'aide de
|
Points de cheminement des polylignes
Vous n'avez plus besoin de convertir vos coordonnées de latitude/longitude en points de cheminement en polyligne avec ce service, qui accepte un corps de requête POST et n'est donc plus affecté par les limites des chaînes d'URL. Certains utilisateurs de l'API Distance Matrix ont résolu le problème de limites des requêtes en convertissant les points de latitude/longitude en points de cheminement de polyligne.
Adresses formatées (géocode inverse)
L'API Routes ne fournit pas d'adresses formatées dans la réponse. Pour obtenir des adresses formatées, utilisez l'API Geocoding conçue pour ce cas d'utilisation et fournit des résultats de meilleure qualité.
Modes de transport disponibles
Comme c'est le cas avec l'API Directions, celle-ci 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 alternatives pour la requête. Si votre cas d'utilisation repose sur cette fonctionnalité, signalez un problème en décrivant la façon dont vous l'utilisez. Nous pourrons ainsi vous aider.
XML comme format de réponse
L'API Routes ne fournit pas de format de réponse XML. Vous trouverez en ligne un certain nombre de convertisseurs JSON en XML qui devraient vous convenir.