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

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

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

  <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.62. Она обновляется еженедельно, добавляя новые функции, исправляя ошибки и улучшая производительность.

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

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

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

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

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

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

Используйте бета-канал, чтобы опробовать новые бета-функции и изменения. Бета-функции уже полностью готовы к работе, но могут иметь некоторые нерешённые проблемы (используйте систему отслеживания ошибок , чтобы сообщать об ошибках и оставлять отзывы). На бета-канал не распространяются никакие соглашения об уровне обслуживания (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>

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

Используйте альфа-канал для тестирования новых экспериментальных функций и изменений. Пожалуйста, используйте систему отслеживания ошибок, чтобы сообщать о проблемах и оставлять отзывы. На альфа-канал не распространяются никакие соглашения об уровне обслуживания (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:

  <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.61,
  });
  </script>

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

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

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

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

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

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

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

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

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

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

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

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

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

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