Pourquoi utiliser l'API Routes ?
Avec l'API Routes, vous pouvez obtenir des itinéraires et des informations précis à l'aide des informations sur les transports, des conditions de circulation et des conditions de circulation à jour, ainsi que des préférences d'itinéraire:
Type et caractéristiques des différents modes de transport
Dans quelle direction va un véhicule
Côté de la route utilisé pour la prise en charge ou le dépôt
Conditions de circulation et routes fermées
les problèmes de sécurité, tels que le fait d'éviter les zones dangereuses ou de fournir des zones de prise en charge sûres ;
Équilibrez la latence, la qualité et le coût pour vos différents itinéraires avec des fonctionnalités facultatives telles que les péages et les métadonnées de trajet comme la durée et la distance, ainsi que l'efficacité énergétique.
Vous pouvez également déterminer les itinéraires les plus efficaces pour planifier la distribution, par exemple:
Comment affecter au mieux un ensemble de nœuds de calcul pour récupérer une série de packages ?
Déterminer le meilleur entrepôt depuis lequel expédier les colis jusqu'à leur destination finale
Que pouvez-vous faire avec l'API Routes ?
Avec l'API Routes, vous pouvez obtenir deux catégories principales d'informations de routage:
Itinéraires depuis un lieu vers une ou plusieurs destinations
Matrice des itinéraires possibles entre de nombreux points de départ et d'arrivée.
Obtenir des itinéraires pour une ou plusieurs destinations
Avec la méthode Compute Routes
de l'API Routes, vous pouvez effectuer des calculs entre des lieux:
Obtenez des itinéraires pour différents modes de transport, pour une ou plusieurs destinations:
Moyens de transport, y compris les transports en commun, la voiture, les deux-roues, la marche ou le vélo.
Une série de points de cheminement que vous pouvez optimiser dans l'ordre le plus efficace pour les parcourir.
Plusieurs façons de spécifier des points de départ, des destinations et des points de cheminement:
Chaînes de texte. Exemples: "Chicago, Illinois", "Darwin, Territoire du Nord, Australie", "1800 Amphitheatre Parkway, Mountain View, CA 94043" ou "CWF6+FWX Mountain View, Californie"
ID de lieu
Coordonnées de latitude et longitude, éventuellement avec l'orientation du véhicule
Optimisez vos options d'itinéraire en fonction de vos besoins et de vos objectifs:
Sélectionnez des itinéraires économes en carburant ou en énergie en fonction du type de moteur de votre véhicule : diesel, électrique, hybride, gaz. Pour en savoir plus, consultez la section Itinéraire économe en carburant.
Définissez des options ultraprécises pour le calcul du trafic, afin de prendre des décisions en termes de qualité et de latence. Pour en savoir plus, consultez la section Indiquer si les données de trafic doivent être incluses et comment.
Définissez l'orientation du véhicule (direction du trajet) et les informations sur le côté de la route pour les points de cheminement afin d'améliorer la précision de l'heure d'arrivée prévue. Pour en savoir plus, consultez Indiquer l'orientation du véhicule et le côté de la route.
Spécifiez les emplacements des passthrough et ceux des terminaux, ainsi que des emplacements d'arrêts sûrs. Pour en savoir plus, consultez les sections Définir un arrêt sur un itinéraire et Définir un point pour un itinéraire.
Demandez des informations sur le péage, ainsi que la distance de l'itinéraire et l'heure d'arrivée prévue. Pour en savoir plus, consultez la section Calculer les frais de péage pour un itinéraire.
Contrôlez la latence et la qualité en ne demandant que les données dont vous avez besoin à l'aide d'un masque de champ. Cela vous permet d'éviter des temps de traitement inutiles et des taux de facturation des requêtes plus élevés. Pour en savoir plus, consultez Choisir les informations à renvoyer.
Obtenir une matrice des itinéraires possibles
La méthode Compute Route Matrix
de l'API Routes fournit une matrice d'informations pour les itinéraires recommandés entre plusieurs points de départ et d'arrivée, y compris la distance et les heures d'arrivée estimées. Elle vous aide à choisir les meilleurs points de départ et destinations en fonction des besoins de votre entreprise. Vous pouvez demander les types de données de distance suivants:
Distance pour le mode de transport sélectionné
Distance en kilomètres ou miles
Durée estimée du trajet en cas de circulation dense
Grâce aux données de distance, vous pouvez déterminer le moyen le plus efficace d'acheminer les passagers, les expéditions ou les travailleurs entre plusieurs points de départ et destinations possibles.
Vous pouvez diffuser les éléments de la réponse avant le calcul de la matrice entière, ce qui réduit la latence de réponse.
Vous pouvez spécifier plusieurs points de départ et destinations par requête côté serveur, en multipliant le nombre de points de départ par le nombre de destinations (625 au maximum).
Fonctionnement de l'API Routes
L'API Routes propose deux méthodes: ComputeRoute
et ComputeRouteMatrix
.
ComputeRoute
La méthode ComputeRoute
de l'API Routes accepte une requête HTTP POST avec un corps de requête JSON contenant les détails de la requête. Les champs de départ, de destination, de mode de transport et de champ sont obligatoires pour spécifier les champs à afficher.
Exemple
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Le service calcule ensuite l'itinéraire demandé et renvoie les champs demandés.
ComputeRouteMatrix
L'API Routes ComputeRouteMatrix
accepte une requête HTTP POST avec un corps de requête JSON contenant les détails de la requête. Les champs obligatoires incluent au moins un point de départ, deux destinations ou plus, le mode de transport et un masque de champ pour spécifier les champs à renvoyer.
Exemple
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
La réponse contient les itinéraires possibles pour la combinaison de tous les points de cheminement de départ et de destination.
Ressources
Le tableau suivant récapitule les ressources disponibles via l'API Routes ainsi que les données qu'elle renvoie.
Ressources de données | Données renvoyées | Format renvoyé |
---|---|---|
ComputeRoute | Renvoie les itinéraires, les sections et les étapes d'un itinéraire, avec des itinéraires alternatifs, si nécessaire. | JSON |
ComputeRouteMatrix | Renvoie un tableau d'itinéraires entre un point de cheminement de départ et un point de cheminement de destination. |
Utiliser l'API Routes
1 | Configuration | Commencez par Configurer votre projet Google Cloud, puis suivez les instructions de configuration. |
2 | Calculer une route et examiner la réponse | Pour en savoir plus, consultez Obtenir un routage et Examiner les réponses de routage. |
3 | Calculer la matrice de routes et examiner la réponse | Pour en savoir plus, consultez les sections Obtenir une matrice de routage et Examiner la réponse de la matrice de routage. |
Bibliothèques clientes disponibles
Pour obtenir la liste des bibliothèques clientes disponibles pour l'API Routes, consultez la page Bibliothèques clientes.