Distance Matrix

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.

DistanceMatrixService
DistanceMatrixService()
Paramètres : aucun
Crée une instance de DistanceMatrixService qui envoie des requêtes Distance Matrix aux serveurs Google.
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.

destinations
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
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.

destinationAddresses
Type : Array<string>
Adresses de destination mises en forme.
originAddresses
Type : Array<string>
Adresses d'origine formatées.
rows
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.

elements
É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.