Présentation de Compute Routes

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. Fournissez des itinéraires avec le trafic en temps réel en transports en commun, en vélo, en voiture, en véhicule motorisé à deux roues ou à pied entre plusieurs lieux.

Besoin de matrices de calcul d'itinéraires ? Si vous souhaitez utiliser une matrice de calcul, consultez la présentation de Compute Route Matrix.

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

Pourquoi utiliser Compute Routes ?

Avec Compute Routes, vous pouvez définir des itinéraires pour vos véhicules ou vos colis en fonction de vos préférences, 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:

  • Obtenez des itinéraires pour différents modes de transport et pour une ou plusieurs destinations:

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

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

  • Vous pouvez spécifier les origines, les destinations et les points de cheminement de plusieurs manières :

    • 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 trajet 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 la section 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, un point de destination, 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 étapes d'un itinéraire, avec des itinéraires alternatifs, si demandé. JSON

Utiliser Compute Routes

1 Configuration 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 les pages Obtenir un itinéraire et Examiner les réponses aux itinéraires.

Bibliothèques clientes disponibles

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

Étape suivante