Distance Matrix

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

DistanceMatrixService

Classe google.maps.DistanceMatrixService

Service de calcul des distances entre plusieurs origines et destinations.

DistanceMatrixService
DistanceMatrixService()
Paramètres : aucun
Crée une instance d'une DistanceMatrixService qui envoie des requêtes matricielles aux serveurs Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Paramètres :
Valeur renvoyée : Promise<DistanceMatrixResponse>
Émet une requête Distance Matrix.

Interface DistanceMatrixRequest

google.maps.DistanceMatrixRequest interface

Une requête de matrice de distance envoyée par DistanceMatrixService contenant des tableaux de lieux de départ et d'arrivée, ainsi que différentes options de calcul des métriques

destinations
Tableau contenant des chaînes d'adresse de destination, ou des objets LatLng ou Place, auxquels calculer la distance et la durée. Obligatoire.
origins
Tableau contenant des chaînes d'adresse d'origine, ou des objets LatLng ou Place, à partir desquels calculer la distance et le temps. Obligatoire.
travelMode
Type de routage demandé. Obligatoire.
avoidFerries optional
Type : boolean optional
Si la valeur est true, indique au service Distance Matrix d'éviter les ferries lorsque cela est possible. Facultatif.
avoidHighways optional
Type:boolean optional
Si la valeur est true, indique au service Distance Matrix d'éviter les autoroutes dans la mesure du possible. Facultatif.
avoidTolls optional
Type:boolean optional
Si la valeur est true, indique au service Distance Matrix d'éviter les routes à péage lorsque cela est possible. Facultatif.
drivingOptions optional
Type:DrivingOptions optional
Paramètres qui ne s'appliquent qu'aux requêtes où travelMode est DRIVING. Cet objet n'aura aucun effet sur les autres modes de transport.
language optional
Type : string optional
Identifiant de la langue dans laquelle les résultats doivent être renvoyés, lorsque cela est possible. Consultez la liste des langues disponibles.
region optional
Type : string optional
Code de région utilisé comme biais pour les requêtes de geocoding. Le code de région accepte la valeur à deux caractères correspondant à ccTLD ("domaine de premier niveau"). 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) alors que son code ISO 3166-1 est "gb" (techniquement, il désigne l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").
transitOptions optional
Type:TransitOptions optional
Paramètres qui ne s'appliquent qu'aux requêtes pour lesquelles travelMode est défini sur TRANSIT. Cet objet n'aura aucun effet sur les autres modes de transport.
unitSystem optional
Type:UnitSystem optional
Système d'unités préféré à utiliser pour l'affichage de la distance. Facultatif. Valeur par défaut : métrique.

Interface DistanceMatrixResponse

google.maps.DistanceMatrixResponse interface

Réponse à une requête DistanceMatrixService composée d'adresses d'origine et de destination mises en forme, et d'une séquence de valeurs DistanceMatrixResponseRow, une pour chaque adresse d'origine correspondante.

destinationAddresses
Type : Array<string>
Adresses de destination mises en forme.
originAddresses
Type : Array<string>
Adresses d'origine mises en forme.
rows
Lignes de la matrice, correspondant aux adresses d'origine.

Interface DistanceMatrixResponseRow

google.maps.DistanceMatrixResponseRow interface

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

google.maps.DistanceMatrixResponseElement interface

Un seul élément d'une réponse à une requête DistanceMatrixService, qui contient la durée et la distance entre une origine et une destination.

distance
Type : Distance
Distance pour cette association point de départ-destination. Cette propriété n'est peut-être pas définie, car la distance est peut-être inconnue.
duration
Type : Duration
Durée de l'association origine-destination. Cette propriété n'est peut-être pas définie, car sa durée peut être inconnue.
duration_in_traffic
Durée de cette association point de départ-destination, en tenant compte des conditions de trafic indiquées par la propriété trafficModel. Cette propriété peut être undefined, car sa durée peut être inconnue. Disponible uniquement pour les clients du forfait Premium lorsque drivingOptions est défini lors de la demande.
fare
Prix total pour cette association point de départ-destination. Applicable uniquement aux demandes de transports en commun.
status
État de cette association point de départ-destination particulière.

Constantes DistanceMatrixStatus

constantes google.maps.DistanceMatrixStatus

État de niveau supérieur de la requête en général renvoyé par DistanceMatrixService une fois la requête matricielle terminée. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple, 'OK' ou google.maps.DistanceMatrixStatus.OK.

INVALID_REQUEST La requête fournie n'était pas valide.
MAX_DIMENSIONS_EXCEEDED La requête contient plus de 25 origines ou plus de 25 destinations.
MAX_ELEMENTS_EXCEEDED Le produit des origines et des destinations dépasse la limite par requête.
OK La réponse contient un résultat valide.
OVER_QUERY_LIMIT Trop d'éléments ont été demandés au cours de la période autorisée. La requête devrait aboutir si vous réessayez plus tard.
REQUEST_DENIED Le service a refusé l'utilisation du service Distance Matrix par votre page Web.
UNKNOWN_ERROR Une requête Distance Matrix n'a pas pu être traitée en raison d'une erreur du serveur. Si vous essayez à nouveau, la requête pourrait aboutir.

Constantes DistanceMatrixElementStatus

constantes google.maps.DistanceMatrixElementStatus

État au niveau de l'élément concernant une association point de départ/destination renvoyée par DistanceMatrixService une fois la requête d'une matrice de distance terminée. Ces valeurs sont spécifiées sous forme de chaînes, par exemple 'OK'.

NOT_FOUND Le point de départ et/ou la destination de cette association n'ont pas pu être géocodés.
OK La réponse contient un résultat valide.
ZERO_RESULTS Aucun itinéraire trouvé entre le point de départ et la destination.