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

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

Каналы обновления и номера версий

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

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

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

Как выбрать недельную версию

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

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

Как выбрать квартальную версию

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

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

Как выбрать бета-версию

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

Эта версия базируется на версии weekly и обновляется еженедельно.

Чтобы выбрать бета-версию, загрузите 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: "beta",
  });
  </script>

Как выбрать альфа-версию

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

Эта версия базируется на версии beta и обновляется еженедельно.

Чтобы выбрать альфа-версию, загрузите 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: "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.65,
  });
  </script>

Указать можно одно из следующих значений: v=3.66, v=3.65, v=3.64 или v=3.63.

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

Со второй половины ноября указать можно будет одно из следующих значений: v=3.67, v=3.66, v=3.65 или v=3.64.

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

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

v=weekly v=quarterly v=3.nn v=3.nn-1 Август 2026 г. Ноябрь 2026 г. Февраль 2027 г. Май 2027 г. v3.63 v3.64 v3.64 v3.65 v3.65 v3.65 v3.66 v3.66 v3.66 v3.66 v3.67 v3.67 v3.67 v3.68 v3.68 v3.69

Если обновление затронуло работу приложения

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

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

  1. Для этого откройте в браузере консоль инструментов разработчика и укажите номер версии в переменной google.maps.version.
  2. Обновите тег script, загружающий API, и запросите более ранний номер версии.
    Например, если в google.maps.version указана версия 3.66.2, установите в теге script значение v=3.65.
    Это решение временное.

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

Когда все будет готово, измените значение тега script на исходное, чтобы загрузить новую версию API.

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

Квартальные обновления

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

Недельная версия обновления

Текущая недельная версия – 3.66.

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

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

Квартальная версия обновления

Текущая квартальная версия – 3.65.

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

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

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

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

Версия 3.67

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

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

Версия 3.66

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

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

Версия 3.65

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

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

Версия 3.64

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

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

Версия 3.63

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

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

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

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

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

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

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