Présentation de Compute Route Matrix

Compute Route Matrix est une méthode du service Routes API qui accepte une requête HTTPS et renvoie les distances et les temps de trajet pour une matrice d'itinéraires 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 ? Si vous êtes intéressé par les itinéraires, consultez la présentation de Compute Routes.

Vous migrez ? Si vous migrez depuis l'ancienne API Distance Matrix, consultez les instructions de migration à partir de Pourquoi migrer vers l'API Routes ?.

Pourquoi utiliser Compute Route Matrix ?

Compute Routes Matrix vous permet de déterminer les itinéraires les plus efficaces pour la planification des expéditions, par exemple :

• Comment attribuer au mieux un ensemble de travailleurs pour récupérer une série de colis ?

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

Que pouvez-vous faire avec Compute Route Matrix ?

Avec Compute Route Matrix, vous pouvez obtenir une matrice des 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 jusqu'à 625. Vous pouvez diffuser 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 route pour déterminer le moyen le plus efficace d'acheminer des passagers, des colis ou des employés entre plusieurs origines et destinations :

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

• Durée estimée du trajet dans le 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. Au moins une origine, deux destinations ou plus, un mode de transport et un masque de champ sont obligatoires pour spécifier les champs à renvoyer.

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 d'origine 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.

Utiliser Compute Route Matrix

Bibliothèques clientes disponibles

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

Étape suivante

• Obtenir une matrice d'itinéraire
• Options de matrice d'itinéraire disponibles
• Choisir les informations à renvoyer
• Migrer depuis l'ancienne API Distance Matrix
• Migrer de l'aperçu de l'API Routes vers la version GA