Documentation
Reference
2.1.56 (current version)
collection
interactivityModel
Interfaces

Versions of the JavaScript API

Numbering system

The API version number consists of three numbers, such as 2.1.9. For each update, the API version number increases using these rules:

  • The first number increases for major changes to the API architecture.
  • The second number increases when back-compatibility with prior versions is lost.
  • The third number increases in all other cases.

The first two numbers make up a so-called major version (such as 2.1), and all three numbers together represent a minor version (such as 2.1.9).

Alternatives when enabling the API

When enabling the API, we recommend specifying only the major version (i.e. do not specify the third number of the version). This guarantees that the latest stable minor release of the current major version will be enabled. For example, if you specified version 2.1, the latest available stable version 2.1.x will be enabled (for example, 2.1.8):

<script src="https://api-maps.yandex.ru/2.1/?lang=ru_RU" type="text/javascript"/>

Each new version of API 2.1 becomes a release candidate with a separate branch for documentation and can be accessed either directly as api-maps.yandex.ru/2.1.х (for example, api-maps.yandex.ru/2.1.11), or by enabling api-maps.yandex.ru/2.1-dev.

The link api-maps.yandex.ru/2.1 switches to the new API version at some point after the publication of the release candidate, if users have not reported errors causing degradation of functionality during this time.

<script src="https://api-maps.yandex.ru/2.1-dev/?lang=ru_RU" type="text/javascript"/>
Note. The 2.1-dev version is recommended for application development, while the 2.1 version is recommended for usage.

Although full compatibility is guaranteed between three-digit versions, in rare cases you may find that your client application does not work as intended when you enable the latest API version. To avoid these situations, in particularly crucial cases (presentations, etc.) you may need to enable a specific API version. You can specify its number in its entirety:

<script src="https://api-maps.yandex.ru/2.1.8/?lang=ru_RU" type="text/javascript"/>

Project typeRecommended version for running applicationsRecommended version for development

Small projects

Map constructor.

Map constructor.

Medium and large projects with a basic map

Latest version of api-maps.yandex.ru/2.1.

The release candidate version api-maps.yandex.ru/2.1-dev for checking functionality.

Medium and large projects with complex map features

Set version api-maps.yandex.ru/2.1.x.

The release candidate version api-maps.yandex.ru/2.1-dev for checking functionality.

Projects using the commercial version of the API

Set version api-maps.yandex.ru/2.1.x.Set version api-maps.yandex.ru/2.1.x.

Supported versions

Four major versions of the Yandex.Maps JS API are currently supported:

  • 1.0 (last minor release 1.0.8)
  • 1.1 (last minor release 1.1.21)
  • 2.0 (last minor release 2.0.39)
  • 2.1 (current version)

The previous major versions of the API continue to be supported, but are not being developed. In other words, critical bugs are fixed, but new functionality is not added to them, including support of new web technologies.

Version 2.1 is current supported and being developed.

The minor versions of the API exist for an extended period (approximately six months), but over time they are deleted and replaced with links to the latest stable releases of the corresponding major versions.

Browser compatibility

The Yandex.Maps API works correctly in the following browsers:

  • Yandex.Browser, including the mobile version
  • Chromium and Google Chrome, include the mobile version
  • Safari for Mac and iOS
  • Mozilla Firefox
  • Opera
  • Microsoft Internet Explorer, including the mobile version if the latest versions are installed

All Yandex.Maps API functionality is available and works exactly the same way in these browsers.

In addition, the following browsers are partially supported:

  • Microsoft Internet Explorer versions 8-10
  • Opera version 12
  • AndroidBrowser version 4.0+

In these browsers, you can only access the Yandex.Maps API features that are technically possible to implement on the given platform. For example, Microsoft Internet Explorer does not have full SVG support, so it does not allow setting custom colors for placemarks. In addition, graphical objects and controls may look different in different browsers.

The API is not guaranteed to work correctly in browsers that are functioning in Quirks mode (for compatibility with older versions).

List of versions

