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

Разработчики из Европейской экономической зоны (ЕЭЗ)

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

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

Или:

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

А также:

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

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

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

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

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

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

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

    Примечание: для бывших пользователей тарифного плана Google Maps Platform Premium требуется цифровая подпись . Подробнее о параметрах аутентификации для пользователей тарифного плана Premium можно узнать здесь.

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


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

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

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

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
Скриншот фотографии, сделанной с уровня улицы, на которой видны электрифицированные железнодорожные пути.

Изображения отсутствуют

Для мест, где изображения Street View недоступны, API Street View Static возвращает серое изображение общего вида с текстом «Извините, здесь нет изображений», как показано в этом примере:

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

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

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

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