Anúncio:em breve, a Plataforma Google Maps vai ter um novo estilo de mapa de base. Essa atualização inclui uma nova paleta de cores padrão, pinos modernizados e melhorias nas experiências de mapa e na usabilidade. Todos os estilos de mapa serão atualizados automaticamente em março de 2025. Para mais informações sobre a disponibilidade e como ativar logo, consulte Novo estilo de mapa para a Plataforma Google Maps.

Esta página foi traduzida pela API Cloud Translation.

Elevation Widget (alpha)

Classe ElevationElement

Classe google.maps.elevation.ElevationElement

Um elemento HTML que mostra visualmente os dados de elevação. Defina a propriedade path do elemento para mostrar um gráfico de elevação ao longo do caminho. Para usar o elemento de elevação, ative a API Places UI Kit para seu projeto no console do Google Cloud.

Elemento personalizado:
<gmp-elevation unit-system="imperial"></gmp-elevation>

Essa classe estende HTMLElement.

Essa classe implementa ElevationElementOptions.

Acesse chamando const {ElevationElement} = await google.maps.importLibrary("elevation"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
`ElevationElement`	`ElevationElement([options])` Parâmetros: `options`: `ElevationElementOptions optional`

Propriedades
`path`	Tipo:`Array<LatLng\|LatLngLiteral\|LatLngAltitude> optional` O caminho para mostrar os dados de elevação. Os segmentos de linha serão interpolados entre os pontos da matriz. Mesmo um pequeno número de pontos ainda vai produzir um gráfico de elevação detalhado. Se apenas um ponto for fornecido, o widget vai mostrar o número de elevação desse ponto.
`unitSystem`	Tipo:`UnitSystem optional` Determina se a elevação será mostrada em pés/milhas ou metros/km. Se não for definido, o widget vai usar o sistema de unidades preferido para a região especificada no carregador de API. Atributo HTML: `<gmp-elevation unit-system="imperial"></gmp-elevation>` `<gmp-elevation unit-system="metric"></gmp-elevation>`

Métodos
`addEventListener`	Aviso:disponível apenas no canal v=beta. `addEventListener(type, listener[, options])` Parâmetros: `type`: `string` uma string que diferencia maiúsculas de minúsculas que representa o tipo de evento a ser detectado. `listener`: `EventListener\|EventListenerObject` O objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent. `options`: `boolean\|AddEventListenerOptions optional` Consulte as opções. Os eventos personalizados só são compatíveis com `capture` e `passive`. Valor de retorno:`void` Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
`removeEventListener`	Aviso:disponível apenas no canal v=beta. `removeEventListener(type, listener[, options])` Parâmetros: `type`: `string` Uma string que especifica o tipo de evento para remover um listener de eventos. `listener`: `EventListener\|EventListenerObject` O listener de eventos do gerenciador de eventos a ser removido do destino do evento. `options`: `boolean\|EventListenerOptions optional` Consulte as opções. Valor de retorno:`void` Remove um listener de eventos registrado anteriormente com addEventListener do destino. Consulte removeEventListener.

Métodos

addEventListener

addEventListener(type, listener[, options])

Parâmetros:

type: string uma string que diferencia maiúsculas de minúsculas que representa o tipo de evento a ser detectado.
listener: EventListener|EventListenerObject O objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
options: boolean|AddEventListenerOptions optional Consulte as opções. Os eventos personalizados só são compatíveis com capture e passive.

Valor de retorno:void

Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.

removeEventListener

removeEventListener(type, listener[, options])

Parâmetros:

type: string Uma string que especifica o tipo de evento para remover um listener de eventos.
listener: EventListener|EventListenerObject O listener de eventos do gerenciador de eventos a ser removido do destino do evento.
options: boolean|EventListenerOptions optional Consulte as opções.

Valor de retorno:void

Remove um listener de eventos registrado anteriormente com addEventListener do destino. Consulte removeEventListener.

Eventos
`gmp-load`	`function(event)` Argumentos: `event`: `Event` Esse evento é acionado quando o elemento carrega e renderiza o conteúdo. Esse evento não é transmitido.
`gmp-requesterror`	`function(event)` Argumentos: `event`: `Event` Esse evento é acionado quando uma solicitação ao back-end é negada (por exemplo, chave de API incorreta). Esse evento não é transmitido.

Interface ElevationElementOptions

Interface google.maps.elevation.ElevationElementOptions

Opções para ElevationElement.

Propriedades
`path optional`	Tipo:`Array<LatLng\|LatLngLiteral> optional` Ver `ElevationElement.path`
`unitSystem optional`	Tipo:`UnitSystem optional` Ver `ElevationElement.unitSystem`