Présentation de l'API Routes

L'API Routes est un service qui accepte une requête 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 de destination.

Pourquoi utiliser l'API Routes ?

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

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

  • Dans quel sens va un véhicule

  • Le côté de la route pour les prises en charge ou les déposes

  • Conditions de circulation et routes fermées

  • Problèmes de sécurité, comme éviter les zones dangereuses ou fournir des zones de prise en charge sécurisées

  • Trouvez l'équilibre entre la latence, la qualité et les coûts pour vos besoins d'itinéraires grâce à des fonctionnalités facultatives telles que les péages et les métadonnées des trajets (durée et distance, et économie de carburant, par exemple).

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

  • Meilleure façon d'attribuer un ensemble de travailleurs pour récupérer une série de colis

  • Déterminer l'entrepôt le plus approprié pour expédier les colis à leur destination finale

Que pouvez-vous faire avec l'API Routes ?

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

  • Itinéraires depuis un lieu vers une ou plusieurs destinations

  • Matrice d'itinéraires possibles entre de nombreux points de départ et d'arrivée.

Obtenir des itinéraires pour une ou plusieurs destinations

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

  • Obtenez un itinéraire selon différents modes de transport, et 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 pour les parcourir dans l'ordre le plus efficace.

  • Plusieurs moyens de spécifier des points de départ, des destinations et des 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 l'orientation du véhicule

  • Affinez vos options de parcours 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, ce qui vous permet d'éviter les temps de traitement inutiles et d'augmenter les frais liés aux requêtes. Pour en savoir plus, consultez Choisir les informations à renvoyer.

Obtenir une matrice d'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, afin de vous aider à choisir les meilleurs points de départ et de destination en fonction de vos besoins professionnels. Vous pouvez demander les types de données de distance suivants :

  • Distance pour un mode de transport sélectionné

  • Distance en kilomètres ou en miles

  • Durée du trajet estimée en cas de trafic

Grâce aux données de distance, vous pouvez déterminer le moyen le plus efficace de router des passagers, des expéditions ou des travailleurs entre plusieurs origines et destinations possibles.

Vous pouvez diffuser en continu des éléments de la réponse avant que la matrice entière n'ait été calculée, ce qui réduit la latence de la réponse.

Vous pouvez spécifier plusieurs origines et destinations par requête côté serveur, avec un nombre d'origines multiplié par le nombre de destinations pouvant atteindre 625.

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 dont le corps contient les détails de la requête. Vous devez indiquer un point de départ, une destination, un mode de transport 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.

ComputeRouteMatrix

Le ComputeRouteMatrix de l'API Routes accepte une requête HTTP POST dont le corps contient les détails de la requête. Vous devez renseigner au moins une origine, au moins deux destinations, travelMode 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 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
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 et suivez les instructions de configuration qui suivent.
2 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 de l'itinéraire.
3 Calculer la matrice des itinéraires et examiner la réponse Pour en savoir plus, consultez Obtenir une matrice de calcul d'itinéraires et Examiner la réponse de la matrice de calcul d'itinéraires.

Bibliothèques clientes disponibles

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

Étape suivante