Введение
Запросы метаданных 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
Как принято в 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
или не получаете никакого значения, это значит, что идентификатор панорамы был удален и его необходимо обновить.
Сохраните адрес местоположения или координаты широты и долготы, которые вы использовали для получения идентификатора панорамы, чтобы при необходимости можно было обновить данные.
Если вы обнаружили, что идентификатор панорамы изменился, используйте исходный адрес местоположения или координаты широты и долготы, чтобы снова найти ближайшие к этому местоположению панорамы и получить новый идентификатор панорамы.
Необязательные параметры для запросов метаданных
Вы можете включить следующие параметры в запрос метаданных: 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.