Présentation de Compute Route Matrix

Développeurs situés dans l'Espace économique européen (EEE)

Compute Route Matrix est une méthode du service de l'API Routes qui accepte une requête HTTPS et renvoie les distances et les temps de trajet pour une matrice de routes entre différents points de départ et de destination. Calculez les temps de trajet et les distances de plusieurs destinations, pour 625 éléments d'itinéraire au maximum.

Besoin d'itinéraires ? Pour obtenir des itinéraires, consultez la section Présentation des routes Compute Engine.

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

Pourquoi utiliser Compute Routes Matrix ?

Avec Compute Routes Matrix, vous pouvez déterminer les itinéraires les plus efficaces pour la planification des expéditions, 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 Compute Routes Matrix ?

Avec Compute Route Matrix, vous pouvez obtenir une matrice d'itinéraires possibles entre de nombreux points de départ et d'arrivée. 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. 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 demander ces types de données de parcours pour déterminer le moyen le plus efficace de router des passagers, des expéditions ou des travailleurs entre plusieurs origines et destinations:

  • Distance en kilomètres ou en miles pour un mode de déplacement sélectionné

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

Fonctionnement de Compute Route Matrix

La méthode ComputeRouteMatrix accepte une requête HTTP POST avec un corps de requête JSON contenant les détails de la requête. Vous devez indiquer 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 départ et de destination.

Ressources

Le tableau suivant récapitule les ressources disponibles via la méthode Compute Route Matrix de l'API Routes, ainsi que les données qu'elle renvoie.

Ressources de données Données renvoyées Format de retour
ComputeRouteMatrix Renvoie un tableau d'itinéraires entre un point de cheminement de départ et un point de cheminement de destination. JSON

Utiliser Compute Route Matrix

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 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 Compute Route Matrix, consultez la page Bibliothèques clientes.

Étape suivante