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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

Если версия обновления или номер версии не указаны явно, по умолчанию принимается недельная версия. Если при переходе с плана 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.50. Раз в неделю разработчики исправляют в ней ошибки и добавляют новые функции и улучшения.

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

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

Для некоторых приложений более удобной может оказаться квартальная версия 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.49. В текущем квартале в ней не появится новых функций, исправлений или улучшений. Однако время от времени в нее могут вноситься внеплановые исправления.

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

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

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

Бета-версия базируется на версии 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.49
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

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

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

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

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

v=weekly v=quarterly v=3.nn v=3.nn-1 08.2022 11.2022 02.2023 05.2023 v3.47 v3.48 v3.48 v3.49 v3.49 v3.49 v3.50 v3.50 v3.50 v3.50 v3.51 v3.51 v3.51 v3.52 v3.52 v3.53

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Версия 3.51

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

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

Версия 3.50

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

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

Версия 3.49

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

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

Версия 3.48

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

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

Версия 3.47

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

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

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

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

В целях отладки используйте свойство 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

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

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