Summary: Nested Classes | Constants | Methods | Inherited Methods | [Expand All]
public final class

# GoogleMap

extends Object

java.lang.Object
↳ | com.google.android.gms.maps.GoogleMap

## Class Overview

This is the main class of the Google Maps Android API and is the entry point for all methods related to the map. You cannot instantiate a `GoogleMap` object directly, rather, you must obtain one from the `getMapAsync()` method on a `MapFragment` or `MapView` that you have added to your application.

Note: Similar to a `View` object, a `GoogleMap` can only be read and modified from the main thread. Calling `GoogleMap` methods from another thread will result in an exception.

You can adjust the viewpoint of a map by changing the position of the camera (as opposed to moving the map). You can use the map's camera to set parameters such as location, zoom level, tilt angle, and bearing. For more information, see Camera and View.

### Developer Guide

To get started, read the Google Maps Android API v2 developer guide.

## Summary

Nested Classes
interface | GoogleMap.CancelableCallback | A callback interface for reporting when a task is complete or canceled.
interface | GoogleMap.InfoWindowAdapter | Provides views for customized rendering of info windows.
interface | GoogleMap.OnCameraChangeListener | This interface is deprecated. Replaced by `GoogleMap.OnCameraMoveStartedListener`, `GoogleMap.OnCameraMoveListener` and `GoogleMap.OnCameraIdleListener`. The order in which the deprecated `onCameraChange` method will be called in relation to the methods in the new camera change listeners is undefined.
interface | GoogleMap.OnCameraIdleListener | Callback interface for when camera movement has ended.
interface | GoogleMap.OnCameraMoveCanceledListener | Callback interface for when the camera's motion has been stopped or when the camera starts moving for a new reason.
interface | GoogleMap.OnCameraMoveListener | Callback interface for when the camera changes position.
interface | GoogleMap.OnCameraMoveStartedListener | Callback interface for when the camera motion starts.
interface | GoogleMap.OnCircleClickListener | Callback interface for when a circle is clicked.
interface | GoogleMap.OnGroundOverlayClickListener | Callback interface for when a ground overlay is clicked.
interface | GoogleMap.OnIndoorStateChangeListener | A listener for when the indoor state changes.
interface | GoogleMap.OnInfoWindowClickListener | Callback interface for click/tap events on a marker's info window.
interface | GoogleMap.OnInfoWindowCloseListener | Callback interface for close events on a marker's info window.
interface | GoogleMap.OnInfoWindowLongClickListener | Callback interface for when the user long presses on a marker's info window.
interface | GoogleMap.OnMapClickListener | Callback interface for when the user taps on the map.
interface | GoogleMap.OnMapLoadedCallback | Callback interface for when the map has finished rendering.
interface | GoogleMap.OnMapLongClickListener | Callback interface for when the user long presses on the map.
interface | GoogleMap.OnMarkerClickListener | Defines signatures for methods that are called when a marker is clicked or tapped.
interface | GoogleMap.OnMarkerDragListener | Callback interface for drag events on markers.
interface | GoogleMap.OnMyLocationButtonClickListener | Callback interface for when the My Location button is clicked.
interface | GoogleMap.OnMyLocationChangeListener | This interface is deprecated. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi provides improved location finding and power usage and is used by the "My Location" blue dot. See the MyLocationDemoActivity in the sample applications folder for example example code, or the Location Developer Guide.
interface | GoogleMap.OnPolygonClickListener | Callback interface for when a polygon is clicked.
interface | GoogleMap.OnPolylineClickListener | Callback interface for when a polyline is clicked.
interface | GoogleMap.SnapshotReadyCallback | Callback interface to notify when the snapshot has been taken.

Constants
int | MAP_TYPE_HYBRID | Satellite maps with a transparent layer of major streets.
int | MAP_TYPE_NONE | No base map tiles.
int | MAP_TYPE_NORMAL | Basic maps.
int | MAP_TYPE_SATELLITE | Satellite maps with no labels.
int | MAP_TYPE_TERRAIN | Terrain maps.

