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

Введение

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

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

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

Получите доступ к метаданным изображений.

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

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

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

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

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

Или:

• 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 игнорирует необязательные параметры и их значения. Информацию об использовании этих параметров см. в руководстве разработчика по статическому 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 в объекте ответа метаданных содержит статус запроса и может содержать отладочную информацию, которая поможет вам устранить неполадки, связанные с неработающим запросом Street View. Поле status может содержать следующие значения:

Более подробная информация

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