Click or drag to move. Keyboard: arrow keys, then Center marker.

Marker Icon API Playground

Design a marker and preview it on the map.

API docs

Live marker preview

Updating…

Your marker’s display size and anchor will appear here.

Browse library

Resolution

Marker size controls the pin shape. Display size measures the final image with its outline, shadow, and other visual effects.

Use 2× for sharper markers on high-density screens. The marker’s size on the map stays the same.

Colors

Outline

Outline width
Outline color

Shadow

Shadow color

Outputs

Updating outputs…

Use this marker

Display the image at Icon-Width × Icon-Height CSS pixels, equal to the PNG dimensions divided by scaleFactor. Place the point given by Icon-Anchor-X and Icon-Anchor-Y, measured from the displayed image’s top-left corner, on the map coordinate. Icon-Marker-Style provides the matching Static Maps marker value; it is absent when no exact equivalent exists.

Example marker request — replace YOUR_API_KEY
https://api.geoapify.com/v2/icon/?type=material&size=46&scaleFactor=2&icon=local-cafe&iconType=material&contentSize=20&contentColor=%23ffffff&color=%23ff2e7a&noWhiteCircle=true&apiKey=YOUR_API_KEY

Playground settings such as content and shadowType=auto are editor-only; the Marker icon URL output is the actual API request.