Блог API Яндекс.Карт

Блог API Яндекс.Карт

Дополнение в систему версионирования API

Мы решили дополнить существующую систему версионирования API.

С момента запуска в API 2.0 было два варианта подключения:
api-maps.yandex.ru/2.0 — последняя опубликованная версия.
api-maps.yandex.ru/2.0.х — конкретная желаемая версия (например, api-maps.yandex.ru/2.0.13).

Теперь мы добавили еще один вариант:
api-maps.yandex.ru/2.0-stable — подключение последней стабильной версии.

2.0-stable будет отставать от 2.0 на несколько релизов и будет переключаться на новую версию, только если в ней не будет выявлено явных ошибок и на нее не будет жалоб от пользователей клуба.

Рекомендуем в продакшене подключать api-maps.yandex.ru/2.0-stable, а для разработки использовать api-maps.yandex.ru/2.0.

Уверены, что благодаря этим изменениям работа карты в вашем проекте станет еще более стабильной.

Команда разработчиков API Яндекс.Карт.

12 комментариев
Авторизуйтесь, чтобы оставить комментарий
nemo-q.dima
28 января 2016, 06:22

молодцы

tekunova
28 января 2016, 06:22

Спасибо :-)

nemo-q.dima
28 января 2016, 06:22

Ведь действительно молодцы.

Попросили changelog - сделали,

начались бока с отваливающимися функциями  - выкатили stable.

Оставайтесь столь же отзывчивыми, этого многим не хватает.

Дмитрий Сухоносов
28 января 2016, 06:22
надо было /2.0 сделать как stable
и отдельно ввести /2.0-dev
а то получается вы бету в продакшен отдаете
Sergey Konstantinov
28 января 2016, 06:22
API уже 4 года живёт по этой системе.
Внезапно менять этот подход нам показалось негуманным.
Egor
28 января 2016, 06:22

с вариантом api-maps.yandex.ru/2.0 перестал правильно работать кластер

ошибку можно посмотреть здесь http://egorl.ru/eeyore/ при масштабировании

лечится записью api-maps.yandex.ru/2.0-stable

mari-na-bzzz
28 января 2016, 06:22

Спасибо за сообщение. В коде образовалась глобальная переменная cluster, и из-за этого затиралось значение, которое вы присваивали переменной cluster. Мы поправим это в следующем релизе. Сейчас вы можете обойти ошибку просто поменяв имя переменной, например с 'cluster' на 'clusterer'.

maps-test-api
28 января 2016, 06:22

Добрый день.

 

Скажите, а новые версии обратносовместимы с предыдущими? То есть если я разрабатывал под 2.0.18 могу ли я в продакшене указать 2.0-stable и не бояться, что в 1 прекрасный момент карты у меня отвалятся, потому что в 2.0-stable положат необратносовместимую версию?

Sergey Konstantinov
28 января 2016, 06:22
Мы стараемся поддерживать полную обратную совместимость. Однако 100%-ой гарантии дать не можем, т.к. возможны разные ситуации (например, починка бага может сломать какой-то функционал).
В вашем случае мы рекомендуем зафиксировать на продакшене конкретную версию (2.0.21, например) и периодически обновлять.
Web Stolica
28 января 2016, 06:22

перехожу по ссылке http://api-maps.yandex.ru/2.0-stable/  выдает

missing lang parameter
tekunova
28 января 2016, 06:22

Конечно. Это же ссылка для подключения API. Почитайте вот тут об обязательный параметрах урла для подключения http://api.yandex.ru/maps/doc/jsapi/2.x/dg/concepts/load.xml.

Web Stolica
28 января 2016, 06:22

Все, спасибо "протупил", целые сутки работал в разработке сайта, голова неи бум-бум))))