Все готово!

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

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

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

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

Сообщения об ошибках


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

Google Maps JavaScript API Коды ошибок

В случае возникновения ошибки при загрузке Google Maps JavaScript API пояснение ее кода можно найти в следующей таблице.

Код ошибки Сообщение Описание
InvalidKeyOrUnauthorizedURLMapError The provided Google API key is invalid or this site is not authorized to use it.

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

См. Получение ключа API.

NotLoadingAPIFromGoogleMapError The Google Maps JavaScript API must be downloaded directly from Google's servers.

Элемент сценария, загружающий Google Maps JavaScript API, не включен должным образом на вашей странице. Для корректной работы API должен загружаться непосредственно с сайта https://maps.googleapis.com.

См. Загрузка Maps API.

TOSViolationMapError This website appears to violate the Google Maps API Terms of Service. The Google Maps API has been disabled for this website.

Ваше приложение было заблокировано из-за несоответствия Условиям использования Google Maps APIs после отправки нескольких уведомлений по эл. почте. Чтобы обжаловать блокировку и обратиться с просьбой проверить ваш случай реализации приложения, заполните эту форму. Ответ будет предоставлен вам по эл. почте в течение нескольких рабочих дней.

Если у вас есть лицензия на Google Maps APIs Premium Plan, используйте учетные данные Google Maps APIs Premium Plan, чтобы устранить эту ошибку. См. руководство для ключей API и идентификаторов клиента.

UnauthorizedURLForClientIdMapError This URL is not authorized to use the Google Maps Client ID provided.

Идентификатор клиента Premium Plan или Maps APIs for Work, задействованный при загрузке сценария, является недопустимым или срок его действия истек, либо текущий адрес, загружающий Google Maps JavaScript API, не добавлен в список разрешенных URL.

См. Регистрация разрешенных URL.

Google Maps JavaScript API Коды ошибок для разработчиков

Если вы обнаружите ошибку в консоли Chrome JavaScript Console, консоли Firefox Web Console или в другом эквивалентном инструменте браузера, вы можете найти разъяснение кода ошибки в следующей таблице.

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

Код ошибки для разработчика Тип Описание
ApiNotActivatedMapError Ошибка

Google Maps JavaScript API не активирован для вашего проекта API. Возможно вам потребуется включить Google Maps JavaScript API в разделе API из Google API Console.

См. Получение ключа API.

DeletedApiProjectMapError Ошибка

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

См. Получение ключа API.

ExpiredKeyMapError Ошибка

Истек срок действия ключа API в элементе сценария, загружающего API. Возможно вам потребуется сгенерировать новый ключ API в Google API Console.

См. Получение ключа API.

InvalidClientIdMapError Ошибка

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

Если у вас нет лицензии на Premium Plan или Maps APIs for Work, вам следует использовать с ключом API параметр key, а не параметр client.

См. Ваш идентификатор клиента.

InvalidKeyMapError Ошибка

Не найден ключ API в элементе сценария, загружающем API. Убедитесь, что вы используете правильный ключ API. Вы можете сгенерировать новый ключ API в Google API Console.

См. Получение ключа API.

MissingKeyMapError Ошибка

В элементе сценария, загружающем API, отсутствует необходимый параметр аутентификации. Если используется стандартный Maps JavaScript API, следует использовать параметр key с действующим ключом API. Если вы являетесь владельцем Premium Plan, применяйте либо параметр client со своим идентификатором клиента, либо параметр key с действительным ключом API.

См. руководство по ключам API и идентификаторам клиента.

ProjectDeniedMapError Ошибка

Ваш запрос не выполнен. Более подробную информацию об ошибке можно найти в Google API Console.

См. Google API Console.

RefererDeniedMapError Ошибка

Ваше приложение было заблокировано из-за несоответствия Условиям использования Google Maps APIs после отправки нескольких уведомлений по эл. почте. Чтобы обжаловать блокировку и обратиться с просьбой проверить ваш случай реализации приложения, заполните эту форму. Ответ будет предоставлен вам по эл. почте в течение нескольких рабочих дней.

RefererNotAllowedMapError Ошибка

URL, загружающий Google Maps JavaScript API, не включен в список разрешенных источников ссылок. Проверьте настройки источника ссылок своего ключа API в Google API Console.

См. информацию о ключах API в Google API Console. Дополнительную информацию см. на странице Практические рекомендации по безопасному использованию ключей API.

OverQuotaMapError Ошибка

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

Дополнительную информацию см. в руководстве по лимитам использования. На этой странице также можно узнать, как повысить лимиты использования.

ClientIdLooksLikeCryptoKey Предупреждение

Возможно вы указали криптографический ключ в параметре client. Если у вас есть лицензия на Premium Plan или Maps APIs for Work, указывайте в параметре client свой идентификатор клиента. Вам не нужно использовать криптографический ключ для Google Maps JavaScript API.

