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.
Cuando se usa v=beta
, se puede acceder a él llamando a const {ElevationService} = await google.map.importLibrary("elevation")
. 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 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 la 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. |
LocationElevationRequest
Interfaz de google.maps.LocationElevationRequest
Una solicitud de elevación enviada por ElevationService
, que contenga una lista de coordenadas discretas (LatLng
) para las cuales se deben mostrar datos de elevación.
Propiedades | |
---|---|
locations optional |
Tipo:
Array<LatLng|LatLngLiteral> optional Las ubicaciones discretas para las que se recuperarán las elevaciones. |
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> La lista de ElevationResult que coincide 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 con la que se mostrarán los datos de la muestra. 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. Todos los trayectos desde el vértice hasta el vértice utilizan segmentos del gran círculo entre esos dos puntos.
Propiedades | |
---|---|
samples |
Tipo:
number Obligatorio. Cantidad de puntos equidistantes de la ruta de acceso determinada para la cual 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 Ruta de acceso para recopilar valores de elevación. |
PathElevationResponse
Interfaz de google.maps.PathElevationResponse
Una respuesta de elevación que muestra el ElevationService
, que contiene la lista de objetos ElevationResult
distribuidos de forma uniforme a lo largo de la ruta del objeto PathElevationRequest
.
Propiedades | |
---|---|
results |
Tipo:
Array<ElevationResult> La lista de ElevationResult que coincide con las muestras de PathElevationRequest . |
ElevationResult
Interfaz de google.maps.ElevationResult
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 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 La distancia, en metros, entre los puntos de ejemplo 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 más toscos (valores 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 La ubicación de este resultado de elevación. |
Constantes de ElevationStatus
google.maps.ElevationStatus
constantes
El estado que muestra ElevationService
cuando se completa una solicitud de elevación. Especifícalos por valor o usa el nombre de la constante. Por ejemplo, 'OK'
o google.maps.ElevationStatus.OK
.
Cuando se usa v=beta
, se puede acceder a él llamando a const {ElevationStatus} = await google.map.importLibrary("elevation")
. 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 excedió el límite de solicitudes en un período demasiado corto. |
REQUEST_DENIED |
La página web no puede utilizar el servicio de elevación. |
UNKNOWN_ERROR |
La solicitud de elevación no se pudo procesar correctamente, pero se desconoce el motivo exacto del error. |