Documentation

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:

StyleColorSize 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.

pm2wt — 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-
vkbk — black button

gr — grey button

Size:

m — medium

Content is not specified.

Vector placemarks

comma

-

org -
round -
home -
work -
ya_en -
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=en_US&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

placemarksstyle placemarkscolor placemarkssize placemarkstext placemark text placemark style placemark size placemark color URL parameterspt