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 | | Size:
Content:
|
pm2 | wt — white | Size:
Content: Number from 1 to 99. |
flag | — flag | - |
vk | bk — black button
| Size:
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 | | Size:
Content:
|
pm2 | wt — white | Size:
Content: Number from 1 to 99. |
flag | — flag | - |
vk | bk — black button
| Size:
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 | - |
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