New pricing changes went into effect on July 16, 2018. For more information, check out the Guide for Existing Users.

Event system

event namespace

google.maps.event namespace

Static Methods
addDomListener
addDomListener(instance, eventName, handler[, capture])
Parameters: 
  • instanceObject
  • eventNamestring
  • handlerFunction
  • capture (optional):  boolean
Return Value:  MapsEventListener
Cross browser event handler registration. This listener is removed by calling removeListener(handle) for the handle that is returned by this function.
addDomListenerOnce
addDomListenerOnce(instance, eventName, handler[, capture])
Parameters: 
  • instanceObject
  • eventNamestring
  • handlerFunction
  • capture (optional):  boolean
Return Value:  MapsEventListener
Wrapper around addDomListener that removes the listener after the first event.
addListener
addListener(instance, eventName, handler)
Parameters: 
  • instanceObject
  • eventNamestring
  • handlerFunction
Return Value:  MapsEventListener
Adds the given listener function to the given event name for the given object instance. Returns an identifier for this listener that can be used with removeListener().
addListenerOnce
addListenerOnce(instance, eventName, handler)
Parameters: 
  • instanceObject
  • eventNamestring
  • handlerFunction
Return Value:  MapsEventListener
Like addListener, but the handler removes itself after handling the first event.
clearInstanceListeners
clearInstanceListeners(instance)
Parameters: 
  • instanceObject
Return Value:  None
Removes all listeners for all events for the given instance.
clearListeners
clearListeners(instance, eventName)
Parameters: 
  • instanceObject
  • eventNamestring
Return Value:  None
Removes all listeners for the given event for the given instance.
removeListener
removeListener(listener)
Parameters: 
Return Value:  None
Removes the given listener, which should have been returned by addListener above. Equivalent to calling listener.remove().
trigger
trigger(instance, eventName, var_args)
Parameters: 
  • instanceObject
  • eventNamestring
  • var_args...*
Return Value:  None
Triggers the given event. All arguments after eventName are passed as arguments to the listeners.

MapsEventListener interface

google.maps.MapsEventListener interface

An event listener, created by google.maps.event.addListener() and friends.

Methods
remove
remove()
Parameters:  None
Return Value:  None
Removes the listener.

Calling listener.remove() is equivalent to google.maps.event.removeListener(listener).

MVCObject class

google.maps.MVCObject class

Base class implementing KVO.

The MVCObject constructor is guaranteed to be an empty function, and so you may inherit from MVCObject by simply writing MySubclass.prototype = new google.maps.MVCObject();. Unless otherwise noted, this is not true of other classes in the API, and inheriting from other classes in the API is not supported.

Constructor
MVCObject
MVCObject()
Parameters:  None
Creates an MVCObject.
Methods
addListener
addListener(eventName, handler)
Parameters: 
  • eventNamestring
  • handlerFunction
Return Value:  MapsEventListener
Adds the given listener function to the given event name. Returns an identifier for this listener that can be used with google.maps.event.removeListener.
bindTo
bindTo(key, target[, targetKey, noNotify])
Parameters: 
  • keystring
  • targetMVCObject
  • targetKey (optional):  string
  • noNotify (optional):  boolean
Return Value:  None
Binds a View to a Model.
get
get(key)
Parameters: 
  • keystring
Return Value:  ?
Gets a value.
notify
notify(key)
Parameters: 
  • keystring
Return Value:  None
Notify all observers of a change on this property. This notifies both objects that are bound to the object's property as well as the object that it is bound to.
set
set(key, value)
Parameters: 
  • keystring
  • value*
Return Value:  None
Sets a value.
setValues
setValues([values])
Parameters: 
  • values (optional):  Object
Return Value:  None
Sets a collection of key-value pairs.
unbind
unbind(key)
Parameters: 
  • keystring
Return Value:  None
Removes a binding. Unbinding will set the unbound property to the current value. The object will not be notified, as the value has not changed.
unbindAll
unbindAll()
Parameters:  None
Return Value:  None
Removes all bindings.

MVCArray class

google.maps.MVCArray<T> class

This class extends MVCObject.

Constructor
MVCArray
MVCArray([array])
Parameters: 
  • array (optional):  Array<T>
A mutable MVC Array.
Methods
clear
clear()
Parameters:  None
Return Value:  None
Removes all elements from the array.
forEach
forEach(callback)
Parameters: 
  • callbackfunction(T, number)
Return Value:  None
Iterate over each element, calling the provided callback. The callback is called for each element like: callback(element, index).
getArray
getArray()
Parameters:  None
Return Value:  Array<T>
Returns a reference to the underlying Array. Warning: if the Array is mutated, no events will be fired by this object.
getAt
getAt(i)
Parameters: 
  • inumber
Return Value:  T
Returns the element at the specified index.
getLength
getLength()
Parameters:  None
Return Value:  number
Returns the number of elements in this array.
insertAt
insertAt(i, elem)
Parameters: 
  • inumber
  • elemT
Return Value:  None
Inserts an element at the specified index.
pop
pop()
Parameters:  None
Return Value:  T
Removes the last element of the array and returns that element.
push
push(elem)
Parameters: 
  • elemT
Return Value:  number
Adds one element to the end of the array and returns the new length of the array.
removeAt
removeAt(i)
Parameters: 
  • inumber
Return Value:  T
Removes an element from the specified index.
setAt
setAt(i, elem)
Parameters: 
  • inumber
  • elemT
Return Value:  None
Sets an element at the specified index.
Events
insert_at
function(index)
Arguments: 
  • indexnumber
This event is fired when insertAt() is called. The event passes the index that was passed to insertAt().
remove_at
function(index, removed)
Arguments: 
  • indexnumber
  • removedT
This event is fired when removeAt() is called. The event passes the index that was passed to removeAt() and the element that was removed from the array.
set_at
function(index, previous)
Arguments: 
  • indexnumber
  • previousT
This event is fired when setAt() is called. The event passes the index that was passed to setAt() and the element that was previously in the array at that index.

Send feedback about...

Maps JavaScript API
Need help? Visit our support page.