Overview of the Static API

The Static API generates a map image based on the parameter values passed to the service in a URL with the following format:

https://static-maps.yandex.ru/1.x/?{URL parameters}

The substring {URL parameters} contains a sequence of pairs in the format {parameter name}={parameter value}, separated by the ampersand symbol (&).


https://static-maps.yandex.ru/1.x/?lang=&ll=32.810152,39.889847&size=450,450&z=10&l=map&pt=32.810152,39.889847,pm2rdl1~32.870152,39.869847,pm2rdl99

The complete list of URL parameters is shown below.


Parameter	Data type and example	Description
Required parameters
l	`string,[string]...` `l=map`	List of layers that define the type of map: map (roadmap), sat (satellite) and sat,skl (hybrid). For more information, see Map layers and types.
ll	`float,float` `ll=32.810152,39.889847`	Longitude and latitude of the map center in degrees; see Map center.
key	`string` `248120a9-95c1-65b2-8876-fdd3b462ff8d`	API key for the commercial version of the Static API. Required to usethe commercial version.
Optional parameters
spn	`float` `spn=0.01,0.01`	Range of the map's viewport by longitude and latitude (in degrees); see Viewport.
z	`integer` `z=10`	Zoom level of the map (0-17); see Map zoom level.
size	`integer,integer` `size=450,450`	Height and width of the requested map image (in pixels); see Map size. By default, it takes the value 450x450.
scale	`float` (from 1.0 to 4.0) `scale=2.0`	Coefficient for scaling map objects. Takes a fractional value from 1.0 to 4.0. For more information, see Scaling map objects.
pt	`string (MarkerDefinition1~MarkerDefinition2~...)` `pt=32.810152,39.889847,pm2rdl1~32.870152,39.869847,pm2rdl99`	Contains definitions of one or more markers to be displayed on the map. Each marker definition contains its coordinates (longitude and latitude) along with information on its appearance (including style, color, size and the marker text). Marker definitions are separated by a tilda (~). For more information, see Placemarks.
pl	`string (FigureDefinition1~FigureDefinition2~...)` `pl=c:ec473fFF,f:00FF00A0,w:5,37.51,55.83,37.67,55.82,37.66,55.74,37.49,55.70,37.51,55.83`	Contains definitions of geometric figures (polylines and polygons) to display on the map. The figure definition contains coordinates for its points (either a comma-separated list, or encoded), along with information on line color and thickness, and the fill color (for polygons). Figure definitions are separated by a tilda (~). For more information, see Lines and polygons


Parameter	Data type and example	Description
Required parameters
l	`string,[string]...` `l=map`	List of layers that define the type of map: map (roadmap), sat (satellite) and sat,skl (hybrid). For more information, see Map layers and types.
ll	`float,float` `ll=32.810152,39.889847`	Longitude and latitude of the map center in degrees; see Map center.
key	`string` `248120a9-95c1-65b2-8876-fdd3b462ff8d`	API key for the commercial version of the Static API. Required to usethe commercial version.
Optional parameters
spn	`float` `spn=0.01,0.01`	Range of the map's viewport by longitude and latitude (in degrees); see Viewport.
z	`integer` `z=10`	Zoom level of the map (0-17); see Map zoom level.
size	`integer,integer` `size=450,450`	Height and width of the requested map image (in pixels); see Map size. By default, it takes the value 450x450.
scale	`float` (from 1.0 to 4.0) `scale=2.0`	Coefficient for scaling map objects. Takes a fractional value from 1.0 to 4.0. For more information, see Scaling map objects.
pt	`string (MarkerDefinition1~MarkerDefinition2~...)` `pt=32.810152,39.889847,pm2rdl1~32.870152,39.869847,pm2rdl99`	Contains definitions of one or more markers to be displayed on the map. Each marker definition contains its coordinates (longitude and latitude) along with information on its appearance (including style, color, size and the marker text). Marker definitions are separated by a tilda (~). For more information, see Placemarks.
pl	`string (FigureDefinition1~FigureDefinition2~...)` `pl=c:ec473fFF,f:00FF00A0,w:5,37.51,55.83,37.67,55.82,37.66,55.74,37.49,55.70,37.51,55.83`	Contains definitions of geometric figures (polylines and polygons) to display on the map. The figure definition contains coordinates for its points (either a comma-separated list, or encoded), along with information on line color and thickness, and the fill color (for polygons). Figure definitions are separated by a tilda (~). For more information, see Lines and polygons

Commercial version

Static API also provides the commercial version. You should use this version if your project does not meet one or more of the use conditions.

For the commercial version of the API, use following URL format:

https://enterprise.static-maps.yandex.ru/1.x/?key=Your API key&{additional parameters}

The commercial version of the Static API can be purchased from the Developer's Dashboard.

Note. In the commercial version of the Static API, only the “roadmap” layer is available. This is because the license restrictions of data providers do not allow using satellite layers in third-party commercial projects.