Public Methods
final Circle | addCircle(CircleOptions options) Add a circle to this map.
final GroundOverlay | addGroundOverlay(GroundOverlayOptions options) Adds an image to this map.
final Marker | addMarker(MarkerOptions options) Adds a marker to this map.
final Polygon | addPolygon(PolygonOptions options) Adds a polygon to this map.
final Polyline | addPolyline(PolylineOptions options) Adds a polyline to this map.
final TileOverlay | addTileOverlay(TileOverlayOptions options) Adds a tile overlay to this map.
final void | animateCamera(CameraUpdate update, GoogleMap.CancelableCallback callback) Animates the movement of the camera from the current position to the position defined in the update and calls an optional callback on completion.
final void | animateCamera(CameraUpdate update) Animates the movement of the camera from the current position to the position defined in the update.
final void | animateCamera(CameraUpdate update, int durationMs, GoogleMap.CancelableCallback callback) Moves the map according to the update with an animation over a specified duration, and calls an optional callback on completion.
final void | clear() Removes all markers, polylines, polygons, overlays, etc from the map.
final CameraPosition | getCameraPosition() Gets the current position of the camera.
IndoorBuilding | getFocusedBuilding() Gets the currently focused building.
final int | getMapType() Gets the type of map that's currently displayed.
final float | getMaxZoomLevel() Returns the maximum zoom level for the current camera position.
final float | getMinZoomLevel() Returns the minimum zoom level.
final Location | getMyLocation() This method is deprecated. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi provides improved location finding and power usage and is used by the "My Location" blue dot. See the MyLocationDemoActivity in the sample applications folder for example example code, or the Location Developer Guide.
final Projection | getProjection() Returns a `Projection` object that you can use to convert between screen coordinates and latitude/longitude coordinates.
final UiSettings | getUiSettings() Gets the user interface settings for the map.
final boolean | isBuildingsEnabled() Returns whether 3D buildings layer is enabled.
final boolean | isIndoorEnabled() Gets whether indoor maps are currently enabled.
final boolean | isMyLocationEnabled() Gets the status of the my-location layer.
final boolean | isTrafficEnabled() Checks whether the map is drawing traffic data.
final void | moveCamera(CameraUpdate update) Repositions the camera according to the instructions defined in the update.
void | resetMinMaxZoomPreference() Removes any previously specified upper and lower zoom bounds.
final void | setBuildingsEnabled(boolean enabled) Turns the 3D buildings layer on or off.
final void | setContentDescription(String description) Sets a contentDescription for the map.
final boolean | setIndoorEnabled(boolean enabled) Sets whether indoor maps should be enabled.
final void | setInfoWindowAdapter(GoogleMap.InfoWindowAdapter adapter) Sets a custom renderer for the contents of info windows.
void | setLatLngBoundsForCameraTarget(LatLngBounds bounds) Specifies a LatLngBounds to constrain the camera target, so that when users scroll and pan the map, the camera target does not move outside these bounds.
final void | setLocationSource(LocationSource source) Replaces the location source of the my-location layer.
final void | setMapType(int type) Sets the type of map tiles that should be displayed.
void | setMaxZoomPreference(float maxZoomPreference) Sets a preferred upper bound for the camera zoom.
void | setMinZoomPreference(float minZoomPreference) Sets a preferred lower bound for the camera zoom.
final void | setMyLocationEnabled(boolean enabled) Enables or disables the my-location layer.
final void | setOnCameraChangeListener(GoogleMap.OnCameraChangeListener listener) This method is deprecated. Replaced by `setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)`, `setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)`, `setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)` and `setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)`.
final void | setOnCameraIdleListener(GoogleMap.OnCameraIdleListener listener) Sets a callback that is invoked when camera movement has ended.
final void | setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener listener) Sets a callback that is invoked when camera motion is stopped or interrupted by a new type of animation.
final void | setOnCameraMoveListener(GoogleMap.OnCameraMoveListener listener) Sets a callback that is invoked repeatedly while the camera is in motion.
final void | setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener listener) Sets a callback that's invoked when the camera starts moving or the reason for camera motion has changed.
final void | setOnCircleClickListener(GoogleMap.OnCircleClickListener listener) Sets a callback that's invoked when a circle is clicked.
final void | setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener listener) Sets a callback that's invoked when a ground overlay is clicked.
final void | setOnIndoorStateChangeListener(GoogleMap.OnIndoorStateChangeListener listener) Sets or clears the listener for indoor events.
final void | setOnInfoWindowClickListener(GoogleMap.OnInfoWindowClickListener listener) Sets a callback that's invoked when a marker info window is clicked.
final void | setOnInfoWindowCloseListener(GoogleMap.OnInfoWindowCloseListener listener) Sets a callback that's invoked when a marker's info window is closed.
final void | setOnInfoWindowLongClickListener(GoogleMap.OnInfoWindowLongClickListener listener) Sets a callback that's invoked when a marker's info window is long pressed.
final void | setOnMapClickListener(GoogleMap.OnMapClickListener listener) Sets a callback that's invoked when the map is tapped.
void | setOnMapLoadedCallback(GoogleMap.OnMapLoadedCallback callback) Sets a callback that's invoked when this map has finished rendering.
final void | setOnMapLongClickListener(GoogleMap.OnMapLongClickListener listener) Sets a callback that's invoked when the map is long pressed.
final void | setOnMarkerClickListener(GoogleMap.OnMarkerClickListener listener) Sets a callback that's invoked when a marker is clicked.
final void | setOnMarkerDragListener(GoogleMap.OnMarkerDragListener listener) Sets a callback that's invoked when a marker is dragged.
final void | setOnMyLocationButtonClickListener(GoogleMap.OnMyLocationButtonClickListener listener) Sets a callback that's invoked when the my location button is clicked.
final void | setOnMyLocationChangeListener(GoogleMap.OnMyLocationChangeListener listener) This method is deprecated. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi provides improved location finding and power usage and is used by the "My Location" blue dot. See the MyLocationDemoActivity in the sample applications folder for example example code, or the Location Developer Guide.
final void | setOnPolygonClickListener(GoogleMap.OnPolygonClickListener listener) Sets a callback that's invoked when a polygon is clicked.
final void | setOnPolylineClickListener(GoogleMap.OnPolylineClickListener listener) Sets a callback that's invoked when a polyline is clicked.
final void | setPadding(int left, int top, int right, int bottom) Sets padding on the map.
final void | setTrafficEnabled(boolean enabled) Turns the traffic layer on or off.
final void | snapshot(GoogleMap.SnapshotReadyCallback callback, Bitmap bitmap) Takes a snapshot of the map.
final void | snapshot(GoogleMap.SnapshotReadyCallback callback) Takes a snapshot of the map.
final void | stopAnimation() Stops the camera animation if there is one in progress.

