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.

Event system

Classe event

Classe google.maps.event

Namespace para todas as funções de evento públicas

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

Métodos estáticos
`addListener`	`addListener(instance, eventName, handler)` Parâmetros: `instance`: `Object` `eventName`: `string` `handler`: `Function` Valor de retorno:`MapsEventListener` Adiciona a função de escuta especificada ao nome de evento especificado para a instância de objeto especificada. Retorna um identificador para essa escuta que pode ser usado com removeListener().
`addListenerOnce`	`addListenerOnce(instance, eventName, handler)` Parâmetros: `instance`: `Object` `eventName`: `string` `handler`: `Function` Valor de retorno:`MapsEventListener` Semelhante ao addListener, mas o manipulador é removido sozinho após manipular o primeiro evento.
`clearInstanceListeners`	`clearInstanceListeners(instance)` Parâmetros: `instance`: `Object` Valor de retorno:`void` Remove todas as escutas de todos os eventos para a instância especificada.
`clearListeners`	`clearListeners(instance, eventName)` Parâmetros: `instance`: `Object` `eventName`: `string` Valor de retorno:`void` Remove todas as escutas do evento especificado da instância especificada.
`hasListeners`	`hasListeners(instance, eventName)` Parâmetros: `instance`: `Object` `eventName`: `string` Valor de retorno:`boolean` Retorna se há listeners para o evento especificado na instância. Pode ser usado para salvar o cálculo de detalhes de eventos caros.
`removeListener`	`removeListener(listener)` Parâmetros: `listener`: `MapsEventListener` Valor de retorno:`void` Remove a escuta especificada, que deve ter sido retornada pelo addListener descrito anteriormente. É equivalente a chamar `listener.remove()`.
`trigger`	`trigger(instance, eventName, eventArgs)` Parâmetros: `instance`: `Object` `eventName`: `string` `eventArgs`: `...?` Valor de retorno:`void` Dispara o evento especificado. Todos os argumentos após eventName são passados como argumentos para as escutas.
`addDomListener`	Descontinuado:o uso de `google.maps.event.addDomListener()` foi suspenso. Use o método addEventListener() padrão. O recurso vai continuar funcionando, e não há planos de desativação. `addDomListener(instance, eventName, handler[, capture])` Parâmetros: `instance`: `Object` `eventName`: `string` `handler`: `Function` `capture`: `boolean optional` Valor de retorno:`MapsEventListener` Registro de manipulador de evento de navegador cruzado. Esta escuta é removida chamando removeListener(handle) para o manipulador retornado por essa função.
`addDomListenerOnce`	Descontinuado:o uso de `google.maps.event.addDomListenerOnce()` foi suspenso. Use o método addEventListener() padrão. O recurso vai continuar funcionando, e não há planos de desativação. `addDomListenerOnce(instance, eventName, handler[, capture])` Parâmetros: `instance`: `Object` `eventName`: `string` `handler`: `Function` `capture`: `boolean optional` Valor de retorno:`MapsEventListener` O empacotador de addDomListener que remove a escuta após o primeiro evento.

Interface MapsEventListener

Interface google.maps.MapsEventListener

Um listener de eventos criado por google.maps.event.addListener() e amigos.

Métodos
`remove`	`remove()` Parâmetros:nenhum Valor de retorno:`void` Remove o listener. Chamar `listener.remove()` é equivalente a `google.maps.event.removeListener(listener)`.

Classe MVCObject

Classe google.maps.MVCObject

Classe base que implementa KVO.

O construtor MVCObject é garantido como uma função vazia. Portanto, você pode herdar de MVCObject escrevendo MySubclass.prototype = new google.maps.MVCObject();. A menos que indicado de outra forma, isso não é verdadeiro para outras classes na API, e não é possível herdar de outras classes na API.

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

Construtor
`MVCObject`	`MVCObject()` Parâmetros:nenhum Cria um `MVCObject`.

