Все готово!

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

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

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

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

Google Street View Image API

Введение

Google Street View Image API позволяет встраивать статическую (не интерактивную) панораму Street View или миниатюру в веб-страницу без использования JavaScript. Для определения области просмотра используются параметры URL-адреса, которые отправляются с помощью стандартного запроса HTTP и возвращаются в виде статического изображения.

https://maps.googleapis.com/maps/api/streetview?size=400x400&location=40.720032,-73.988354
&fov=90&heading=235&pitch=10
&key=YOUR_API_KEY

Параметры URL-адреса

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

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

Изображение указывается с помощью параметров запроса. Все параметры разделяются амперсандами (&) в соответствии со стандартом URL-адресов. Ниже указаны допустимые параметры и их возможные значения.

Обязательные параметры

Или:

  • location – может быть представлен либо как текстовая строка (например, Chagrin Falls, OH), либо как значение широты и долготы (40.457375, -80.009353). Google Street View Image API отобразит панораму, снятую максимально близко к этому месту. Когда предоставляется адресная текстовая строка, API может использовать другое расположение камеры, чтобы лучше отобразить указанное место. Если предоставляется широта и долгота, API ищет ближайшую к данному местоположению фотографию в радиусе 50 метров. Поскольку изображения панорамы Street View периодически обновляются, а фотографии могут быть сделаны каждый раз из немного разных позиций, есть вероятность, что при обновлении изображений необходимое вам местоположение (параметр location) может оказаться прикрепленным к другой панораме.

Или:

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

А также:

  • size (размер) – указывает выходной размер изображения в пикселях. Размер указывается как {width}x{height} – например, size=600x400 возвращает изображение шириной 600 пикселей и высотой 400 пикселей.
  • key – позволяет контролировать использование API приложением в Google API Console и обеспечивает доступ к значительной бесплатной ежедневной квоте, а также позволяет Google в случае необходимости связываться с вами относительно вашего приложения. Дополнительные сведения см. в документе Получение ключа и подписи.

    Примечание. Пользователи Google Maps APIs Premium Plan в запросах Street View могут использовать либо ключ API и цифровую подпись, либо действительный идентификатор клиента и цифровую подпись. См. дополнительную информацию о параметрах аутентификации пользователей Premium Plan.

    Пользователи с лицензией на ранее выпускавшийся продукт Google Maps APIs for Work должны включать в свои запросы действующие параметры client и signature вместо параметра key. Подробнее см. раздел Идентификаторы и подписи клиента на странице "Получение ключа и подписи".

Дополнительные параметры

  • signature (рекомендуемый параметр) – цифровая подпись, используемая для проверки наличия соответствующих прав у сайта, который создает запросы с помощью вашего ключа API. Примечание. При включенной тарификации требуется цифровая подпись. Если вы превысите бесплатный ежедневный лимит загрузок карт, то до конца этого дня дополнительные загрузки карт будут платными. Тарифицируемые загрузки карт без цифровой подписи выполняться не будут. Дополнительные сведения см. в документе Получение ключа и подписи.

    Примечание. Для пользователей Google Maps APIs Premium Plan цифровая подпись является обязательной. См. дополнительную информацию о параметрах аутентификации пользователей Premium Plan.

  • heading – указывает направление компаса камеры. Допустимые значения : от 0 до 360 (оба значения указывают север, 90 указывает восток и 180 – юг). Если направление камеры не указано, будет рассчитано значение, при котором камера ориентируется в направлении указанного местоположения (параметр location) с той точки, из которой была сделана ближайшая фотография.
  • fov (по умолчанию установлено 90) – определяет горизонтальное поле обзора для изображения. Поле обзора задается в градусах, с максимальным допустимым значением 120. Если используется область просмотра с фиксированным размером или изображение панорамы Street View установленного размера, то поле обзора можно считать уровнем масштабирования, меньшие значения поля обзора обеспечивают более высокий уровень масштабирования.



    (Слева: fov=120; Справа: fov=20)

  • pitch (по умолчанию установлено 0) – указывает угол наклона (вниз или вверх) камеры относительно автомобиля Street View. Чаще всего (но не всегда), этот параметр соответствует горизонтальному положению камеры. При положительных значениях угла камера будет направлена вверх (когда 90 градусов означает направление вертикально вверх), а при отрицательных значениях – наклонена вниз (-90 означает направление вертикально вниз).

Ниже приведен пример запроса.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY

Изображения не найдены

Для мест, для которых изображения Street View отсутствуют, Google Street View Image API отображает стандартное изображение с текстом "Sorry, we have no imagery here".

Стандартная картинка, показываемая в случае отсутствия изображения для указанного местоположения
Рисунок: стандартная картинка, показываемая в случае отсутствия изображения для указанного местоположения

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

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

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

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

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