Clase ElevationService
Clase google.maps.ElevationService
Define una clase de servicio que se comunica directamente con los servidores de Google para solicitar datos de elevación.
Para acceder, llama a const {ElevationService} = await google.maps.importLibrary("elevation")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constructor | |
---|---|
ElevationService |
ElevationService() Parámetros: Ninguno
Crea una instancia nueva de un ElevationService que envía consultas de elevación a los servidores de Google. |
Métodos | |
---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback]) Parámetros:
Valor que se muestra:
Promise<PathElevationResponse> Realiza una solicitud de elevación a lo largo de una ruta, en la que los datos de elevación se muestran como muestras basadas en la distancia a lo largo de esa ruta. |
getElevationForLocations |
getElevationForLocations(request[, callback]) Parámetros:
Valor que se muestra:
Promise<LocationElevationResponse> Realiza una solicitud de elevación para una lista de ubicaciones discretas. |
Interfaz LocationElevationRequest
Interfaz de google.maps.LocationElevationRequest
Una solicitud de elevación que envía ElevationService
y que contiene la lista de coordenadas discretas (LatLng
) para las que se deben mostrar los datos de elevación.
Propiedades | |
---|---|
locations optional |
Tipo:
Array<LatLng|LatLngLiteral> optional Las ubicaciones discretas para las que se deben recuperar las elevaciones. |
Interfaz LocationElevationResponse
Interfaz de google.maps.LocationElevationResponse
Una respuesta de elevación que muestra ElevationService
y que contiene la lista de ElevationResult
que coinciden con las ubicaciones de LocationElevationRequest
.
Propiedades | |
---|---|
results |
Tipo:
Array<ElevationResult> Es la lista de ElevationResult que coinciden con las ubicaciones de LocationElevationRequest . |
Interfaz PathElevationRequest
Interfaz de google.maps.PathElevationRequest
Una consulta de elevación que envía ElevationService
y que contiene la ruta a lo largo de la cual se muestran los datos muestreados. Esta solicitud define una ruta continua a lo largo de la Tierra a lo largo de la cual se deben tomar muestras de elevación a distancias espaciadas de manera uniforme. Todas las rutas de un vértice a otro usan segmentos del círculo máximo entre esos dos puntos.
Propiedades | |
---|---|
samples |
Tipo:
number Obligatorio. Es la cantidad de puntos equidistantes a lo largo de la ruta determinada para la que se recuperarán los datos de elevación, incluidos los extremos. La cantidad de muestras debe ser un valor entre 2 y 512 inclusive. |
path optional |
Tipo:
Array<LatLng|LatLngLiteral> optional Es la ruta a lo largo de la cual se deben recopilar los valores de elevación. |
Interfaz PathElevationResponse
Interfaz de google.maps.PathElevationResponse
Una respuesta de elevación que muestra ElevationService
y que contiene la lista de ElevationResult
espaciados de manera uniforme a lo largo de la ruta de PathElevationRequest
.
Propiedades | |
---|---|
results |
Tipo:
Array<ElevationResult> Es la lista de ElevationResult que coinciden con los samples de PathElevationRequest . |
Interfaz ElevationResult
Interfaz de google.maps.ElevationResult
Es el resultado de una solicitud ElevationService
, que consiste en el conjunto de coordenadas de elevación y sus valores de elevación. Ten en cuenta que una sola solicitud puede producir varios ElevationResult
.
Propiedades | |
---|---|
elevation |
Tipo:
number Es la elevación de este punto en la Tierra, en metros sobre el nivel del mar. |
resolution |
Tipo:
number Es la distancia, en metros, entre los puntos de muestra a partir de los cuales se interpoló la elevación. Esta propiedad estará ausente si se desconoce la resolución. Ten en cuenta que los datos de elevación se vuelven menos precisos (valores de resolution mayores) cuando se pasan varios puntos. Para obtener el valor de elevación más preciso para un punto, deben realizarse consultas independientes. |
location optional |
Tipo:
LatLng optional Es la ubicación de este resultado de elevación. |
Constantes de ElevationStatus
Constantes de google.maps.ElevationStatus
Es el estado que muestra ElevationService
cuando se completa una solicitud de elevación. Especifica estos valores por valor o con el nombre de la constante. Por ejemplo, 'OK'
o google.maps.ElevationStatus.OK
.
Para acceder, llama a const {ElevationStatus} = await google.maps.importLibrary("elevation")
. Consulta Bibliotecas de la API de Maps JavaScript.
Constantes | |
---|---|
INVALID_REQUEST |
La solicitud no era válida. |
OK |
La solicitud no encontró ningún error. |
OVER_QUERY_LIMIT |
La página web superó el límite de solicitudes en un período demasiado corto. |
REQUEST_DENIED |
La página web no tiene permitido usar el servicio de elevación. |
UNKNOWN_ERROR |
No se pudo procesar correctamente la solicitud de elevación, pero no se conoce el motivo exacto de la falla. |