Route Matrix (beta)

Classe RouteMatrix

Classe google.maps.routes.RouteMatrix

Matrice d'itinéraires calculée pour un ensemble de paires point de départ/destination par RouteMatrix.computeRouteMatrix

Accédez-y en appelant le const {RouteMatrix} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
computeRouteMatrix
computeRouteMatrix(request)
Paramètres :
Valeur renvoyée : Promise<{matrix:RouteMatrix}>
Accepte une liste de points de départ et de destinations, et renvoie une matrice contenant des informations sur l'itinéraire pour chaque combinaison de point de départ et de destination.

 Remarque : Cette méthode nécessite que vous spécifiiez un masque de champ de réponse dans la requête en définissant la propriété ComputeRouteMatrixRequest.fields. La valeur est une liste de chemins de champ.

 Par exemple :
  • Masque de champ de tous les champs disponibles : fields: ['*']
  • Masque de champ de la durée et de la distance au niveau de l'itinéraire : fields: ['durationMillis', 'distanceMeters']

 L'utilisation du masque de champ de réponse générique fields: ['*'] est déconseillée, car :
  • Si vous ne sélectionnez que les champs dont vous avez besoin, notre serveur économise des cycles de calcul, ce qui nous permet de vous renvoyer le résultat avec une latence plus faible.
  • Si vous ne sélectionnez que les champs dont vous avez besoin dans votre job de production, vous garantissez des performances de latence stables. Nous pourrons ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourront nécessiter un temps de calcul supplémentaire. Si vous sélectionnez tous les champs ou tous les champs au niveau supérieur, les performances peuvent se dégrader, car tout nouveau champ que nous ajoutons sera automatiquement inclus dans la réponse.
  • Si vous ne sélectionnez que les champs dont vous avez besoin, la taille de la réponse sera plus petite et le chargement sur le réseau sera donc plus rapide.
rows
Lignes de la matrice. Chaque ligne correspond à un point de départ et contient un tableau de RouteMatrixItem, chacun représentant un itinéraire vers une destination.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe RouteMatrixRow

Classe google.maps.routes.RouteMatrixRow

Correspond à une origine transmise à RouteMatrix.computeRouteMatrix. Contient une liste de RouteMatrixItem, chaque élément représentant un itinéraire vers une destination.

Accédez-y en appelant le const {RouteMatrixRow} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
items
Informations sur l'itinéraire pour chaque destination.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe RouteMatrixItem

Classe google.maps.routes.RouteMatrixItem

Contient les informations d'itinéraire calculées pour une paire point de départ/destination transmise à RouteMatrix.computeRouteMatrix.

Accédez-y en appelant le const {RouteMatrixItem} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
condition
Type : RouteMatrixItemCondition optional
Indique si l'itinéraire a été trouvé ou non.
distanceMeters
Type : number optional
Distance du trajet en mètres.
durationMillis
Type : number optional
Durée nécessaire pour parcourir l'itinéraire, en millisecondes. Si vous définissez ComputeRouteMatrixRequest.routingPreference sur TRAFFIC_UNAWARE, cette valeur est identique à RouteMatrixItem.staticDurationMillis. Si vous définissez ComputeRouteMatrixRequest.routingPreference sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL, cette valeur est calculée en tenant compte des conditions de circulation.

 Remarque : Si la durée dépasse 2^53 millisecondes, cette valeur est Number.POSITIVE_INFINITY.
error
Type : RouteMatrixItemError optional
Erreur survenue lors du calcul de l'itinéraire.
fallbackInfo
Type : FallbackInfo optional
Dans certains cas, lorsque le serveur n'est pas en mesure de calculer l'itinéraire avec les préférences données pour cette paire origine/destination, il peut revenir à un autre mode de calcul. Lorsque le remplacement est utilisé, ce champ contient des informations détaillées sur la réponse de remplacement. Sinon, ce champ n'est pas défini.
localizedValues
Représentations textuelles des propriétés de RouteMatrixItem.
staticDurationMillis
Type : number optional
Durée du trajet sans tenir compte des conditions de circulation.

 Remarque : Si la durée dépasse 2^53 millisecondes, cette valeur est Number.POSITIVE_INFINITY.
