О версиях JavaScript API
Нумерация
Номер версии API состоит из трех цифр, например 1.0.5. При каждом обновлении API номер версии увеличивается по следующим правилам:
- первая цифра - при значительных изменениях в архитектуре API;
- вторая цифра - при потере обратной совместимости с предыдущими версиями;
- третья цифра - во всех остальных случаях.
Варианты подключения
При подключении API рекомендуется не указывать третью цифру версии. В этом случае гарантированно будет подключена самая последняя на данный момент версия, чей номер первыми двумя цифрами совпадает с указанным вами. Так, например, если указана версия 1.0, то подключена будет последняя на данный момент версия 1.0.x (например, 1.0.6):
<script src="https://api-maps.yandex.ru/1.0/?key=API-ключ" type="text/javascript"/>
Хотя между трехцифренными версиями гарантируется полная совместимость, в редких случаях может оказаться, что ваше клиентское приложение при подключении последней версии API не работает так, как было задумано. Поэтому для предотвращения таких ситуаций, в особо ответственных случаях (презентации, и т. п.) может потребоваться подключить строго определенную версию API (например, 1.0.5). Для этого ее номер нужно указать целиком (см. Время жизни):
<script src="https://api-maps.yandex.ru/1.0.5/?key=API-ключ" type="text/javascript"/>
Время жизни
Обратите внимание, что по истечении месяца со дня выхода новой версии, чей номер отличается от номера предыдущей только третьей цифрой, предыдущая версия автоматически удаляется. Например, через месяц после выхода версии 1.0.6, версия 1.0.5 будет удалена.