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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вы можете указать бета-канал, загрузив 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: "beta",
  });
  </script>

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

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

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

Вы можете указать альфа-канал, загрузив 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: "alpha",
  });
  </script>

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

Указывайте номер версии только в том случае, если вы регулярно тестируете и обновляете свое приложение. Это связано с тем, что пронумерованные версии в конечном итоге удаляются, поскольку новые версии создаются каждый квартал. Вы можете указать номер версии, загрузив JavaScript API Maps с помощью следующего тега <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.63,
  });
  </script>

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

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

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

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

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

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

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

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

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

1. Откройте консоль в инструментах разработчика вашего браузера и посмотрите значение параметра google.maps.version .
2. Обновите тег <script>, который загружает API, и запросите более старый номер версии .
   Например, если google.maps.version равно "3.64.2", используйте v=3.63 в теге <script>.
   Это временное решение будет работать только в течение ограниченного времени.

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

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

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

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

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

Мы рекомендуем регулярно тестировать ваши приложения, чтобы определить, не вызывают ли новые версии или обновления за последние три месяца каких-либо проблем, требующих устранения. Для этого можно создать тестовый экземпляр приложения или специальную среду для тестирования (staging/development environment).

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

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

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

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

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

В текущем ежеквартальном каталоге указана версия 3.63.

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

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

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

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

Версия 3.65

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

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

Версия 3.64

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

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

Версия 3.63

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

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

Версия 3.62

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

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

Версия 3.61

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

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

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

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

Для отладки используйте свойство google.maps.version , чтобы получить текущую версию 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.64 (еженедельный канал)
• Справочник по API версии 3.63 (ежеквартальный канал)
• Справочник по API версии 3.62
• Справочник по API версии 3.61
• Версии с 3.0 по 3.60 удалены.