Présentation de l'API Routes

L'API Routes est un service qui accepte une requête HTTPS renvoie soit l'itinéraire idéal entre deux lieux, soit les distances et les trajets des durées pour une matrice d'itinéraires entre différents lieux de départ et de destination.

Pourquoi utiliser l'API Routes ?

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

  • 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

  • Préoccupations de sécurité (par exemple, éviter les zones dangereuses ou proposer un retrait sécurisé) zones

  • Trouvez l'équilibre entre la latence, la qualité et les coûts pour tous vos besoins de routage grâce à des Caractéristiques (péages, trajets, durée, distance, carburant, etc.) efficacité

Vous pouvez également déterminer les itinéraires les plus efficaces pour la planification de la répartition, par exemple en tant que:

  • Comment attribuer une série de colis à un ensemble de nœuds de calcul ?

  • Déterminer le meilleur entrepôt à partir duquel expédier les colis jusqu'à leur livraison finale destination

Que pouvez-vous faire avec l'API Routes ?

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

  • 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 le calcul entre les lieux:

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

    • Les moyens de transport, y compris les transports en commun, la voiture, les deux-roues, à pied ou à vélo.

    • Une série de points de cheminement que vous pouvez optimiser et de les emmener.

  • 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, NT, Australie", "1800 Amphitheatre Parkway, Mountain View, CA 94043, États-Unis" ou "CWF6+FWX Mountain View, Californie"

    • ID de lieu

    • Coordonnées de latitude et de longitude, avec éventuellement l'orientation du véhicule

  • Ajustez vos options d'itinéraire 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 via un masque de champ, ce qui vous aide à éviter les délais de traitement inutiles et demander des tarifs de facturation. Pour en savoir plus, consultez Sélectionnez les informations à renvoyer.

Obtenir une matrice d'itinéraires possibles

La méthode Compute Route Matrix de l'API Routes fournit un matrice d'informations pour les itinéraires recommandés entre plusieurs points de départ et d'arrivée tels que la distance et l'heure d'arrivée estimée, pour vous aider à choisir les meilleurs points de départ et de destination besoins de l'entreprise. Vous pouvez demander les types de données de distance suivants:

  • Distance pour le mode de transport sélectionné

  • Distance en kilomètres ou en miles

  • Temps de trajet estimé en fonction des embouteillages

Grâce aux données de distance, vous pouvez déterminer l'itinéraire le plus efficace de passagers, de colis ou de travailleurs d'origines diverses et de destination.

Vous pouvez diffuser des éléments de la réponse avant que la matrice entière ait été calculé, 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 avec le nombre de points de départ multiplié par le nombre de destinations, jusqu'à 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 avec un corps de requête JSON contenant les détails de la requête. Les champs obligatoires sont une origine, destination, TravelMode et d'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 affiche les champs que vous avez demandée.

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. Veuillez indiquer au moins un point de départ, deux destinations ou plus, "travelMode" et un masque de champ pour spécifier à 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 routes possibles pour la combinaison de tous les points de départ. et les points de cheminement de destination.

Ressources

Le tableau suivant récapitule les ressources disponibles via le API Routes avec les données renvoyées.

Ressources de données Données renvoyées Format de retour
ComputeRoutes Les retours, les étapes et les étapes d'un itinéraire (avec des itinéraires bis) si nécessaire. JSON
ComputeRouteMatrix Renvoie un tableau d'itinéraires allant d'un point de cheminement de départ à une destination point de cheminement.

Utiliser l'API Routes

1 Configuration Commencez par Configurer votre projet Google Cloud. et 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 des routes et examiner la réponse Pour en savoir plus, consultez la section Obtenir une matrice de routage et Examiner la réponse de la matrice de routes.

Bibliothèques clientes disponibles

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

Étape suivante