GoogleMap

Returns the DEMO_MAP_ID, which can be used for code samples which require a Map ID. This Map ID is not intended for use in production applications and cannot be used for features which require cloud configuration (such as Cloud-based maps styling).

Note: Usage of DEMO_MAP_ID triggers a map load charge against the Dynamic Maps SKU for Android and iOS. For more information, see Google Maps Platform Pricing

Satellite maps with a transparent layer of major streets.

No base map tiles.

Basic maps.

Satellite maps with no labels.

Terrain maps.

Add a circle to this map.

Adds an image to this map.

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.

If an AdvancedMarkerOptions is passed to this method then an AdvancedMarker will be created and returned as a Marker.

Adds a listener that's invoked when the map capabilities are changed.

Adds a polygon to this map.

Adds a polyline to this map.

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.

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.

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.

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.

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

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 a feature layer of the specified type. Feature layers must be configured in the Cloud Console.

If a layer of the specified type does not exist on this map, or if data-driven styling is not enabled, the resulting layer's FeatureLayer.isAvailable() will be false, and will not respond to any calls.

Gets the currently focused building.

Returns the MapCapabilities instance.

Returns the MapColorScheme int the map is currently rendering.

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

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.

Note: This returns the maximum zoom level supported by the Google Maps API for the current camera position, and not the zoom level preference previously requested in setMaxZoomPreference(float).

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

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.

Note: This returns the minimum zoom level supported by the Google Maps API, and not the zoom level preference previously requested in setMinZoomPreference(float).

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

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

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.

Gets the user interface settings for the map.

Returns whether 3D buildings layer is enabled.

Gets whether indoor maps are currently enabled.

Gets the status of the my-location layer.

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

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.

Removes a listener that's invoked when the map capabilities are changed.

Removes any previously specified upper and lower zoom bounds.

Turns the 3D buildings layer on or off.

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"

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.

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.

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 SDK adjusts all later camera updates to respect those bounds if possible. Note that there are technical considerations that may prevent the SDK from keeping the camera target strictly within the bounds. For example, floating point precision rounding errors or a very low zoom level.

Replaces the location source of the my-location layer.

Sets the map rendering color scheme to light, dark, or follow system settings after initialization.

Does not save state after the map is destroyed. Reinitialize via GoogleMapOptions.mapColorScheme(int) or setMapColorScheme(int).

Sets the styling of the base map.

Using the style options, you can apply custom styles to features and elements on the map. See MapStyleOptions for style definition details.

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

• MAP_TYPE_NORMAL: Basic map.
• MAP_TYPE_SATELLITE: Satellite imagery.
• MAP_TYPE_HYBRID: Satellite imagery with roads and labels.
• MAP_TYPE_TERRAIN: Topographic data.
• MAP_TYPE_NONE: No base map tiles.

Sets a preferred upper bound for the camera zoom.

When the maximum zoom changes, the SDK adjusts all later camera updates to respect that maximum if possible. Note that there are technical considerations that may prevent the SDK 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 SDK 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 SDK 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 SDK 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 SDK uses a minimum zoom of 6 and a maximum zoom of 6.

Sets a preferred lower bound for the camera zoom.

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

The SDK 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 SDK 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 SDK 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 SDK uses a minimum zoom of 16 and a maximum zoom of 16.

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 SDK for Android 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.

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

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

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

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.

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

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

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

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

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

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

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

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

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.

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

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

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

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).

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

Sets a callback that's invoked when the My Location dot (which signifies the user's location) is clicked.

Sets a listener which will be triggered when a POI is clicked or tapped.

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

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

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.

Turns the traffic layer on or off.

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.

Note:

• The snapshot is taken on the main thread. snapshot() should only be invoked while the underlying UI view/fragment is in the foreground.
• 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.

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:

• The snapshot is taken on the main thread. snapshot() should only be invoked while the underlying UI view/fragment is in the foreground.
• 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.

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.