Метаданные изображения Street View

Введение

Запросы метаданных 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 , либо отсутствие значения, то идентификатор панорамы был удален и его необходимо обновить.

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

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

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

В запрос метаданных вы можете включить следующие параметры: 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 может содержать следующие значения:

Дополнительная информация

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