Métodos
`addListener`	`addListener(eventName, handler)` Parâmetros: `eventName`: `string` `handler`: `Function` Valor de retorno:`MapsEventListener` Adiciona a função de listener especificada ao nome do evento especificado. Retorna um identificador para esse listener que pode ser usado com `google.maps.event.removeListener`.
`bindTo`	`bindTo(key, target[, targetKey, noNotify])` Parâmetros: `key`: `string` `target`: `MVCObject` `targetKey`: `string optional` `noNotify`: `boolean optional` Valor de retorno:nenhum Vincula uma visualização a um modelo.
`get`	`get(key)` Parâmetros: `key`: `string` Valor de retorno:`?` Obtém um valor.
`notify`	`notify(key)` Parâmetros: `key`: `string` Valor de retorno:nenhum Notifica todos os observadores sobre uma alteração nesta propriedade. Este método notifica os objetos que estão vinculados à propriedade do objeto, bem como o objeto ao qual ela está vinculada.
`set`	`set(key, value)` Parâmetros: `key`: `string` `value`: `` Valor de retorno*:nenhum Define um valor.
`setValues`	`setValues([values])` Parâmetros: `values`: `Object optional` Valor de retorno:nenhum Define uma coleção de pares de chave e valor.
`unbind`	`unbind(key)` Parâmetros: `key`: `string` Valor de retorno:nenhum Remove um vínculo. Essa remoção definirá a propriedade sem vínculo com o valor atual. Como o valor não foi alterado, o objeto não será notificado.
`unbindAll`	`unbindAll()` Parâmetros:nenhum Valor de retorno:nenhum Remove todos os vínculos.

Classe MVCArray

Classe google.maps.MVCArray<T>

Essa classe estende MVCObject.

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

Construtor
`MVCArray`	`MVCArray([array])` Parâmetros: `array`: `Array<T> optional` Uma matriz mutável de MVCs.

Métodos
`clear`	`clear()` Parâmetros:nenhum Valor de retorno:nenhum Remove todos os elementos da matriz.
`forEach`	`forEach(callback)` Parâmetros: `callback`: `function(T, number): void` Valor de retorno:nenhum Itera em cada elemento, chamando o retorno de chamada fornecido. O retorno de chamada é chamado para cada elemento, como: retorno de chamada(elemento, índice).
`getArray`	`getArray()` Parâmetros:nenhum Valor de retorno:`Array<T>` Retorna uma referência à matriz subjacente. Aviso: se a matriz for alterada, nenhum evento será acionado por este objeto.
`getAt`	`getAt(i)` Parâmetros: `i`: `number` Valor de retorno:`T` Retorna o elemento no índice especificado.
`getLength`	`getLength()` Parâmetros:nenhum Valor de retorno:`number` Retorna o número de elementos nesta matriz.
`insertAt`	`insertAt(i, elem)` Parâmetros: `i`: `number` `elem`: `T` Valor de retorno:nenhum Insere um elemento no índice especificado.
`pop`	`pop()` Parâmetros:nenhum Valor de retorno:`T` Remove o último elemento da matriz e retorna esse elemento.
`push`	`push(elem)` Parâmetros: `elem`: `T` Valor de retorno:`number` Adiciona um elemento ao final da matriz e retorna o novo tamanho da matriz.
`removeAt`	`removeAt(i)` Parâmetros: `i`: `number` Valor de retorno:`T` Remove um elemento do índice especificado.
`setAt`	`setAt(i, elem)` Parâmetros: `i`: `number` `elem`: `T` Valor de retorno:nenhum Define um elemento no índice especificado.
Herdado: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Eventos
`insert_at`	`function(index)` Argumentos: `index`: `number` Esse evento é acionado quando `insertAt()` é chamado. O evento transmite o índice transmitido para `insertAt()`.
`remove_at`	`function(index, removed)` Argumentos: `index`: `number` `removed`: `T` O elemento removido da matriz em `index`. Esse evento é acionado quando `removeAt()` é chamado. O evento transmite o índice transmitido para `removeAt()` e o elemento removido da matriz.
`set_at`	`function(index, previous)` Argumentos: `index`: `number` `previous`: `T` O elemento que estava na matriz em `index`. Esse evento é acionado quando `setAt()` é chamado. O evento transmite o índice transmitido para `setAt()` e o elemento que estava anteriormente na matriz nesse índice.

Interface ErrorEvent

Interface google.maps.ErrorEvent

Um evento com um erro associado.

Propriedades
`error`	Tipo:`Error` O erro relacionado ao evento.

Event system

Classe event

Métodos estáticos

Interface MapsEventListener

Métodos

Classe MVCObject

Construtor

Métodos

Classe MVCArray

Construtor

Métodos

Eventos

Interface ErrorEvent

Propriedades