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

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

2D-плитки и изображения Street View

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

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

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

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

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

  • Для обычных фрагментов карты максимальный уровень масштабирования зависит от конкретного фрагмента карты и запрошенных вами параметров карты.

  • Для обычных фрагментов карты координата x должна находиться в диапазоне [0, (2^zoom)-1].

  • Для обычных фрагментов карты координата y должна находиться в диапазоне [0, (2^(zoom-1))-1].

  • Для плиток просмотра улиц масштаб должен быть от нуля до пяти включительно.

  • Для фрагментов просмотра улиц диапазоны координат x и y такие же, как и для обычных фрагментов карты, до пятого уровня масштабирования. На этом этапе максимальные значения — это imageHeight или imagewidth разделенные на tileHeight или tileWidth .

forbidden : в запросе отсутствует действительный ключ API.

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

Ваш запрос имеет неверный формат. К частым причинам этого относятся:

  • Вы указали тип карты terrain , не включая слой roadmap .

  • Вы включили массив styles для типа карты, не являющегося дорожной картой.

  • Вы отправили значение широты и долготы, а также идентификатор панорамы в запросе метаданных Просмотра улиц.

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, параметры запроса, идентификаторы плиток/наборов плиток или токен сеанса с истекшим сроком действия.
403: Разрешение отклонено
Отсутствует ключ API, отсутствует SSL-соединение или ваш ключ API не добавлен в белый список для 3D-плиток. Обратитесь в службу поддержки Google, указав идентификатор своего проекта, чтобы вас добавили в белый список функций 3D-плиток API Map Tiles.
429: Слишком много запросов.
Ваша квота исчерпана. Обратитесь в службу поддержки Google, чтобы увеличить квоту.