Elevation

Classe ElevationService

Classe google.maps.ElevationService

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

Pour y accéder, appelez const {ElevationService} = await google.maps.importLibrary("elevation"). Consultez Bibliothèques dans l'API Maps JavaScript.

ElevationService
ElevationService()
Paramètres:aucun
Crée une instance de ElevationService qui envoie des requêtes d'altitude aux serveurs Google.
getElevationAlongPath
getElevationAlongPath(request[, callback])
Paramètres: 
Valeur renvoyée:  Promise<PathElevationResponse>
Effectue une requête d'altitude le long d'un tracé. 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: 
Valeur renvoyée:  Promise<LocationElevationResponse>
Exécute une requête d'altitude pour une liste de lieux discrets.

Interface LocationElevationRequest

Interface google.maps.LocationElevationRequest

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

locations optional
Type:Array<LatLng|LatLngLiteral> optional
Lieux discrets pour lesquels extraire des altitudes.

Interface LocationElevationResponse

Interface google.maps.LocationElevationResponse

Réponse d'altitude renvoyée par le ElevationService, contenant la liste des ElevationResult correspondant aux emplacements des LocationElevationRequest.

results
Liste des ElevationResult correspondant aux emplacements de LocationElevationRequest.

Interface PathElevationRequest

Interface google.maps.PathElevationRequest

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

samples
Type:number
Obligatoire. Nombre de points équidistants le long du tracé donné pour lesquels extraire les données d'altitude, y compris les extrémités. Le nombre d'échantillons doit être une valeur comprise entre 2 et 512 inclus.
path optional
Type:Array<LatLng|LatLngLiteral> optional
Trajet le long duquel collecter les valeurs d'altitude.

Interface PathElevationResponse

Interface google.maps.PathElevationResponse

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

results
Liste des ElevationResult correspondant aux échantillons de PathElevationRequest.

Interface ElevationResult

Interface google.maps.ElevationResult

Résultat d'une requête ElevationService, constitué de l'ensemble des coordonnées d'altitude et de leurs valeurs d'altitude. Notez qu'une même requête peut générer plusieurs ElevationResult.

elevation
Type:number
Altitude 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 deviennent plus grossières (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 de la demande d'altitude. Spécifiez-les à l'aide d'une valeur ou du nom de la constante. (par exemple, 'OK' ou google.maps.ElevationStatus.OK).

Pour y accéder, appelez const {ElevationStatus} = await google.maps.importLibrary("elevation"). Consultez Bibliothèques dans l'API Maps JavaScript.

INVALID_REQUEST La requête n'est pas valide
OK La requête n'a rencontré aucune erreur.
OVER_QUERY_LIMIT La page Web a dépassé la limite de requêtes en trop peu de temps.
REQUEST_DENIED La page Web n'est pas autorisée à utiliser le service Elevation.
UNKNOWN_ERROR La demande d'élévation n'a pas pu être traitée, mais la raison exacte de l'échec n'est pas connue.