[Expand] Inherited Methods
From class java.lang.Object
Object | clone()
boolean | equals(Object arg0)
void | finalize()
final Class<?> | getClass()
int | hashCode()
final void | notify()
final void | notifyAll()
String | toString()
final void | wait(long arg0, int arg1)
final void | wait(long arg0)
final void | wait()

## Constants

#### public static final int MAP_TYPE_HYBRID

Satellite maps with a transparent layer of major streets.

Constant Value: 4 (0x00000004)

#### public static final int MAP_TYPE_NONE

No base map tiles.

Constant Value: 0 (0x00000000)

#### public static final int MAP_TYPE_NORMAL

Basic maps.

Constant Value: 1 (0x00000001)

#### public static final int MAP_TYPE_SATELLITE

Satellite maps with no labels.

Constant Value: 2 (0x00000002)

#### public static final int MAP_TYPE_TERRAIN

Terrain maps.

Constant Value: 3 (0x00000003)

## Public Methods

#### public final Circle addCircle (CircleOptions options)

Add a circle to this map.

##### Parameters

options | A circle options object that defines how to render the Circle

##### Returns

- The `Circle` object that is added to the map

#### public final GroundOverlay addGroundOverlay (GroundOverlayOptions options)

Adds an image to this map.

##### Parameters

