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

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

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

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

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

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

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

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

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

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