New basemap styling is coming soon to Google Maps Platform. This update to map styling includes a new default color palette, modernized pins, and improvements to map experiences and usability. All map styles will be automatically updated in March 2025. For more information on availability and how to opt in earlier, see New map style for Google Maps Platform.

MarkerOptions

public final class MarkerOptions extends Object
implements Parcelable

Defines MarkerOptions for a marker.

Developer Guide

For more information, read the Markers developer guide.

Inherited Constant Summary

From interface android.os.Parcelable

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

Public Constructor Summary

MarkerOptions()

Creates a new set of marker options.

Public Method Summary

MarkerOptions	alpha(float alpha) Sets the alpha (opacity) of the marker.
MarkerOptions	anchor(float u, float v) Specifies the anchor to be at a particular point in the marker image.
MarkerOptions	collisionBehavior(int collisionBehavior) Sets the collision state for the marker.
MarkerOptions	draggable(boolean draggable) Sets the draggability for the marker.
MarkerOptions	flat(boolean flat) Sets whether this marker should be flat against the map `true` or a billboard facing the camera `false`.
float	getAlpha() Gets the alpha set for this `MarkerOptions` object.
float	getAnchorU() Horizontal distance, normalized to [0, 1], of the anchor from the left edge.
float	getAnchorV() Vertical distance, normalized to [0, 1], of the anchor from the top edge.
int	getCollisionBehavior()
BitmapDescriptor	getIcon() Gets the custom icon descriptor set for this `MarkerOptions` object.
float	getInfoWindowAnchorU() Horizontal distance, normalized to [0, 1], of the info window anchor from the left edge.
float	getInfoWindowAnchorV() Vertical distance, normalized to [0, 1], of the info window anchor from the top edge.
LatLng	getPosition() Returns the position set for this `MarkerOptions` object.
float	getRotation() Gets the rotation set for this `MarkerOptions` object.
String	getSnippet() Gets the snippet set for this `MarkerOptions` object.
String	getTitle() Gets the title set for this `MarkerOptions` object.
float	getZIndex() Gets the zIndex set for this `MarkerOptions` object.
MarkerOptions	icon(BitmapDescriptor iconDescriptor) Sets the icon for the marker.
MarkerOptions	infoWindowAnchor(float u, float v) Specifies the anchor point of the info window on the marker image.
boolean	isDraggable() Gets the draggability setting for this `MarkerOptions` object.
boolean	isFlat() Gets the flat setting for this `MarkerOptions` object.
boolean	isVisible() Gets the visibility setting for this `MarkerOptions` object.
MarkerOptions	position(LatLng latlng) Sets the location for the marker.
MarkerOptions	rotation(float rotation) Sets the rotation of the marker in degrees clockwise about the marker's anchor point.
MarkerOptions	snippet(String snippet) Sets the snippet for the marker.
MarkerOptions	title(String title) Sets the title for the marker.
MarkerOptions	visible(boolean visible) Sets the visibility for the marker.
MarkerOptions	zIndex(float zIndex) Sets the zIndex for the marker.

Inherited Method Summary

From class java.lang.Object

boolean	equals(Object arg0)
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()

From interface android.os.Parcelable

abstract int	describeContents()
abstract void	writeToParcel(Parcel arg0, int arg1)

Public Constructors

public MarkerOptions ()

Creates a new set of marker options.

Public Methods

public MarkerOptions alpha (float alpha)

Sets the alpha (opacity) of the marker. This is a value from 0 to 1, where 0 means the marker is completely transparent and 1 means the marker is completely opaque.

Parameters

alpha

Returns

the object for which the method was called, with the new alpha set.

public MarkerOptions anchor (float u, float v)

Specifies the anchor to be at a particular point in the marker image.

The anchor specifies the point in the icon image that is anchored to the marker's position on the Earth's surface.

The anchor point is specified in the continuous space [0.0, 1.0] x [0.0, 1.0], where (0, 0) is the top-left corner of the image, and (1, 1) is the bottom-right corner. The anchoring point in a W x H image is the nearest discrete grid point in a (W + 1) x (H + 1) grid, obtained by scaling the then rounding. For example, in a 4 x 2 image, the anchor point (0.7, 0.6) resolves to the grid point at (3, 1).

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

Parameters

u	u-coordinate of the anchor, as a ratio of the image width (in the range [0, 1])
v	v-coordinate of the anchor, as a ratio of the image height (in the range [0, 1])

Returns

the object for which the method was called, with the new anchor set.

public MarkerOptions collisionBehavior (int collisionBehavior)

Sets the collision state for the marker. This is a value of Marker.CollisionBehavior. It can only be set once.

Parameters

