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 actuellement l'API Directions et l'API Distance Matrix. La plupart des fonctionnalités de l'API Routes sont rétrocompatibles avec l'API Directions et l'API 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 présente certaines des améliorations que vous pouvez 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é Compute Route Matrix offre les améliorations de latence suivantes:
- Recevez les éléments de la réponse en streaming 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 vous permet également de réduire vos coûts.
- Calculs d'itinéraires améliorés pour le trafic, afin de pouvoir faire un compromis entre la qualité des données et le temps de réponse.
Améliorations du routage
La fonctionnalité de routage Compute 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 passage pour des raisons de 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 spécifiez désormais les champs à renvoyer, ce qui réduit le temps de traitement et les frais de facturation.
| API Routes | Vos requêtes doivent utiliser un masque de champ pour spécifier les champs que vous souhaitez renvoyer dans la réponse. Le masquage de champ vous permet de ne pas demander de données inutiles, ce qui évite de perdre du temps et de payer des frais de facturation inutiles.
Pour en savoir plus, consultez la section Choisir les champs à renvoyer. |
| API Directions API Distance Matrix |
Renvoie une liste par défaut de champs, 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éraires améliorés pour le trafic
L'API Routes prend en charge 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é 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 permet d'obtenir la latence de réponse la plus faible. Ce paramètre est équivalent à celui 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, qui 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 est équivalent au paramètre departure_time dans l'API Directions et l'API 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 calcul d'itinéraires 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 |
Propriété departure_time non définie |
La 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. Il offre une latence légèrement supérieure à celle de Sa latence est beaucoup plus faible que celle de |
| 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 x nombre de destinations) ne doit 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 les gérer lors de la migration de 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 la section Configurer dans la console API Google. |
| 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 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 pages suivantes: - Calculer un itinéraire - Calculer une matrice de calcul d'itinéraires |
| API Directions API Distance Matrix |
Transmettez les paramètres d'URL à l'aide d'une requête HTTP GET. |
Différences entre les réponses de délai estimé d'arrivée
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 indépendante du trafic. | Défini à l'aide de
|
Correspond à l'absence de définition de
|
| Heure d'arrivée prévue tenant compte du trafic en temps réel. | Définissez-le à l'aide de
|
Définissez à 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 repères de polyligne. Il 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 limite de requêtes en convertissant les points de latitude/longitude en points de cheminement de polyligne.
Adresses formatées (geocoding inversé)
L'API Routes ne fournit pas d'adresses formatées 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 pour 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 options de remplacement 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.
Format 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 vers XML qui devraient répondre à vos besoins.