L'API Routes offre de meilleures performances pour le calcul des itinéraires, de la distance et du 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 de l'API Routes par rapport aux produits qu'elle remplace, et pour découvrir 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 rencontrer 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 calcul des routes 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 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.
- Amélioration des calculs de routage pour le trafic, afin que vous puissiez faire le compromis entre qualité des données et temps de réponse.
Amélioration du calcul d'itinéraire
La fonctionnalité Compute Route 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 des véhicules à deux roues.
- Assurez la sécurité de vos points de cheminement avec des arrêts.
- Meilleure précision de l'heure d'arrivée prévue en définissant la direction du trajet 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 maintenant 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 des champs vous évite de demander des données inutiles, ce qui évite des 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. |
Amélioration du calcul des routes pour le trafic
L'API Routes accepte 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 indépendantes du temps, et non des données de trafic en temps réel pour calculer le routage, ce qui permet de réduire la latence de réponse. Ce paramètre équivaut à lorsque le trafic n'est pas utilisé dans les API Directions et Distance Matrix. |
TRAFFIC_AWARE (nouveauté) |
Qualité du trafic en direct optimisée pour les performances 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 ou l'API Distance Matrix.
|
TRAFFIC_AWARE_OPTIMAL |
Des données complètes de haute qualité sur le trafic Ce paramètre produit la latence la plus élevée et équivaut au paramètre departure_time des API Directions et Distance Matrix. Cette préférence correspond 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 d'itinéraire entre les services de l'API Routes, de l'API Directions et de 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 à celle de La latence est beaucoup plus faible que |
| Données de trafic en temps réel complètes et de haute qualité appliquées | TRAFFIC_AWARE_OPTIMAL |
Propriété departure_time définie |
Équivaut 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 de points de départ × nombre de destinations) ne peut pas dépasser 100. |
Différences majeures
Cette section décrit les principales différences entre l'API Routes et les services qu'elle remplace, et vous explique comment corriger ces différences lorsque vous effectuez une migration à partir de ces services dans vos applications existantes.
Appeler un service au lieu de deux
| API Routes | Activez 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 vos projets 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 des en-têtes avec une requête HTTP POST. Pour obtenir des exemples, consultez les pages suivantes: - Calculer une route - Calculer une matrice de routage |
| API Directions API Distance Matrix |
Transmettre des paramètres d'URL à l'aide d'une requête HTTP GET |
Différences de réponse d'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 des API Directions et 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 prise en compte du trafic et indépendante de l'heure. | Défini à l'aide de
|
Correspond à
|
| Heure d'arrivée prévue qui tient compte du trafic en temps réel. | Défini à l'aide de
|
Défini à l'aide de
|
Points de cheminement de 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 concerné par les limites des 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 type polyligne.
Adresses formatées (geocoding 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, conçue pour ce cas d'utilisation et qui 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 en tant qu'alternatives possibles 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 vous servez de cette fonctionnalité afin que nous puissions vous recontacter.
Format de réponse XML
L'API Routes ne fournit pas de format de réponse XML. Un certain nombre de convertisseurs JSON en XML sont disponibles en ligne pour répondre à vos besoins.