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

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

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

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

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

Или:

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

Или:

  • pano — это конкретный идентификатор панорамы. Идентификатор панорамы может со временем измениться, поэтому не сохраняйте этот идентификатор. Вместо этого сохраните адрес местоположения или координаты широты и долготы, чтобы можно было обновить идентификатор панорамы. Подробности см. в разделе «Обновление идентификаторов удаленных панорам» .

А также:

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

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

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

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

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

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

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

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

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


    Снимок экрана с широким обзором, показывающий потолок, стены, пол и окно резервуара внутри аквариума.Скриншот поля зрения крупным планом, показывающий увеличенную фотографию 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 вместо обычного серого изображения, если для указанного местоположения изображение недоступно.
  • Перед отправкой запроса запросите метаданные изображения Street View, чтобы определить, доступны ли изображения для указанного места.