Présentation de l'API Routes

L'API Routes est un service qui accepte les requêtes HTTPS et renvoie soit l'itinéraire idéal entre deux lieux, soit les distances et les temps de trajet pour une matrice d'itinéraires entre différents points de départ et d'arrivée.

Pourquoi utiliser l'API Routes ?

Avec l'API Routes, vous pouvez obtenir des itinéraires précis et des informations sur les trajets à l'aide des informations sur les transports, des conditions de circulation et des conditions de circulation, ainsi que des préférences d'itinéraire:

  • Le type et les capacités des différents modes de transport

  • Direction dans laquelle se dirige un véhicule

  • Le côté de la route où monter ou descendre le véhicule

  • Conditions de circulation et routes fermées

  • Les problèmes de sécurité, comme éviter les zones dangereuses ou fournir des zones de prise en charge sûres

  • Équilibrez la latence, la qualité et le coût de vos itinéraires avec des fonctionnalités facultatives telles que les péages et les métadonnées de trajet (durée, distance et consommation de carburant).

Vous pouvez également déterminer les itinéraires les plus efficaces pour la planification de la distribution, par exemple:

  • Attribuer au mieux un ensemble de nœuds de calcul pour qu'il récupère une série de packages

  • Déterminer le meilleur entrepôt depuis lequel expédier les colis à leur destination finale

Que pouvez-vous faire avec l'API Routes ?

Avec l'API Routes, vous pouvez obtenir deux principales catégories d'informations de routage:

  • Itinéraires à partir d'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 routes pour une ou plusieurs destinations

Avec la méthode Compute Routes de l'API Routes, vous pouvez effectuer des calculs entre des lieux:

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

    • Modes de transport, y compris les transports en commun, la voiture, les deux-roues, la marche ou le vélo.

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

  • Plusieurs façons de spécifier des points de départ, des destinations et des points de cheminement:

    • Chaînes de texte. Par exemple: "Chicago, Illinois", "Darwin, Territoire du Nord, 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

  • Ajustez les itinéraires possibles 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. Cela vous permet d'éviter des temps de traitement inutiles et des taux de facturation des requêtes plus élevés. Pour en savoir plus, consultez la section Choisir les informations à renvoyer.

Obtenir une matrice des itinéraires possibles

La méthode Compute Route Matrix de l'API Routes fournit une matrice d'informations pour 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. Elle vous aide à choisir les points de départ et les destinations les plus adaptés en fonction des besoins de votre entreprise. Vous pouvez demander les types de données de distance suivants:

  • Distance pour un mode de transport sélectionné

  • Distance en kilomètres ou miles

  • Estimation du temps de trajet en cas de trafic

Les données de distance vous permettent de déterminer le moyen le plus efficace d'acheminer les passagers, les livraisons ou les travailleurs entre plusieurs points de départ et destinations possibles.

Vous pouvez diffuser des éléments de la réponse avant que la matrice entière ne soit calculée, ce qui réduit la latence de réponse.

Vous pouvez spécifier plusieurs points de départ et destinations par requête côté serveur, en multipliant le nombre de points de départ par le nombre de destinations (625 au maximum).

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. Les champs "origin", "destination", "travelMode" et "field masque" 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.

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. Les champs obligatoires incluent au moins un point de départ, deux destinations ou plus, le mode de transport 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 cheminement de départ et de destination.

Ressources

Le tableau suivant récapitule les ressources disponibles via l'API Routes ainsi que les données renvoyées.

Ressources de données Données renvoyées Format renvoyé
ComputeRoutes Affiche les itinéraires, les sections et les étapes d'un itinéraire, avec des itinéraires bis, si nécessaire. 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 s'affichent.
2 Calculer une route et examiner la réponse Pour en savoir plus, consultez Obtenir un itinéraire et Examiner les réponses de routage.
3 Calculer la matrice de routes et examiner la réponse Pour en savoir plus, consultez les sections Obtenir une matrice de routage et Examiner la réponse de la matrice de routage.

Bibliothèques clientes disponibles

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

Étapes suivantes