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.

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:  request:  PathElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional 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:  request:  LocationElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional 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

Propiedades
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.

Propiedades
results	Tipo:  Array<ElevationResult> 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.

Propiedades
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.

Propiedades
results	Tipo:  Array<ElevationResult> 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.

Propiedades
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.

Constantes
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.