Запрос и ответ на просмотр улиц

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

Либо:

  • location может быть либо текстовой строкой (например, Chagrin Falls, OH ), либо значением широты/долготы ( 40.457375,-80.009353 ) и должно быть закодировано в URL , поэтому такие адреса, как «City Hall, New York, NY», должны быть преобразуется в «City+Hall,New+York,NY» до того, как запрос будет подписан. Статический API Просмотра улиц привязывается к панораме, сфотографированной ближе всего к этому месту. Когда предоставляется текстовая строка адреса, API может использовать другое местоположение камеры, чтобы лучше отобразить указанное местоположение. Когда предоставляется широта/долгота, API ищет в радиусе 50 метров фотографию, ближайшую к этому местоположению. Поскольку изображения в Просмотре улиц периодически обновляются, а фотографии могут каждый раз делаться с немного разных позиций, возможно, что ваше location может быть привязано к другой панораме при обновлении изображений.

Или же:

  • pano — это идентификатор панорамы. Обычно они стабильны.

Так же как:

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

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

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

    Примечание. Для бывших клиентов с планом Premium платформы Google Карт требуется цифровая подпись . Получите дополнительную информацию о параметрах аутентификации для клиентов Премиум-плана .

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


    Скриншот широкого поля зрения, показывающий потолок, стены, пол и окно резервуара внутри аквариума.Скриншот поля зрения крупным планом, показывающий увеличенные детали фотографии Street View внутри аквариума.
    (Слева: fov=120 ; справа: fov=20 )

  • pitch ( по умолчанию 0 ) определяет угол наклона камеры вверх или вниз относительно транспортного средства в Просмотре улиц. Часто, но не всегда, это плоская горизонталь. Положительные значения наклоняют камеру вверх ( 90 градусов указывают прямо вверх); отрицательные значения наклоняют камеру вниз (при -90 указывает прямо вниз).
  • radius ( по умолчанию 50 ) задает радиус, указанный в метрах, в котором нужно искать панораму с центром на заданной широте и долготе. Допустимые значения — неотрицательные целые числа.
  • return_error_code указывает, должен ли API возвращать код ошибки, когда изображение не найдено (404 NOT FOUND) или в ответ на недопустимый запрос (400 BAD REQUEST). Допустимые значения true и false . Если установлено значение true , вместо стандартного серого изображения возвращается сообщение об ошибке. Это избавляет от необходимости делать отдельный вызов для проверки доступности изображения.
  • source ( по умолчанию используется по default ) ограничивает поиск в Просмотре улиц выбранными источниками. Допустимые значения:
    • default используются стандартные источники для Просмотра улиц; поиск не ограничивается конкретными источниками.
    • outdoor ограничивает поиск уличными коллекциями. Коллекции для помещений не включаются в результаты поиска. Обратите внимание, что наружные панорамы могут не существовать для указанного местоположения. Также обратите внимание, что поиск возвращает только те панорамы, где можно определить, находятся ли они в помещении или на улице. Например, фотосферы не возвращаются, потому что неизвестно, находятся ли они в помещении или на улице.

Это примерный запрос.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Скриншот фотографии смотровой площадки на уровне улицы, на которой видны электрифицированные железнодорожные пути.

Нет доступных изображений

Для местоположений, где изображения Просмотра улиц недоступны, Статический API Просмотра улиц возвращает стандартное изображение серого цвета с текстом "Извините, у нас нет изображений", как показано в следующем примере:

Скриншот общего изображения, отображаемого, когда для указанного местоположения нет доступных изображений. Фон светло-коричневый, и на нем отображается текст: «Извините, здесь нет изображений».
Рисунок: Общее изображение, отображаемое, когда для указанного местоположения нет доступных изображений.

Показывать только допустимые изображения

Чтобы избежать отображения общего изображения и убедиться, что на вашей веб-странице отображаются только действительные изображения Street View Static API, следуйте этим рекомендациям:

  • Установите для параметра return_error_code значение true . Это приведет к тому, что статический API Просмотра улиц будет возвращать ошибку 404 NOT FOUND вместо стандартного серого изображения, если для указанного местоположения нет доступного изображения.
  • Запросите метаданные изображения Просмотра улиц , чтобы определить, доступны ли изображения для указанного местоположения, прежде чем отправлять запрос.