Présentation de Compute Routes

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

Introduction

Compute Routes est une méthode du service Routes API qui accepte une requête HTTPS et renvoie l'itinéraire idéal entre deux lieux. Fournissez des itinéraires avec le trafic en temps réel en transports en commun, à vélo, en voiture, en véhicule motorisé à deux roues ou à pied entre plusieurs lieux.

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

Vous migrez ? Si vous migrez depuis l'ancienne API Distance Matrix, consultez les instructions de migration à partir de Pourquoi migrer vers l'API Routes ?.

Pourquoi utiliser Compute Routes ?

Avec 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 des itinéraires pour différents modes de transport, et pour une ou plusieurs destinations :

    • Moyens de transport : transports en commun, voiture, deux-roues, marche ou vélo.

    • Il s'agit d'une série de points de cheminement que vous pouvez optimiser pour trouver l'ordre le plus efficace pour les atteindre.

  • Utilisez plusieurs méthodes pour spécifier les origines, 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 votre latence et votre qualité en ne demandant que les données dont vous avez besoin à l'aide d'un masque de champ. Vous éviterez ainsi un temps de traitement inutile 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. Une origine, une destination, travelMode et un masque de champ sont obligatoires 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 sous-étapes d'un itinéraire, avec des itinéraires alternatifs, si demandé. JSON

Utiliser Compute Routes

1 Configurer Commencez par Configurer votre projet Google Cloud, puis suivez les instructions de configuration.
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