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