travelAdvisory
Type : RouteTravelAdvisory optional
Informations supplémentaires sur l'itinéraire.

Interface ComputeRouteMatrixRequest

Interface google.maps.routes.ComputeRouteMatrixRequest

Demande de matrice de routes.
destinations
Tableau de destinations, qui détermine les colonnes de la matrice de réponse. Une valeur transmise sous forme de chaîne peut être une adresse, un code Plus ou un nom de ressource Lieu. Les valeurs d'altitude ne sont pas prises en compte.
fields
Type : Iterable<string>
Collection de champs à récupérer. Spécifiez ["*"] pour tous les champs.
origins
Tableau d'origines qui détermine les lignes de la matrice de réponse. Une valeur transmise sous forme de chaîne peut être une adresse, un code Plus ou un nom de ressource Lieu. Les valeurs d'altitude ne sont pas prises en compte.

 Plusieurs restrictions de taille s'appliquent à la cardinalité des origines et des destinations :
  • Le nombre total d'origines et de destinations spécifiées en tant que string ou Place ne doit pas dépasser 50.
  • Le produit du nombre d'origines par le nombre de destinations ne doit pas dépasser 625.
  • Le produit du nombre d'origines et de destinations ne doit pas dépasser 100 si ComputeRouteMatrixRequest.routingPreference est défini sur TRAFFIC_AWARE_OPTIMAL.
  • Le produit du nombre d'origines et de destinations ne doit pas dépasser 100 si ComputeRouteMatrixRequest.travelMode est défini sur TRANSIT.
arrivalTime optional
Type : Date optional
Heure d'arrivée.

 Remarque : Ne peut être défini que lorsque ComputeRouteMatrixRequest.travelMode est défini sur TRANSIT. Vous pouvez spécifier une liste ComputeRouteMatrixRequest.departureTime ou une liste ComputeRouteMatrixRequest.arrivalTime, mais pas les deux. Les trajets en transports en commun sont disponibles pour les sept derniers jours ou les 100 prochains jours.
departureTime optional
Type : Date optional
Heure de départ. Si vous ne définissez pas cette valeur, elle est définie par défaut sur l'heure à laquelle vous avez envoyé la demande.

 Remarque : Vous ne pouvez spécifier une heure passée que lorsque ComputeRouteMatrixRequest.travelMode est défini sur TRANSIT. Les trajets en transports en commun sont disponibles pour les sept derniers jours ou les 100 prochains jours.
extraComputations optional
Liste des calculs supplémentaires pouvant être utilisés pour traiter la demande.

 Remarque : Ces calculs supplémentaires peuvent renvoyer des champs supplémentaires dans la réponse. Ces champs supplémentaires doivent également être spécifiés dans ComputeRouteMatrixRequest.fields pour être renvoyés dans la réponse.
language optional
Type : string optional
Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez Identifiant de paramètres régionaux Unicode. Pour obtenir la liste des langues disponibles, consultez Langues acceptées. Si vous ne fournissez pas cette valeur, la langue est déduite de vos paramètres de localisation de l'API Google Maps JavaScript. Sinon, la langue est déduite de la localisation de la première origine.
region optional
Type : string optional
Code régional, spécifié sous la forme d'une valeur ccTLD (TLD pour top-level domain, domaine de premier niveau) à deux caractères. Pour en savoir plus, consultez Domaines de premier niveau de code pays. Si vous ne fournissez pas cette valeur, la région est déduite de vos paramètres de localisation de l'API Google Maps JavaScript. Sinon, la région est déduite de l'emplacement de la première origine.
routingPreference optional
Type : RoutingPreference optional
Spécifie comment calculer la matrice de routes. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la matrice de routage. Si la préférence de routage entraîne une erreur ou une latence très longue, une erreur est renvoyée. Vous ne pouvez spécifier cette option que lorsque ComputeRouteMatrixRequest.travelMode est défini sur DRIVING ou TWO_WHEELER. Sinon, la requête échoue.
trafficModel optional
Type : TrafficModel optional
Spécifie les hypothèses à utiliser pour calculer le temps de trajet selon le trafic. Ce paramètre influe sur la valeur renvoyée dans RouteMatrixItem.durationMillis, qui contient le temps de trajet prévu en fonction des moyennes historiques. ComputeRouteMatrixRequest.trafficModel n'est disponible que pour les requêtes qui ont défini ComputeRouteMatrixRequest.routingPreference sur TRAFFIC_AWARE_OPTIMAL et ComputeRouteMatrixRequest.travelMode sur DRIVING. La valeur par défaut est BEST_GUESS.
transitPreference optional
Type : TransitPreference optional
Spécifie les préférences qui influencent l'itinéraire renvoyé pour les itinéraires TRANSIT.

 Remarque : Ne peut être spécifié que lorsque ComputeRouteMatrixRequest.travelMode est défini sur TRANSIT.
