Présentation de Compute Route Matrix

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 d'itinéraires entre différents points de départ et de destination. Calculez les temps de trajet et les distances selon plusieurs destinations (jusqu'à 625 éléments d'itinéraire).

Besoin d'itinéraires ? Si vous êtes intéressé par les itinéraires, consultez la présentation de Compute Routes.

Vous effectuez une migration ? Si vous migrez depuis l'API Distance Matrix (ancienne version), consultez les instructions de migration à partir de la section Pourquoi migrer vers l'API Routes ?.

Pourquoi utiliser Compute Route Matrix ?

Avec Compute Route Matrix, vous pouvez 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 le meilleur entrepôt à partir duquel expédier les colis vers leur destination finale

Que pouvez-vous faire avec Compute Route 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 points de départ et de destination par requête côté serveur, avec un nombre de points de départ multiplié par le nombre de destinations allant jusqu'à 625. Vous pouvez diffuser en streaming 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 d'itinéraire pour déterminer le moyen le plus efficace d'acheminer des passagers, des expéditions ou des travailleurs entre plusieurs points de départ et de destination :

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

• Temps de trajet estimé 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 un point de départ, deux destinations ou plus, un travelMode et un masque de champ sont requis 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 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.

Comment 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éraires
• Options de matrice d'itinéraires disponibles
• Choisir les informations à renvoyer
• Migrer depuis l'API Distance Matrix (ancienne version)
• Migrer de la version preview de l'API Routes vers la version GA