Введение
Запросы метаданных 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=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
или вот так:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
Обновить идентификаторы удаленных панорам
Если вы попытаетесь получить идентификатор панорамы и получите либо ZERO_RESULTS
, либо отсутствие значения, то идентификатор панорамы был удален и его необходимо обновить.
Сохраните адрес местоположения или координаты широты и долготы, которые вы использовали для получения идентификатора панорамы, чтобы при необходимости их можно было обновить.
Когда вы обнаружите, что идентификатор панорамы изменился, используйте исходный адрес местоположения или координаты широты и долготы, чтобы снова найти ближайшие панорамы к этому местоположению и получить новый идентификатор панорамы.
Дополнительные параметры для запросов метаданных
В запрос метаданных вы можете включить следующие параметры: size
, heading
, fov
и pitch
. Обратите внимание, что эти параметры не влияют на данные о панораме или на то, какая панорама найдена. API позволяет включать те же параметры, что и запрос изображения , чтобы упростить создание запроса метаданных, связанного с конкретным запросом изображения, но для запросов метаданных API игнорирует необязательные параметры и их значения. Информацию об использовании этих параметров см. в руководстве разработчика Street View Static API .
Формат ответа
Ответы с метаданными возвращаются только в формате 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" | Указывает, что рядом с указанным местоположением панораму найти не удалось. Этот ответ может возникнуть, если вы предоставите несуществующий или неверный идентификатор панорамы. См. раздел [Обновление идентификаторов удаленных панорам](#refresh-pano). |
"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.