An icon placed at a particular point on the map's surface. A marker icon is drawn oriented against the device's screen rather than the map's surface; i.e., it will not necessarily change orientation due to map rotations, tilting, or zooming.
A marker has the following properties:
LatLng
position of the marker. This defaults to 50% from the left of the image and at the bottom of the image.
LatLng
value for the marker's position on the map. You can change this value at any time if you want to move the marker.
BitmapDescriptorFactory.defaultMarker(float)
.
true
. You can change this value at any time. The default is false
.
false
. You can change this value at any time.
GroundOverlay
. If the marker is a billboard, it will remain stuck to the map as the camera rotates and tilts. As with flat markers, billboard markers retain their size when the map is zoomed in or out. The default is a billboard (false
)
Object
associated with the marker. For example, the Object
can contain data about what the marker represents. This is easier than storing a separate Map<Marker, Object>
. As another example, you can associate a String
ID corresponding to the ID from a data set. Google Maps SDK for Android neither reads nor writes this property.
Methods in this class must be called on the Android UI thread. If not, an IllegalStateException
will be thrown at runtime.
GoogleMap map = ... // get a map.
// Add a marker at San Francisco.
Marker marker = map.addMarker(new MarkerOptions()
.position(new LatLng(37.7750, 122.4183))
.title("San Francisco")
.snippet("Population: 776733"));
Developer Guide
For more information, read the Markers developer guide.
Public Method Summary boolean float getAlpha()
Gets the alpha of the marker.
String getId()
Gets this marker's id.
LatLng float String Object getTag()
Gets the tag for the marker.
String getTitle()
Gets the title of the marker.
float getZIndex()
Returns the zIndex of the marker.
int void hideInfoWindow()
Hides the info window if it is shown from this marker.
boolean boolean isFlat()
Gets the flat setting of the Marker.
boolean isInfoWindowShown()
Returns whether the info window is currently shown above this marker.
boolean isVisible()
Gets the visibility setting of this marker.
void remove()
Removes this marker from the map.
void setAlpha(float alpha)
Sets the alpha (opacity) of the marker.
void setAnchor(float anchorU, float anchorV)
Sets the anchor point for the marker.
void setDraggable(boolean draggable)
Sets the draggability of the marker.
void setFlat(boolean flat)
Sets whether this marker should be flat against the map true
or a billboard facing the camera false
.
(float anchorU, float anchorV)
Specifies the point in the marker image at which to anchor the info window when it is displayed.
void void setRotation(float rotation)
Sets the rotation of the marker in degrees clockwise about the marker's anchor point.
void void void void setVisible(boolean visible)
Sets the visibility of this marker.
void setZIndex(float zIndex)
Sets the zIndex of the marker.
void Inherited Method Summary From class java.lang.Object Objectclone()
boolean voidfinalize()
final Class<?>getClass()
inthashCode()
final voidnotify()
final voidnotifyAll()
StringtoString()
final voidwait(long arg0, int arg1)
final voidwait(long arg0)
final voidwait()
Public Methods public boolean equals (Object other)Tests if this Marker
is equal to another.
Gets the alpha of the marker.
ReturnsGets this marker's id. The id will be unique amongst all Markers on a map.
ReturnsReturns the position of the marker.
ReturnsLatLng
object specifying the marker's current position.Gets the rotation of the marker.
ReturnsGets the snippet of the marker.
Returnsnull
if no snippet has been set.Gets the tag for the marker.
ReturnssetTag
; null
if no tag has been set.Gets the title of the marker.
Returnsnull
if no title has been set.Returns the zIndex of the marker.
ReturnsHides the info window if it is shown from this marker.
This method has no effect if this marker is not visible.
public boolean isDraggable ()Gets the draggability of the marker. When a marker is draggable, it can be moved by the user by long pressing on the marker.
Returnstrue
if the marker is draggable; otherwise, returns false
.Gets the flat setting of the Marker.
Returnstrue
if the marker is flat against the map; false
if the marker should face the camera.Returns whether the info window is currently shown above this marker. This does not consider whether or not the info window is actually visible on screen.
public boolean isVisible ()Gets the visibility setting of this marker. Note that this does not indicate whether the marker is within the screen's viewport. It indicates whether the marker will be drawn if it is contained in the screen's viewport.
ReturnsRemoves this marker from the map. After a marker has been removed, the behavior of all its methods is undefined.
public void setAlpha (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.
public void setAnchor (float anchorU, float anchorV)Sets the anchor point for the marker.
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 anchorU u-coordinate of the anchor, as a ratio of the image width (in the range [0, 1]). anchorV v-coordinate of the anchor, as a ratio of the image height (in the range [0, 1]). public void setDraggable (boolean draggable)
Sets the draggability of the marker. When a marker is draggable, it can be moved by the user by long pressing on the marker.
public void setFlat (boolean flat)Sets whether this marker should be flat against the map true
or a billboard facing the camera false
.
Sets the icon for the marker.
Parameters iconDescriptor if null, the default marker is used. public void setInfoWindowAnchor (float anchorU, float anchorV)Specifies the point in the marker image at which to anchor the info window when it is displayed. This is specified in the same coordinate system as the anchor. See setAnchor(float, float)
for more details. The default is the top middle of the image.
Sets the location of the marker.
public void setRotation (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.
public void setSnippet (String snippet)Sets the snippet of the marker.
Parameters snippet if null, the snippet is cleared. public void setTag (Object tag)Sets the tag for the marker.
You can use this property to associate an arbitrary Object
with this marker. For example, the Object
can contain data about what the marker represents. This is easier than storing a separate Map<Marker, Object>
. As another example, you can associate a String
ID corresponding to the ID from a data set. Google Maps SDK for Android neither reads nor writes this property. It is your responsibility to call setTag(null)
to clear the tag when you no longer need it, to prevent memory leaks in your app.
Sets the title of the marker.
Parameters title if null, the title is cleared. public void setVisible (boolean visible)Sets the visibility of this marker. If set to false
and an info window is currently showing for this marker, this will hide the info window.
Sets the zIndex of the marker.
public void showInfoWindow ()Shows the info window of this marker on the map, if this marker isVisible()
.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4