options | A ground-overlay options object that defines how to render the overlay. Options must have an image (AnchoredBitmap) and position specified.

##### Returns

- The `GroundOverlay` that was added to the map.

##### Throws

IllegalArgumentException | if either the image or the position is unspecified in the options.

#### public final Marker addMarker (MarkerOptions options)

Adds a marker to this map.

The marker's icon is rendered on the map at the location Marker.position. Clicking the marker centers the camera on the marker. If Marker.title is defined, the map shows an info box with the marker's title and snippet. If the marker is draggable, long-clicking and then dragging the marker moves it.

##### Parameters

options | A marker options object that defines how to render the marker.

##### Returns

- The `Marker` that was added to the map.

#### public final Polygon addPolygon (PolygonOptions options)

Adds a polygon to this map.

##### Parameters

options | A polygon options object that defines how to render the Polygon.

##### Returns

- The `Polygon` object that is added to the map.

#### public final Polyline addPolyline (PolylineOptions options)

Adds a polyline to this map.

##### Parameters

options | A polyline options object that defines how to render the Polyline.

##### Returns

- The `Polyline` object that was added to the map.

#### public final TileOverlay addTileOverlay (TileOverlayOptions options)

Adds a tile overlay to this map. See `TileOverlay` for more information.

Note that unlike other overlays, if the map is recreated, tile overlays are not automatically restored and must be re-added manually.

##### Parameters

options | A tile-overlay options object that defines how to render the overlay. Options must have a `TileProvider` specified, otherwise an `IllegalArgumentException` will be thrown.

##### Returns

- The `TileOverlay` that was added to the map.

##### Throws

IllegalArgumentException | if the `TileProvider` is unspecified in the options.

#### public final void animateCamera (CameraUpdate update, GoogleMap.CancelableCallback callback)

Animates the movement of the camera from the current position to the position defined in the update and calls an optional callback on completion. See `CameraUpdateFactory` for a set of updates.

During the animation, a call to `getCameraPosition()` returns an intermediate location of the camera.

##### Parameters

update | The change that should be applied to the camera.
callback | The callback to invoke from the main thread when the animation stops. If the animation completes normally, `onFinish()` is called; otherwise, `onCancel()` is called. Do not update or animate the camera from within `onCancel()`.

#### public final void animateCamera (CameraUpdate update)

Animates the movement of the camera from the current position to the position defined in the update. During the animation, a call to `getCameraPosition()` returns an intermediate location of the camera.

See `CameraUpdateFactory` for a set of updates.

##### Parameters

update | The change that should be applied to the camera.

#### public final void animateCamera (CameraUpdate update, int durationMs, GoogleMap.CancelableCallback callback)

Moves the map according to the update with an animation over a specified duration, and calls an optional callback on completion. See `CameraUpdateFactory` for a set of updates.

If `getCameraPosition()` is called during the animation, it will return the current location of the camera in flight.

##### Parameters

durationMs | The duration of the animation in milliseconds. This must be strictly positive, otherwise an `IllegalArgumentException` will be thrown.
callback | An optional callback to be notified from the main thread when the animation stops. If the animation stops due to its natural completion, the callback will be notified with `onFinish()`. If the animation stops due to interruption by a later camera movement or a user gesture, `onCancel()` will be called. The callback should not attempt to move or animate the camera in its cancellation method. If a callback isn't required, leave it as `null`.

#### public final void clear ()

Removes all markers, polylines, polygons, overlays, etc from the map.

#### public final CameraPosition getCameraPosition ()

Gets the current position of the camera.

The `CameraPosition` returned is a snapshot of the current position, and will not automatically update when the camera moves.

