Security notice: We have become aware of a security issue that may be affecting websites using specific third-party libraries (including polyfill.io). This issue can sometimes redirect visitors away from the intended website without website owner knowledge or permission. Many of our JavaScript samples previously included a polyfill.io script declaration. We have removed this from our samples. If you have used our JavaScript samples that contain this declaration, we recommend removing the declaration.

Announcement: 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.

Markers

Use markers to draw a user's attention to a location on a map. This guide demonstrates how to use and customize markers in 3D maps. You can control the shape, size, and color of markers, in addition to the altitude at which they appear.

Use markers to show locations on maps. The example above shows a simple, single marker with no customization applied.

Customize color, scale and icon image

Customize the default marker's background, glyph, border color, and size.

Custom markers

Try sample

Replace the default marker icon with a custom SVG resource.

Markers with graphics

Try sample

Set marker altitude

You can set marker altitude by extruding the marker and setting the altitude.

Extruded marker

Try sample

Control collision behavior

Collision behavior controls how a marker will display if it collides (overlaps) with another marker.

To set collision behavior, set collisionBehavior to one of the following:

REQUIRED: Always display the marker regardless of collision
REQUIRED_AND_HIDES_OPTIONAL: Always display the marker regardless of collision, and hide any OPTIONAL_AND_HIDES_LOWER_PRIORITY markers or labels that would overlap with the marker.
OPTIONAL_AND_HIDES_LOWER_PRIORITY: Display the marker only if it does not overlap with other markers. If two markers of this type would overlap, the one with the higher zIndex is shown. If they have the same zIndex, the one with the lower vertical screen position is shown.