Класс StreetViewPanorama
class
google.maps.StreetViewPanorama
extends MVCObject
library "streetView"
Показывает панораму для заданного объекта LatLng или идентификатора панорамы. Объект StreetViewPanorama предоставляет средство просмотра сервиса "Просмотр улиц", которое может быть автономным в отдельном элементе <div> или привязанным к объекту Map.
const {StreetViewPanorama} = await google.maps.importLibrary("streetView");
Конструктор | |
|---|---|
StreetViewPanorama |
StreetViewPanorama(container[, opts])Параметры:
Создает панораму с переданным StreetViewPanoramaOptions. |
Свойства | |
|---|---|
controls |
Тип:
Array<MVCArray<HTMLElement>>Дополнительные элементы управления, которые должны быть присоединены к панораме. Чтобы добавить элемент управления в панораму, добавьте <div> элемента управления в MVCArray, соответствующий ControlPosition, где он должен быть отрисован. |
Методы | |
|---|---|
focus |
focus()Параметры: нет.
Возвращаемое значение: нет.
Устанавливает фокус на этом StreetViewPanorama. Рекомендуем попробовать этот метод вместе с событием visible_changed, чтобы убедиться, что элемент StreetViewPanorama виден, прежде чем задавать фокус. Невидимый элемент StreetViewPanorama не может быть в фокусе. |
getLinks |
getLinks()Параметры: нет.
Возвращаемое значение:
Array<StreetViewLink optional>|nullВозвращает набор навигационных ссылок для панорамы просмотра улиц. |
getLocation |
getLocation()Параметры: нет.
Возвращаемое значение:
StreetViewLocationВозвращает объект StreetViewLocation текущей панорамы. |
getMotionTracking |
getMotionTracking()Параметры: нет.
Возвращаемое значение:
booleanВозвращает состояние отслеживания движения. Если задано значение true, то при физическом перемещении устройства пользователем и при условии, что браузер поддерживает эту функцию, панорама в Просмотре улиц отслеживает физические перемещения. |
getPano |
getPano()Параметры: нет.
Возвращаемое значение:
stringВозвращает идентификатор текущей панорамы для панорамы просмотра улиц. Идентификатор остается без изменения только на время текущего сеанса браузера. |
getPhotographerPov |
getPhotographerPov()Параметры: нет.
Возвращаемое значение:
StreetViewPovВозвращает направление и наклон камеры фотографа в момент съемки панорамы. Для панорам в Просмотре улиц, снятых на дороге, также указывается направление движения автомобиля. Эти данные доступны после события pano_changed. |
getPosition |
getPosition()Параметры: нет.
Возвращаемое значение:
LatLng|nullВозвращает текущее положение LatLng для панорамы в Просмотре улиц. |
getPov |
getPov()Параметры: нет.
Возвращаемое значение:
StreetViewPovВозвращает текущую точку обзора для панорамы просмотра улиц. |
getStatus |
getStatus()Параметры: нет.
Возвращаемое значение:
StreetViewStatusВозвращает статус панорамы после выполнения запроса setPosition() или setPano(). |
getVisible |
getVisible()Параметры: нет.
Возвращаемое значение:
booleanВозвращает true, если панорама видна. Не указывает, доступно ли изображение панорамы просмотра улиц в указанном месте. |
getZoom |
getZoom()Параметры: нет.
Возвращаемое значение:
numberВозвращает уровень масштабирования панорамы. При минимальном масштабе (уровень 0) зона обзора составляет 180 градусов. При увеличении масштаба уровень масштабирования увеличивается. |
registerPanoProvider |
registerPanoProvider(provider[, opt_options])Параметры:
Возвращаемое значение: нет.
Задает поставщика пользовательской панорамы, вызываемого после изменения панорамы для загрузки пользовательских панорам. |
setLinks |
setLinks(links)Параметры:
Возвращаемое значение: нет.
Задает набор навигационных ссылок для панорамы в Просмотре улиц. |
setMotionTracking |
setMotionTracking(motionTracking)Параметры:
Возвращаемое значение: нет.
Задает состояние отслеживания движения. Если задано значение true, то при физическом перемещении устройства пользователем и при условии, что браузер поддерживает эту функцию, панорама в Просмотре улиц отслеживает физические перемещения. |
setOptions |
setOptions(options)Параметры:
Возвращаемое значение: нет.
Задает набор пар "ключ-значение". |
setPano |
setPano(pano)Параметры:
Возвращаемое значение: нет.
Задает текущий идентификатор панорамы для панорамы просмотра улиц. |
setPosition |
setPosition(latLng)Параметры:
Возвращаемое значение: нет.
Задает текущее положение LatLng для панорамы в Просмотре улиц. |
setPov |
setPov(pov)Параметры:
Возвращаемое значение: нет.
Задает точку обзора для панорамы просмотра улиц. |
setVisible |
setVisible(flag)Параметры:
Возвращаемое значение: нет.
Измените значение этого свойства на true, чтобы сделать панораму видимой. Если задано значение false, панорама будет скрыта независимо от того, встроена ли она в карту или в собственный элемент <div>. |
setZoom |
setZoom(zoom)Параметры:
Возвращаемое значение: нет.
Задает уровень масштабирования панорамы. При минимальном масштабе (уровень 0) зона обзора составляет 180 градусов. При увеличении масштаба уровень масштабирования увеличивается. |
Унаследованные:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll.
| |
События | |
|---|---|
closeclick |
function(event)Аргументы:
Это событие вызывается при нажатии кнопки закрытия. |
pano_changed |
function()Аргументы: нет.
Это событие вызывается при изменении идентификатора панорамы. Панорама может меняться по мере перемещения по ней пользователя или если положение устанавливается вручную. Обратите внимание, что не все изменения позиции вызывают pano_changed. |
position_changed |
function()Аргументы: нет.
Это событие вызывается при изменении положения панорамы. Панорама может меняться по мере перемещения по ней пользователя или если положение устанавливается вручную. |
pov_changed |
function()Аргументы: нет.
Это событие вызывается при изменении точки обзора панорамы. Точка обзора меняется при изменении угла наклона, масштаба или заголовка. |
resize |
function()Аргументы: нет.
Разработчики должны активировать это событие для панорамы, когда изменяется размер ее элемента div: google.maps.event.trigger(panorama, 'resize'). |
status_changed |
function()Аргументы: нет.
Это событие запускается после каждого поиска панорамы по идентификатору или местоположению с помощью setPosition() или setPano(). |
visible_changed |
function()Аргументы: нет.
Это событие вызывается при изменении видимости панорамы. Видимость меняется, когда человечек перетаскивается на карту, нажимается кнопка закрытия или вызывается метод setVisible(). |
zoom_changed |
function()Аргументы: нет.
Это событие вызывается при изменении уровня масштабирования панорамы. |
Интерфейс StreetViewPanoramaOptions
интерфейс
google.maps.StreetViewPanoramaOptions
Параметры, определяющие свойства объекта StreetViewPanorama.
Свойства | |
|---|---|
addressControl
необязательно |
Тип:
boolean optionalВключенное/выключенное состояние элемента управления адресом. |
addressControlOptions
необязательно |
Тип:
StreetViewAddressControlOptions optionalПараметры отображения для элемента управления адресом. |
clickToGo
необязательно |
Тип:
boolean optionalПо умолчанию:
true.Включен или отключен переход по клику. Неприменимо к пользовательским панорамам. |
controlSize
необязательно |
Тип:
number optionalРазмер элементов управления, отображаемых на панораме, в пикселях. Это значение необходимо указать непосредственно при создании панорамы. Если изменить его позже, элементы управления могут перейти в неопределенное состояние. Управляет только элементами, созданными самим Maps API. Не масштабирует созданные разработчиком элементы управления. |
disableDefaultUI
необязательно |
Тип:
boolean optionalВключает или отключает весь интерфейс по умолчанию. Их можно переопределить по отдельности. |
disableDoubleClickZoom
необязательно |
Тип:
boolean optionalПо умолчанию:
true.Включение/отключение масштабирования при двойном нажатии. |
enableCloseButton
необязательно |
Тип:
boolean optionalПо умолчанию:
false.Если задано значение true, кнопка закрытия показывается. |
fullscreenControl
необязательно |
Тип:
boolean optionalВключено или отключено управление полноэкранным режимом. |
fullscreenControlOptions
необязательно |
Тип:
FullscreenControlOptions optionalПараметры отображения элемента управления полноэкранным режимом. |
imageDateControl
необязательно |
Тип:
boolean optionalВключено или отключено управление датой получения снимков. По умолчанию выключена. |
linksControl
необязательно |
Тип:
boolean optionalВключенное/выключенное состояние элемента управления ссылками. |
motionTracking
необязательно |
Тип:
boolean optionalВключено или отключено отслеживание движения. По умолчанию включено, если есть элемент управления отслеживанием движения и пользователь предоставил разрешение или оно не требуется. В этом случае точка обзора следует за ориентацией устройства. Это в первую очередь относится к мобильным устройствам. Если для параметра motionTracking задано значение false, а параметр motionTrackingControl включен, элемент управления отслеживанием движения будет виден, но само отслеживание будет отключено. Пользователь может коснуться элемента управления, чтобы включить или отключить эту функцию. Если для motionTracking задано значение true, когда разрешение требуется, но ещё не запрошено, элемент управления отслеживанием движения появляется, но отслеживание отключено. Пользователь может коснуться элемента управления, чтобы запросить разрешение. Если для параметра motionTracking задано значение true, а пользователь запретил доступ, элемент управления отслеживанием движения будет неактивен, а само отслеживание – отключено. |
motionTrackingControl
необязательно |
Тип:
boolean optionalСостояние элемента управления отслеживанием движения (включен или отключен) Включен по умолчанию, если на устройстве есть данные о движении, чтобы элемент управления отображался на карте. Это в первую очередь относится к мобильным устройствам. |
motionTrackingControlOptions
необязательно |
Тип:
MotionTrackingControlOptions optionalПараметры отображения элемента управления отслеживанием движения. |
panControl
необязательно |
Тип:
boolean optionalВключенное/выключенное состояние элемента управления панорамированием. |
panControlOptions
необязательно |
Тип:
PanControlOptions optionalПараметры отображения для элемента управления панорамированием. |
pano
необязательно |
Тип:
string optionalИдентификатор панорамы, который должен быть задан, когда указывается пользовательская панорама. |
position
необязательно |
Тип:
LatLng|LatLngLiteral optionalПозиция LatLng панорамы в Просмотре улиц. |
pov
необязательно |
Тип:
StreetViewPov optionalОриентация камеры, заданная как направление и наклон для панорамы. |
scrollwheel
необязательно |
Тип:
boolean optionalПо умолчанию:
true.Если задано значение false, отключает масштабирование колесиком мыши в режиме просмотра улиц. |
showRoadLabels
необязательно |
Тип:
boolean optionalПо умолчанию:
true.Отображение названий улиц на панораме. Если это значение не указано или задано как true, на панораме будут показываться названия улиц. Если задано значение false, названия улиц не показываются. |
visible
необязательно |
Тип:
boolean optionalЕсли задано значение true, панорама в Просмотре улиц будет видна при загрузке. |
zoom
необязательно |
Тип:
number optionalМасштаб панорамы, заданный числом. При масштабе 0 зона обзора составляет 180 градусов. |
zoomControl
необязательно |
Тип:
boolean optionalВключенное/выключенное состояние элемента управления масштабированием. |
zoomControlOptions
необязательно |
Тип:
ZoomControlOptions optionalПараметры отображения для элемента управления масштабированием. |
Интерфейс StreetViewAddressControlOptions
интерфейс
google.maps.StreetViewAddressControlOptions
Параметры для отображения элемента управления адресом в просмотре улиц.
Свойства | |
|---|---|
position
необязательно |
Тип:
ControlPosition optionalИдентификатор положения. Этот идентификатор используется, чтобы указывать положение элемента управления на карте. Положение по умолчанию – TOP_LEFT. |
Интерфейс PanoProviderOptions
интерфейс
google.maps.PanoProviderOptions
Параметры для поставщика пользовательских панорам.
Свойства | |
|---|---|
cors
необязательно |
Тип:
boolean optionalЕсли задано, средство визуализации будет использовать технологии (например, WebGL), которые работают только в том случае, если в предоставленных изображениях правильно заданы заголовки CORS. Разработчик должен обеспечить правильный показ изображений в сочетании с этим флагом, иначе могут возникнуть ошибки SecurityError. |
Интерфейс StreetViewTileData
интерфейс
google.maps.StreetViewTileData
Свойства набора фрагментов, используемого в панораме просмотра улиц.
Свойства | |
|---|---|
centerHeading |
Тип:
numberНаправление (в градусах) в исходной точке панорамных фрагментов. |
tileSize |
Тип:
SizeРазмер (в пикселях) отображения фрагментов. |
worldSize |
Тип:
SizeРазмер (в пикселях) всей "области" панорамы. |
Методы | |
|---|---|
getTileUrl |
getTileUrl(pano, tileZoom, tileX, tileY)Параметры:
Возвращаемое значение:
stringПолучает URL изображения для указанного фрагмента. Это пользовательский метод, который необходимо реализовать, чтобы предоставить собственные фрагменты. API вызывает этот метод, предоставляя следующие параметры: pano – идентификатор панорамы фрагмента Просмотра улиц.tileZoom – уровень масштабирования фрагмента.tileX – координата X фрагмента.tileY – координата Y фрагмента.Ваш собственный метод должен возвращать URL изображения фрагмента. |
Интерфейс StreetViewPov
интерфейс
google.maps.StreetViewPov
Объект точки обзора, который определяет ориентацию камеры в положении панорамного изображения просмотра улиц. Точка обзора определяется направлением и наклоном.
Свойства | |
|---|---|
heading |
Тип:
numberНаправление камеры в градусах относительно true севера. Истинный север – 0°, восток – 90°, юг – 180°, запад – 270°. |
pitch |
Тип:
numberУгол наклона камеры в градусах относительно транспорта в просмотре улиц. Диапазон в пределах от 90° (прямо вверх) до -90° (прямо вниз). |
Класс StreetViewCoverageLayer
class
google.maps.StreetViewCoverageLayer
extends MVCObject
library "streetView"
Слой, на котором показаны места, доступные в Просмотре улиц.
const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView");
Конструктор | |
|---|---|
StreetViewCoverageLayer |
StreetViewCoverageLayer()Параметры: нет.
Создает новый экземпляр класса StreetViewCoverageLayer. |
Методы | |
|---|---|
getMap |
getMap()Параметры: нет.
Возвращаемое значение:
Map|nullВозвращает карту, на которой отображается этот слой. |
setMap |
setMap(map)Параметры:
Возвращаемое значение:
undefinedПоказывает слой на указанной карте. Если для карты задано значение null, слой будет удален. |
Унаследованные:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll.
| |