Elevation

Clase ElevationService

google.maps.ElevationService clase
biblioteca "elevation"

Define una clase de servicio que se comunica directamente con los servidores de Google para solicitar datos de elevación.

const {ElevationService} = await google.maps.importLibrary("elevation");

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 de retorno: 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 de retorno: Promise<LocationElevationResponse> Realiza una solicitud de elevación para una lista de ubicaciones discretas.

Interfaz LocationElevationRequest

Interfaz google.maps.LocationElevationRequest

Una solicitud de elevación enviada por el ElevationService que contiene la lista de coordenadas discretas (LatLng) para las que se deben devolver datos de elevación.

Propiedades
locations opcional	Tipo: Array<LatLng|LatLngLiteral> optional Son las ubicaciones discretas para las que se recuperarán las elevaciones.

Interfaz LocationElevationResponse

Interfaz google.maps.LocationElevationResponse

Es una respuesta de elevación que devuelve el 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 google.maps.PathElevationRequest

Es una consulta de elevación que envía la ElevationService y que contiene la ruta a lo largo de la cual se deben devolver los datos de muestra. Esta solicitud define una ruta continua en 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 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 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 opcional	Tipo: Array<LatLng|LatLngLiteral> optional Es la ruta de acceso a lo largo de la cual se recopilarán los valores de elevación.

Interfaz PathElevationResponse

Interfaz google.maps.PathElevationResponse

Es una respuesta de elevación que muestra el ElevationService y que contiene la lista de ElevationResult espaciados de manera uniforme a lo largo de la ruta de acceso del PathElevationRequest.

Propiedades
results	Tipo: Array<ElevationResult> Es la lista de ElevationResult que coinciden con las muestras de PathElevationRequest.

Interfaz ElevationResult

Interfaz google.maps.ElevationResult

Es el resultado de una solicitud de 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 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 opcional	Tipo: LatLng optional Es la ubicación de este resultado de elevación.

Constantes de ElevationStatus

google.maps.ElevationStatus constantes biblioteca
"elevation"

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.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo ElevationStatusString.

const {ElevationStatus} = await google.maps.importLibrary("elevation");

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 se desconoce el motivo exacto del error.