Присоединяйтесь к нам на следующем Дне сообщества разработчиков платформы Google Карт в Сан-Франциско в декабре. Чтобы принять участие, подайте заявку.

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

Исправление ошибок

Разработчики из Европейской экономической зоны (ЕЭЗ)

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

Двумерные фрагменты и изображения Просмотра улиц

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

Список ошибок

Ниже перечислены ошибки, которые могут возникать при использовании Map Tiles API.

required

В запросе отсутствует параметр URL. Обратите внимание, что в сообщении об ошибке указано, какой параметр отсутствует.

notFound, invalid

Значения x, y или z выходят за допустимые пределы.

Для обычных фрагментов карты максимальный уровень масштабирования зависит от конкретного фрагмента и запрошенных параметров карты.
Для обычных фрагментов карты координата X должна находиться в диапазоне [0, (2^zoom)-1].
Для обычных фрагментов карты координата Y должна находиться в диапазоне [0, (2^(zoom-1))-1].
Для плиток Просмотра улиц масштаб должен быть от 0 до 5 включительно.
Для плиток Просмотра улиц диапазоны координат x и y такие же, как и для обычных плиток карты, до пятого уровня масштабирования. В этом случае максимальные значения будут равны imageHeight или imagewidth, разделенным на tileHeight или tileWidth.

forbidden:

Возможные причины:

В запросе отсутствует действительный ключ API.
Сообщение: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

Двухмерные спутниковые тайлы недоступны в проектах, связанных с платежным аккаунтом, адрес которого находится в Европейской экономической зоне (ЕЭЗ). Подробнее об изменениях в Map Tiles API для клиентов из ЕЭЗ…

expired

Срок действия токена session истек. Токен сеанса действителен в течение двух недель с момента создания. Обратите внимание, что это может измениться без уведомления. Если вы получили эту ошибку, вам нужно получить новый токен сеанса, как описано в разделе Использование токенов сеанса.

badRequest

Запрос составлен неправильно. Возможные причины:

Вы указали тип карты terrain, но не добавили слой roadmap.
Вы включили массив styles для типа карты, отличного от roadmap.
Вы отправили значение широты/долготы, а также идентификатор панорамы в запросе метаданных Просмотра улиц.

quotaExceeded, rateLimitExceeded

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

Пример ошибки

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

Повторные запросы

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

Например, если запрос не выполнен, повторите попытку через одну секунду. Если и эта попытка не удалась, повторите запрос через две секунды. Если и этот запрос не удался, повторите попытку через четыре секунды. Таким образом, вы эффективно распределяете каждый последующий запрос, просто удваивая продолжительность времени между ними.

3D-плитки

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

Ошибки отрисовки фрагментов

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

Метод отладки ошибок сервера зависит от используемого средства визуализации. Для браузерных средств визуализации, таких как CesiumJS, вы можете проверить сетевой трафик с помощью инструментов, встроенных в большинство браузеров. Например, вы можете использовать инструменты разработчика Chrome.

Распространенные ошибки

Ниже приведен список наиболее распространенных ошибок.

400: недопустимый аргумент: Недействительные ключи API, параметры запроса, идентификаторы тайлов или наборов тайлов, а также истекший срок действия токена сеанса.
400: Invalid Value: Убедитесь, что параметр mapType, с которым был выполнен запрос createSessionToken, соответствует параметру mapType, используемому в последующей конечной точке фрагмента. Например, токен сеанса streetview нельзя использовать для запроса фрагмента roadmap.

403: Permission denied