travelMode optional
Type : TravelMode optional
Spécifie le mode de transport.
units optional
Type : UnitSystem optional
Spécifie les unités de mesure pour les champs d'affichage. Si vous ne fournissez pas cette valeur, les unités d'affichage sont déduites de l'emplacement de la première origine.

Constantes ComputeRouteMatrixExtraComputation

google.maps.routes.ComputeRouteMatrixExtraComputation constantes

Calculs supplémentaires à effectuer pour une requête RouteMatrix.computeRouteMatrix.

Accédez-y en appelant le const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
TOLLS Informations sur les péages pour le ou les éléments de la matrice.

Constantes RouteMatrixItemCondition

google.maps.routes.RouteMatrixItemCondition constantes

État d'un itinéraire pour une paire origine/destination donnée.

Accédez-y en appelant le const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
ROUTE_EXISTS Un itinéraire a été trouvé.
ROUTE_NOT_FOUND Aucun itinéraire n'a pu être trouvé.

Classe RouteMatrixItemError

Classe google.maps.routes.RouteMatrixItemError

Erreur survenue lors de RouteMatrix.computeRouteMatrix pour une paire origine/destination spécifique.

Cette classe étend Error.

Accédez-y en appelant le const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Classe RouteMatrixItemLocalizedValues

Classe google.maps.routes.RouteMatrixItemLocalizedValues

Représentations textuelles de RouteMatrixItem.

Accédez-y en appelant le const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
 Consultez Bibliothèques de l'API Maps JavaScript.
distance
Type : string optional
Distance de trajet de l'élément de la matrice de trajets sous forme de texte.
distanceLanguage
Type : string optional
Code de langue BCP-47 du texte de distance, tel que "en-US" ou "sr-Latn".

 Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Type : string optional
Durée, représentée sous forme de texte et localisée selon la région de la requête. Tient compte des conditions de circulation.

 Remarque : Si vous n'avez pas demandé d'informations sur le trafic, cette valeur est identique à celle de RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage
Type : string optional
Code de langue BCP-47 du texte de la durée, tel que "en-US" ou "sr-Latn".

 Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Type : string optional
Durée sans tenir compte des conditions de circulation, représentée sous forme de texte.
staticDurationLanguage
Type : string optional
Code de langue BCP-47 du texte de durée statique, tel que "en-US" ou "sr-Latn".
transitFare
Type : string optional
Tarif du transport en commun, représenté sous forme de texte.
transitFareLanguage
Type : string optional
Code de langue BCP-47 du texte du tarif des transports en commun, tel que "en-US" ou "sr-Latn".

 Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit en objet.

Interface RouteMatrixOrigin

Interface google.maps.routes.RouteMatrixOrigin

Une seule origine pour un ComputeRouteMatrixRequest.
waypoint
Emplacement de l'origine. Une valeur transmise sous forme de chaîne peut être une adresse ou un code Plus. Les valeurs d'altitude ne sont pas prises en compte.
routeModifiers optional
Type : RouteModifiers optional
Modificateurs pour chaque itinéraire qui prend ce point comme origine.