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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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