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

Введение

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

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

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

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

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

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

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

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=<YOUR_SIGNATURE>

или так:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

Обновить идентификаторы удаленных панорам

Если при попытке получить идентификатор панорамы вы получаете ZERO_RESULTS или не получаете никакого значения, это значит, что идентификатор панорамы был удален и его необходимо обновить.

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

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

Примечание: поскольку изображения Street View периодически обновляются, а фотографии могут быть сделаны каждый раз с немного разных позиций, заданный идентификатор панорамы может привязываться к другой панораме при обновлении изображения или идентификатора панорамы.

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

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

Статус	Описание
"OK"	Указывает на то, что ошибок не произошло; панорама найдена и метаданные возвращены.
"ZERO_RESULTS"	Указывает, что панорама не найдена рядом с указанным местоположением. Этот ответ может возникнуть, если вы указали несуществующий или недействительный идентификатор панорамы. См. [Обновить идентификаторы удаленных панорам](#refresh-pano).
"NOT_FOUND"	Указывает, что адресная строка, указанная в параметре location не найдена. Это сообщение может возникнуть, если указан несуществующий адрес.
"OVER_QUERY_LIMIT"	Указывает, что вы превысили дневную или посекундную квоту для этого API.
"REQUEST_DENIED"	Указывает, что ваш запрос был отклонен. Это сообщение может появиться, если вы не авторизовали свой запрос или если Street View Static API не активирован в проекте консоли Google Cloud, содержащем ваш ключ API.
"INVALID_REQUEST"	Обычно указывает на то, что отсутствуют параметры запроса (адрес, координаты широты и долготы или компоненты).
"UNKNOWN_ERROR"	Указывает, что запрос не может быть обработан из-за ошибки сервера. Эта проблема часто временная. Запрос может быть выполнен успешно, если вы попробуете еще раз.

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

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