Запрос изображения 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
, либо отсутствие значения, то идентификатор панорамы был удален и его необходимо обновить.
Сохраните адрес местоположения или координаты широты и долготы, которые вы использовали для получения идентификатора панорамы, чтобы при необходимости их можно было обновить.
Когда вы обнаружите, что идентификатор панорамы изменился, используйте исходный адрес местоположения или координаты широты и долготы, чтобы снова найти ближайшие панорамы к этому местоположению и получить новый идентификатор панорамы.
Дополнительные параметры
-
signature
( рекомендуется ) — это цифровая подпись, используемая для проверки того, что любой сайт, генерирующий запросы с использованием вашего ключа API, имеет на это право. Запросы, не содержащие цифровой подписи, могут завершиться неудачно. Дополнительные сведения см. в разделе Получение ключа и подписи .Примечание. Для бывших клиентов премиального плана платформы 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 вместо обычного серого изображения, если для указанного местоположения изображение недоступно. - Перед отправкой запроса запросите метаданные изображения Street View, чтобы определить, доступны ли изображения для указанного места.