collisionBehavior

Returns

the object for which the method was called, with the collision state set.

public MarkerOptions draggable (boolean draggable)

Sets the draggability for the marker.

Parameters

draggable

Returns

the object for which the method was called, with the new draggable state set.

public MarkerOptions flat (boolean flat)

Sets whether this marker should be flat against the map true or a billboard facing the camera false. If the marker is flat against the map, it will remain stuck to the map as the camera rotates and tilts but will still remain the same size as the camera zooms, unlike a GroundOverlay. If the marker is a billboard, it will always be drawn facing the camera and will rotate and tilt with the camera. The default value is false.

Parameters

flat

Returns

the object for which the method was called, with the new flat state set.

public float getAlpha ()

Gets the alpha set for this MarkerOptions object.

Returns

the alpha of the marker in the range [0, 1].

public float getAnchorU ()

Horizontal distance, normalized to [0, 1], of the anchor from the left edge.

Returns

the u value of the anchor.

public float getAnchorV ()

Vertical distance, normalized to [0, 1], of the anchor from the top edge.

Returns

the v value of the anchor.

public int getCollisionBehavior ()

public BitmapDescriptor getIcon ()

Gets the custom icon descriptor set for this MarkerOptions object.

Returns

A BitmapDescriptor representing the custom icon, or null if no custom icon is set.

public float getInfoWindowAnchorU ()

Horizontal distance, normalized to [0, 1], of the info window anchor from the left edge.

Returns

the u value of the info window anchor.

public float getInfoWindowAnchorV ()

Vertical distance, normalized to [0, 1], of the info window anchor from the top edge.

Returns

the v value of the info window anchor.

public LatLng getPosition ()

Returns the position set for this MarkerOptions object.

Returns

A LatLng object specifying the marker's current position.

public float getRotation ()

Gets the rotation set for this MarkerOptions object.

Returns

the rotation of the marker in degrees clockwise from the default position.

public String getSnippet ()

Gets the snippet set for this MarkerOptions object.

Returns

A string containing the marker's snippet.

public String getTitle ()

Gets the title set for this MarkerOptions object.

Returns

A string containing the marker's title.

public float getZIndex ()

Gets the zIndex set for this MarkerOptions object.

Returns

the zIndex of the marker.

public MarkerOptions icon (BitmapDescriptor iconDescriptor)

Sets the icon for the marker.

Parameters

iconDescriptor	if `null`, the default marker is used.

Returns

the object for which the method was called, with the new icon descriptor set.

public MarkerOptions infoWindowAnchor (float u, float v)

Specifies the anchor point of the info window on the marker image. This is specified in the same coordinate system as the anchor. See anchor(float, float) for more details. The default is the top middle of the image.

Parameters

u	u-coordinate of the info window anchor, as a ratio of the image width (in the range [0, 1])
v	v-coordinate of the info window anchor, as a ratio of the image height (in the range [0, 1])

Returns

the object for which the method was called, with the new info window anchor set.

public boolean isDraggable ()

Gets the draggability setting for this MarkerOptions object.

Returns

true if the marker is draggable; otherwise, returns false.

public boolean isFlat ()

Gets the flat setting for this MarkerOptions object.

Returns

true if the marker is flat against the map; false if the marker should face the camera.

public boolean isVisible ()

Gets the visibility setting for this MarkerOptions object.

Returns

true if the marker is visible; otherwise, returns false.

public MarkerOptions position (LatLng latlng)

Sets the location for the marker.

Parameters

latlng

Returns

the object for which the method was called, with the new position set.

public MarkerOptions rotation (float rotation)

Sets the rotation of the marker in degrees clockwise about the marker's anchor point. The axis of rotation is perpendicular to the marker. A rotation of 0 corresponds to the default position of the marker. When the marker is flat on the map, the default position is North aligned and the rotation is such that the marker always remains flat on the map. When the marker is a billboard, the default position is pointing up and the rotation is such that the marker is always facing the camera. The default value is 0.

Parameters

rotation

Returns

the object for which the method was called, with the new rotation set.

public MarkerOptions snippet (String snippet)

Sets the snippet for the marker.

Parameters

snippet

Returns

the object for which the method was called, with the new snippet set.

public MarkerOptions title (String title)

Sets the title for the marker.

Parameters

title

Returns

the object for which the method was called, with the new title set.

public MarkerOptions visible (boolean visible)

Sets the visibility for the marker.

Parameters

visible

Returns

the object for which the method was called, with the new visibility state set.

public MarkerOptions zIndex (float zIndex)

Sets the zIndex for the marker.

Parameters

zIndex

Returns

the object for which the method was called, with the new zIndex set.