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.
Constructeur | |
---|---|
ElevationService |
ElevationService() Paramètres : aucun
Crée une instance de ElevationService qui envoie des requêtes d'altitude aux serveurs Google. |
Méthodes | |
---|---|
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:
Valeur renvoyée:
Promise<LocationElevationResponse> 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.
Propriétés | |
---|---|
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
.
Propriétés | |
---|---|
results |
Type:
Array<ElevationResult> 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.
Propriétés | |
---|---|
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 ElevationResult
s espacés uniformément le long du chemin de PathElevationRequest
.
Propriétés | |
---|---|
results |
Type:
Array<ElevationResult> 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 ElevationResult
s.
Propriétés | |
---|---|
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
.
Constantes | |
---|---|
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. |