The changes to the Yandex.Maps JavaScript API from version to version are listed below. The release date of each version is shown in parentheses.

  • JSAPI 2.1.56 — current version (October 10, 2017) Download PDF
    Change list

    Added:

    • New route editing control to add an expanded route panel on the map.
    • The option to set the routing modes that are available in the route panel.
    • The 'routePanel.geolocate()' method to set the user position as a route point.
    • Placemark presets with new icons.

    Changed:

    • The 'iconCaption' property can now be set for most of the placemark presets.

    Fixed:

    • The 'marker*' events of the panorama player returned the wrong entity in the 'marker' field.
    • The "Open in Yandex.Maps" block was shown on maps in custom projections.
    • When filling a waypoint in the route panel via the API method, its input was still focused.
    • The 'interactiveZIndex' option for the ObjectManager didn't work.
    • Layout fixes.
  • JSAPI 2.1.55 (August 10, 2017) Download PDF
    Change list

    Fixed:

    • Placemarks didn't work with the pieChart layout.
    • Errors occurred if the route editing panel was opened when another route editor was active on the map.
  • JSAPI 2.1.54 (August 08, 2017) Download PDF
    Change list

    Added:

    • New route editing control with panel to set start and finish points for the route.
    • SearchControl options for setting the width of the control.
    • The 'zoomIn()' and 'zoomOut()' methods of the panorama player.
    • The 'markermouseenter', 'markermouseleave','markerexpand' and 'markercollapse' events of the panorama player markers.
    • The 'loadTileSize' option for the RemoteObjectManager and LoadingObjectManager to set the size of tiles to load.
    • The 'getPanoramaManager()' method for access to panorama.Manager.

    Changed:

    • Geolink now supports coordinates as the link body.

    Fixed:

    • The panorama player worked incorrectly in Chromium-based browsers if the player was embedded with iframe.
    • Sometimes high definition tiles weren't loaded in the panorama player after changing the center and zoom.
    • The point "A" cursor blinked when adding a route to the map.
    • The alternative route balloon wasn't open with the first click on the route line.
    • The route editing cursor was still shown on the map when the panorama layer was enabled.
    • The map popup wasn't hidden with repeat clicks on the Geolink.
    • Issues with map dragging when the map was embedded with iframe.
    • Sometimes the 'click' event occurred after map dragging.
  • JSAPI 2.1.53 (July 11, 2017) Download PDF
    Change list

    Fixed:

    • API working in webView on iOS devices.
  • JSAPI 2.1.52 (June 06, 2017) Download PDF
    Change list

    Fixed:

    • CSP mode issues.
  • JSAPI 2.1.51 (May 23, 2017) Download PDF
    Change list

    Changed:

    • Design of route reference points and the route editor cursor.

    Fixed:

    • The route segment icon sometimes indicated the wrong transport mode for mass transit routes.
    • When zooming the minimap with the right mouse button in panorama view mode, the selected area wasn't shown.
    • The ruler didn't work with the panorama layer enabled.
    • The 'getObjectInPosition()' method of the hotspot layer sometimes didn't round off the fractional zoom level value in tile requests.
    • When searching for businesses, the object balloon sometimes opened automatically if the map viewport contained just a single result.
    • Geolink map locale didn't match the API locale.
    • Geolink popup contained an empty description when the request returned an error.
    • Address wasn't shown for houses in POI balloons.
    • Rendering error when zooming a panorama on iOS.
    • POI markers on the map sometimes were non-interactive.
    • The API responded with the status 500 instead of 400 for some incorrect requests.
    • Error of the geocollection 'removeAll()' method when items are set by indexes.
    • Optimized API loading.
  • JSAPI 2.1.50 (April 04, 2017) Download PDF
    Change list

    Fixed:

    • Panorama player didn't work with latest updates of Safari for MacOS and iOS.
  • JSAPI 2.1.49 (March 30, 2017)
    Change list

    Added:

    • Panorama layer selection in 'typeSelector' can be disabled after creating the control.
    • Hot keys in the panorama player to change the viewing direction: PageUp - look up, PageDown - look down (use with the Fn key on MacOS).

    Changed:

    • Namings of interfaces and methods related to panorama connections. Old names are still valid.
    • Search result placemark is placed to the coordinates from the request when searching by coordinates in 'searchControl'.
    • Walking time is now shown for walking segments on mass transit routes.
    • Panorama marker layout on dark map layers.

    Fixed:

    • When calling the 'setBounds()' method, some browsers requested unnecessary map tiles.
    • Geolink balloon content inherited page styles.
    • The "Search in Yandex" link in 'searchControl' redirected to the wrong domain for the ru_UA API locale.
    • Encoding issues in MS IE when navigating to Yandex.Maps from the toponym balloon title.
    • An error in the hotspot layer occured when 'keyTemplate' is set as a function.
    • The 'getObjectInPosition()' method of the new hotspot layer returned 'null' until the cursor moved to the next tile.
    • Hotspot layer objects were sometimes duplicated when 'getObjectsInPosition()' was called multiple times.
    • API usage with CSP enabled caused errors in MS IE 8, MS IE 9 and Opera 12.
    • Sometimes the wrong viewing direction was applied when creating the panorama player.
    • The 'fitToViewport()' method for the panorama player ignored the 'padding' CSS property.
    • Optimized network requests for the panorama player working inside the map when the internet connection is slow.
    • Route via points were sometimes duplicated after dragging.
    • Deleting via points on a route sometimes caused other route points to change positions.
    • An error occured if the traffic layer was enabled right after clicking on the panorama layer when the API was loaded with the 'mode=release' parameter.
    • The issue with displaying complex polygons.
    • Layout errors.
  • JSAPI 2.1.42 (March 30, 2017)
    Change list

    Added:

    • Panorama layer selection in 'typeSelector' can be disabled after creating the control.
    • Hot keys in the panorama player to change the viewing direction: PageUp - look up, PageDown - look down (use with the Fn key on MacOS).

    Changed:

    • Namings of interfaces and methods related to panorama connections. Old names are still valid.
    • Search result placemark is placed to the coordinates from the request when searching by coordinates in 'searchControl'.
    • Walking time is now shown for walking segments on mass transit routes.
    • Panorama marker layout on dark map layers.

    Fixed:

    • When calling the 'setBounds()' method, some browsers requested unnecessary map tiles.
    • Geolink balloon content inherited page styles.
    • The "Search in Yandex" link in 'searchControl' redirected to the wrong domain for the ru_UA API locale.
    • Encoding issues in MS IE when navigating to Yandex.Maps from the toponym balloon title.
    • An error in the hotspot layer occured when 'keyTemplate' is set as a function.
    • The 'getObjectInPosition()' method of the new hotspot layer returned 'null' until the cursor moved to the next tile.
    • Hotspot layer objects were sometimes duplicated when 'getObjectsInPosition()' was called multiple times.
    • API usage with CSP enabled caused errors in MS IE 8, MS IE 9 and Opera 12.
    • Sometimes the wrong viewing direction was applied when creating the panorama player.
    • The 'fitToViewport()' method for the panorama player ignored the 'padding' CSS property.
    • Optimized network requests for the panorama player working inside the map when the internet connection is slow.
    • Route via points were sometimes duplicated after dragging.
    • Deleting via points on a route sometimes caused other route points to change positions.
    • The icon for a walking segment was sometimes duplicated in the route balloon.
    • An error occured if the traffic layer was enabled right after clicking on the panorama layer when the API was loaded with the 'mode=release' parameter.
    • Sometimes two route balloon panels opened on the map at once.
    • The issue with displaying complex polygons.
    • Layout errors.
  • JSAPI 2.1.41 (June 7, 2016)
    Change list

    Changed:

    • The duration of kinetic drag.

    Fixed:

    • Dependencies of third-party modules could not be resolved by fallback.
    • The error message didn't load in searchControl when there were no search results.
  • JSAPI 2.1.40 (May 26, 2016)
    Change list

    Added:

    • Pedestrian routing.
    • New presets for placemarks with icons.
    • Contextual hints when searching for businesses.
    • Support for the 'autoPan' option for the balloon in panel mode.

    Changed:

    • The logic of user interaction with 'searchControl'.

    Fixed:

    • In some cases, the 'resultHide' event wasn't triggered.
    • When calling the 'destroy()' method for the map, an error occurred in 'suggest' for 'searchControl'.
    • The "Sending request to server" message didn't appear in 'searchControl'.
    • Business hours weren't displayed in the search if the API was enabled with the coordorder=longlat parameter.
    • Errors when using a Map Builder map in an Angular application.
    • Error when setting ruler states without the map.
    • The "Open in Yandex.Maps" block didn't display in Mozilla Firefox when loading the map in a hidden container.
    • Optimized search queries.
    • Optimized layouts and CSS.
    • Tile performance issues in Mozilla Firefox.
  • JSAPI 2.1.39 (April 14, 2016)
    Change list

    Fixed:

    • The 'boundschange' event occurred twice when dragging with inertion.
    • A placemark was displayed incorrectly if a preset was changed when workiing with the map.
    • Memory leaks in option.Manager.
  • JSAPI 2.1.38 (March 31, 2016)
    Change list

    Added:

    • The Panoramas API for integrating a Yandex panorama or your own panorama on your website (beta release).
    • Shifting the map when nearing its borders in vertex drawing mode in the geometry editor.

    Fixed:

    • The problem with hotspots for cluster placemarks in Firefox and Safari.
    • Incorrect map behavior when calling 'map.destroy()' during shape editing.
    • SearchControl replaced entered quotation marks with "&quot;".
    • Incorrect behavior of the geometry editor when using the global CSS rule 'text-align: center'.
    • Incorrect behavior of the 'useMapMargin' option for 'route'.
    • Geometry drawing finished when removing a ruler point by double-click.
    • Transition via the "Open in Yandex.Maps" block with the objects search results.
    • Tile animation artifacts in Firefox on HD displays.
  • JSAPI 2.1.35 (February 18, 2016)
    Change list

    Added:

    • The "Open in Yandex.Maps" block now passes placemark locations, routes, search results, and other map parameters.
    • The MarginManager for setting the map margins.
    • The coordinates corrector in the point geometry editor.
    • The ability to access the fields of a cluster's child objects from the hint layout.
    • The ability to pass the zoom level manager of a specific map to the 'requireCenterAndZoom' method of the 'map.ZoomRange' object.
    • Basic methods for accessing xAL geocoding results.

    Changed:

    • The logic for transitions out of the "Open in Yandex.Maps" block on mobile devices.
    • The "Open in Yandex.Maps" block is now hidden when printing.
    • A new hotspots algorithm: PR-tree.

    Fixed:

    • The KML parser now correctly processes width and height parameters in the 'iconImageSize' option.
    • Tile rendering for traffic predictions on Retina displays.
    • Improved performance through optimized caching.
    • Internal API scripts are always loaded over HTTPS.
    • Removed the global variable 'res'.
    • When rotating a shape and scrolling in the rotation editor simultaneously, it didn't hide anymore.
    • When editing intermediary points, the previous line of drawing remained in the editor.
    • If an object was made much smaller in editing mode, it was sometimes rendered outside of the frame.
    • In 'canvas' mode, the 'stretch' fill didn't work correctly for multi-contour polygons.
    • Polygons with an internal contour were displayed incorrectly when located near the 180th meridian.
    • Fixed the behavior of the 'geocode' method when a server error occurs.
    • Dynamically changing the display of placemarks in IE 11.
    • Layout when specifying the global CSS rule 'text-align: center'.
    • Layout of a business profile in the Turkish locale.
    • Problems with displaying the map when zooming in MacOS X 10.11 in Safari.
    • The order of adding and displaying throughpoints in the multi-route builder.
    • Cluster positioning in the object manager on the Z axis.
    • An error occurred when 'map.destroy()' was called twice if the map had a ruler on it.
    • Fixed the layout in older browser versions.
  • JSAPI 2.1.34 (December 7, 2015)
    Change list

    Fixed:

    • Worked incorrectly with RequireJS-style module systems.
  • JSAPI 2.1.32 (November 25, 2015)
    Change list

    Added:

    • New design and optimization of the geometry editor.
    • The "Open in Yandex.Maps" block now supports maps created in the Map Builder.
    • Printing standard placemarks in Mozilla Firefox.
    • Objects in ObjectManager support the zIndex option.
    • Improved the business profile in the search by business.
    • Possible to switch to Yandex search if SearchControl didn't return any results (controlled by the suppressYandexSearch option).
    • The menu in the geo object editor now allows you to pass HTML markup.
    • The 'clear()' method is now available in SearchControl.
    • Optimized filtering in ObjectManager.
    • Optimized animation on mobile devices.
    • The 'suppressMapOpenBlock' option can be changed in runtime.

    Fixed:

    • If multiple versions of the API were enabled with different localed, placemarks were duplicated.
    • The 'getOverlay()' method for geo object balloons and hints now always returns a promise (which may be rejected if there isn't an overlay).
    • There wasn't a 'drawingstart' event when selecting "Continue" in the graphics editor.
    • An error could occur when switching the multiroute mode from driving to public transport.
    • Problems with double taps on placemarks in Android.
    • When using the touchpad to scroll on a Mac, it jumped in the opposite direction.
    • Internal contours on polygons no longer disappear when switching between worlds.
    • When rotating a polygon with an internal contour, sometimes an extra point was added.
    • Map dragging was blocked after pressing the left and right mouse buttons in turn in MSIE10 and MSIE11 in WIN8-10.
    • Animation artifacts in Mozilla Firefox.
    • SearchControl didn't work correctly with the 'popupItemLayout' option.
    • Problems displaying areal objects in MSIE.
    • In editing mode, the context menu could be detached from the vertex of a polygon.
    • Balloon options weren't passed in the 'setObjectOptions()' method of the 'objects' object in the 'ObjectManager' class.
    • When searching for businesses, 'searchControl' showed the first result at the other end of the world if '&coordorder=longlat' was set.
    • For the hint overlay and panel, the 'getShape()' method sometimes returned null.
    • Usage of the option clusterIconContentLayout: null.
    • Problems displaying circles that crossed the 180th meridian.
    • The "Open in Yandex.Maps" block is now shown only in the geographical coordinates system.
    • An incorrect 'bounds' was received for routes consisting of multiple identical points.
    • Minor layout errors.
  • JSAPI 2.1.31 (November 5, 2015)
    Change list

    Fixed:

    • A problem with dragging route points in Microsoft Edge.
    • A problem with the scroll gesture in Chrome on MacOS.
  • JSAPI 2.1.29 (August 3, 2015)
    Change list

    Added:

    • Support for new browsers: Microsoft Edge and Firefox for Android.

    Fixed:

    • The coordinates of reference points shifted when building multi-routes with reverse geocoding enabled.
    • Problems with the "click" event on some Android devices.
  • JSAPI 2.1.27 (June 18, 2015)
    Change list

    Added:

    • The "Open in Yandex.Maps" link at the bottom of the map.
    • The "Update browser" link for outdated browser versions.
    • The 'Template' class.

    Changed:

    • Optimized RemoteObjectManager: displays points only in the visible area.

    Fixed:

    • Geocoding of route points in enterprise versions.
    • An occasional error when building a route from three points.
    • Optimized the speed of zooming maps on iOS devices.
    • Problems with touch events when certain areal geo objects were added to the map.
    • YMapsML: failed to set the map type if 'MapState' had 'bounds'.
    • Incorrect sizes for 'masstransit' icons in the multi-route builder.
    • Invalid value for the 'address' field in the multi-route builder.
    • Results were not deleted in the search control when the provider was changed.
    • A custom provider for suggestions didn't display values.
    • 'util.hd.selectValue()' didn't return values for fractional DPRs.
    • Clusters in RemoteObjectManager disappeared when the zoom changed.
    • Placemark shifting when the page zoom was changed.
    • 'editor.StartDrawing()' worked incorrectly in the 'geometrychange' event handler for a polygon.
    • When dragging a route, the 'searchCoordOrder' parameter was ignored.
    • The map crashed in IE8 if it was initialized in a hidden container.
    • Problems displaying graphics when zooming in IE 8-9 and Opera 12.
  • JSAPI 2.1.26 (May 27, 2015)
    Change list

    Added:

    • Automatically moving the map when drawing or editing objects close to the edges.
    • Printing the map in Firefox.
    • The 'util.hd' module for working with high-definition screens.
    • The 'util.bounds' module for working with boundaries and their intersections.
    • The 'event.Mapper' module for managing event propagation.
    • The 'ymaps.meta' module, which contains API parameters and environment data.
    • The 'util.requireCenterAndZoom' module for calculating the optimal center and zoom for displaying the map with the specified boundaries.
    • Support for the 'AddressDetails' field when searching for organizations.

    Changed:

    • Expanded the interface for the 'ready' method, which now allows loading additional modules.
    • Optimized the smoothness and responsiveness of map actions.
    • Optimized the first loading of required modules.
    • Optimized map zooming on mobile devices.
    • Optimized the 'dblClickZoom' map behavior.
    • Smooth scrolling of elements with 'overflow: auto' in iOS.
    • Route points are now geocoded on the client.

    Fixed:

    • Removed global CSS 'box-sizing' rules that could affect custom elements.
    • Corrected the 'getClosest' method in geometries.
    • Rendering stretchy icons with brief contents.
    • In geo objects, the promise object for the 'open' method on a hint or balloon did not return the value if opening or closing was called before modules had loaded.
    • Displaying a hint when pointing the mouse at the center of certain objects instead of under the cursor.
    • Scrolling disappeared in the panel when the balloon height changed.
    • Error when holes or empty spots appear in a collection of geo objects.
    • Incorrect placemark cursor with the 'interactive: false' option.
    • Setting 'dataURI' / 'Image' / 'Canvas' didn't work for the 'fillImageHref' option on geo objects.
    • Incorrect fill when zooming for self-intersecting polygons.
    • Closing a cluster balloon on the 'change' state event or when changing the 'activeObject' field caused an error.
    • When enabling geometry editing, the 'editorstatechange' and 'statechange' events were thrown twice.
    • The vertext in the graphic editor jumps to the original location if the map is moved while dragging it.
    • Problems when rotating a polygon with an internal contour.
    • Scrolling while dragging the vertex in the editor caused an error.
    • Problems displaying copyrights on small maps.
    • The sorting order elements in a drop-down list.
    • An error in IE 10-11 that changed the size of a drop-down list.
    • Errors rendering a drop-down list.
    • Changing the 'maxWidth' option did not visually change the button.
    • The panel with search and traffic blinked when switching tabs.
    • Copyrights were missing on tablets.
    • An error hiding the search results panel when 'visible: false' was set.
    • Problems with the "Search on map" drop-down list when switching to full screen.
    • Errors rendering and displaying the "Search on map" control.
    • When there was a search error, the text "Making server request..." was shown instead of "The server could not process the request".
    • Automatic zooming to a selected search result on the map didn't work.
    • Problems deleting a point on the middle of a route.
    • An error when trying to change coordinates before adding points to the map in the router.
    • Some non-point objects were not shown on the map in the object manager and 'LoadingObjectManager'.
    • The promise object from a hint's 'open' method was not returned in the object manager.
    • 'map.geoObjects.getBounds' returned 'null' when the object manager was added to the map.
    • Errors in the object manager when changing the fractional map scale.
    • Incorrect result for the 'getBounds' method after deleting objects from the manager.
    • The "id" string was replaced with 'object.id' in the object manager's 'setFilter' method.
    • The order of mouse events in layouts and overlays.
    • Smooth zooming in tiles.
    • Problems when dragging the map in Internet Explorer 10.
    • Errors when rendering placemarks at high zoom levels in Chrome.
    • Problems with gestures in Windows Phone.
    • Problems with rendering and sending events using various components in older versions of IE.
  • JSAPI 2.1.23 (17 March, 2015)
    Change list

    Added:

    • Support for non-point geo objects was added to ObjectManger.
    • RemoteObjectManager and LoadingObjectManager can now detect the name of the callback function for a JSONP request.
    • RemoteObjectManager now has the setFilter(), getFilter(), and getObjectState() methods.
    • The noPlacemark option was added to the "Geolocation" control.
    • The nearest metro stations are now displayed for toponyms in the results of searching for organizations.

    Fixed:

    • Geo objects couldn't be dragged in drawing mode.
    • Problems with interactivity and disappearance of geo objects when switching between panes.
    • The cluster hint worked incorrectly.
    • An error when double-clicking on a cluster.
    • The 'icons' option worked incorrectly in the clusterer.
    • Cluster icons disappeared when pointing the cursor in certain cases.
    • The 'boundsPath' value for the coordRendering option on a rectangle.
    • An error moving an open balloon in ObjectManager.
    • Faster deletion of geo objects in ObjectManager.
    • Errors in balloon in ObjectManager.
    • Corrected filtering of clustered objects in ObjectManager.
    • How the ObjectManager.getBounds() method works for clusterization.
    • When using the 'longlat' order of coordinates, the ObjectManager balloon opened in the wrong place.
    • Setting the mapStateAutoApply option for the multiroute mode when using ymaps.route.
    • The showResult() method for the "Search on map" control didn't execute when the noPlacemark and noCentering options were enabled.
    • Displaying large balloons with organizations in panel mode.
    • An error with repeated data requests after an invalid result in the search for organizations.
    • An error in the search for organizations that sometimes caused coordinates to be returned in the wrong order.
    • Problems with simultaneous actions on the map, such as Balloon.autoPan() and Map.panTo().
    • The hotspot layer worked incorrectly after being updated.
    • Errors when changing the hasBalloon option for hotspots.
    • A set of errors and inconsistencies rendering map elements.
  • JSAPI 2.1.22 (February 26, 2015)
    Change list

    Fixed:

    • SVG placemarks were not displayed in Firefox when the <base> tag was set.
    • The balloon for placemarks loaded via geoxml did not open when balloonTemplate was specified.
    • The getResult method worked incorrectly in SearchControl when the noPlacemark and noCentering options were set.
  • JSAPI 2.1.20 (February 5, 2015)
    Change list

    Fixed:

    • Blinking tiles when dragging the map.
    • Objects disappearing when dragging over the 180th meridian.
    • Problems with transparency in areal geo objects.
    • Displaying a zero outline for geo objects.
    • When changing the 'offset' option for overlays, the result of calling the getShape() method didn't change.
    • Problems with 'autoPan' in balloons.
    • After automatically positioning a balloon, the balloon opened for the object that was under the cursor.
    • Error displaying the hint for a geo object after closing the balloon panel.
    • The 'mouseleave' events didn't work right in hotspots when dragging the map.
    • Search for organizations: organization profiles disappeared immediately after opening.
    • Artifacts when removing the "Search on map" control from the map.
    • Problems displaying the results of the "Search on map" control on the Public Map.
    • Error when editing throughpoints in the router.
    • Problems rendering route points and segments in IE9 and Android Browser.
    • Error in the editor with resuming drawing after deleting existing points.
    • The editor didn't show the guide lines in drawing mode for a polygon or polyline.
    • Ruler end points were deleted when attempting to add a point by double-clicking.
    • Fixed the key of the 'islands#multiRouterBigSmallPoint' layout to 'islands#multiRouterSmallWayPoint'.
    • No 'mousemove' events in IE on touch devices.
  • JSAPI 2.1.17 (October 30, 2014)
    Change list
    Added:
    • The ability to add custom filters to layout templates.
    • The Template class for working with HTML templates.

    Changed:

    • RemoteObjectManager displays objects only in the map viewport.

    Fixed:

    • RemoteObjectManager did not redraw identical objects when changing the zoom level.
    • Error that caused the viaPointsChange field for the multiRouter.MultiRouteModel.requestsuccess event to take an invalid value.
    • Placemark positioning when changing the page scale in Chromium browsers.
    • After selecting a layer in the drop-down list of layers, the list did not close.
    • In some cases, errors occurred when entering text in the "Search on map" control when using the mouse and keyboard simultaneously.
    • Errors with the geo object editor.
    • editor.StartDrawing worked incorrectly in the geometrychange event handler for a polygon.
    • Errors in displaying the "Traffic" control when displaying maps from a hidden container.
    • In some cases, the "Traffic" panel displayed the wrong time.
    • In some cases, errors occurred if a balloon was opened on a placemark and the zoom was then changed, causing the placemark to be in a cluster.
    • When dragging a route, the searchCoordOrder parameter was not taken into account.
    • In some versions of IE, animation was not triggered when changing tiles.
    • Errors when changing the boundaries of elements in nested collections.
    • Errors when deleting and re-adding ObjectManager to the map.
    • Fixed memory leaks.
    • Errors when hotspot objects with identical IDs were in multiple neighboring tiles.
  • JSAPI 2.1.16 (September 17, 2014)
    Change list
    Added:
    • The activeRouteAutoSelection option for the multi-router.
    • The update event for the multi-router.
    • Search suggestions in the commercial version of the API.

    Fixed:

    • The cluster balloon worked incorrectly when html was set in clusterCaption.
    • Errors when working with a point balloon for the geo object editor in IE8.
    • Errors when filtering objects in ObjectManager.
    • The ObjectManager.getObjectState method returned incorrect values for objects outside of the viewport.
    • In IE9 and IE10, changing the zIndex of a route was incorrectly processed in some cases.
    • The autoPan method returned an incorrect value for a balloon in panel mode.
    • In some cases, an error occurred when changing the value of the yandexMapAutoSwitch option.
    • Nodal points in the geo object editor shifted aways from the object in iOS7.
    • The fillOpacity option for a geo object didn't work in some cases.
    • The fill option for a geo object didn't work in some cases.
    • The error message text was missing in the search control in the English version.
    • Problems with scrolling the default cluster balloon when setting a custom itemContentLayout.
    • LoadingObjectManager and RemoteObjectManager sent invalid requests when moving the map across the prime meridian.
    • In some cases, options for single objects didn't work in ObjectManager.
    • Errors when changing the hasHint option for the clusterer.
    • In some cases, the cluster hint did not close when moving the cursor away from the placemark.
    • Errors with the hint manager for ObjectManager.
    • In some cases, a cluster placemark was displayed incorrectly when switching the balloon to panel mode.
    • In some cases, the placemark balloon did not close when the placemark was in a cluster in ObjectManager.
    • When repeating a call of the GeoQueryResult.addToMap method, objects were deleted and added to the map again.
  • JSAPI 2.1.15 (August 28, 2014)
    Change list
    Added:
    • LoadingObjectManager — a module that allows adding a very large number of placemarks (a significantly greater number of placemarks) to the map. If necessary, it clusters them. It loads data from the server only for those placemarks that fall within the map viewport.
    • RemoteObjectManager — a module for displaying a large number of placemarks by loading data from the server by tiles or for the map viewport. It uses server clustering of data.

    Fixed:

    • Duplicated text when typing with search suggestions enabled in Android browsers.
  • JSAPI 2.1.14 (August 7, 2014)
    Change list
    Added:
    • New features in the template engine - elseif and square brackets.
    • Previous requests can be canceled when setting new reference points and parameters in the multi-router.
    • Search suggestions panel.
    • The 'onerror' parameter when enabling the API.
    • The ability to disable exiting full-screen mode when pressing the Esc key.
    • Added the GeoQueryResult.getParent method.
    • The then method for the GeoQueryResult object supports the execution context of callback functions.
    • Faster rendering of graphics with a background image.
    • The ability to specify the shape of the cluster placemark in JSON format.

    Fixed:

    • Graphics errors in IE.
    • Errors with the multi-router.
    • Error with enabling two different API versions on the same page.
    • In certain cases, an error occurred when clicking on the traffic layer in IE8.
    • In certain cases, an error occurred when deleting the "Traffic" control from the map.
    • Errors in displaying a polygon with an inside contour.
    • Errors in graphic display with the opacity option set to 0 in IE9-11.
    • Incorrect display of scrollbar in search results.
    • In some cases, the map became inactive in the mobile version of Chrome for Android.
    • Problems with dragging on WindowsPhone.
    • Error with passing events from under the ItemContent layout in a cluster balloon.
    • Layout errors for controls in IE8.
    • Error with re-adding an element in ObjectManager.
    • Error displaying a balloon when initializing from a hidden container.
    • Error calling the autoPan method in balloon managers.
    • Error dragging objects under the events layer.
    • A balloon in panel mode did not shift the "Ruler" control.
    • Error switching to full-screen mode when the map is located in a container with dynamic width.
    • Error hiding hints in certain cases.
  • JSAPI 2.1.11 (June 26, 2014)
    Change list
    Added:
    • Public transport in the multi-router.
    • The ObjectManager module for displaying a large number of placemarks on the map.
    Changed:
    • Updated the Regions module.
    • map.geoObjects.getBounds now calculates objects that are in the clusterer.

    Fixed:

    • Errors with initializing the map in iframe.
    • Mixed up order of click, select, and press events for FullscreenControl.
    • The zoomControl element did not calculate the lower offset when calculating its dimensions.
    • The container with the base layer shifted in relation to the events layer in Android 4.x.
    • In some cases, the browser unexpectedly stopped working on iOS devices with Retina screens.
    • Incorrect map display in an element with position: fixed in webkit.
    • The strictBounds option did not work in control.SearchControl.
    • Errors animating control.ListBox in iOS 6.
    • When "enter" was triggered on the "Search on map" control, it performed "submit" on the parent form.
    • Incorrect time displayed in the traffic panel when changing time zones.
    • Error when using the API with the sugar.js library in IE8.
  • JSAPI 2.1.9 (April 24, 2014)
    Change list
    Added:
    • The "shape" option in templateLayoutFactory.
    • Documented the API 2.1 module system.
    • The ability to specify an empty namespace (the "ns" load parameter) to get API functionality as an argument when calling the "onload" function.
    • Documented standard implementations of the IPane interface.
    Changed:
    • The cluster placemark increases the z-index when the mouse pointer is on it.
    • The promise returned by the ymaps.ready function is confirmed by the ymaps namespace.

    Fixed:

    • The way the removeMapType and removeAllMapTypes work in the "Layers" control.
    • Error in setting the scroll state in the default cluster balloon.
    • Artifacts in the layout of the accordion balloon cluster in AndroidBrowser.
    • Error when parsing geoQuery.search.
    • "Shaking" placemarks in iOS 6.
    • Problems with activating the "Layers" and "Traffic" controls on OS Android tablets.
    • Flickering "Traffic" control in a touch interface.
    • Layout errors for the "Traffic" control.
    • Layout errors in IE.
    • Error when disabling the graphics editor.
    • In some situations, the height of the balloon panel didn't change when the map height was changed.
    • The getElement and getBalloonElement methods returned incorrect values in the panel mode.
    • In certain situations, horizontal scrolling was missing in the cluster balloon.
    • The balloon panel could cover the placemark it was opened on.
    • In certain situations, the traffic hint did not hide itself in FireFox browser.
    • Problems with performance on the iPad when the traffic layer was enabled.
    • In certain situations, the marker preset was reset after closing a balloon.
  • JSAPI 2.1.7 (April 10, 2014)
    Change list
    Added:
    • Router with alternate routes.
    • The zoomMargin option in SearchControl.
    • The setAll method in data.Manager.
    Changed:
    • Updated the design of the cluster balloons.
    • Standard cluster placemarks were converted to SVG.
    • New design for traffic event balloons.
    • When setting "position" options for controls, the "float" option value is interpreted as "none".

    Fixed:

    • Minor interface errors.
    • Blinking controls when displaying maps on mobile devices.
    • Initialization of SearchControl from a hidden container.
    • Use of the drawingCursor option.
    • In certain cases, a geo object hint was not hidden.
    • In certain cases, pixelgeometrychange occurred at the wrong time.
    • Minor errors in the new template factory.
    • The first found item was not selected in the "Search on map" control.
    • The white background of the ruler line was rendered incorrectly at large distances.
    • Editing mode for polygons and polylines did not turn off on a double-click.
    • A route continued being edited after deactivating the corresponding control.
    • The vertexdragend event was generated at the wrong time.
    • Drop-down lists were not clickable in Android browsers.
    • Errors in animating "Traffic" controls.
    • Errors in the zoom scale layout.
    • In the controls manager it was not possible to subscribe to events of child elements.
    • The wrong index for an added vertex in the vertexadd event of the polygon editor.
    • When changing positions, zoomcontrol assumed the wrong size.
    • Errors in the "Search on map" control layout in Internet Explorer versions 8 and 9.
    • When calling the "search" method for the "Search on map" control with the "small" and "medium" states, the drop-down list with search results was not shown by default.
    • A line on the map was blinking if strokeWidth increased when pointing at it.
    • The behavior .behavior.MultiTouch was corrected.
    • After deleting all the points on a polygon, drawing mode was turned off.
    • An empty balloon opened when clicking on the route line.
    • An incorrect value for the "position" field in DOM events in Internet Explorer.
    • Route points were not set over geo objects.
    • In certain cases, the dimensions of balloon contents were calculated incorrectly.
    • Options for displaying a geo object were incorrectly processed on devices with high pixel density.
    • A placemark hotspot did not change when the placemark style was changed.
    • Information about an object did not fit in the balloon panel.
    • In certain cases, clicking an object on the map caused the map to move.
    • An error occurred if the cluster balloon was opened when another balloon was already open on the map.
    • The "tremor" option did not work in behavior.Drag.
    • In Internet Explorer, a placemark disappeared after the balloon closed.
    • When switching balloonPanelMaxMapArea, certain options did not work correctly.
    • Geolocation of the user by IP did not work.
    • Stretchy placemarks did not stretch if there was a space in the placemark content.
    • The context menu did not open when right-clicking balloons.
    • Errors when adding map types to TypeSelector.
    • The application crashed on an iPad with a Retina screen.
    • Error destroying the map immediately after creating it.
    • Errors in the geoXML module.
    • The balloon panel and copyrights moved when text was selected.
  • JSAPI 2.1.5 (February 11, 2014)
    Change list
    Added:
    • The ymaps.ready and ymaps.load methods return a vow.Promise class object.
    • The position of a drop-down list depends on where the list's button is placed on the map.
    • Support for nested namespaces for the API loader's "ns" parameter.
    • Methods for the util.AsyncStorage class return a vow.Promise class object.
    • Updated implementation of vow.Promise to correspond to the http://dom.spec.whatwg.org/#promises standard.
    • Textual templates have been switched to a new syntax. Added support for the "for" cycle and processing nested conditions and cycles. For more information, see the documentation.
    Changed:
    • Faster construction of the cluster balloon layout.

    Fixed:

    • Scrolling long lists in Safari iOS7.
    • Layout errors in the "Traffic" control panel in Opera.
    • Layout conflicts when the bootstrap library is enabled.
    • Conflicts displaying the search results and the keyboard on mobile devices with the "Search on map" control.
    • Layout errors in a drop-down list in Opera.
    • Behavior of placemark balloons and hints in IE8.
    • Errors when dynamically changing the clusterer's hasHint and hasBalloon options.
    • Animations triggered excessively in the "Search on map" control.
    • Errors when deleting the "Search on map" control.
    • The button for clearing the search query was missing in IE8.
    • Layout errors in the "Traffic" control panel.
    • Removed "contextmenu" event emulation in browsers on WinPhone that do not support it.
    • In some cases, the mobile browser stopped responding when changing the map zoom with traffic enabled.
    • Code loops with a nested subscription to the ymaps.ready handler.
    • Conflicts when enabling two versions on the same page.
    • The getZoomRange method was not in package.full.
    • Memory leaks when processing events.
    • The clusterer's balloonopen and balloonclose events were duplicated.
    • Errors in "release" mode when deleting the clusterer from the map.
    • Placemark presets were reset when re-closing a balloon.
    • The "mouseenter" events were duplicated in IE8 and IE9.
    • The "click" event did not occur on a cluster if a balloon opened on it.
    • Submitting a search query using the Enter key in IE8.
    • Map zooming didn't work when double-clicking geo objects without a balloon.
    • The clusterer did not generate "optionschange" events.
    • The "pane" option did not work for point geo objects.
    • When editing lines and polygons, the balloon moved.
    • Extra "close" and "balloonclose" events for a geo object and its balloon.
    • Extra "autopanbegin" and "autopanend" events for a geo object's balloon.
    • The "destroy" method was not called for layouts created programmatically.
    • In some cases, "defaultaction" events were duplicated in controls.
    • After closing a geo object's balloon, the hint appeared.
    • Ruler points were not set over geo objects.
    • Mini-balloons on the ruler were incorrectly positioned in IE8 and IE9.
    • Errors in the "Traffic" control panel when re-adding it to the map.
    • Errors in drop-down list layouts in IE8.
    • The map center changed in response to a long touch on a geo object in Safari i)S 6.1.
    • In some cases, cluster hints did not disappear.
    • In Windows 8, the "click" and "contextmenu" events were simultaneous.
    • When automatically going to the Public Map in Firefox, tiles were not shown for HD devices.
    • In some cases, interactivity of geo objects was lost when changing the map zoom.
    • When changing "pane" options, the incorrect zIndex value was set for geo objects.
  • JSAPI 2.1.4 (December 19, 2013)
    Change list
    Added:
    • Ability to display pop-up hints in the clusterer.
    • Added the getDistance method to geometry.LineString.
    • Added the currentTarget field when distributing events of geo objects.
    • Clusterer presets can be set explicitly in the cluster placemark.
    • The value of the clusterIconContentLayout option can be set to null for displaying the cluster placemark without content.
    • Ability to set "shape" in cluster placemark descriptions.
    • The "context" parameter in the GeoQueryResult.each method.
    • The panelMaxMapSize balloon option.
    • The interactiveZIndex option, which turns off auto-setting the zIndex depending on the geo object state.
    • Added the "overlays" pane.
    • The iconOpacity option for placemarks.
    • The "show more results" button for the "Search on map" control.
    • The viewportMargin option for the clusterer.
    Changed:
    • The "get", "each", and "getIterator" clusterer methods were replaced with getGeoObjects and getClusters.
    • The Cluster object was renamed to ClusterPlacemark.
    • Improved logic for switching to the Public Map.
    • Method for working with the cluster balloon placemark.balloon.open and cluster.balloon.open.
    • Now placemarks are always added to the clusterer synchronously.

    Fixed:

    • Support for Windows Phone 8.
    • Errors with text visibility in the search bar.
    • Errors with displaying copyrights.
    • Errors when positioning list items with negative indexes.
    • Incorrect clusterer behavior when the gridSize option had values that were not a power of two.
    • Extra "mouseleave" events were generated on the map in IE8 and IE9.
    • Errors when trying to clear option values for the control manager.
    • Errors in deleting a set of controls from a map.
    • Errors after enabling the placemark drawing mode.
    • Errors loading the API without specifying the "load" parameter.
    • Memory leaks when deleting events on the fly in domEvent.manager.
    • Errors when right-clicking in the browser with pointer events.
    • When opening the balloon panel, copyrights did not move to the top.
    • Layout errors in the "Traffic" control panel in Opera.
    • Layout errors in a drop-down list.
    • Incorrect calculation of zIndex for overlays located in different panes.
    • Inverted scroll zoom in Chrome.
    • Errors in distributing events on geo objects that do not have a balloon.
    • Incorrect re-drawing of a balloon when the map dimensions changed or a placemark was dragged.
    • Performance issues when using the Cartesian projection.
    • In IE8 the balloon did not appear when switching to full-screen mode.
    • Open hints remained after deleting the ruler if the last point on the ruler was deleted by double-click.
    • The ruler broke after adding a new point in the middle of a segment.
    • The balloon turned into a panel if the map was short and wide.
    • The cursor stayed on the map when opening a balloon on a placemark with autoPan.
    • Hintclose was displayed when the map moved, even if there was no hint.
    • The text in the "Traffic" control did not change when moving to a region without data.
    • Errors in placemark interactivity when exporting via YMapsML.
    • The icon was not removed from a button after using the "unset" method.
    • Incorrect hint positioning over ruler points.
    • The cluster placemark was not hidden when a balloon opened.
    • Different sizes of ruler points in IE and Opera.
    • A balloon near a line lost its position when zooming.
    • Extra mouseenter events on map objects.
    • When zooming with the mouse wheel, the page in Firefox scrolled with the map.
    • When continuing a line in editing mode, the part that "continued" disappeared when pointing at it.
    • In certain cases, the value of the GeoObject.state.get ('hover') field did not change for the first cursor movement.
    • Correct order of "click", "select", and "press" events for FullscreenControl.
    • Part of controls did not hide for mousedown on the map.
    • In certain cases, the balloon did not move with the geo object.
    • Errors in the drawOver option in geometryEditor.
    • Errors when quickly ending object editing.
    • Errors when enabling the geodesic option.
    • A geo object's hint appeared when opening the balloon for a hotspot object.
    • The API worked incorrectly when the bootstrap library was enabled.
    • When changing the visible map area, the wrong type of events were triggered.
    • Errors when throwing balloonclose and balloonopen for hotspots.
    • Errors with autoPan when working with the ruler.
    • The interactivityModel option did not work for pop-up hints.
    • When changing the map type, zoom buttons did not stop being active/inactive.
    • The cursor did not appear in the search bar when clicking SearchControl.
    • Moving geo objects broke after moving using touch.
    • In certain cases, the map type control was reconstructed when changing options.
    • Extra hiding and expanding controls when switching to full-screen mode.
    • Errors when deleting map types from control.TypeSelector.
    • Errors rendering geometries.
    • Change to the vertical map dimension in full-screen mode in IE8.
    • API errors in IE8.
  • JSAPI 2.1.3 (November 14, 2013)
    Change list
    Added:
    • Support for IE11.
    • Support for iOS7.
    • New modes for the panTo method.
    • Map zoom buttons now become inactive when the maximum and minimum zooms are reached.
    • The STOP_ITERATION object in the IIterator interface.

    Fixed:

    • Errors in IE.
    • Changes to zIndex of geo objects didn't work in the event handlers for mouse overs, opening the balloon, or moving the map.
    • Layout errors for the "Traffic" control.
    • Incorrect behavior when calling the Balloon.autoPan method during smooth map movement.
    • The icon was not removed from a button when using the options.unset method.
    • It was not possible to make the ruler button unavailable.
    • The hotspot layer threw the defaultaction event twice.
    • The YMaps variable leaked to the global visible area.
    • In certain situations, deleting a button from the map led to an exception. Errors when dragging ruler points.
    • Empty hint over the first point on the ruler.
    • Events were not received with contents of SVG placemarks.
    • Layout error for stretchy icons.
    • Incorrect placemark dragging in webkit browsers on Windows 8.
    • The contextmenu event was not received for double-right-clicks. Conflict in the "ruler" and "routeEditor" behaviors.
    • The "mouseenter" and "mouseleave" events were not generated on the map.
    • The "press" event was not generated for FullscreenControl and GeolocationControl. The "mousedown" event was not generated before "contextmenu".
    • Incorrect hotspot for a stretchy icon.
    • On touch devices, the geo object hint did not disappear after dragging.
    • The hint was not displayed when a balloon was open.
    • The "userclose" event was triggered twice in a balloon.
    • In certain situations, the Fullscreen control did not work. Incorrect calculation of element sizes in Firefox.