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

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

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

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

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

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

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

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

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

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

Некоторые приложения могут выиграть от меньшего количества, но более крупных обновлений, поскольку это обеспечивает большую предсказуемость. Эти приложения должны использовать квартальный канал. Используйте этот подход, если вы хотите, чтобы исправления ошибок и улучшения производительности приходили в ожидаемое время (см. квартальные обновления ). Вы можете указать квартальный канал, загрузив 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: "quarterly",
  });
  </script>

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

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

Мы рекомендуем вам в начале августа протестировать свое приложение, используя v=3.61 .

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

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

Этот канал основан на 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>

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

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

Этот канал основан на 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.60,
  });
  </script>

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

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

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

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

Если вы используете v=3.59 или v=3.58 , мы рекомендуем вам обновиться до v=3.61 или v=3.60 до середины августа. При переключении версий помните, что более новые версии могут удалять устаревшие функции и/или вводить обратную несовместимость.

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

Обновление повлияло на мое приложение

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В середине августа номера версий меняются в связи с выпуском новой версии.

Версия 3.62

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

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

Версия 3.61

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

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

Версия 3.60

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

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

Версия 3.59

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

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

Версия 3.58

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

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

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

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

Для отладки используйте свойство 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.61 (еженедельный канал)
• Справочник API версии 3.60 (ежеквартальный канал)
• Ссылка на API версии 3.59
• Версия 3.58 Справочник API
• Версии 3.0–3.57 удалены.