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

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

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

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

• Недельная – обозначается кодом v=weekly.
  Обновляется еженедельно и является самой последней из доступных.
• Квартальная – обозначается кодом v=quarterly.
  Обновляется ежеквартально и является наиболее стабильной.
• Бета-версия – обозначается кодом v=beta.
  Базируется на версии weekly и обновляется еженедельно. Включает изменения, внесенные с целью раннего тестирования и сбора отзывов.
• Альфа-версия – обозначается кодом v=alpha.
  Базируется на версии beta и обновляется еженедельно. Включает эксперименты для получения отзывов клиентов о прототипах. Используется только для целей разработки и не предназначена для рабочей среды.
• Номер версии обозначается кодом 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>

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

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

Альфа-версия базируется на версии beta и обновляется еженедельно.

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

  <script async
      src="https://maps.googleapis.com/maps/api/js?v=alpha
          &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 удалены.