Метаданные изображения 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

Примечание . Протокол https:// необходим для запросов метаданных.

Как это принято в 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=

или вот так:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&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 может содержать следующие значения:

Статус	Описание
"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.