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. 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 effectuez une migration ? Si vous migrez depuis l'API Distance Matrix (ancienne version), consultez les instructions de migration à partir de la section 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 grâce à un large éventail de détails sur les itinéraires, tout en optimisant les coûts et la qualité.

Que pouvez-vous faire avec Compute Routes ?

Avec la méthode Compute Routes de l'API Routes, vous pouvez effectuer les opérations suivantes :

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

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

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

  • Utiliser plusieurs façons de 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

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

  • Contrôler la latence et la qualité en ne demandant que les données dont vous avez besoin à l'aide d'un masque de champ, ce qui vous permet d'éviter 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. L'origine, la destination, le 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 tronçons d'un itinéraire, avec des itinéraires alternatifs, si demandé. JSON

Comment utiliser Compute Routes ?

1 Configurer vos écouteurs Commencez par Configurer votre projet Google Cloud et suivez les instructions de configuration.
2 Comprendre comment l'API Routes est facturée 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 de l'itinéraire.

Bibliothèques clientes disponibles

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

Étape suivante