Placemarks

The pt parameter is used to display one or more (up to 100) placemarks on the map image:

pt=PlacemarkDefinition1~PlacemarkDefinition2~PlacemarkDefinition3...

Each placemark definition contains its coordinates (longitude and latitude) along with information on its appearance (including style, color, size, and content of the placemark). A placemark definition looks like this:

{longitude},{latitude},{style}{color}{size}{content}

Rules for designating placemarks:

Style

Color

Size and content

pm

wt — white (default)
do — dark orange
db — dark blue
bl — blue
gn — green
gr — grey
lb — light blue
nt — dark night
or — orange
pn — pink
rd — red
vv — purple
yw — yellow

Size:

  • s — small
  • m — medium
  • l — large

Content:

  • For sizes s and m, a number from 1 to 99.
  • For size l, a number from 1 to 100.

pm2

wt — white
do — dark orange
db — dark blue
bl — blue
gn — green
dg — dark green
gr — grey
lb — light blue
nt — dark night
or — orange
pn — pink
rd — red
vv — purple
yw — yellow
org — blue (no content specified)
dir — purple (no content specified)
blyw — blue with a yellow dot

Size:

  • m — medium
  • l — large

Content:
number from 1 to 99.

flag

vk

bk — black button
gr — grey button

Size: m — medium.

Content is not specified.

Vector placemarks

org

— blue placemark with a tail

comma

— blue placemark with a circle at the center

round

— blue circle placemark

Note

The Static API does not currently allow setting the size, color, or content for vector placemarks.

By default (if only the placemark coordinates are passed in the request), a medium white placemark is used: pmwtm .

If there is at least one placemark on the map image, the viewport can be set automatically. The Static API selects the values of omitted parameters so that all placemarks are visible on the map. But if the viewport is explicitly set in the request with a pair of parameters (ll and z, or ll and spn) and a placemark's coordinates fall outside the boundaries of the set viewport, this placemark is not shown on the map.

Example

The example below shows a request for an image of a map fragment with placemarks of various styles, colors, and sizes:

https://static.api.mappable.world/v1?lang=en_US&pt=28.98624,41.043451~28.95624,41.043451,78~28.94114,41.043451,pmgrs~28.98124,41.043451,pm2rdm~28.97624,41.043451,pmntl100~28.965573,41.04311,pmors23~28.950111,41.043451,flag~28.969573,41.04311,pm2ywl99~37.608,55.6,round&apikey=YOUR_API_KEY