For more information about changing the camera's position, see Camera and View.

##### Returns

- The current position of the Camera.

#### public IndoorBuilding getFocusedBuilding ()

Gets the currently focused building.

##### Returns

- The current focused building or `null` if no building is focused.

#### public final int getMapType ()

Gets the type of map that's currently displayed. See `MAP_TYPE_NORMAL`, `MAP_TYPE_SATELLITE`, `MAP_TYPE_TERRAIN` for possible values.

##### Returns

- The map type.

#### public final float getMaxZoomLevel ()

Returns the maximum zoom level for the current camera position. This takes into account what map type is currently being used, e.g., satellite or terrain may have a lower max zoom level than the base map tiles.

For more information about changing the camera's zoom level, see Camera and View.

##### Returns

- The maximum zoom level available at the current camera position.

#### public final float getMinZoomLevel ()

Returns the minimum zoom level. This is the same for every location (unlike the maximum zoom level) but may vary between devices and map sizes.

For more information about changing the camera's zoom level, see Camera and View.

##### Returns

- The minimum zoom level available.

#### public final Location getMyLocation ()

This method is deprecated.
use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi provides improved location finding and power usage and is used by the "My Location" blue dot. See the MyLocationDemoActivity in the sample applications folder for example example code, or the Location Developer Guide.

Returns the currently displayed user location, or `null` if there is no location data available.

##### Returns

- The currently displayed `user location`.

##### Throws

IllegalStateException | if the my-location layer is not enabled.

#### public final Projection getProjection ()

Returns a `Projection` object that you can use to convert between screen coordinates and latitude/longitude coordinates.

The `Projection` returned is a snapshot of the current projection, and will not automatically update when the camera moves. As this operation is expensive, you should get the projection only once per screen. Google Maps uses the Mercator projection to create its maps from geographic data and convert points on the map into geographic coordinates.

##### Returns

- The `Projection` of the map in its current state.

#### public final UiSettings getUiSettings ()

Gets the user interface settings for the map.

##### Returns

- The `UiSettings` for this map.

#### public final boolean isBuildingsEnabled ()

Returns whether 3D buildings layer is enabled.

##### Returns

- True if buildings are enabled, false otherwise.

#### public final boolean isIndoorEnabled ()

Gets whether indoor maps are currently enabled.

##### Returns

- `true` if indoor maps are enabled; `false` if indoor maps are disabled;

#### public final boolean isMyLocationEnabled ()

Gets the status of the my-location layer.

##### Returns

- True if the my-location layer is enabled, false otherwise.

#### public final boolean isTrafficEnabled ()

Checks whether the map is drawing traffic data. This is subject to the availability of traffic data.

##### Returns

- True if traffic data is enabled, false otherwise.

#### public final void moveCamera (CameraUpdate update)

Repositions the camera according to the instructions defined in the update. The move is instantaneous, and a subsequent `getCameraPosition()` will reflect the new position. See `CameraUpdateFactory` for a set of updates.

##### Parameters

update | The change that should be applied to the camera.

#### public void resetMinMaxZoomPreference ()

Removes any previously specified upper and lower zoom bounds.

#### public final void setBuildingsEnabled (boolean enabled)

Turns the 3D buildings layer on or off.

##### Parameters

enabled | `true` to enable the 3D buildings layer; `false` to disable 3D buildings.

#### public final void setContentDescription (String description)

Sets a contentDescription for the map.

This is used to provide a spoken description of the map in accessibility mode. The default value is "Google Map"

##### Parameters

description | a string to use as a description.

#### public final boolean setIndoorEnabled (boolean enabled)

Sets whether indoor maps should be enabled. Currently, indoor maps can only be shown on one map at a time and by default, this is the first map added to your application. To enable indoor maps on another map, you must first disable indoor maps on the original map. If you try to enable indoor maps when it is enabled on another map, nothing will happen and this will return `false`. When Indoor is not enabled for a map, all methods related to indoor will return `null`, or `false`.

