Все готово!

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

Активировать Google Maps Roads API

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

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

Устранение ошибок

В случае ошибки будет возвращен ответ на нее в стандартном формате и для кода состояния HTTP будет установлено состояние ошибки.

Ответ будет содержать объект error со следующими ключами.

  • code: это то же самое, что и состояние HTTP ответа.
  • message: краткое описание ошибки.
  • status: код состояния, указывающий характер ошибки.

Например, при отправке недопустимого параметра placeId будет возвращена следующая ошибка:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

Возможные ошибки:

Код Состояние Сообщение Устранение неполадок
400 INVALID_ARGUMENT Указан недопустимый ключ. Ключ API недействителен или не включен в запрос. Убедитесь, что вы указали полный ключ и активировали API для данного ключа.
400 INVALID_ARGUMENT параметр "\"path\" содержит недопустимое значение: ☃" Ваш запрос содержит недопустимые аргументы. Вероятные причины ошибки:
  • Проблема с параметром path.
    Убедитесь, что имеется хотя бы одна, но не более 100 точек . Каждая точка представляет собой пару чисел, разделенную запятой, например: 48.409114,-123.369158. Между собой точки разделяются вертикальной чертой: "|".
  • Ваш запрос содержит недопустимый параметр placeId.
  • В вашем запросе содержатся и placeId, и path. Для каждого запроса необходимо указать только один параметр.

Данная ошибка не будет возвращена, если параметрplaceId передан для несуществующей дороги или для участка, не являющегося дорогой.

403 PERMISSION_DENIED Незарегистрированный запрос был заблокирован. Зарегистрируйтесь с помощью консоли разработчика Google. Ключ API недействителен или не включен в запрос. Убедитесь, что вы указали полный ключ и активировали API для данного ключа.
404 NOT_FOUND Для данной службы требуется HTTPS. Убедитесь, что вы отправляете запрос в https://roads.googleapis.com/, а не в http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED Запрос отменен из-за достижения лимита на число запросов для проекта. Вы превысили лимит запросов requests в секунду для одного пользователя, указанный в API Console. Этот лимит необходимо настроить, чтобы не допустить расходования всей дневной квоты одним пользователем или небольшой группой пользователей, вместе с тем предоставляя всем пользователям разумные возможности доступа.
429 RESOURCE_EXHAUSTED Запрос отменен из-за превышения дневного ограничения. Вы превысили дневную квоту для проекта.

Экспоненциальная задержка

При сбое запросов необходимо использовать экспоненциальную задержку для повторных запросов. Например, при первом сбое запроса, выполните повтор через секунду, при втором сбое выполните повтор через две секунды, при третьем – через четыре секунды и т. д. Это позволит не перегружать серверы Google в случае ошибок в запросах и масштабных сбоев, поскольку многие пользователи сразу же пытаются повторить свои запросы.

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

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