Pourquoi utiliser l'API Routes ?
Avec l'API Routes, vous pouvez obtenir des itinéraires et des informations de trajet précis à l'aide de détails sur les transports, de l'état actuel du trafic et de la route, et de préférences d'itinéraire:
Type et caractéristiques des différents modes de transport
Direction prise par un véhicule
Côté de la route pour les prises en charge ou les déposes
Conditions de circulation et routes fermées
Problèmes de sécurité, comme éviter les zones dangereuses ou fournir des zones de prise en charge sécurisées
Équilibrez la latence, la qualité et les coûts en fonction de vos besoins en calcul d'itinéraires grâce à des fonctionnalités facultatives telles que les péages et les métadonnées de trajet (durée, distance et efficacité énergétique, par exemple).
Vous pouvez également déterminer les itinéraires les plus efficaces pour la planification des affectations, par exemple:
Meilleure façon d'attribuer un ensemble de travailleurs pour récupérer une série de colis
Déterminer l'entrepôt le plus approprié pour expédier les colis à 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 calcul d'itinéraires:
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 calculer entre des emplacements:
Obtenez des itinéraires pour différents modes de transport et pour une ou plusieurs destinations:
Modes de transport, y compris transports en commun, voiture, véhicules à deux roues, marche ou vélo
Série de points de cheminement que vous pouvez optimiser pour obtenir l'ordre le plus efficace pour les parcourir.
Plusieurs moyens de spécifier des points de départ, des destinations et des points de cheminement:
Chaînes de texte Par exemple: "Chicago, IL", "Darwin, NT, Australie", "1800 Amphitheatre Parkway, Mountain View, CA 94043" ou "CWF6+FWX Mountain View, Californie"
ID de lieu
Coordonnées de latitude et de longitude, éventuellement avec l'orientation du véhicule
Affinez vos options de parcours 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 ou essence. Pour en savoir plus, consultez la section Obtenir un itinéraire écologique.
Définissez des options précises pour le calcul du trafic, ce qui vous permet de prendre des décisions d'équilibre entre la qualité et la latence. Pour en savoir plus, consultez la section Spécifier comment et si inclure des données sur le trafic.
Définissez la direction du véhicule (direction de circulation) 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 la section Spécifier l'orientation du véhicule et le côté de la route.
Spécifiez les emplacements de passage et de terminaux, ainsi que les lieux d'escale sécurisés. Pour en savoir plus, consultez Définir un arrêt sur un itinéraire et Définir un point par lequel un itinéraire doit passer.
Demander des informations sur les péages, ainsi que la distance de l'itinéraire et l'heure d'arrivée prévue Pour en savoir plus, consultez Calculer les frais de péage pour un itinéraire.
Contrôlez votre latence et votre qualité en ne demandant que les données dont vous avez besoin à l'aide d'un masquage de champ. Vous éviterez ainsi un temps de traitement inutile et des tarifs de facturation des demandes plus élevés. Pour en savoir plus, consultez la section Choisir les informations à renvoyer.
Obtenir une matrice d'itinéraires possibles
La méthode Compute Route Matrix de l'API Routes fournit une matrice d'informations sur 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, pour vous aider à choisir les meilleurs points de départ et de destination en fonction de vos besoins commerciaux. Vous pouvez demander les types de données de distance suivants:
Distance pour un mode de transport sélectionné
Distance en kilomètres ou en miles
Durée du trajet estimée en cas de trafic
Grâce aux données de distance, vous pouvez déterminer le moyen le plus efficace de router des passagers, des expéditions ou des travailleurs entre plusieurs origines et destinations possibles.
Vous pouvez diffuser en continu des éléments de la réponse avant que la matrice entière n'ait été calculée, ce qui réduit la latence de la réponse.
Vous pouvez spécifier plusieurs origines et destinations par requête côté serveur, avec un nombre d'origines multiplié par le nombre de destinations pouvant atteindre 625.
Fonctionnement de l'API Routes
L'API Routes propose deux méthodes: ComputeRoutes et ComputeRouteMatrix.
ComputeRoutes
La méthode ComputeRoutes 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. Vous devez indiquer un point de départ, une destination, un mode de transport et un masque de champ pour spécifier les champs à renvoyer.
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 que vous avez 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. Vous devez renseigner au moins une origine, au moins deux destinations, travelMode 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 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 de retour |
|---|---|---|
| ComputeRoutes | Renvoie les itinéraires, les étapes et les étapes d'un itinéraire, avec des itinéraires alternatifs, si demandé. | 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 qui suivent. |
| 2 | Calculer un itinéraire et examiner la réponse | Pour en savoir plus, consultez les pages Obtenir un itinéraire et Examiner les réponses de l'itinéraire. |
| 3 | Calculer la matrice des itinéraires et examiner la réponse | Pour en savoir plus, consultez Obtenir une matrice de calcul d'itinéraires et Examiner la réponse de la matrice de calcul d'itinéraires. |
Bibliothèques clientes disponibles
Pour obtenir la liste des bibliothèques clientes disponibles pour l'API Routes, consultez la section Bibliothèques clientes.