Elevation

Classe ElevationService

Classe google.maps.ElevationService

Définit une classe de service qui communique directement avec les serveurs Google pour demander des données d'altitude.

Accédez-y en appelant const {ElevationService} = await google.maps.importLibrary("elevation"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur
ElevationService	ElevationService() Paramètres:aucun Crée une instance d'un ElevationService qui envoie des requêtes d'élévation aux serveurs Google.

Méthodes
getElevationAlongPath	getElevationAlongPath(request[, callback]) Paramètres: request:  PathElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional Valeur renvoyée:Promise<PathElevationResponse> Envoie une requête d'altitude le long d'un tracé, où les données d'altitude sont renvoyées sous forme d'échantillons basés sur la distance le long de ce tracé.
getElevationForLocations	getElevationForLocations(request[, callback]) Paramètres: request:  LocationElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional Valeur renvoyée:Promise<LocationElevationResponse> Envoie une requête d'altitude pour une liste d'emplacements distincts.

Interface LocationElevationRequest

Interface google.maps.LocationElevationRequest

Requête d'altitude envoyée par le ElevationService contenant la liste des coordonnées discrètes (LatLng) pour lesquelles renvoyer les données d'altitude.

Propriétés
locations optional	Type:Array<LatLng|LatLngLiteral> optional Emplacements distincts pour lesquels récupérer les altitudes.

Interface LocationElevationResponse

Interface google.maps.LocationElevationResponse

Réponse d'élévation renvoyée par ElevationService contenant la liste des ElevationResult correspondant aux emplacements de LocationElevationRequest.

Propriétés
results	Type:Array<ElevationResult> Liste des ElevationResult correspondant aux emplacements des LocationElevationRequest.

Interface PathElevationRequest

Interface google.maps.PathElevationRequest

Requête d'altitude envoyée par le ElevationService contenant le tracé sur lequel renvoyer les données échantillonnées. Cette requête définit un tracé continu sur la Terre, le long duquel des échantillons d'altitude doivent être collectés à des distances régulières. Tous les chemins d'un sommet à un autre utilisent des segments du grand cercle entre ces deux points.

Propriétés
samples	Type:number Obligatoire. Nombre de points équidistants le long du chemin donné pour lesquels récupérer des données d'altitude, y compris les points de terminaison. Le nombre d'échantillons doit être compris entre 2 et 512 (inclus).
path optional	Type:Array<LatLng|LatLngLiteral> optional Chemin d'accès pour collecter les valeurs d'altitude.

Interface PathElevationResponse

Interface google.maps.PathElevationResponse

Réponse d'altitude renvoyée par le ElevationService contenant la liste des ElevationResult espacées uniformément le long du tracé du PathElevationRequest.

Propriétés
results	Type:Array<ElevationResult> Liste des ElevationResult correspondant aux exemples de l'PathElevationRequest.

Interface ElevationResult

Interface google.maps.ElevationResult

Résultat d'une requête ElevationService, composé de l'ensemble des coordonnées d'altitude et de leurs valeurs d'altitude. Notez qu'une seule requête peut produire plusieurs ElevationResult.

Propriétés
elevation	Type:number Élévation de ce point sur Terre, en mètres au-dessus du niveau de la mer.
resolution	Type:number Distance, en mètres, entre les points d'échantillonnage à partir desquels l'altitude a été interpolée. Cette propriété est omise si la résolution n'est pas connue. Notez que les données d'altitude sont moins précises (valeurs resolution plus élevées) lorsque plusieurs points sont transmis. Pour obtenir la valeur d'altitude la plus précise possible pour un point, vous devez effectuer une requête indépendante.
location optional	Type:LatLng optional Emplacement de ce résultat d'altitude.

Constantes ElevationStatus

Constantes google.maps.ElevationStatus

État renvoyé par ElevationService à la fin d'une requête d'élevation. Spécifiez-les par valeur ou en utilisant le nom de la constante. (par exemple, 'OK' ou google.maps.ElevationStatus.OK).

Accédez-y en appelant const {ElevationStatus} = await google.maps.importLibrary("elevation"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constantes
INVALID_REQUEST	La requête n'est pas valide
OK	Aucune erreur n'a été détectée lors de la requête.
OVER_QUERY_LIMIT	La page Web a dépassé la limite de requêtes sur une période trop courte.
REQUEST_DENIED	La page Web n'est pas autorisée à utiliser le service d'élévation.
UNKNOWN_ERROR	La requête d'élévation n'a pas pu être traitée, mais la raison exacte de l'échec est inconnue.