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

Введение

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

Примечание . Значение поля даты может варьироваться:

• Поле даты может иметь разную степень детализации для разных панорам. Например, поле даты для одних панорам содержит год и месяц, а для других — только год.
• Поле даты опускается, если данные недоступны.

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

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

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

Запрос метаданных изображения Просмотра улиц представляет собой 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=<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 игнорирует необязательные параметры и их значения. Информацию об использовании этих параметров см. в руководстве разработчика 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"	Указывает, что рядом с указанным местоположением не удалось найти панораму. Это может произойти, если указан несуществующий или недействительный идентификатор панорамы.
"NOT_FOUND"	Указывает, что строка адреса, предоставленная в параметре location , не может быть найдена. Это может произойти, если указан несуществующий адрес.
"OVER_QUERY_LIMIT"	Указывает, что вы превысили дневную или посекундную квоту для этого API.
"REQUEST_DENIED"	Указывает, что ваш запрос был отклонен. Это может произойти, если вы не авторизовали свой запрос или если статический API Просмотра улиц не активирован в проекте Google Cloud Console, содержащем ваш ключ API.
"INVALID_REQUEST"	Обычно указывает, что параметры запроса (адрес, latlng или компоненты) отсутствуют.
"UNKNOWN_ERROR"	Указывает, что запрос не может быть обработан из-за ошибки сервера. Часто это временное состояние. Запрос может быть успешным, если вы попробуете еще раз.

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

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