Classe DistanceMatrixService
Classe google.maps.DistanceMatrixService
Service permettant de calculer les distances entre plusieurs points de départ et destinations.
Accédez-y en appelant le const {DistanceMatrixService} = await google.maps.importLibrary("routes")
.
Consultez Bibliothèques de l'API Maps JavaScript.
Constructeur | |
---|---|
DistanceMatrixService |
DistanceMatrixService() Paramètres : aucun
Crée une instance de DistanceMatrixService qui envoie des requêtes Distance Matrix aux serveurs Google. |
Méthodes | |
---|---|
getDistanceMatrix |
getDistanceMatrix(request[, callback]) Paramètres :
Valeur renvoyée :
Promise<DistanceMatrixResponse> Émet une requête Distance Matrix. |
Interface DistanceMatrixRequest
Interface google.maps.DistanceMatrixRequest
Requête Distance Matrix envoyée par DistanceMatrixService
, contenant des tableaux de lieux de départ et de destination, ainsi que diverses options pour calculer les métriques.
Propriétés | |
---|---|
destinations |
Type :
Array<string|LatLng|LatLngLiteral|Place> Tableau contenant des chaînes d'adresse de destination, ou des objets LatLng ou Place , à utiliser comme destinations pour calculer des distances et des durées. Obligatoire. |
origins |
Type :
Array<string|LatLng|LatLngLiteral|Place> Tableau contenant des chaînes d'adresse d'origine, des objets LatLng ou des objets Place à partir desquels calculer la distance et la durée. Obligatoire. |
travelMode |
Type :
TravelMode Type de routage demandé. Obligatoire. |
avoidFerries optional |
Type :
boolean optional Si la valeur est true , le service Distance Matrix est invité à éviter les ferries dans la mesure du possible. Facultatif. |
avoidHighways optional |
Type :
boolean optional Si la valeur est true , le service Distance Matrix est invité à éviter les autoroutes dans la mesure du possible. Facultatif. |
avoidTolls optional |
Type :
boolean optional Si la valeur est true , le service Distance Matrix est invité à éviter les routes à péage dans la mesure du possible. Facultatif. |
drivingOptions optional |
Type :
DrivingOptions optional Paramètres qui ne s'appliquent qu'aux requêtes où travelMode est défini sur DRIVING . Cet objet n'aura aucun effet pour les autres modes de déplacement. |
language optional |
Type :
string optional Identifiant de la langue dans laquelle les résultats doivent être renvoyés, si possible. Consultez la liste des langues disponibles. |
region optional |
Type :
string optional Code de région utilisé comme biais pour les demandes de géocodage. Le code régional accepte une valeur ccTLD ("domaine de premier niveau") à deux caractères. La plupart des codes ccTLD sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" ( .co.uk ), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord"). |
transitOptions optional |
Type :
TransitOptions optional Paramètres qui s'appliquent uniquement aux requêtes où travelMode est TRANSIT. Cet objet n'aura aucun effet pour les autres modes de déplacement. |
unitSystem optional |
Type :
UnitSystem optional Système d'unités préféré à utiliser pour afficher les distances. Facultatif ; la valeur par défaut est "metric". |
Interface DistanceMatrixResponse
Interface google.maps.DistanceMatrixResponse
Réponse à une requête DistanceMatrixService
, composée des adresses de départ et de destination mises en forme, et d'une séquence de DistanceMatrixResponseRow
, une pour chaque adresse de départ correspondante.
Propriétés | |
---|---|
destinationAddresses |
Type :
Array<string> Adresses de destination mises en forme. |
originAddresses |
Type :
Array<string> Adresses d'origine formatées. |
rows |
Type :
Array<DistanceMatrixResponseRow> Les lignes de la matrice, correspondant aux adresses d'origine. |
Interface DistanceMatrixResponseRow
Interface google.maps.DistanceMatrixResponseRow
Ligne de la réponse à une requête DistanceMatrixService
, composée d'une séquence de DistanceMatrixResponseElement
, une pour chaque adresse de destination correspondante.
Propriétés | |
---|---|
elements |
Type :
Array<DistanceMatrixResponseElement> Éléments de la ligne, correspondant aux adresses de destination. |
Interface DistanceMatrixResponseElement
Interface google.maps.DistanceMatrixResponseElement
Élément unique d'une réponse à une requête DistanceMatrixService
, qui contient la durée et la distance entre un point de départ et une destination.
Propriétés | |
---|---|
|