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

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

Каналы выпуска и номера версий

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

  • Недельный канал указывается с помощью v=weekly .
    Этот канал обновляется раз в неделю и является самым актуальным.
  • Квартальный канал указывается с помощью v=quarterly .
    Этот канал обновляется раз в квартал и является наиболее предсказуемым.
  • Бета-канал указывается с помощью v=beta .
    Этот канал основан на weekly канале и обновляется один раз в неделю. Он включает дополнительные изменения для раннего тестирования и обратной связи.
  • Альфа-канал указывается с помощью v=alpha .
    Этот канал основан на beta канале и обновляется раз в неделю. Он включает в себя эксперименты по получению отзывов клиентов о прототипах. Он предназначен только для целей разработки и не должен использоваться в производстве.
  • Номер версии указывается с помощью v=n.nn .
    Вы можете выбрать v=3.60 , v=3.59 , v=3.58 или v=3.57 .
    Номера версий обновляются один раз в квартал (см. Ежеквартальные обновления ).

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

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

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

  <script>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </script>

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

В середине мая еженедельный канал обновится до версии 3.61. В это время новая версия может удалить устаревшие функции и/или ввести обратную несовместимость.

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

Некоторым приложениям может быть полезно меньшее количество обновлений, но более крупные, поскольку это обеспечивает большую предсказуемость. Эти приложения должны использовать ежеквартальный канал. Используйте этот подход, если вы хотите, чтобы исправления ошибок и улучшения производительности появлялись в ожидаемое время (см. ежеквартальные обновления ). Вы можете указать квартальный канал, загрузив API JavaScript Карт со следующим тегом скрипта:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </script>

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

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

Выбор бета-канала

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

Этот канал основан на weekly канале и обновляется раз в неделю.

Вы можете указать бета-канал, загрузив Maps JavaScript API со следующим тегом скрипта:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </script>

Выбор альфа-канала

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

Этот канал основан на beta канале и обновляется раз в неделю.

Вы можете указать альфа-канал, загрузив Maps JavaScript API со следующим тегом скрипта:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </script>

Выбор номера версии

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.59,
  });
  </script>

В настоящее время вы можете указать v=3.60 , v=3.59 , v=3.58 или v=3.57 .

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

После середины мая вы сможете указать v=3.61 , v=3.60 , v=3.59 или v=3.58 .

  • Версия 3.61 будет получать еженедельные обновления с новыми функциями, исправлениями ошибок и улучшениями производительности.
  • Версия 3.60 больше не будет получать еженедельные обновления.
  • Версия 3.59 больше не будет получать еженедельные обновления.
  • Версия 3.58 больше не будет получать еженедельные обновления.
  • Время от времени мы можем вносить исправления ошибок безопасности в любую версию.
  • Версия 3.57 больше не будет доступна. Любая попытка загрузить эту версию будет проигнорирована, и вместо этого вы получите канал по умолчанию.

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

v=еженедельно v=ежеквартально v=3.nn v=3.nn-1 февраль 2025 г. май 2025 г. август 2025 г. ноябрь 2025 г. v3.57 v3.58 v3.58 v3.59 v3.59 v3.59 v3.60 v3.60 v3.60 v3.60 v3.61 v3.61 v3.61 v3.62 v3.62 v3.63

Обновление затронуло мое приложение

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

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

  1. Откройте консоль в инструментах разработчика браузера и посмотрите значение google.maps.version .
  2. Обновите тег скрипта, загружающий API, и запросите более старый номер версии .
    Например, если google.maps.version имеет значение «3.60.2», используйте v=3.59 в теге скрипта.
    Это временное решение будет работать только в течение ограниченного времени.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Версия 3.61

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

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

Версия 3.60

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

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

Версия 3.59

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

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

Версия 3.58

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

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

Версия 3.57

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

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

В каждом квартале доступны четыре версии. Поддерживаются все четыре версии.

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

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

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

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