Управление версиями

Команда разработчиков Maps JavaScript API регулярно обновляет этот программный продукт, исправляя ошибки и добавляя новые функции и улучшения. На этой странице описаны версии API, доступные для использования в ваших приложениях.

Версии обновлений и номера версий

В приложении можно указывать версии обновлений и номера версий API:

• Недельная – обозначается кодом v=weekly.
  Обновляется еженедельно и является самой последней из доступных.
• Квартальная – обозначается кодом v=quarterly.
  Обновляется ежеквартально и является наиболее стабильной.
• Бета-версия – обозначается кодом v=beta.
  Базируется на версии weekly и обновляется еженедельно. Включает изменения, внесенные с целью раннего тестирования и сбора отзывов.
• Номер версии обозначается кодом v=n.nn.
  Возможные варианты – v=3.52, v=3.51, v=3.50 или v=3.49.
  Номер версии изменяется раз в квартал (см. Ежеквартальные обновления).

Если версия обновления или номер версии не указаны явно, по умолчанию принимается недельная версия. Если при переходе с плана Premium вы не укажете предпочтительную версию или ее номер, по умолчанию будет применена квартальная. Если указанное значение версии недействительно, будет применена версия по умолчанию.

Как выбрать недельную версию

Для большинства целей мы рекомендуем использовать недельную версию. Это самая свежая из версий с последними исправлениями ошибок и улучшениями. Чтобы выбрать недельную версию, загрузите Maps JavaScript API со следующим тегом script:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

Текущая недельная версия – 3.52. Раз в неделю разработчики исправляют в ней ошибки и добавляют новые функции и улучшения.

В середине мая недельная версия API будет обновлена до 3.53. Из новой версии могут быть удалены устаревшие функции. Также могут появиться или исчезнуть обратные несовместимости.

Как выбрать квартальную версию

Квартальная версия API обновляется реже. Поэтому она более предсказуема и может оказаться удобнее для работы с некоторыми приложениями. Выбирайте ее, если вам важно, чтобы исправления и улучшения появлялись в заданное время, ежеквартально. Чтобы выбрать квартальную версию, загрузите Maps JavaScript API со следующим тегом script:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

Текущая квартальная версия – 3.51. В текущем квартале в ней не появится новых функций, исправлений или улучшений. Однако время от времени в нее могут вноситься внеплановые исправления.

В середине мая квартальная версия будет обновлена до 3.52. Будут удалены устаревшие функции и добавлены новые. Также могут появиться или исчезнуть обратные несовместимости.

Рекомендуем в начале мая протестировать в вашем приложении работу версии v=3.52.

Как выбрать бета-версию

Выбирайте бета-версию, если хотите попробовать новые функции и изменения на стадии тестирования. В такой версии есть все нужные функции, однако могут быть и нерешенные проблемы. Если вы столкнетесь с проблемой, пожалуйста, сообщите нам об этом через Систему отслеживания ошибок и дайте ее краткое описание. Использование бета-версии не защищено соглашениями об уровне обслуживания и правилами прекращения поддержки. Изменения в бета-версии могут быть обратно несовместимы с более ранними версиями.

Бета-версия базируется на версии weekly и обновляется еженедельно.

Чтобы выбрать бета-версию, загрузите Maps JavaScript API со следующим тегом script:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &key=YOUR_API_KEY&callback=initMap">
</script>

Как выбрать номер версии

Указывайте номера версий, только если вы регулярно тестируете и обновляете свое приложение, поскольку они удаляются по мере замены новыми (т. е. ежеквартально). Чтобы указать номер версии, загрузите Maps JavaScript API со следующим тегом script:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.51
        &key=YOUR_API_KEY&callback=initMap">
</script>

Указать можно одно из следующих значений: v=3.52, v=3.51, v=3.50 или v=3.49.

• В версию 3.52 еженедельно вносятся новые функции, исправления и улучшения.
• Версия 3.51 еженедельно не обновляется.
• Версия 3.50 еженедельно не обновляется.
• Версия 3.49 еженедельно не обновляется.
• Время от времени в любую из этих версий могут вноситься внеплановые исправления.
• При создании новой версии настройки обратной несовместимости могут быть изменены.

Со второй половины мая указать можно будет одно из следующих значений: v=3.53, v=3.52, v=3.51 или v=3.50.

• В версию 3.53 будут еженедельно вноситься новые функции, исправления и улучшения.
• Версия 3.52 больше не будет еженедельно обновляться.
• Версия 3.51 больше не будет еженедельно обновляться.
• Версия 3.50 больше не будет еженедельно обновляться.
• Время от времени в любую из этих версий могут вноситься внеплановые исправления.
• Версия 3.49 больше не будет доступна. Система проигнорирует все попытки загрузить эту версию, и вместо нее будет применена версия по умолчанию.

Если вы работаете с версией v=3.50 или v=3.49, рекомендуем обновить ее до v=3.52 или v=3.51 до середины мая. При изменении версии учтите, что это может привести к удалению устаревших функций и появлению/исчезновению обратных несовместимостей.

Диаграмма ниже иллюстрирует, какие номера версий будут доступны в разных версиях обновлений в ближайшие годы.

