Метаданные изображения просмотра улиц

Введение

Запросы метаданных Street View Static API предоставляют данные о панорамах Street View. Используя метаданные, вы можете узнать, доступно ли изображение Street View в данном месте, а также получить программный доступ к широте и долготе, идентификатору панорамы, дате съемки фотографии и информации об авторских правах на изображение. . Доступ к этим метаданным позволяет вам настроить поведение ошибок в вашем приложении.

Запросы метаданных Street View Static API доступны бесплатно. При запросе метаданных квота не используется. Квота расходуется только при загрузке изображения с помощью Street View Static API .

При запросе метаданных изображений Street View панорамные изображения получаются с точностью до 50 метров.

Доступ к метаданным изображений

Запрос метаданных изображения Street View представляет собой URL-адрес HTTP следующей формы:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

Как обычно в URL-адресах, все параметры разделяются символом амперсанда (&).

Обязательные параметры для запросов метаданных

Запросы метаданных принимают те же параметры URL-адреса, что и запросы изображений Street View Static API, однако требуются только следующие параметры:

Или:

  • location — может быть либо текстовой строкой (например, Chagrin Falls, OH ), либо парой координат широты и долготы, разделенных запятыми ( 40.457375,-80.009353 ).

Или:

  • pano — конкретный идентификатор панорамы. Как правило, они стабильны, хотя идентификаторы панорам могут со временем меняться по мере обновления изображений.

А также:

  • key и signature — ключ API необходим для аутентификации запроса. Цифровая подпись также требуется в некоторых случаях и всегда рекомендуется. Дополнительные сведения см. в разделе Получение ключа и подписи .

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

https://maps.googleapis.com/maps/api/streetview/metadata?location=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

или вот так:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

Дополнительные параметры для запросов метаданных

В запрос метаданных вы можете включить следующие параметры: size , heading , fov и pitch . Обратите внимание, что эти параметры не влияют на данные о панораме или на то, какая панорама найдена. API позволяет включать те же параметры, что и запрос изображения , чтобы упростить создание запроса метаданных, связанного с конкретным запросом изображения, но для запросов метаданных API игнорирует необязательные параметры и их значения. Информацию об использовании этих параметров см. в руководстве разработчика Static API Street View.

Формат ответа

Ответы с метаданными возвращаются только в формате JSON.

Примеры

Пример 1: Найдена панорама

Следующие URL-адреса успешно запрашивают метаданные и изображение одной и той же панорамы.

Запрос и ответ метаданных

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

Запрос изображения и ответ, если ожидается отсутствующее изображение.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Эйфелева башня

Пример 2: Панорама не найдена

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

Запрос и ответ метаданных

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{
   "status" : "ZERO_RESULTS"
}

Запрос изображения и ответ

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Здесь нет изображений

Коды состояния

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

Положение дел Описание
"OK" Указывает, что ошибок не произошло; панорама найдена и метаданные возвращены.
"ZERO_RESULTS" Указывает, что рядом с указанным местоположением панораму найти не удалось. Это может произойти, если указан несуществующий или неверный идентификатор панорамы.
"NOT_FOUND" Указывает, что строка адреса, указанная в параметре location , не найдена. Это может произойти, если указан несуществующий адрес.
"OVER_QUERY_LIMIT" Указывает, что вы превысили дневную или посекундную квоту для этого API.
"REQUEST_DENIED" Указывает, что ваш запрос отклонен. Это может произойти, если вы не авторизовали свой запрос или если статический API просмотра улиц не активирован в проекте Google Cloud Console, содержащем ваш ключ API.
"INVALID_REQUEST" Обычно указывает на то, что параметры запроса (адрес, широта или компоненты) отсутствуют.
"UNKNOWN_ERROR" Указывает, что запрос не удалось обработать из-за ошибки сервера. Зачастую это временный статус. Запрос может быть успешным, если вы повторите попытку.

Больше информации

Для получения дополнительной информации об использовании Street View Static API или других продуктов Google Maps API обязательно посетите страницу поддержки Maps API.