##### Parameters

enabled | `true` to try to enable indoor maps; `false` to disable indoor maps.

##### Returns

- whether it was possible to enable indoor maps.

#### public final void setInfoWindowAdapter (GoogleMap.InfoWindowAdapter adapter)

Sets a custom renderer for the contents of info windows.

Like the map's event listeners, this state is not serialized with the map. If the map gets re-created (e.g., due to a configuration change), you must ensure that you call this method again in order to preserve the customization.

##### Parameters

adapter | The adapter to use for info window contents, or `null` to use the default content rendering in info windows.

#### public void setLatLngBoundsForCameraTarget (LatLngBounds bounds)

Specifies a LatLngBounds to constrain the camera target, so that when users scroll and pan the map, the camera target does not move outside these bounds.

Set to null to clear the bounding box completely. The new bounds replaces any previously specified bounding box.

When the LatLngBounds changes, the API adjusts all later camera updates to respect those bounds if possible. Note that there are technical considerations that may prevent the API from keeping the camera target strictly within the bounds. For example, floating point precision rounding errors or a very low zoom level.

##### Parameters

bounds | The bounds to constrain the camera target within.

#### public final void setLocationSource (LocationSource source)

Replaces the location source of the my-location layer.

##### Parameters

source | A location source to use in the my-location layer. Set to `null` to use the default location source.

#### public final void setMapType (int type)

Sets the type of map tiles that should be displayed. The allowable values are:

- `MAP_TYPE_NORMAL`: Basic map with roads.
- `MAP_TYPE_SATELLITE`: Satellite view with roads.
- `MAP_TYPE_TERRAIN`: Terrain view without roads.

##### Parameters

type | The type of map to display.

#### public void setMaxZoomPreference (float maxZoomPreference)

Sets a preferred upper bound for the camera zoom.

When the maximum zoom changes, the API adjusts all later camera updates to respect that maximum if possible. Note that there are technical considerations that may prevent the API from allowing users to zoom too deep into the map. For example, satellite or terrain may have a lower maximum zoom than the base map tiles.

The API resolves any conflicts in the minimum and maximum values. If you set the minimum zoom to a higher zoom level than the current maximum, then the API uses the new minimum value for both minimum and maximum. If you set the maximum zoom to a lower zoom level than the minimum, the API uses the new maximum value for both minimum and maximum. For example: Assume the current minimum zoom is 8 and the maximum is 14. Then you set the maximum zoom to 6. The API uses a minimum zoom of 6 and a maximum zoom of 6.

##### Parameters

maxZoomPreference | The preferred upper bound.

#### public void setMinZoomPreference (float minZoomPreference)

Sets a preferred lower bound for the camera zoom.

When the minimum zoom changes, the API adjusts all later camera updates to respect that minimum if possible. Note that there are technical considerations that may prevent the API from allowing users to zoom too low.

The API resolves any conflicts in the minimum and maximum values. If you set the minimum zoom to a higher zoom level than the current maximum, then the API uses the new minimum value for both minimum and maximum. If you set the maximum zoom to a lower zoom level than the minimum, the API uses the new maximum value for both minimum and maximum. For example: Assume the current minimum zoom is 8 and the maximum is 14. Then you set the minimum zoom to 16. The API uses a minimum zoom of 16 and a maximum zoom of 16.

##### Parameters

minZoomPreference | The preferred lower bound.

#### public final void setMyLocationEnabled (boolean enabled)

Enables or disables the my-location layer.

While enabled and the location is available, the my-location layer continuously draws an indication of a user's current location and bearing, and displays UI controls that allow a user to interact with their location (for example, to enable or disable camera tracking of their location and bearing).

In order to use the my-location-layer feature you need to request permission for either `ACCESS_COARSE_LOCATION` or `ACCESS_FINE_LOCATION` unless you have set a custom location source.

If you have set a custom location source via `setLocationSource(LocationSource)` the Google Maps Android API will not check whether the above permissions have been granted. However, you still need to make sure that the user has granted all the permissions required for your custom location source.

