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

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

  • 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 ограничивает поиск коллекциями outdoor. Внутренние коллекции не включаются в результаты поиска. Обратите внимание, что для указанного местоположения панорамы outdoor могут отсутствовать. Также обратите внимание, что поиск возвращает только панорамы, для которых можно определить, находятся ли они в помещении или на открытом воздухе. Например, PhotoSpheres не возвращаются, поскольку неизвестно, находятся ли они в помещении или на открытом воздухе.

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

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