Все готово!

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

Активация Google Street View Image API

Чтобы помочь вам освоиться, мы покажем, как выполнить некоторые необходимые действия в консоли разработчика Google:

  1. Создание или выбор проекта
  2. Активация Google Street View Image API
  3. Создание соответствующих ключей

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

Введение

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

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

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

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

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

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

Все параметры разделяются амперсандами (&) в соответствии со стандартом URL-адресов.

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

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

Воспользуйтесь одним из следующих способов:

  • location – может быть либо текстовой строкой (например, Chagrin Falls, OH), либо значением широты и долготы (40.457375,-80.009353).

Или:

  • pano – идентификатор определенной панорамы. Они, как правило, неизменны.

А также:

  • key или client и signature – ключ API и идентификатор клиента являются обязательными реквизитами, необходимыми для аутентификации запроса. В определенных случаях требуется также и цифровая подпись. Дополнительные сведения см. в документе Получение ключа и подписи.

Дополнительные параметры запросов метаданных

В запрос метаданных можно включить следующие параметры: size, heading, fov, pitch. Обратите внимание, что эти параметры не влияют на данные о панораме и на результаты ее поиска. API позволяет включать те же параметры, что и запрос изображений. Это упрощает построение запроса метаданных, относящегося к определенному запросу изображений. Но в случае с запросами метаданных дополнительные параметры и их значения игнорируются API. См. информацию об использовании этих параметров в руководстве для разработчиков Street View Image API.

Формат ответа

Ответы на запросы метаданных возвращаются только в формате JSON.

Примеры

Пример 1

Следующие URL-адреса успешно запрашивают метаданные и изображение одной и той же панорамы.

Запрос метаданных и ответ на него

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&fov=110&pitch=38&key=YOUR_API_KEY
{
   "copyright" : "© 2016 Google",
   "date" : "2016-04",
   "location" : {
      "lat" : 48.85895346423429,
      "lng" : 2.293383539827548
   },
   "pano_id" : "ou7kIuLmb-TE-EnFkxhPHQ",
   "status" : "OK"
}

Запрос изображения и ответ на него

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&fov=110&pitch=38&key=YOUR_API_KEY

Пример 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
{
   "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

Коды состояния

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

Состояние Описание
"OK" Означает, что ни одной ошибки не произошло, панорама найдена и метаданные возвращены.
"ZERO_RESULTS": Означает, что не удается найти панораму для окрестностей указанного места. Такое может произойти, если задан несуществующий или неверный идентификатор панорамы.
"NOT_FOUND" Означает, что не найдена адресная строка, задаваемая параметром location. Такое может произойти, если задан несуществующий адрес.
"OVER_QUERY_LIMIT": Означает, что для данного API превышена ежедневная или посекундная квота.
"REQUEST_DENIED" Означает, что запрос отклонен. Такое может произойти, если не использовался ключ API или идентификатор клиента, а также если Google Street View Image API не активирован в проекте Google API Console, содержащем ваш ключ API.
"INVALID_REQUEST" Как правило, означает, что отсутствуют параметры запроса (адрес, широта и долгота, или компоненты).
"UNKNOWN_ERROR": Означает, что запрос не удалось выполнить из-за ошибки сервера. Часто это состояние временное. Если повторить попытку, запрос может оказаться успешным.

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

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

Оставить отзыв о...

Текущей странице
Google Street View Image API
Нужна помощь? Обратитесь в службу поддержки.