Класс карты
google.maps . Map
Класс google.maps . Map
Этот класс расширяет MVCObject
.
Доступ осуществляется путем вызова const {Map} = await google.maps.importLibrary("maps")
. См. раздел Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Map | Map(mapDiv[, opts]) Параметры:
Создает новую карту внутри заданного HTML-контейнера, который обычно является элементом DIV . |
Константы | |
---|---|
DEMO_MAP_ID | Идентификатор карты, который можно использовать для примеров кода, требующих идентификатор карты. Этот идентификатор карты не предназначен для использования в рабочих приложениях и не может использоваться для функций, требующих облачной настройки (например, Cloud Styling). |
Характеристики | |
---|---|
controls | Тип: Array < MVCArray < HTMLElement >> Дополнительные элементы управления для прикрепления к карте. Чтобы добавить элемент управления на карту, добавьте <div> элемента управления в MVCArray соответствующий ControlPosition , где он должен отображаться. |
data | Тип: Data Экземпляр Data , привязанный к карте. Добавьте объекты к этому объекту Data , чтобы их было удобно отображать на этой карте. |
mapTypes | Тип: MapTypeRegistry Реестр экземпляров MapType по строковому идентификатору. |
overlayMapTypes | Дополнительные типы карт для наложения. Типы наложенных карт будут отображаться поверх базовой карты, к которой они прикреплены, в том порядке, в котором они появляются в массиве overlayMapTypes (наложения с более высокими значениями индекса отображаются перед наложениями с более низкими значениями индекса). |
Методы | |
---|---|
fitBounds | fitBounds(bounds[, padding]) Параметры:
Возвращаемое значение: Нет Устанавливает область просмотра, содержащую заданные границы. Примечание. Если для карты установлено display: none , функция fitBounds считывает размер карты как 0x0 и, следовательно, ничего не делает. Чтобы изменить область просмотра, когда карта скрыта, установите для карты visibility: hidden , тем самым гарантируя, что div карты имеет фактический размер. Для векторных карт этот метод устанавливает наклон и направление карты на нулевые значения по умолчанию. Вызов этого метода может привести к плавной анимации, когда карта перемещается и масштабируется в соответствии с границами. Анимируется ли этот метод или нет, зависит от внутренней эвристики. |
getBounds | getBounds() Параметры: Нет Возвращаемое значение: LatLngBounds |undefined Границы широты и долготы текущего окна просмотра. Возвращает границы широты и долготы текущего окна просмотра. Если видно более одной копии мира, границы располагаются по долготе от -180 до 180 градусов включительно. Если карта еще не инициализирована или центрирование и масштаб не установлены, результат undefined . Для векторных карт с ненулевым наклоном или направлением возвращаемые границы широты и долготы представляют собой наименьшую ограничивающую рамку, включающую видимую область области просмотра карты. См. MapCanvasProjection.getVisibleRegion , чтобы получить точную видимую область области просмотра карты. |
getCenter | getCenter() Параметры: Нет Возвращаемое значение: LatLng |undefined |
getClickableIcons | getClickableIcons() Параметры: Нет Возвращаемое значение: boolean|undefined Возвращает кликабельность значков карты. Значок карты представляет собой достопримечательность, также известную как POI. Если возвращаемое значение — true , то значки на карте можно щелкнуть. |
| getDatasetFeatureLayer(datasetId) Параметры:
Возвращаемое значение: FeatureLayer Возвращает FeatureLayer для указанного datasetId . Идентификаторы набора данных необходимо настроить в Google Cloud Console. Если идентификатор набора данных не связан со стилем карты карты или если стиль на основе данных недоступен (нет идентификатора карты, нет векторных листов, нет векторных слоев стиля на основе данных или наборов данных, настроенных в стиле карты), это регистрирует ошибка, и результирующий FeatureLayer.isAvailable будет ложным. |
getDiv | getDiv() Параметры: Нет Возвращаемое значение: HTMLElement MapDiv карты. |
getFeatureLayer | getFeatureLayer(featureType) Параметры:
Возвращаемое значение: FeatureLayer Возвращает FeatureLayer определенного FeatureType . FeatureLayer должен быть включен в Google Cloud Console. Если FeatureLayer указанного FeatureType не существует на этой карте или стиль, управляемый данными, недоступен (нет идентификатора карты, нет векторных листов и нет FeatureLayer , включенного в стиле карты), это регистрирует ошибку, и в результате FeatureLayer.isAvailable будет иметь значение false. |
getHeading | getHeading() Параметры: Нет Возвращаемое значение: number|undefined Возвращает компасный заголовок карты. Значение курса измеряется в градусах (по часовой стрелке) от кардинального направления на север. Если карта еще не инициализирована, результат undefined . |
getHeadingInteractionEnabled | getHeadingInteractionEnabled() Параметры: Нет Возвращаемое значение: boolean|null Возвращает, включено ли взаимодействие заголовков. Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна). |
getMapCapabilities | getMapCapabilities() Параметры: Нет Возвращаемое значение: MapCapabilities Информирует вызывающую сторону о текущих возможностях, доступных карте, на основе предоставленного идентификатора карты. |
getMapTypeId | getMapTypeId() Параметры: Нет Возвращаемое значение: MapTypeId |string|undefined |
getProjection | getProjection() Параметры: Нет Возвращаемое значение: Projection |undefined Возвращает текущую Projection . Если карта еще не инициализирована, результат undefined . Прослушайте событие projection_changed и проверьте его значение, чтобы убедиться, что оно не undefined . |
getRenderingType | getRenderingType() Параметры: Нет Возвращаемое значение: RenderingType Возвращает текущий RenderingType карты. |
getStreetView | getStreetView() Параметры: Нет Возвращаемое значение: StreetViewPanorama Панорама, привязанная к карте. Возвращает StreetViewPanorama по умолчанию, привязанную к карте, которая может быть панорамой по умолчанию, встроенной в карту, или панорамой, установленной с помощью setStreetView() . Изменения в streetViewControl карты будут отражены при отображении такой привязанной панорамы. |
getTilt | getTilt() Параметры: Нет Возвращаемое значение: number|undefined Возвращает текущий угол наклона карты в градусах от плоскости области просмотра к плоскости карты. Для растровых карт результатом будет 0 для изображений, сделанных непосредственно над головой, или 45 для изображений под углом 45°. Этот метод не возвращает значение, установленное setTilt . Подробности смотрите setTilt . |
getTiltInteractionEnabled | getTiltInteractionEnabled() Параметры: Нет Возвращаемое значение: boolean|null Возвращает, включены ли взаимодействия наклона. Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна). |
getZoom | getZoom() Параметры: Нет Возвращаемое значение: number|undefined Возвращает масштаб карты. Если масштаб не установлен, результат undefined . |
moveCamera | moveCamera(cameraOptions) Параметры:
Возвращаемое значение: Нет Немедленно устанавливает для камеры карты целевые параметры камеры без анимации. |
panBy | panBy(x, y) Параметры:
Возвращаемое значение: Нет Изменяет центр карты на заданное расстояние в пикселях. Если расстояние меньше ширины и высоты карты, переход будет плавно анимирован. Обратите внимание, что система координат карты увеличивается с запада на восток (для значений x) и с севера на юг (для значений y). |
panTo | panTo(latLng) Параметры:
Возвращаемое значение: Нет Изменяет центр карты на заданный LatLng . Если изменение меньше ширины и высоты карты, переход будет плавно анимирован. |
panToBounds | panToBounds(latLngBounds[, padding]) Параметры:
Возвращаемое значение: Нет Панорамирует карту на минимальную величину, необходимую для содержания данного LatLngBounds . Он не дает никаких гарантий, где на карте будут границы, за исключением того, что карта будет панорамирована, чтобы показать как можно больше границ внутри {currentMapSizeInPx} - {padding} . Как для растровых, так и для векторных карт масштаб, наклон и заголовок карты не будут изменены. |
setCenter | setCenter(latlng) Параметры:
Возвращаемое значение: Нет |
setClickableIcons | setClickableIcons(value) Параметры:
Возвращаемое значение: Нет Определяет, являются ли значки карты кликабельными или нет. Значок карты представляет собой достопримечательность, также известную как POI. Чтобы отключить кликабельность значков карты, передайте этому методу значение false . |
setHeading | setHeading(heading) Параметры:
Возвращаемое значение: Нет Устанавливает направление компаса для карты, измеряемое в градусах от кардинального направления на север. Для растровых карт этот метод применим только к аэрофотоснимкам. |
setHeadingInteractionEnabled | setHeadingInteractionEnabled(headingInteractionEnabled) Параметры:
Возвращаемое значение: Нет Устанавливает, включено ли взаимодействие с заголовком. Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна). |
setMapTypeId | setMapTypeId(mapTypeId) Параметры:
Возвращаемое значение: Нет |
setOptions | setOptions(options) Параметры:
Возвращаемое значение: Нет |
setRenderingType | setRenderingType(renderingType) Параметры:
Возвращаемое значение: Нет Устанавливает текущий тип рендеринга карты. |
setStreetView | setStreetView(panorama) Параметры:
Возвращаемое значение: Нет Привязывает StreetViewPanorama к карте. Эта панорама переопределяет StreetViewPanorama по умолчанию, позволяя карте привязываться к внешней панораме за пределами карты. Установка для панорамы значения null привязывает встроенную панораму по умолчанию обратно к карте. |
setTilt | setTilt(tilt) Параметры:
Возвращаемое значение: Нет Для векторных карт задает угол падения карты. Допустимые значения ограничены в зависимости от уровня масштабирования карты. Для растровых карт управляет автоматическим переключением угла наклона карты. Единственные допустимые значения — 0 и 45 . setTilt(0) заставляет карту всегда использовать вид сверху под углом 0° независимо от уровня масштабирования и области просмотра. setTilt(45) заставляет угол наклона автоматически переключаться на 45 всякий раз, когда изображения под углом 45° доступны для текущего уровня масштабирования и окна просмотра, и переключаться обратно на 0, когда изображения под углом 45° недоступны (это поведение по умолчанию). Снимки под углом 45° доступны только для типов satellite и hybrid карт, в некоторых местоположениях и при некоторых уровнях масштабирования. Примечание. getTilt возвращает текущий угол наклона, а не значение, установленное setTilt . Поскольку getTilt и setTilt относятся к разным вещам, не bind() свойство tilt ; это может привести к непредсказуемым последствиям. |
setTiltInteractionEnabled | setTiltInteractionEnabled(tiltInteractionEnabled) Параметры:
Возвращаемое значение: Нет Устанавливает, включены ли взаимодействия наклона. Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна). |
setZoom | setZoom(zoom) Параметры:
Возвращаемое значение: Нет Устанавливает масштаб карты. |
Наследуется: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll . |
События | |
---|---|
bounds_changed | function() Аргументы: Нет Это событие вызывается, когда границы области просмотра изменились. |
center_changed | function() Аргументы: Нет Это событие вызывается при изменении свойства центра карты. |
click | function(event) Аргументы:
Это событие вызывается, когда пользователь нажимает на карту. MapMouseEvent со свойствами выбранного местоположения возвращается, если только не был щелкнут значок места; в этом случае возвращается IconMouseEvent с идентификатором места. IconMouseEvent и MapMouseEvent идентичны, за исключением того, что IconMouseEvent имеет поле идентификатора места. Событие всегда можно рассматривать как MapMouseEvent, если идентификатор места не важен. Событие щелчка не запускается, если был щелкнут маркер или информационное окно. |
contextmenu | function(event) Аргументы:
Это событие вызывается, когда событие контекстного меню DOM запускается в контейнере карты. |
dblclick | function(event) Аргументы:
Это событие вызывается, когда пользователь дважды щелкает карту. Обратите внимание, что событие щелчка иногда срабатывает один, а иногда и два раза, прямо перед этим. |
drag | function() Аргументы: Нет Это событие вызывается неоднократно, пока пользователь перетаскивает карту. |
dragend | function() Аргументы: Нет Это событие вызывается, когда пользователь перестает перетаскивать карту. |
dragstart | function() Аргументы: Нет Это событие вызывается, когда пользователь начинает перетаскивать карту. |
heading_changed | function() Аргументы: Нет Это событие вызывается при изменении свойства заголовка карты. |
idle | function() Аргументы: Нет Это событие вызывается, когда карта становится бездействующей после панорамирования или масштабирования. |
isfractionalzoomenabled_changed | function() Аргументы: Нет Это событие вызывается при изменении свойства isFractionalZoomEnabled. |
mapcapabilities_changed | function() Аргументы: Нет Это событие вызывается при изменении возможностей карты. |
maptypeid_changed | function() Аргументы: Нет Это событие вызывается при изменении свойства MapTypeId. |
mousemove | function(event) Аргументы:
Это событие вызывается всякий раз, когда мышь пользователя перемещается по контейнеру карты. |
mouseout | function(event) Аргументы:
Это событие вызывается, когда мышь пользователя выходит из контейнера карты. |
mouseover | function(event) Аргументы:
Это событие вызывается, когда мышь пользователя входит в контейнер карты. |
projection_changed | function() Аргументы: Нет Это событие вызывается при изменении проекции. |
renderingtype_changed | function() Аргументы: Нет Это событие вызывается при изменении типа рендеринга. |
tilesloaded | function() Аргументы: Нет Это событие вызывается, когда видимые плитки завершили загрузку. |
tilt_changed | function() Аргументы: Нет Это событие вызывается при изменении свойства наклона карты. |
zoom_changed | function() Аргументы: Нет Это событие вызывается при изменении свойства масштабирования карты. |
| function(event) Аргументы:
Это событие вызывается, когда пользователь щелкает правой кнопкой мыши на карте. |
Интерфейс MapOptions
google.maps . MapOptions
Интерфейс google.maps . MapOptions
Объект MapOptions, используемый для определения свойств, которые можно установить на карте.
Характеристики | |
---|---|
backgroundColor optional | Тип: string optional Цвет, используемый для фона div-карты. Этот цвет будет виден, когда плитки еще не загружены при панорамировании пользователем. Эту опцию можно установить только при инициализации карты. |
center optional | Тип: LatLng | LatLngLiteral optional Начальный центр карты. |
clickableIcons optional | Тип: boolean optional По умолчанию: true Если false , значки карты недоступны для кликов. Значок карты представляет собой достопримечательность, также известную как POI. |
| Тип: ColorScheme |string optional По умолчанию: ColorScheme.LIGHT Исходная цветовая схема карты. Эту опцию можно установить только при инициализации карты. |
controlSize optional | Тип: number optional Размер элементов управления, отображаемых на карте, в пикселях. Это значение необходимо указать непосредственно при создании карты. Обновление этого значения позже может привести элементы управления в undefined состояние. Управляет только элементами управления, созданными самим Maps API. Не масштабируется пользовательские элементы управления, созданные разработчиком. |
disableDefaultUI optional | Тип: boolean optional Включает/отключает все кнопки пользовательского интерфейса по умолчанию. Может быть переопределено индивидуально. Не отключает элементы управления с клавиатуры, которые отдельно управляются параметром MapOptions.keyboardShortcuts . Не отключает элементы управления жестами, которые отдельно управляются параметром MapOptions.gestureHandling . |
disableDoubleClickZoom optional | Тип: boolean optional Включает/отключает масштабирование и центрирование при двойном щелчке. Включено по умолчанию. Примечание . Использование этого свойства не рекомендуется . Чтобы отключить масштабирование при двойном щелчке, вы можете использовать свойство |
| Тип: boolean optional Если false , предотвращает перетаскивание карты. Перетаскивание включено по умолчанию. |
draggableCursor optional | Тип: string optional Имя или URL-адрес курсора, отображаемого при наведении указателя мыши на перетаскиваемую карту. Это свойство использует атрибут cursor CSS для изменения значка. Как и в случае со свойством css, вы должны указать хотя бы один резервный курсор, который не является URL-адресом. Например: draggableCursor: 'url( http://www.example.com/icon.png ), auto;' . |
draggingCursor optional | Тип: string optional Имя или URL-адрес курсора, который будет отображаться при перетаскивании карты. Это свойство использует атрибут cursor CSS для изменения значка. Как и в случае со свойством css, вы должны указать хотя бы один резервный курсор, который не является URL-адресом. Например: draggingCursor: 'url( http://www.example.com/icon.png ), auto;' . |
fullscreenControl optional | Тип: boolean optional Включенное/отключенное состояние элемента управления «Полноэкранный режим». |
fullscreenControlOptions optional | Тип: FullscreenControlOptions optional Параметры отображения для полноэкранного элемента управления. |
gestureHandling optional | Тип: string optional Этот параметр определяет, как API обрабатывает жесты на карте. Допустимые значения:
|
heading optional | Тип: number optional Направление для аэрофотоснимков в градусах измеряется по часовой стрелке от кардинального направления на север. Заголовки привязываются к ближайшему доступному углу, для которого доступны изображения. |
headingInteractionEnabled optional | Тип: boolean optional По умолчанию: false Должна ли карта позволять пользователю управлять направлением камеры (вращением). Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна). |
isFractionalZoomEnabled optional | Тип: boolean optional По умолчанию: true для векторных карт и false для растровых карт. Должна ли карта поддерживать дробные уровни масштабирования. Прослушайте isfractionalzoomenabled_changed чтобы узнать, когда установлено значение по умолчанию. |
keyboardShortcuts optional | Тип: boolean optional Если false , предотвращается управление картой с клавиатуры. Сочетания клавиш включены по умолчанию. |
mapId optional | Тип: string optional Идентификатор карты . Этот параметр нельзя установить или изменить после создания экземпляра карты. Map.DEMO_MAP_ID можно использовать для опробования функций, для которых требуется идентификатор карты, но не требуется поддержка облака. |
mapTypeControl optional | Тип: boolean optional Исходное включенное/отключенное состояние элемента управления «Тип карты». |
mapTypeControlOptions optional | Тип: MapTypeControlOptions optional Начальные параметры отображения элемента управления «Тип карты». |
mapTypeId optional | Тип: MapTypeId |string optional Исходный MapTypeId. По умолчанию используется ROADMAP . |
maxZoom optional | Тип: number optional Максимальный уровень масштабирования, который будет отображаться на карте. Если этот параметр опущен или установлен в значение null , вместо него используется максимальный масштаб текущего типа карты. Допустимые значения масштабирования — это числа от нуля до поддерживаемого максимального уровня масштабирования . |
minZoom optional | Тип: number optional Минимальный уровень масштабирования, который будет отображаться на карте. Если этот параметр опущен или установлен в значение null , вместо него используется минимальный масштаб текущего типа карты. Допустимые значения масштабирования — это числа от нуля до поддерживаемого максимального уровня масштабирования . |
noClear optional | Тип: boolean optional Если true , не очищайте содержимое div Map. |
| Тип: boolean optional Включенное/выключенное состояние элемента управления панорамированием. |
| Тип: PanControlOptions optional Параметры отображения элемента управления панорамированием. |
renderingType optional | Тип: RenderingType optional По умолчанию: RenderingType.RASTER Должна ли карта быть растровой или векторной. Этот параметр нельзя установить или изменить после создания экземпляра карты. Если не установлено, то конфигурация облака для идентификатора карты будет определять тип рендеринга (если доступен). Обратите внимание, что векторные карты могут быть доступны не для всех устройств и браузеров, и при необходимости карта будет преобразована в растровую. |
restriction optional | Тип: MapRestriction optional Определяет границу, ограничивающую область карты, доступную пользователям. Если этот параметр установлен, пользователь может панорамировать и масштабировать изображение только тогда, когда вид с камеры остается в пределах границы. |
rotateControl optional | Тип: boolean optional Включенное/выключенное состояние элемента управления «Поворот». |
rotateControlOptions optional | Тип: RotateControlOptions optional Параметры отображения элемента управления «Поворот». |
scaleControl optional | Тип: boolean optional Исходное включенное/отключенное состояние элемента управления «Масштаб». |
scaleControlOptions optional | Тип: ScaleControlOptions optional Первоначальные параметры отображения элемента управления «Масштаб». |
scrollwheel optional | Тип: boolean optional Если false , отключает масштабирование карты с помощью колеса прокрутки мыши. Колесо прокрутки включено по умолчанию. Примечание . Использование этого свойства не рекомендуется . Чтобы отключить масштабирование с помощью колеса прокрутки, вы можете использовать свойство |
streetView optional | Тип: StreetViewPanorama optional StreetViewPanorama , отображаемая при размещении человечка Street View на карте. Если панорама не указана, StreetViewPanorama по умолчанию будет отображаться в div карты при отбрасывании человечка. |
streetViewControl optional | Тип: boolean optional Исходное включенное/отключенное состояние элемента управления Street View Pegman. Этот элемент управления является частью пользовательского интерфейса по умолчанию, и для него должно быть установлено значение false при отображении типа карты, на котором не должно отображаться наложение дорог Street View (например, тип карты, отличный от карты Земли). |
streetViewControlOptions optional | Тип: StreetViewControlOptions optional Первоначальные параметры отображения элемента управления «Человеком» в просмотре улиц. |
styles optional | Тип: Array < MapTypeStyle > optional Стили, применяемые к каждому типу карт по умолчанию. Обратите внимание, что для режимов satellite / hybrid и terrain эти стили будут применяться только к меткам и геометрии. Эта функция недоступна при использовании идентификатора карты или при использовании векторных карт (вместо этого используйте стили облачных карт ). |
tilt optional | Тип: number optional Для векторных карт задает угол падения карты. Допустимые значения ограничены в зависимости от уровня масштабирования карты. Для растровых карт управляет автоматическим переключением угла наклона карты. Единственные допустимые значения — 0 и 45 . Значение 0 заставляет карту всегда использовать вид сверху под углом 0° независимо от уровня масштабирования и области просмотра. Значение 45 приводит к тому, что угол наклона автоматически переключается на 45 всякий раз, когда изображения под углом 45° доступны для текущего уровня масштабирования и области просмотра, и переключается обратно на 0, когда изображения под углом 45° недоступны (это поведение по умолчанию). Снимки под углом 45° доступны только для типов satellite и hybrid карт, в некоторых местоположениях и при некоторых уровнях масштабирования. Примечание. getTilt возвращает текущий угол наклона, а не значение, указанное в этой опции. Поскольку getTilt и этот параметр относятся к разным вещам, не bind() свойство tilt ; это может привести к непредсказуемым последствиям. |
tiltInteractionEnabled optional | Тип: boolean optional По умолчанию: false Должна ли карта позволять пользователю контролировать наклон камеры. Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна). |
zoom optional | Тип: number optional Начальный уровень масштабирования карты. Допустимые значения масштабирования — это числа от нуля до поддерживаемого максимального уровня масштабирования . Большие значения масштабирования соответствуют более высокому разрешению. |
zoomControl optional | Тип: boolean optional Включенное/выключенное состояние элемента управления масштабированием. |
zoomControlOptions optional | Тип: ZoomControlOptions optional Параметры отображения элемента управления масштабированием. |
Класс MapElement
google.maps . MapElement
Класс google.maps . MapElement
MapElement — это подкласс HTMLElement
для рендеринга карт. После загрузки библиотеки maps
можно создать карту в формате HTML. Например:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
<button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>
Внутри он использует
Map
, доступ к которому можно получить с помощью свойства innerMap
. Пользовательский элемент:
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>
Этот класс расширяет HTMLElement
.
Этот класс реализует MapElementOptions
.
Доступ осуществляется путем вызова const {MapElement} = await google.maps.importLibrary("maps")
. См. раздел Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
MapElement | MapElement([options]) Параметры:
|
Характеристики | |
---|---|
center | Тип: LatLng | LatLngLiteral optional Центральная широта/долгота карты. HTML-атрибут:
|
headingInteractionDisabled | Тип: boolean optional По умолчанию: false Должна ли карта позволять пользователю управлять направлением камеры (вращением). Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна). HTML-атрибут:
|
innerMap | Тип: Map Ссылка на Map , которую MapElement использует внутри себя. |
mapId | Тип: string optional Идентификатор карты . Этот параметр нельзя установить или изменить после создания экземпляра карты. Map.DEMO_MAP_ID можно использовать для опробования функций, для которых требуется идентификатор карты, но не требуется поддержка облака. HTML-атрибут:
|
renderingType | Тип: RenderingType optional По умолчанию: RenderingType.VECTOR Должна ли карта быть растровой или векторной. Этот параметр нельзя установить или изменить после создания экземпляра карты. Если не установлено, то конфигурация облака для идентификатора карты будет определять тип рендеринга (если доступен). Обратите внимание, что векторные карты могут быть доступны не для всех устройств и браузеров, и при необходимости карта будет преобразована в растровую. HTML-атрибут:
|
tiltInteractionDisabled | Тип: boolean optional По умолчанию: false Должна ли карта позволять пользователю контролировать наклон камеры. Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна). HTML-атрибут:
|
zoom | Тип: number optional Уровень масштабирования карты. Допустимые значения масштабирования — это числа от нуля до поддерживаемого максимального уровня масштабирования . Большие значения масштабирования соответствуют более высокому разрешению. HTML-атрибут:
|
Методы | |
---|---|
| addEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. addEventListener. |
| removeEventListener(type, listener[, options]) Параметры:
Возвращаемое значение: void Удаляет из цели прослушиватель событий, ранее зарегистрированный с помощью addEventListener. См. RemoveEventListener. |
События | |
---|---|
gmp-zoomchange | function(event) Аргументы:
Это событие вызывается при изменении свойства масштабирования карты. |
Интерфейс MapElementOptions
google.maps . MapElementOptions
Интерфейс google.maps . MapElementOptions
Объект MapElementOptions, используемый для определения свойств, которые можно задать для MapElement.
Характеристики | |
---|---|
center optional | Тип: LatLng | LatLngLiteral optional См. MapElement.center . |
headingInteractionDisabled optional | Тип: boolean optional |
mapId optional | Тип: string optional См. MapElement.mapId . |
renderingType optional | Тип: RenderingType optional См. MapElement.renderingType . |
tiltInteractionDisabled optional | Тип: boolean optional |
zoom optional | Тип: number optional См. MapElement.zoom . |
Класс ZoomChangeEvent
google.maps . ZoomChangeEvent
Класс google.maps . ZoomChangeEvent
Это событие создается в результате мониторинга изменения масштаба.
Этот класс расширяет Event
.
Доступ осуществляется путем вызова const {ZoomChangeEvent} = await google.maps.importLibrary("maps")
. См. раздел Библиотеки в Maps JavaScript API .
Интерфейс MapTypeStyle
google.maps . MapTypeStyle
Интерфейс google.maps . MapTypeStyle
MapTypeStyle
— это набор селекторов и стилей, определяющих стиль карты. Селекторы указывают объекты и/или элементы карты, на которые следует повлиять, а стилисты указывают, как следует изменить эти объекты и элементы. Подробности см. в справочнике по стилю .
Характеристики | |
---|---|
stylers | Правила стиля, которые будут применяться к выбранным объектам и элементам карты. Правила применяются в том порядке, который вы указываете в этом массиве. Рекомендации по использованию и допустимые значения см. в справочнике по стилю . |
elementType optional | Тип: string optional Элемент, к которому следует применить стиль. Элемент — это визуальный аспект объекта на карте. Пример: метка, значок, обводка или заливка, примененная к геометрии, и многое другое. Необязательный. Если elementType не указан, предполагается, что значение равно 'all' . Подробности использования и допустимые значения см. в справочнике по стилю . |
featureType optional | Тип: string optional Объект или группа объектов, к которым следует применить стиль. Необязательный. Если featureType не указан, предполагается, что значение равно 'all' . Подробности использования и допустимые значения см. в справочнике по стилю . |
Интерфейс MapMouseEvent
google.maps . MapMouseEvent
Интерфейс google.maps . MapMouseEvent
Этот объект возвращается из различных событий мыши на карте и наложениях и содержит все поля, показанные ниже.
Характеристики | |
---|---|
domEvent | Тип: MouseEvent | TouchEvent | PointerEvent | KeyboardEvent | Event Соответствующее собственное событие DOM. Разработчикам не следует полагаться на то, что свойства target , currentTarget , relatedTarget и path определены и согласованы. Разработчикам также не следует полагаться на структуру DOM внутренней реализации Maps API. Из-за внутреннего сопоставления событий domEvent может иметь семантику, отличную от MapMouseEvent (например, «щелчок» MapMouseEvent может иметь domEvent типа KeyboardEvent ). |
latLng optional | Тип: LatLng optional Широта/долгота, которая находилась под курсором в момент возникновения события. |
Методы | |
---|---|
stop | stop() Параметры: Нет Возвращаемое значение: void Предотвращает дальнейшее распространение этого события. |
Интерфейс IconMouseEvent
google.maps . IconMouseEvent
Интерфейс google.maps . IconMouseEvent
Этот объект отправляется в событии, когда пользователь нажимает на значок на карте. Идентификатор этого места хранится в элементе PlaceId. Чтобы предотвратить появление информационного окна по умолчанию, вызовите метод stop() для этого события, чтобы предотвратить его распространение. Подробную информацию об идентификаторах мест можно найти в руководстве для разработчиков Places API.
Этот интерфейс расширяет MapMouseEvent
.
Характеристики | |
---|---|
placeId optional | Тип: string optional Идентификатор места, по которому был выполнен клик. Этот идентификатор места можно использовать для запроса дополнительной информации о выбранном объекте. Подробную информацию об идентификаторах мест можно найти в руководстве для разработчиков Places API. |
Наследовано: domEvent , latLng |
Методы | |
---|---|
Наследовано: stop |
Константы цветовой схемы
google.maps . ColorScheme
Константы google.maps . ColorScheme
Идентификаторы цветовых схем карты. Укажите их по значению или используя имя константы. Например, 'FOLLOW_SYSTEM'
или google.maps.ColorScheme.FOLLOW_SYSTEM
.
Доступ осуществляется путем вызова const {ColorScheme} = await google.maps.importLibrary("core")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
DARK | Темная цветовая гамма карты. |
FOLLOW_SYSTEM | Цветовая схема выбирается исходя из системных предпочтений. |
LIGHT | Светлая цветовая гамма карты. Значение по умолчанию для устаревших Maps JS. |
Константы MapTypeId
google.maps . MapTypeId
Константы google.maps . MapTypeId
Идентификаторы для распространенных типов карт. Укажите их по значению или используя имя константы. Например, 'satellite'
или google.maps.MapTypeId.SATELLITE
.
Доступ осуществляется путем вызова const {MapTypeId} = await google.maps.importLibrary("maps")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
HYBRID | Этот тип карты отображает прозрачный слой основных улиц на спутниковых изображениях. |
ROADMAP | Этот тип карты отображает обычную карту улиц. |
SATELLITE | Этот тип карты отображает спутниковые изображения. |
TERRAIN | Этот тип карты отображает карты с физическими особенностями, такими как рельеф и растительность. |
Класс MapTypeRegistry
google.maps . MapTypeRegistry
Класс google.maps . MapTypeRegistry
Реестр для экземпляров MapType с ключом по идентификатору MapType.
Этот класс расширяет MVCObject
.
Доступ, вызовов const {MapTypeRegistry} = await google.maps.importLibrary("maps")
. См. Библиотеки в API Maps JavaScript .
Конструктор | |
---|---|
MapTypeRegistry | MapTypeRegistry() Параметры: нет MapTypeRegistry содержит коллекцию пользовательских типов карт, доступных для карты для ее использования. API консультирует этот реестр при предоставлении списка доступных типов карт в управлении, например. |
Методы | |
---|---|
set | set(id, mapType) Параметры:
Возвращаемое значение: нет Устанавливает реестр, чтобы связать идентификатор пропущенного строки с пройденным Maptype. |
Унаследован: addListener , bindTo , get , notify , setValues , unbind , unbindAll |
Интерфейс Maprestriction
google.maps . MapRestriction
Интерфейс google.maps . MapRestriction
Ограничение, которое можно применить к карте. Просмотр карты не будет превышать эти ограничения.
Характеристики | |
---|---|
latLngBounds | Тип: LatLngBounds | LatLngBoundsLiteral При установке пользователь может только паном и масштабировать внутри заданных границ. Границы могут ограничивать как долготу, так и широту, или могут ограничивать только широту. Для ограничений только широты используются продоки на западе и востоке -180 и 180, соответственно, например, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180} . |
strictBounds optional | Тип: boolean optional Границы могут быть сделаны более ограничивающими, установив флаг strictBounds на true . Это уменьшает то, как далеко может уменьшить пользователь, гарантируя, что все за пределами ограниченных границ остается скрытым. По умолчанию false , что означает, что пользователь может увеличить до тех пор, пока не будет видна вся ограниченная область, возможно, включая области за пределами ограниченной области. |
Класс трафика
google.maps . TrafficLayer
Класс google.maps . TrafficLayer
Трафик.
Этот класс расширяет MVCObject
.
Доступ, вызовов const {TrafficLayer} = await google.maps.importLibrary("maps")
. См. Библиотеки в API Maps JavaScript .
Конструктор | |
---|---|
TrafficLayer | TrafficLayer([opts]) Параметры:
Слой, который отображает текущее дорожное движение. |
Методы | |
---|---|
getMap | getMap() Параметры: нет Возвращаемое значение: Map Возвращает карту, на которой отображается этот слой. |
setMap | setMap(map) Параметры:
Возвращаемое значение: нет Образует слой на указанной карте. Если карта установлена на null , слой будет удален. |
setOptions | setOptions(options) Параметры:
Возвращаемое значение: нет |
Унаследован: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll |
Trafficlayeroptions Interface
google.maps . TrafficLayerOptions
Interface
Объект Trafficlayeroptions, используемый для определения свойств, которые могут быть установлены на трафике.
Характеристики | |
---|---|
autoRefresh optional | Тип: boolean optional По умолчанию: true Обычный уровень трафика автоматически обновляется с обновленной информацией. |
map optional | Тип: Map optional Карта, на которой можно отобразить уровень трафика. |
Транзитлейщик класс
google.maps . TransitLayer
класс
Транзитный слой.
Этот класс расширяет MVCObject
.
Доступ, вызовов const {TransitLayer} = await google.maps.importLibrary("maps")
. См. Библиотеки в API Maps JavaScript .
Конструктор | |
---|---|
TransitLayer | TransitLayer() Параметры: нет Слой, который отображает транзитные линии. |
Методы | |
---|---|
getMap | getMap() Параметры: нет Возвращаемое значение: Map Возвращает карту, на которой отображается этот слой. |
setMap | setMap(map) Параметры:
Возвращаемое значение: нет Образует слой на указанной карте. Если карта установлена на null , слой будет удален. |
Унаследован: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll |
Bicyclinglayer Class
google.maps . BicyclingLayer
Class
Слой, показывающий велосипедные дорожки и пути.
Этот класс расширяет MVCObject
.
Доступ, вызовов const {BicyclingLayer} = await google.maps.importLibrary("maps")
. См. Библиотеки в API Maps JavaScript .
Конструктор | |
---|---|
BicyclingLayer | BicyclingLayer() Параметры: нет Слой, который отображает велосипедные дорожки и дорожки и демонстрирует большие дороги. |
Методы | |
---|---|
getMap | getMap() Параметры: нет Возвращаемое значение: Map Возвращает карту, на которой отображается этот слой. |
setMap | setMap(map) Параметры:
Возвращаемое значение: нет Образует слой на указанной карте. Если карта установлена на null , слой будет удален. |
Унаследован: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll |
Интерфейс камеры
google.maps . CameraOptions
Интерфейс google.maps . CameraOptions
Используется для установки параметров камеры карты.
Характеристики | |
---|---|
center optional | Тип: LatLngLiteral | LatLng optional |
heading optional | Тип: number optional |
tilt optional | Тип: number optional |
zoom optional | Тип: number optional |
ВИЗИБЕРЕГИОН ГОДА
google.maps . VisibleRegion
ГОДА
Содержит четыре точки, определяющие четырехсторонний многоугольник, который является видимой областью карты. На векторной карте этот многоугольник может быть трапецией вместо прямоугольника, когда векторная карта имеет наклон.
Характеристики | |
---|---|
farLeft | Тип: LatLng |
farRight | Тип: LatLng |
latLngBounds | Тип: LatLngBounds Самая маленькая ограничивающая коробка, которая включает в себя видимую область. |
nearLeft | Тип: LatLng |
nearRight | Тип: LatLng |
Константы рендеринга
google.maps . RenderingType
Константы google.maps . RenderingType
Доступ, вызывая const {RenderingType} = await google.maps.importLibrary("maps")
. См. Библиотеки в API Maps JavaScript .
Константы | |
---|---|
RASTER | Указывает, что карта представляет собой растровую карту. |
UNINITIALIZED | Указывает, что еще неизвестно, является ли карта векторной или растровой, потому что карта еще не закончила инициализацию. |
VECTOR | Указывает, что карта является векторной картой. |
Интерфейс MapCapability
google.maps . MapCapabilities
Интерфейс google.maps . MapCapabilities
Объект, содержащий снимок того, какие возможности в настоящее время доступны для карты. Обратите внимание, что это не обязательно означает, что соответствующие модули загружаются или инициализируются, а скорее, что текущая карта имеет разрешение на использование этих API. Смотрите свойства для списка возможных возможностей.
Характеристики | |
---|---|
isAdvancedMarkersAvailable optional | Тип: boolean optional Если это правда, эта карта настроена правильно, чтобы позволить использовать расширенные маркеры. Обратите внимание, что вы все равно должны импортировать библиотеку marker , чтобы использовать расширенные маркеры. См . |
isDataDrivenStylingAvailable optional | Тип: boolean optional Если True, эта карта настроена должным образом для использования стиля, управляемого данными, по крайней мере, для одного FeatureLayer. См. Https://goo.gle/gmp-data-diven-styling и https://goo.gle/gmp-featurelayerisavailable для получения дополнительной информации. |
isWebGLOverlayViewAvailable optional | Тип: boolean optional Если True, эта карта настроена правильно, чтобы разрешить использование WebGLOverlayView . |