##### Parameters

enabled | True to enable; false to disable.

##### Throws

SecurityException | if location permission is not granted.

#### public final void setOnCameraChangeListener (GoogleMap.OnCameraChangeListener listener)

This method is deprecated.
Replaced by `setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)`, `setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)`, `setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)` and `setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)`.

Sets a callback that's invoked when the camera changes.

##### Parameters

listener | The callback that's invoked when the camera changes. To unset the callback, use `null`.

#### public final void setOnCameraIdleListener (GoogleMap.OnCameraIdleListener listener)

Sets a callback that is invoked when camera movement has ended.

##### Parameters

listener | The callback that's invoked. To unset the callback, use `null`.

#### public final void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener listener)

Sets a callback that is invoked when camera motion is stopped or interrupted by a new type of animation.

##### Parameters

listener | The callback that's invoked. To unset the callback, use `null`. Do not update or animate the camera from within `onCameraMoveCanceled()`.

#### public final void setOnCameraMoveListener (GoogleMap.OnCameraMoveListener listener)

Sets a callback that is invoked repeatedly while the camera is in motion. The callback may be invoked as often as once every frame and should not perform expensive operations.

##### Parameters

listener | The callback that's invoked. To unset the callback, use `null`.

#### public final void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener listener)

Sets a callback that's invoked when the camera starts moving or the reason for camera motion has changed.

##### Parameters

listener | The callback that's invoked. To unset the callback, use `null`. Do not update or animate the camera from within `onCameraMoveStarted()`.

#### public final void setOnCircleClickListener (GoogleMap.OnCircleClickListener listener)

Sets a callback that's invoked when a circle is clicked.

##### Parameters

listener | The callback that's invoked when a circle is clicked. To unset the callback, use `null`.

#### public final void setOnGroundOverlayClickListener (GoogleMap.OnGroundOverlayClickListener listener)

Sets a callback that's invoked when a ground overlay is clicked.

##### Parameters

listener | The callback that's invoked when a ground overlay is clicked. To unset the callback, use `null`.

#### public final void setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener listener)

Sets or clears the listener for indoor events. Only one listener can ever be set. Setting a new listener will remove the previous listener.

##### Parameters

listener | the listener for indoor events if non-null; otherwise, clears the listener

#### public final void setOnInfoWindowClickListener (GoogleMap.OnInfoWindowClickListener listener)

Sets a callback that's invoked when a marker info window is clicked.

##### Parameters

listener | The callback that's invoked when a marker info window is clicked. To unset the callback, use `null`.

#### public final void setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener listener)

Sets a callback that's invoked when a marker's info window is closed.

##### Parameters

listener | The callback that's invoked when a marker's info window is closed. To unset the callback, use `null`.

#### public final void setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener listener)

Sets a callback that's invoked when a marker's info window is long pressed.

##### Parameters

listener | The callback that's invoked when a marker's info window is long pressed. To unset the callback, use `null`.

#### public final void setOnMapClickListener (GoogleMap.OnMapClickListener listener)

Sets a callback that's invoked when the map is tapped.

##### Parameters

listener | The callback that's invoked when the map is tapped. To unset the callback, use `null`.

#### public void setOnMapLoadedCallback (GoogleMap.OnMapLoadedCallback callback)

Sets a callback that's invoked when this map has finished rendering. The callback will only be invoked once. If this method is called when the map is fully rendered, the callback will be invoked immediately. This event will not fire if the map never loads due to connectivity issues, or if the map is continuously changing and never completes loading due to the user constantly interacting with the map.

##### Parameters

callback | The callback invoked when the map has finished rendering. To unset the callback, use `null`.

#### public final void setOnMapLongClickListener (GoogleMap.OnMapLongClickListener listener)

Sets a callback that's invoked when the map is long pressed.

##### Parameters

listener | The callback that's invoked when the map is long pressed. To unset the callback, use `null`.

