Classe DistanceMatrixService
Classe google.maps.DistanceMatrixService
Service permettant de calculer les distances entre plusieurs destinations et destinations
Lorsque vous utilisez v=beta
, vous pouvez y accéder en appelant const {DistanceMatrixService} = await google.map.importLibrary("routes")
. Consultez Bibliothèques dans l'API Maps JavaScript.
Constructeur | |
---|---|
DistanceMatrixService |
DistanceMatrixService() Paramètres : aucun
Crée une instance de DistanceMatrixService qui envoie des requêtes de matrice de distance aux serveurs Google. |
Méthodes | |
---|---|
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 points de départ et de destination, ainsi que différentes options de calcul des 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 auxquels calculer la distance et la durée. Obligatoire. |
origins |
Type :
Array<string|LatLng|LatLngLiteral|Place> Tableau contenant des chaînes d'adresse d'origine, ou des objets LatLng ou Place à partir desquels calculer la distance et l'heure. Obligatoire. |
travelMode |
Type :
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 , le service Distance Matrix est demandé pour éviter les autoroutes lorsque cela est possible. Facultatif. |
avoidTolls optional |
Type :
boolean optional Si la valeur est true , le service Distance Matrix évite 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 pour lesquelles la valeur de travelMode est DRIVING . Cet objet n'aura aucun effet pour 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 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 ) alors 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 ne s'appliquent qu'aux requêtes pour lesquelles la valeur de travelMode est TRANSIT. Cet objet n'aura aucun effet pour les autres modes de transport. |
unitSystem optional |
Type:
UnitSystem optional Système d'unités préféré à utiliser pour afficher 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 formatées, ainsi que d'une séquence de DistanceMatrixResponseRow
, une pour chaque adresse d'origine correspondante.
Propriétés | |
---|---|
destinationAddresses |
Type :
Array<string> Adresses de destination formatées. |
originAddresses |
Type :
Array<string> Adresses d'origine formatées. |
rows |
Lignes de la matrice, correspondant aux adresses d'origine. |
Interface DistanceMatrixResponseRow
google.maps.DistanceMatrixResponseRow
interface
Une 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> Les é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.
Propriétés | |
---|---|
distance |
Type :
Distance Distance pour cette association point de départ-destination. Il est possible que cette propriété ne soit pas définie, car la distance peut être inconnue. |
duration |
Type:
Duration Durée de l'association origine-destination. Il est possible que cette propriété ne soit pas définie, car la durée soit inconnue. |
duration_in_traffic |
Type :
Duration Durée pour cette association point de départ-destination, en tenant compte des conditions de circulation indiquées par la propriété trafficModel . Cette propriété peut être undefined , car la durée peut être inconnue. Disponible uniquement pour les clients du forfait Premium lorsque drivingOptions est défini lors de la demande. |
fare |
Type:
TransitFare Tarif total pour cette association point de départ-destination. Uniquement applicable aux requêtes de transport en commun. |
status |
Type :
DistanceMatrixElementStatus É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
à la fin d'une requête de matrice de distance. Spécifiez ces valeurs par valeur ou en utilisant le nom de la constante. Par exemple, 'OK'
ou google.maps.DistanceMatrixStatus.OK
.
Lorsque vous utilisez v=beta
, vous pouvez y accéder en appelant const {DistanceMatrixStatus} = await google.map.importLibrary("routes")
. Consultez Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
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 d'origine et de destination dépasse la limite par requête. |
OK |
La réponse contient un résultat valide. |
OVER_QUERY_LIMIT |
Vous avez demandé trop d'éléments 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 paire point de départ-destination renvoyée par le DistanceMatrixService
à la fin d'une requête de matrice de distance. Ces valeurs sont spécifiées sous forme de chaînes (par exemple, 'OK'
).
Lorsque vous utilisez v=beta
, vous pouvez y accéder en appelant const {DistanceMatrixElementStatus} = await google.map.importLibrary("routes")
. Consultez Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
NOT_FOUND |
Impossible de géocoder l'origine et/ou la destination de cette association. |
OK |
La réponse contient un résultat valide. |
ZERO_RESULTS |
Impossible de trouver un itinéraire entre le point de départ et la destination. |