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.
Llama al const {ElevationService} = await google.maps.importLibrary("elevation")
para acceder.
Consulta Bibliotecas en 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 de devolución:
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 de devolución:
Promise<LocationElevationResponse> Realiza una solicitud de elevación para una lista de ubicaciones discretas. |
Interfaz LocationElevationRequest
Interfaz de google.maps.LocationElevationRequest
Es una solicitud de elevación enviada por el objeto ElevationService
que contiene la lista de coordenadas discretas (LatLng
s) para las que se deben devolver datos de elevación.
Propiedades | |
---|---|
locations optional |
Tipo:
Array<LatLng|LatLngLiteral> optional Son las ubicaciones discretas para las que se recuperarán las elevaciones. |
Interfaz de LocationElevationResponse
Interfaz de google.maps.LocationElevationResponse
Es una respuesta de elevación que devuelve ElevationService
y que contiene la lista de ElevationResult
que coinciden con las ubicaciones de LocationElevationRequest
.
Propiedades | |
---|---|
results |
Tipo:
Array<ElevationResult> Es la lista de objetos ElevationResult que coinciden con las ubicaciones del objeto LocationElevationRequest . |
Interfaz PathElevationRequest
Interfaz de google.maps.PathElevationRequest
Es una consulta de elevación enviada por ElevationService
que contiene la ruta a lo largo de la cual se deben devolver 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 uniformemente espaciadas. Todas las rutas de vértice a vértice 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 los que se recuperarán 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 recopilan los valores de elevación. |
Interfaz PathElevationResponse
Interfaz de google.maps.PathElevationResponse
Es una respuesta de elevación que devuelve el objeto ElevationService
y que contiene la lista de objetos ElevationResult
espaciados de manera uniforme a lo largo de la ruta del objeto PathElevationRequest
.
Propiedades | |
---|---|
results |
Tipo:
Array<ElevationResult> Es la lista de ElevationResult que coinciden con las muestras del PathElevationRequest . |
Interfaz ElevationResult
Interfaz de google.maps.ElevationResult
Es el resultado de una solicitud de 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 varios objetos ElevationResult
.
Propiedades | |
---|---|
elevation |
Tipo:
number Es la elevación de este punto de 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 devuelve ElevationService
cuando se completa una solicitud de elevación. Puedes especificarlos por valor o con el nombre de la constante. Por ejemplo, 'OK'
o google.maps.ElevationStatus.OK
.
Llama al const {ElevationStatus} = await google.maps.importLibrary("elevation")
para acceder.
Consulta Bibliotecas en 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 permiso para usar el servicio de elevación. |
UNKNOWN_ERROR |
No se pudo procesar correctamente la solicitud de elevación, pero se desconoce el motivo exacto del error. |