См. руководство по идентификаторам клиентов для владельцевPremium Plan и Maps APIs for Work.

ClientIdLooksLikeKey Предупреждение

Возможно вы указали ключ API в параметре client. Если у вас есть лицензия на Premium Plan или Maps APIs for Work, указывайте в параметре client свой идентификатор клиента. Если у вас есть Google Maps APIs Premium Plan, можно использовать или параметр client, или key. Если у вас нет лицензий, вы должны использовать параметр key вместо параметра client .

См. руководство по идентификаторам клиентов и ключам API.

InvalidChannel Предупреждение

Возможно вы указали неверный параметр channel. Значение параметра channel должно представлять собой буквенно-числовую строку в формате ASCII, которая может содержать точки (.), символы подчеркивания (_) и дефисы (-). Убедитесь, что вы указали корректный параметр channel.

См. документ Отчеты | Google Maps APIs Premium Plan.

InvalidClientId Предупреждение

Параметр client не содержит корректный идентификатор клиента. Идентификатор клиента должен начинаться с префикса "gme-".

См. руководство по идентификаторам клиентов для владельцевPremium Plan или Maps APIs for Work.

InvalidKey Предупреждение

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

См. Получение ключа API.

InvalidVersion Предупреждение

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

См. Определение версии | Google Maps JavaScript API.

KeyLooksLikeClientId Предупреждение Возможно вы указали идентификатор клиента в качестве параметра key. Если у вас есть лицензия на Premium Plan или Maps APIs for Work, указывайте свой идентификатор клиента в параметре client, а не в параметре key. Если у вас есть Google Maps APIs Premium Plan, можно использовать или параметр client, или key. Если у вас нет лицензий, вы должны использовать параметр key вместо параметра client .

См. руководство по идентификаторам клиентов и ключам API.

KeyLooksLikeCryptoKey Предупреждение

Возможно вы указали криптографический ключ в качестве параметра key. Если у вас есть лицензия на Premium Plan или Maps APIs for Work, указывайте свой идентификатор клиента в параметре client и удалите параметр key из элемента своего сценария. Для Google Maps JavaScript API не требуется криптографический ключ. Если у вас есть Google Maps APIs Premium Plan, можно использовать или параметр client, или key. Если у вас нет никаких лицензий, вы можете получить бесплатный ключ API в Google API Console.

См. руководство по идентификаторам клиентов и ключам API.

KeyLooksLikeProjectNumber Предупреждение

Возможно вы указали номер проекта в качестве параметра key. Убедитесь, что вы используете правильный ключ API. Вы можете сгенерировать новый ключ API в Google API Console.

См. Получение ключа API.

NoApiKeys Предупреждение

В элементе сценария, загружающем API, отсутствует ключ API. Убедитесь, что вы добавили действительный ключ API как параметр key. Вы можете сгенерировать новый ключ API в Google API Console.

См. Получение ключа API.

RetiredVersion Предупреждение

Возможно вы указали неподдерживаемую версию в своем сценарии. Версии 3.0–3.24 больше не поддерживаются, возможно вместо них используется версия 3.25. Обновите свое приложение для использования одной из доступных версий

См. Определение версии | Google Maps JavaScript API.

SensorNotRequired Предупреждение

Параметр sensor больше не требуется для Google Maps JavaScript API. Это не помешает нормальной работе Google Maps JavaScript API, но мы рекомендуем удалить параметр sensor из элемента сценария.

SignatureNotRequired Предупреждение

Параметр signature не требуется для Google Maps JavaScript API. Это не помешает нормальной работе Google Maps JavaScript API, но может представлять угрозу безопасности. Удалите его из своего элемента сценария.

SignedInDeprecated Предупреждение

Параметр signed_in объявлен устаревшим и не будет поддерживаться в будущих версиях Google Maps JavaScript API. Это не будет препятствовать работе Google Maps JavaScript API после прекращения использования режима с регистрацией, однако поведение вашего приложения может измениться, если вы будете полагаться на текущие возможности режима с регистрацией.

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

UrlAuthenticationCommonError Ошибка

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

Проверка ошибок в браузере

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

В Chrome вы можете использовать консоль JavaScript для проверки данных, возвращаемых window.console, выполнив следующие действия.

  1. Чтобы открыть Developer Tools, выберите значок меню > More Tools > Developer Tools.
  2. Чтобы открыть консоль JavaScript, нажмите клавишу ESC на клавиатуре. Клавиша ESC переключит в режим консоли JavaScript. Если вы закроете консоль, еще раз нажмите ESC, чтобы открыть ее.

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

Ошибка Google Maps API: [КОД ОШИБКИ] [Ссылка на документ API]
или
Предупреждение Google Maps API: [КОД ОШИБКИ] [Ссылка на документ API]

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

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

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

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