Placemarks

The pt parameter is for displaying one or more placemarks (up to 100) 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). The placemark definition uses the following pattern:

{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 — midnight

or — orange

pn — pink

rd — red

vv — violet

yw — yellow

a — with the letter "A" (without specifying content or size)

b — with the letter "B" (without specifying content or size)

Size:

  • s — small
  • m — medium
  • l — large
Content:
  • For the sizes s and m, a number from 1 to 99.
  • For the l size, 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 — midnight

or — orange

pn — pink

rd — red

vv — violet

yw — yellow

a — with the letter "A" (without specifying content)

b — with the letter "B" (without specifying content)

org — blue (without specifying content)

dir — violet (without specifying content)

blyw — blue with a yellow dot

Size:

  • m — medium
  • l — large

Content:

Number from 1 to 99.

flag — flag -
vk bk — black button

gr — grey button

Size:

m — medium

Content is not specified.

Vector placemarks

org

— blue pin (placemark with a tail)

-

comma

— blue placemark with a circle in the center

-

round

— blue circle placemark

-

home

— home icon

-

work

— work icon

-

ya_en

— icon with the Yandex logo

-

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 — midnight

or — orange

pn — pink

rd — red

vv — violet

yw — yellow

a — with the letter "A" (without specifying content or size)

b — with the letter "B" (without specifying content or size)

Size:

  • s — small
  • m — medium
  • l — large
Content:
  • For the sizes s and m, a number from 1 to 99.
  • For the l size, 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 — midnight

or — orange

pn — pink

rd — red

vv — violet

yw — yellow

a — with the letter "A" (without specifying content)

b — with the letter "B" (without specifying content)

org — blue (without specifying content)

dir — violet (without specifying content)

blyw — blue with a yellow dot

Size:

  • m — medium
  • l — large

Content:

Number from 1 to 99.

flag — flag -
vk bk — black button

gr — grey button

Size:

m — medium

Content is not specified.

Vector placemarks

org

— blue pin (placemark with a tail)

-

comma

— blue placemark with a circle in the center

-

round

— blue circle placemark

-

home

— home icon

-

work

— work icon

-

ya_en

— icon with the Yandex logo

-

Note. The Static API does not currently allow you to set 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. However, if the viewport is set explicitly in the request by 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 request example below is for an image of a map fragment with placemarks of various styles, colors and sizes:

https://static-maps.yandex.ru/1.x/?lang=&l=map&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