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

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

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

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

2D-плитки и изображения 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 такие же, как для обычных фрагментов карты, до уровня масштабирования 5. На этом уровне максимальные значения равны 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.
Спутниковые 2D-плитки недоступны в проектах, привязанных к платёжному аккаунту с адресом в Европейской экономической зоне (ЕЭЗ). Подробнее см. в разделе «Настройки 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 DevTools .

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

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

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

403: Доступ запрещен