Elevation

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 el artículo Bibliotecas de la API de Maps JavaScript.

ElevationService
ElevationService()
Parámetros: Ninguno
Crea una instancia nueva de un ElevationService que envía consultas de elevación a los servidores de Google.
getElevationAlongPath
getElevationAlongPath(request[, callback])
Parámetros: 
Valor que se devuelve:  Promise<PathElevationResponse>
Realiza una solicitud de elevación a lo largo de una ruta, en la que los datos de elevación se devuelven como muestras basadas en la distancia a lo largo de esa ruta.
getElevationForLocations
getElevationForLocations(request[, callback])
Parámetros: 
Valor que se devuelve:  Promise<LocationElevationResponse>
Realiza una solicitud de elevación para una lista de ubicaciones discretas.

LocationElevationRequest

Interfaz de google.maps.LocationElevationRequest

Una solicitud de elevación enviada por ElevationService, que contiene la lista de coordenadas discretas (LatLng) para las que se muestran datos de elevación

locations optional
Tipo:  Array<LatLng|LatLngLiteral> optional
Las ubicaciones discretas para las que se deben recuperar elevaciones.

LocationElevationResponse

Interfaz de google.maps.LocationElevationResponse

Es una respuesta de elevación que muestra ElevationService y que contiene la lista de ElevationResult que coinciden con las ubicaciones del LocationElevationRequest.

results
La lista de ElevationResult que coinciden con las ubicaciones de LocationElevationRequest.

PathElevationRequest

Interfaz de google.maps.PathElevationRequest

Una consulta de elevación enviada por ElevationService, que contiene la ruta de acceso para mostrar los datos de muestra. Esta solicitud define un recorrido continuo a lo largo de la Tierra a lo largo del cual se deben tomar muestras de elevación a distancias distribuidas de manera uniforme. Todas las rutas, desde el vértice hasta el vértice, usan segmentos del círculo mayor entre esos dos puntos.

samples
Tipo:  number
Obligatorio. La cantidad de puntos equidistantes a lo largo de la ruta determinada para los que se deben recuperar los datos de elevación, incluidos los puntos finales. El número de muestras debe ser un valor entre 2 y 512, inclusive.
path optional
Tipo:  Array<LatLng|LatLngLiteral> optional
Ruta por la que se recopilarán valores de elevación.

PathElevationResponse

Interfaz de google.maps.PathElevationResponse

Una respuesta de elevación que muestra el objeto ElevationService y que contiene la lista de objetos ElevationResult distribuidos de manera uniforme a lo largo de la ruta del elemento PathElevationRequest.

results
La lista de ElevationResult que coinciden con las muestras de PathElevationRequest.

ElevationResult

Interfaz de google.maps.ElevationResult

Es el resultado de una solicitud ElevationService, que consta del conjunto de coordenadas de elevación y sus valores de elevación. Ten en cuenta que una sola solicitud puede producir varias ElevationResult.

elevation
Tipo:  number
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 la cual 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 más toscos (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 ElevationStatus

Constantes google.maps.ElevationStatus

Es el estado que muestra ElevationService cuando se completa una solicitud de elevación. Especifícalas 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 el artículo Bibliotecas de la API de Maps JavaScript.

INVALID_REQUEST La solicitud no era válida.
OK No se encontraron errores en la solicitud.
OVER_QUERY_LIMIT La página web excedió el límite de solicitudes en un período demasiado corto.
REQUEST_DENIED La página web no puede usar el servicio de elevación.
UNKNOWN_ERROR La solicitud de elevación no se pudo procesar correctamente, pero se desconoce el motivo exacto de la falla.