Все готово!

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

Активация Google Maps JavaScript API

Чтобы помочь вам освоиться, мы покажем, как выполнить некоторые необходимые действия в консоли разработчика Google:

  1. Создание или выбор проекта
  2. Активация Google Maps JavaScript API и связанных служб
  3. Создание соответствующих ключей

Определение версии

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

  • Экспериментальная
  • Выпущенная
  • Зафиксированная

Также вы найдете практические рекомендации по управлению версиями в зависимости от типа и назначения вашего приложения.

Смена версий и типы версий

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

В течение квартала мы продолжаем исправлять ошибки в экспериментальной и выпущенной версиях. Эти обновления упоминаются в примечаниях к выпуску Google Maps JavaScript API.

Вы можете указать в своем приложении загружаемую версию API с помощью параметра v в загрузочном запросе Google Maps JavaScript API. Поддерживаются следующие параметры:

  • Экспериментальная версия – v=3.exp.
  • Выпущенная версия – v=3.
  • Конкретный номер версии. Например, v=3.25 или v=3.26.

Если версия явно не указана, то по умолчанию вы получите экспериментальную версию, если используете тариф Standard Plan (это также относится к пользователям, не указавшим ключ). Если вы используете премиум-план и не укажете версию, то по умолчанию вы получите выпущенную версию.

Экспериментальная версия

Экспериментальная версия (в настоящее время 3.27) содержит последние функции и исправления ошибок, доступные для открытого использования. Изменения экспериментальной версии не гарантируют ее функциональную стабильность. Мы рекомендуем регулярно тестировать приложения с экспериментальной версией, для чего нужно добавить параметр v=3.27 при загрузке API. Если вы любите рисковать, можете добавить параметр v=3.exp, чтобы всегда получать текущую экспериментальную версию со всеми последними функциями.

Использование экспериментальной версии можно задать с помощью следующей загрузочной строки:

<script async defer
    src="https://maps.googleapis.com/maps/api/js?v=3.exp
        &key=YOUR_API_KEY&callback=initMap">

Выпущенная версия

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

Текущая выпущенная версия: 3.26. Ее можно запросить с помощью одного из следующих вариантов загрузочной строки:

<script async defer
    src="https://maps.googleapis.com/maps/api/js?v=3
        &key=YOUR_API_KEY&callback=initMap">

<script async defer
    src="https://maps.googleapis.com/maps/api/js?v=3.26
        &key=YOUR_API_KEY&callback=initMap">

Зафиксированная версия

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

Каждый раз при появлении новой зафиксированной версии предыдущая зафиксированная версия удаляется. При указании в загрузочной строке удаленной версии, например v=3.0, возвращается текущая зафиксированная версия.

Текущая зафиксированная версия: 3.25. Ее использование можно запросить с помощью следующей загрузочной строки:

<script async defer
    src="https://maps.googleapis.com/maps/api/js?v=3.25
        &key=YOUR_API_KEY&callback=initMap">

Практические рекомендации

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

Для приложений с высокой доступностью и/или большим объемом трафика

Обеспечение стабильности и доступности ценой дополнительных усилий

Чтобы обеспечить отсутствие проблем при смене версий мы рекомендуем явно указывать номер текущей выпущенной версии API в загрузочной строке. Например, v=3.26. Чтобы избежать перехода на зафиксированную версию API, рекомендуется подписаться на уведомления Google о смене версий в группе Уведомления и объявления по Google Maps JS API v3.

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

Для обычных приложений

Мы рекомендуем использовать в загрузочной строке параметр v=3. Это означает, что приложение всегда будет использовать текущую выпущенную версиюGoogle Maps JavaScript API, которая уже проверена с большим объемом трафика и включает все необходимые исправления. В большинстве случаев от вас не требуется никаких действий при смене версий. Однако для обеспечения корректной работы приложения мы рекомендуем подписаться на получение уведомлений от Google о смене версий в группе Уведомления и объявления по Google Maps JS API v3.

После смены версии ваше приложение будет использовать новую версию Google Maps JavaScript API. Вы также можете ознакомиться с примечаниями к выпуску, чтобы узнать о любых изменениях, которые могут повлиять на ваше приложение. Если вы обнаружите, что в вашем приложении что-то работает неправильно, вы можете вернуться к прежней версии, явно указав номер зафиксированной версии в параметрах загрузочной строки на тот период, пока вы вносите в программный код необходимые изменения.

Для новейших приложений

Скорейший доступ к самым новым функциям

Для приложений, где постоянная доступность не имеет критической важности, мы рекомендуем использовать все новейшие функции экспериментальной версии (v=3.exp) Google Maps JavaScript API. Экспериментальная версия полностью тестируется Google каждую неделю перед выпуском и обычно обладает достаточной стабильностью. Однако еженедельный цикл выпуска означает необходимость внимательно следить за тем, чтобы приложение работало требуемым образом.

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

Для отладки используйте свойство google.maps.version, чтобы получить текущую версию Google 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?YOUR_API_KEY&callback=initMap"
    async defer></script>
  </body>
</html>

Документация по версиям API

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

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

Оставить отзыв о...

Текущей странице
Google Maps JavaScript API
Google Maps JavaScript API
Нужна помощь? Обратитесь в службу поддержки.