Elevation

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

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.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {ElevationService} = await google.map.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>
Exécute une requête d'altitude le long d'un trajet, 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:
Exécute une requête d'altitude pour une liste d'emplacements distincts.

Interface LocationElevationRequest

google.maps.LocationElevationRequest interface

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

locations optional
Type:Array<LatLng|LatLngLiteral> optional
Lieux distincts pour lesquels récupérer des altitudes.

Interface LocationElevationResponse

google.maps.LocationElevationResponse interface

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

results
Liste des ElevationResult correspondant aux emplacements de LocationElevationRequest.

Interface PathElevationRequest

google.maps.PathElevationRequest interface

Une requête d'altitude envoyée par ElevationService contenant le chemin le long duquel renvoyer des échantillons de données. Cette requête définit un tracé continu le long de la Terre, selon lequel les échantillons de dénivelé doivent être prélevés à distance égale. Tous les tracés allant du sommet au sommet utilisent des segments du grand cercle entre ces deux points.

samples
Type:number
Obligatoire. Nombre de points équidistants sur le tracé donné pour lesquels extraire des 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
Chemin le long duquel collecter des valeurs d'altitude.

Interface PathElevationResponse

google.maps.PathElevationResponse interface

Une réponse d'altitude renvoyée par ElevationService contenant la liste des ElevationResults espacés uniformément le long du chemin de PathElevationRequest.

results
Liste des ElevationResult correspondant aux exemples de PathElevationRequest.

Interface ElevationResult

google.maps.ElevationResult interface

Résultat d'une requête ElevationService composée de l'ensemble des coordonnées d'altitude et de leurs valeurs d'altitude. Notez qu'une seule requête peut générer plusieurs ElevationResults.

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 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 lors du traitement d'une requête d'altitude. Spécifiez ces valeurs par valeur ou en utilisant le nom de la constante. Par exemple, 'OK' ou google.maps.ElevationStatus.OK.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {ElevationStatus} = await google.map.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é le nombre maximal de requêtes trop rapidement.
REQUEST_DENIED La page Web n'est pas autorisée à utiliser le service Elevation.
UNKNOWN_ERROR La demande d'altitude n'a pas pu être traitée, mais la raison exacte de l'échec n'est pas connue.