Версии

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

Команда 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 .
    Номера версий обновляются один раз в квартал (см. Ежеквартальные обновления ).

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

Выбор еженедельного канала

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

Выбор квартального канала

Некоторым приложениям может быть полезно меньшее количество, но более крупных обновлений, поскольку это обеспечивает большую предсказуемость. Эти приложения должны использовать квартальный канал. Используйте этот подход, если вы хотите, чтобы исправления ошибок и улучшения производительности поступали в ожидаемое время (см. ежеквартальные обновления ). Вы можете указать ежеквартальный канал, загрузив 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=еженедельно v=ежеквартально v=3.nn v=3.nn-1 авг 2022 г. ноябрь 2022 г. февраль 2023 г. май 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. Обновите тег скрипта, который загружает API, и запросите более старый номер версии .
    Например, если google.maps.version имеет значение «3.50.2», используйте v=3.49 в теге скрипта.
    Этот временный обходной путь будет работать только в течение ограниченного времени.

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

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

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

Ежеквартальные обновления

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

Еженедельное обновление канала

Еженедельный канал в настоящее время указывает на версию 3.50.

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

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

Ежеквартальное обновление канала

Ежеквартальный канал в настоящее время указывает на версию 3.49.

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

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

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

В середине ноября номера версий меняются, чтобы приспособиться к выпуску новой версии.

Версия 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

Руководство разработчика всегда описывает недельную версию.

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