Эта страница переведена с помощью Cloud Translation API.

Обработка ошибок

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

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

Двумерные тайлы и изображения Street View

Ниже приведён список ошибок, с которыми вы можете столкнуться при использовании 2D-тайлов и изображений Street View.

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

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

required

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

notFound , invalid

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

Для обычных фрагментов карты максимальный уровень масштабирования зависит от конкретного фрагмента карты и от выбранных вами параметров карты.
Для обычных фрагментов карты координата x должна находиться в диапазоне [0, (2^zoom)-1].
Для обычных фрагментов карты координата y должна находиться в диапазоне [0, (2^(zoom-1))-1].
Для отображения фрагментов Street View масштаб должен быть в диапазоне от нуля до пяти включительно.
Для тайлов Street View диапазоны координат 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.
Двумерные спутниковые тайлы недоступны в проектах, связанных с платежным аккаунтом, имеющим адрес в Европейской экономической зоне (ЕЭЗ). Для получения дополнительной информации см. раздел «Настройка API картографических тайлов для клиентов из ЕЭЗ» .

expired

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

badRequest

Ваш запрос был сформирован некорректно. Распространенные причины этого:

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

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

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

3D-плитки

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

Ошибки отрисовки тайлов

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

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

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

Ниже приведён список наиболее распространённых ошибок, с которыми вы можете столкнуться.

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

403: Отказано в доступе