Если обновление затронуло работу приложения

Обновление версии может повлиять на работу вашего приложения. Так происходит, когда старая версия использует недокументированные или устаревшие функции, или из-за ошибок и исправлений в новой версии.

В качестве временного решения вы можете настроить в приложении использование более старой версии.

1. Для этого откройте консоль Инструментов разработчика и укажите номер версии в переменной google.maps.version.
2. Обновите тег script, загружающий API, и запросите номер более ранней версии.
   Например, если в google.maps.version указана версия 3.52.2, установите в теге script значение v=3.51.
   Это решение временное.

У вас будет 3–6 месяцев, чтобы обновить свое приложение, исключив использование недокументированных и устаревших функций (также учтите, что в новой версии могут быть исправлены ошибки и появиться новые).

Закончив, измените значение тега script на исходное, чтобы загрузить новую версию API.

Также вы можете отправить запросы в службу поддержки или сообщить об ошибке.

Квартальная версия обновления

Каждый квартал команда Maps JavaScript API выпускает новую версию этого продукта – в середине февраля, мая, августа и ноября. Следующее обновление выйдет в середине мая. Новой недельной версией станет 3.53. Все другие версии также будут обновлены.

Просим вас регулярно тестировать свои приложения, чтобы понять, не вызвали ли обновления, внесенные за последние три месяца или вместе с новой версией, новые проблемы. Для этого можно сделать тестовый экземпляр приложения и создать промежуточную среду или среду разработки.

Недельная версия обновления

Текущая недельная версия – 3.52.

В середине мая недельная версия будет обновлена с 3.52 до 3.53. Будут удалены устаревшие функции и добавлены новые. Также могут появиться или исчезнуть обратные несовместимости. Вы сможете протестировать эти изменения после обновления версии.

В течение квартала разработчики еженедельно будут добавлять новые функции, улучшения и исправления ошибок. При этом останутся все устаревшие функции и не будет добавлено обратных несовместимостей.

Обновление квартальной версии

Текущая квартальная версия – 3.51.

В середине мая квартальная версия будет обновлена с 3.51 до 3.52. Будут удалены устаревшие функции и добавлены новые. Также в течение трех месяцев могут появиться или исчезнуть обратные несовместимости. Вы сможете протестировать эти изменения после обновления версии.

В течение квартала в эту версию не будут добавляться новые функции, улучшения и исправления ошибок. При этом останутся все устаревшие функции и не будет добавлено обратных несовместимостей.

Обновление версий

В середине мая выйдет новая версия API – и все используемые версии будут обновлены до следующей по очереди.

Версия 3.53

Новая версия 3.53 выйдет в середине мая. Будут удалены устаревшие функции версии 3.52 и добавлены новые. Также могут появиться или исчезнуть обратные несовместимости. После обновления версии рекомендуем протестировать ваши приложения.

В течение квартала в новую версию будут еженедельно добавляться новые функции, улучшения и исправления ошибок. При этом останутся все устаревшие функции и не будет добавлено обратных несовместимостей.

Версия 3.52

В этой версии были удалены устаревшие функции версии 3.51, а также появились или исчезли обратные несовместимости. После обновления версии рекомендуем протестировать ваши приложения.

Начиная с середины мая эта версия перестанет обновляться новыми функциями, исправлениями ошибок и улучшениями. При этом останутся все устаревшие функции и не будет добавлено обратных несовместимостей.

Версия 3.51

В этой версии были удалены устаревшие функции версии 3.50, а также появились или исчезли обратные несовместимости. После обновления версии рекомендуем протестировать ваши приложения.

Эта версия больше не будет обновляться новыми функциями, исправлениями ошибок и улучшениями. В ней останутся все устаревшие функции и не появится новых обратных несовместимостей.

Версия 3.50

В этой версии были удалены устаревшие функции версии 3.49, а также появились или исчезли обратные несовместимости. После обновления версии рекомендуем протестировать ваши приложения.

Эта версия больше не будет обновляться новыми функциями, исправлениями ошибок и улучшениями. В ней останутся все устаревшие функции и не появится новых обратных несовместимостей.

Версия 3.49

Начиная с середины мая эта версия будет удалена, и вы больше не сможете пользоваться ею. Система проигнорирует все попытки загрузить эту версию, и вместо нее будет применена версия по умолчанию.

Поддержка версий

Если в течение квартала доступны все четыре версии обновлений, то все они поддерживаются.

Проверка версий

В целях отладки используйте свойство google.maps.version, чтобы применить текущую версию Maps JavaScript API в вашем приложении. Следующий пример кода записывает версию API в консоль браузера. Подробнее о консоли читайте в статье Проверка ошибок в браузере.

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
    defer></script>
  </body>
</html>

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

В руководстве для разработчиков всегда дается описание недельной версии.

Кроме того, для каждой версии существует отдельный справочник:

• Документация по API версии 3.52 (недельная)
• Документация по API версии 3.51 (квартальная)
• Документация по API версии 3.50
• Документация по API версии 3.49
• Версии с 3.0 по 3.48 удалены.