Présentation de Compute Routes

Développeurs de l'Espace économique européen (EEE)

Introduction

Compute Routes est une méthode du service de l'API Routes qui accepte une requête HTTPS et renvoie l'itinéraire idéal entre deux lieux. Proposez un itinéraire entre plusieurs lieux en tenant compte du trafic en temps réel (en transports en commun, à vélo, en voiture, en véhicule motorisé à deux roues ou à pied).

Besoin de matrices d'itinéraires ? Si vous êtes intéressé par une matrice d'itinéraires, consultez la présentation de Compute Route Matrix.

Vous migrez ? Si vous effectuez une migration à partir de l'API Distance Matrix (ancienne version), consultez les instructions de migration en commençant par Pourquoi migrer vers l'API Routes.

Pourquoi utiliser Compute Routes ?

Grâce à Compute Routes, vous pouvez acheminer vos véhicules ou vos colis selon vos préférences, tout en optimisant les coûts et la qualité, grâce à un large éventail de détails sur les itinéraires.

Que pouvez-vous faire avec Compute Routes ?

La méthode Compute Routes de l'API Routes vous permet d'effectuer les opérations suivantes :

  • Obtenez un itinéraire pour différents modes de transport, et pour une ou plusieurs destinations :

    • Modes de transport : transports en commun, voiture, deux-roues, camions, à pied ou à vélo.

    • Série de points de cheminement que vous pouvez optimiser pour déterminer l'ordre le plus efficace pour les parcourir.

  • Utilisez plusieurs façons de spécifier les points de départ, les destinations et les 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 le cap du véhicule

  • Ajustez vos options d'itinéraire en fonction de vos besoins et de vos objectifs :

  • 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. Vous éviterez ainsi des temps de traitement inutiles et des tarifs de facturation des requêtes plus élevés. Pour en savoir plus, consultez Choisir les informations à renvoyer.

Fonctionnement de Compute Routes

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 travelMode 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.

Ressources

Le tableau suivant récapitule les ressources disponibles via la méthode Compute Routes de 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 segments d'un itinéraire, avec des itinéraires bis, si demandé. JSON

Utiliser Compute Routes

1 Configurer Commencez par Configurer votre projet Google Cloud, puis suivez les instructions de configuration qui suivent.
2 Comprendre la facturation de l'API Routes Pour en savoir plus, consultez Utilisation et facturation.
3 Calculer un itinéraire et examiner la réponse Pour en savoir plus, consultez Obtenir un itinéraire et Examiner les réponses d'itinéraire.

Bibliothèques clientes disponibles

Pour obtenir la liste des bibliothèques clientes disponibles pour Compute Routes, consultez Bibliothèques clientes.

Étape suivante