#### public final void setOnMarkerClickListener (GoogleMap.OnMarkerClickListener listener)

Sets a callback that's invoked when a marker is clicked.

##### Parameters

listener | The callback that's invoked when a marker is clicked. To unset the callback, use `null`.

#### public final void setOnMarkerDragListener (GoogleMap.OnMarkerDragListener listener)

Sets a callback that's invoked when a marker is dragged.

##### Parameters

listener | The callback that's invoked on marker drag events. To unset the callback, use `null`.

#### public final void setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener listener)

Sets a callback that's invoked when the my location button is clicked.

If the `listener` returns `true`, the event is consumed and the default behavior will not occur. If it returns `false`, the default behavior will occur (i.e. The camera moves such that it is centered on the user's location).

##### Parameters

listener | The callback that's invoked when the My Location button is clicked.

#### public final void setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener listener)

This method is deprecated.
use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi provides improved location finding and power usage and is used by the "My Location" blue dot. See the MyLocationDemoActivity in the sample applications folder for example example code, or the Location Developer Guide.

Sets a callback that's invoked when the My Location dot changes location.

##### Parameters

listener | The callback that's invoked when the My Location dot changes.

#### public final void setOnPolygonClickListener (GoogleMap.OnPolygonClickListener listener)

Sets a callback that's invoked when a polygon is clicked.

##### Parameters

listener | The callback that's invoked when a polygon is clicked. To unset the callback, use `null`.

#### public final void setOnPolylineClickListener (GoogleMap.OnPolylineClickListener listener)

Sets a callback that's invoked when a polyline is clicked.

##### Parameters

listener | The callback that's invoked when a polyline is clicked. To unset the callback, use `null`.

#### public final void setPadding (int left, int top, int right, int bottom)

Sets padding on the map.

This method allows you to define a visible region on the map, to signal to the map that portions of the map around the edges may be obscured, by setting padding on each of the four edges of the map. Map functions will be adapted to the padding. For example, the zoom controls, compass, copyright notices and Google logo will be moved to fit inside the defined region, camera movements will be relative to the center of the visible region, etc.

##### Parameters

left | the number of pixels of padding to be added on the left of the map.
top | the number of pixels of padding to be added on the top of the map.
right | the number of pixels of padding to be added on the right of the map.
bottom | the number of pixels of padding to be added on the bottom of the map.

#### public final void setTrafficEnabled (boolean enabled)

Turns the traffic layer on or off.

#### public final void snapshot (GoogleMap.SnapshotReadyCallback callback, Bitmap bitmap)

Takes a snapshot of the map.

This method is equivalent to `snapshot(SnapshotReadyCallback)` but lets you provide a preallocated `Bitmap`. If the bitmap does not match the current dimensions of the map, another bitmap will be allocated that fits the map's dimensions.

Although in most cases the object passed by the callback method is the same as the one given in the parameter to this method, in some cases the returned object can be different (e.g., if the view's dimensions have changed by the time the snapshot is actually taken). Thus, you should only trust the content of the bitmap passed by the callback method.

##### Parameters

callback | Callback method invoked when the snapshot is taken.
bitmap | A preallocated bitmap. If `null`, behaves like `snapshot(SnapshotReadyCallback)`.

#### public final void snapshot (GoogleMap.SnapshotReadyCallback callback)

Takes a snapshot of the map.

You can use snapshots within your application when an interactive map would be difficult, or impossible, to use. For example, images produced with the `snapshot()` method can be used to display a thumbnail of the map in your app, or a snapshot in the notification center.

Note: Images of the map must not be transmitted to your servers, or otherwise used outside of the application. If you need to send a map to another application or user, send data that allows them to reconstruct the map for the new user instead of a snapshot.

##### Parameters

callback | Callback method invoked when the snapshot is taken.

#### public final void stopAnimation ()

Stops the camera animation if there is one in progress. When the method is called, the camera stops moving immediately and remains in that position.