Maps

Класс карты

google.maps . Map Класс google.maps . Map

Этот класс расширяет MVCObject .

Доступ осуществляется путем вызова const {Map} = await google.maps.importLibrary("maps") . См. раздел Библиотеки в Maps JavaScript API .

Map
Map(mapDiv[, opts])
Параметры:
  • mapDiv : HTMLElement Карта будет отображаться так, чтобы заполнить этот элемент.
  • opts : MapOptions optional
Создает новую карту внутри заданного HTML-контейнера, который обычно является элементом DIV .
DEMO_MAP_ID Идентификатор карты, который можно использовать для примеров кода, требующих идентификатор карты. Этот идентификатор карты не предназначен для использования в рабочих приложениях и не может использоваться для функций, требующих облачной настройки (например, Cloud Styling).
controls
Тип: Array < MVCArray < HTMLElement >>
Дополнительные элементы управления для прикрепления к карте. Чтобы добавить элемент управления на карту, добавьте <div> элемента управления в MVCArray соответствующий ControlPosition , где он должен отображаться.
data
Тип: Data
Экземпляр Data , привязанный к карте. Добавьте объекты к этому объекту Data , чтобы их было удобно отображать на этой карте.
mapTypes
Реестр экземпляров MapType по строковому идентификатору.
overlayMapTypes
Тип: MVCArray < MapType optional >
Дополнительные типы карт для наложения. Типы наложенных карт будут отображаться поверх базовой карты, к которой они прикреплены, в том порядке, в котором они появляются в массиве overlayMapTypes (наложения с более высокими значениями индекса отображаются перед наложениями с более низкими значениями индекса).
fitBounds
fitBounds(bounds[, padding])
Параметры:
  • bounds : LatLngBounds | LatLngBoundsLiteral Границы для отображения.
  • padding : number| Padding optional Заполнение в пикселях. Границы будут соответствовать той части карты, которая останется после удаления заполнения. Числовое значение даст одинаковое дополнение со всех четырех сторон. Укажите здесь 0, чтобы сделать fitBounds идемпотентным по отношению к результату getBounds.
Возвращаемое значение: Нет
Устанавливает область просмотра, содержащую заданные границы.
Примечание. Если для карты установлено значение display: none , функция fitBounds считывает размер карты как 0x0 и, следовательно, ничего не делает. Чтобы изменить область просмотра, когда карта скрыта, установите для карты visibility: hidden , тем самым гарантируя, что div карты имеет фактический размер. Для векторных карт этот метод устанавливает наклон и направление карты на нулевые значения по умолчанию. Вызов этого метода может привести к плавной анимации, когда карта перемещается и масштабируется в соответствии с границами. Анимируется ли этот метод или нет, зависит от внутренней эвристики.
getBounds
getBounds()
Параметры: Нет
Возвращаемое значение: LatLngBounds |undefined Границы широты и долготы текущего окна просмотра.
Возвращает границы широты и долготы текущего окна просмотра. Если видно более одной копии мира, границы располагаются по долготе от -180 до 180 градусов включительно. Если карта еще не инициализирована или центрирование и масштаб не установлены, результат undefined . Для векторных карт с ненулевым наклоном или направлением возвращаемые границы широты и долготы представляют собой наименьшую ограничивающую рамку, включающую видимую область области просмотра карты. См. MapCanvasProjection.getVisibleRegion , чтобы получить точную видимую область области просмотра карты.
getCenter
getCenter()
Параметры: Нет
Возвращаемое значение: LatLng |undefined
Возвращает позицию, отображаемую в центре карты. Обратите внимание, что этот объект LatLng не упакован. См. LatLng для получения дополнительной информации. Если центр или границы не установлены, результат undefined .
getClickableIcons
getClickableIcons()
Параметры: Нет
Возвращаемое значение: boolean|undefined
Возвращает кликабельность значков карты. Значок карты представляет собой достопримечательность, также известную как POI. Если возвращаемое значение — true , то значки на карте можно щелкнуть.
Beta getDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Параметры:
  • datasetId : string
Возвращаемое значение: 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
Возвращает, включено ли взаимодействие заголовков. Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
Параметры: Нет
Возвращаемое значение: Iterable <string>|null
Возвращает список идентификаторов атрибуции использования, которые помогают Google понять, какие библиотеки и примеры полезны для разработчиков, например использование библиотеки кластеризации маркеров.
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 : number Количество пикселей для перемещения карты в направлении x.
  • y : number Количество пикселей для перемещения карты в направлении y.
Возвращаемое значение: Нет
Изменяет центр карты на заданное расстояние в пикселях. Если расстояние меньше ширины и высоты карты, переход будет плавно анимирован. Обратите внимание, что система координат карты увеличивается с запада на восток (для значений x) и с севера на юг (для значений y).
panTo
panTo(latLng)
Параметры:
  • latLng : LatLng | LatLngLiteral Новая центральная широта/долгота карты.
Возвращаемое значение: Нет
Изменяет центр карты на заданный LatLng . Если изменение меньше ширины и высоты карты, переход будет плавно анимирован.
panToBounds
panToBounds(latLngBounds[, padding])
Параметры:
  • latLngBounds : LatLngBounds | LatLngBoundsLiteral Границы панорамирования карты.
  • padding : number| Padding optional Заполнение в пикселях. Числовое значение даст одинаковое дополнение со всех четырех сторон. Значение по умолчанию — 0.
Возвращаемое значение: Нет
Панорамирует карту на минимальную величину, необходимую для содержания данного LatLngBounds . Он не дает никаких гарантий, где на карте будут границы, за исключением того, что карта будет панорамирована, чтобы показать как можно большую часть границ внутри {currentMapSizeInPx} - {padding} . Как для растровых, так и для векторных карт масштаб, наклон и заголовок карты не будут изменены.
setCenter
setCenter(latlng)
Параметры:
Возвращаемое значение: Нет
setClickableIcons
setClickableIcons(value)
Параметры:
  • value : boolean значение
Возвращаемое значение: Нет
Определяет, являются ли значки карты кликабельными или нет. Значок карты представляет собой достопримечательность, также известную как POI. Чтобы отключить кликабельность значков карты, передайте этому методу значение false .
setHeading
setHeading(heading)
Параметры:
  • heading : number
Возвращаемое значение: Нет
Устанавливает направление компаса для карты, измеряемое в градусах от кардинального направления на север. Для растровых карт этот метод применим только к аэрофотоснимкам.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
Параметры:
  • headingInteractionEnabled : boolean
Возвращаемое значение: Нет
Устанавливает, включено ли взаимодействие с заголовком. Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна).
setMapTypeId
setMapTypeId(mapTypeId)
Параметры:
Возвращаемое значение: Нет
setOptions
setOptions(options)
Параметры:
Возвращаемое значение: Нет
setRenderingType
setRenderingType(renderingType)
Параметры:
Возвращаемое значение: Нет
Устанавливает текущий тип рендеринга карты.
setStreetView
setStreetView(panorama)
Параметры:
  • panorama : StreetViewPanorama optional Панорама для привязки к карте.
Возвращаемое значение: Нет
Привязывает StreetViewPanorama к карте. Эта панорама переопределяет StreetViewPanorama по умолчанию, позволяя карте привязываться к внешней панораме за пределами карты. Установка для панорамы значения null привязывает встроенную панораму по умолчанию обратно к карте.
setTilt
setTilt(tilt)
Параметры:
  • tilt : number
Возвращаемое значение: Нет
Для векторных карт задает угол падения карты. Допустимые значения ограничены в зависимости от уровня масштабирования карты.

Для растровых карт управляет автоматическим переключением угла наклона карты. Единственные допустимые значения — 0 и 45 . setTilt(0) заставляет карту всегда использовать вид сверху под углом 0° независимо от уровня масштабирования и области просмотра. setTilt(45) заставляет угол наклона автоматически переключаться на 45 всякий раз, когда изображения под углом 45° доступны для текущего уровня масштабирования и окна просмотра, и переключаться обратно на 0, когда изображения под углом 45° недоступны (это поведение по умолчанию). Снимки под углом 45° доступны только для типов satellite и hybrid карт, в некоторых местоположениях и при некоторых уровнях масштабирования. Примечание. getTilt возвращает текущий угол наклона, а не значение, установленное setTilt . Поскольку getTilt и setTilt относятся к разным вещам, не bind() свойство tilt ; это может привести к непредсказуемым последствиям.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
Параметры:
  • tiltInteractionEnabled : boolean
Возвращаемое значение: Нет
Устанавливает, включены ли взаимодействия наклона. Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна).
setZoom
setZoom(zoom)
Параметры:
  • zoom : number Большие значения масштабирования соответствуют более высокому разрешению.
Возвращаемое значение: Нет
Устанавливает масштаб карты.
Наследуется: 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()
Аргументы: Нет
Это событие вызывается, когда пользователь перестает перетаскивать карту. Примечание. Перетаскивание НЕ запускается, когда пользователь прекращает панорамировать карту с помощью клавиатуры. Вместо этого используйте событие Map.idle , чтобы определить, когда пользователь прекратил панорамирование ИЛИ перетаскивание карты.
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()
Аргументы: Нет
Это событие вызывается при изменении свойства масштабирования карты.
rightclick
function(event)
Аргументы:
Это событие вызывается, когда пользователь щелкает правой кнопкой мыши на карте.

Интерфейс MapOptions

google.maps . MapOptions Интерфейс google.maps . MapOptions

Объект MapOptions, используемый для определения свойств, которые можно установить на карте.

backgroundColor optional
Тип: string optional
Цвет, используемый для фона div-карты. Этот цвет будет виден, когда плитки еще не загружены при панорамировании пользователем. Эту опцию можно установить только при инициализации карты.
cameraControl optional
Тип: boolean optional
Включенное/выключенное состояние элемента управления камерой.
cameraControlOptions optional
Тип: CameraControlOptions optional
Параметры отображения элемента управления «Камера».
center optional
Тип: LatLng | LatLngLiteral optional
Начальный центр карты.
clickableIcons optional
Тип: boolean optional
По умолчанию: true
Если установлено false , значки карты недоступны для кликов. Значок карты представляет собой достопримечательность, также известную как POI.
colorScheme optional
Тип: ColorScheme |string optional
По умолчанию: ColorScheme.LIGHT
Исходная цветовая схема карты. Эту опцию можно установить только при инициализации карты.
controlSize optional
Тип: number optional
Размер элементов управления, отображаемых на карте, в пикселях. Это значение необходимо указать непосредственно при создании карты. Обновление этого значения позже может привести элементы управления в undefined состояние. Управляет только элементами управления, созданными самим Maps API. Не масштабируется пользовательские элементы управления, созданные разработчиком.
disableDefaultUI optional
Тип: boolean optional
Включает/отключает все кнопки пользовательского интерфейса по умолчанию. Может быть переопределено индивидуально. Не отключает элементы управления с клавиатуры, которые отдельно управляются параметром MapOptions.keyboardShortcuts . Не отключает элементы управления жестами, которые отдельно управляются параметром MapOptions.gestureHandling .
disableDoubleClickZoom optional
Тип: boolean optional
Включает/отключает масштабирование и центрирование при двойном щелчке. Включено по умолчанию.

Примечание . Использование этого свойства не рекомендуется . Чтобы отключить масштабирование при двойном щелчке, вы можете использовать свойство gestureHandling и установить для него значение "none" .

draggable 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 обрабатывает жесты на карте. Допустимые значения:
  • "cooperative" : события прокрутки и жесты касания одним пальцем прокручивают страницу, но не масштабируют и не панорамируют карту. Жесты касания двумя пальцами позволяют перемещать и масштабировать карту. Прокручивайте события с помощью клавиши Ctrl или нажатой клавиши ⌘, чтобы увеличить карту.
    В этом режиме карта взаимодействует со страницей.
  • "greedy" : все сенсорные жесты и события прокрутки перемещают или масштабируют карту.
  • "none" : карту нельзя перемещать или масштабировать с помощью жестов пользователя.
  • "auto" : (по умолчанию) Обработка жестов либо совместная, либо жадная, в зависимости от того, прокручивается ли страница или находится в iframe.
heading optional
Тип: number optional
Направление для аэрофотоснимков в градусах измеряется по часовой стрелке от кардинального направления на север. Заголовки привязываются к ближайшему доступному углу, для которого доступны изображения.
headingInteractionEnabled optional
Тип: boolean optional
По умолчанию: false
Должна ли карта позволять пользователю управлять направлением камеры (вращением). Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна).
internalUsageAttributionIds optional
Тип: Iterable <string> optional
По умолчанию: null
Добавляет идентификатор атрибуции использования в инициализатор, который помогает Google понять, какие библиотеки и примеры полезны для разработчиков, например использование библиотеки кластеризации маркеров. Чтобы отказаться от отправки идентификатора атрибуции использования, можно безопасно удалить это свойство или заменить значение пустой строкой. Будут отправлены только уникальные значения. Изменения этого значения после создания экземпляра можно игнорировать.
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.
panControl optional
Тип: boolean optional
Включенное/выключенное состояние элемента управления панорамированием.

panControlOptions 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 , отключает масштабирование карты с помощью колеса прокрутки мыши. Колесо прокрутки включено по умолчанию.

Примечание . Использование этого свойства не рекомендуется . Чтобы отключить масштабирование с помощью колеса прокрутки, вы можете использовать свойство gestureHandling и установить для него значение "cooperative" или "none" .

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 internal-usage-attribution-ids="id1 id2" 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-атрибут:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
Тип: boolean optional
По умолчанию: false
Должна ли карта позволять пользователю управлять направлением камеры (вращением). Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна).
HTML-атрибут:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
Тип: Map
Ссылка на Map , которую MapElement использует внутри себя.
internalUsageAttributionIds
Тип: Iterable <string> optional
По умолчанию: null
Добавляет идентификатор атрибуции использования в инициализатор, который помогает Google понять, какие библиотеки и примеры полезны для разработчиков, например использование библиотеки кластеризации маркеров. Чтобы отказаться от отправки идентификатора атрибуции использования, можно безопасно удалить это свойство или заменить значение пустой строкой. Будут отправлены только уникальные значения. Изменения этого значения после создания экземпляра можно игнорировать.
HTML-атрибут:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
Тип: string optional
Идентификатор карты. Этот параметр нельзя установить или изменить после создания экземпляра карты. Map.DEMO_MAP_ID можно использовать для опробования функций, для которых требуется идентификатор карты, но не требуется поддержка облака.
HTML-атрибут:
  • <gmp-map map-id="string"></gmp-map>
renderingType
Тип: RenderingType optional
По умолчанию: RenderingType.VECTOR
Должна ли карта быть растровой или векторной. Этот параметр нельзя установить или изменить после создания экземпляра карты. Если не установлено, то конфигурация облака для идентификатора карты будет определять тип рендеринга (если доступен). Обратите внимание, что векторные карты могут быть доступны не для всех устройств и браузеров, и при необходимости карта будет преобразована в растровую.
HTML-атрибут:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
Тип: boolean optional
По умолчанию: false
Должна ли карта позволять пользователю контролировать наклон камеры. Эта опция действует только в том случае, если карта является векторной. Если это не установлено в коде, то для идентификатора карты будет использоваться облачная конфигурация (если она доступна).
HTML-атрибут:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
Тип: number optional
Уровень масштабирования карты. Допустимые значения масштабирования — это числа от нуля до поддерживаемого максимального уровня масштабирования . Большие значения масштабирования соответствуют более высокому разрешению.
HTML-атрибут:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Помещает элемент с прорезями в позицию ControlPosition.BLOCK_END_INLINE_CENTER .
control-block-end-inline-end
Помещает элемент с прорезями в позицию ControlPosition.BLOCK_END_INLINE_END .
control-block-end-inline-start
Помещает элемент с прорезью в позицию ControlPosition.BLOCK_END_INLINE_START .
control-block-start-inline-center
Помещает элемент с прорезью в позицию ControlPosition.BLOCK_START_INLINE_CENTER .
control-block-start-inline-end
Помещает элемент с прорезями в позицию ControlPosition.BLOCK_START_INLINE_END .
control-block-start-inline-start
Помещает элемент с прорезями в позицию ControlPosition.BLOCK_START_INLINE_START .
control-inline-end-block-center
Помещает элемент с прорезями в позицию ControlPosition.INLINE_END_BLOCK_CENTER .
control-inline-end-block-end
Помещает элемент с прорезями в позицию ControlPosition.INLINE_END_BLOCK_END .
control-inline-end-block-start
Помещает элемент с прорезью в позицию ControlPosition.INLINE_END_BLOCK_START .
control-inline-start-block-center
Помещает элемент с прорезями в позицию ControlPosition.INLINE_START_BLOCK_CENTER .
control-inline-start-block-end
Помещает элемент с прорезью в позицию ControlPosition.INLINE_START_BLOCK_END .
control-inline-start-block-start
Помещает элемент с прорезью в позицию ControlPosition.INLINE_START_BLOCK_START .
default
Вы можете создавать повторно используемые компоненты на основе веб-компонентов JavaScript Maps, например AdvancedMarkerElement , используя пользовательские элементы. По умолчанию любые пользовательские элементы, добавленные непосредственно в MapElement будут размещены и отображены в MapPanes.overlayMouseTarget . Однако веб-компоненты Maps JavaScript API могут быть перераспределены во внутренние слоты MapElement .
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Строка с учетом регистра, представляющая тип события, которое необходимо прослушивать.
  • listener : EventListener | EventListenerObject Объект, который получает уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. параметры . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется в цель. См. addEventListener.
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, определяющая тип события, для которого необходимо удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из целевого объекта события.
  • options : boolean| EventListenerOptions optional См . параметры.
Возвращаемое значение: 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
См. MapElement.headingInteractionDisabled .
internalUsageAttributionIds optional
Тип: Iterable <string> optional
См. MapElement.internalUsageAttributionIds .
mapId optional
Тип: string optional
См. MapElement.mapId .
renderingType optional
Тип: RenderingType optional
См. MapElement.renderingType .
tiltInteractionDisabled optional
Тип: boolean optional
См. MapElement.tiltInteractionDisabled .
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
Тип: Array < Object >
Правила стиля, которые будут применяться к выбранным объектам и элементам карты. Правила применяются в том порядке, который вы указываете в этом массиве. Рекомендации по использованию и допустимые значения см. в справочнике по стилю .
elementType optional
Тип: string optional
Элемент, к которому следует применить стиль. Элемент — это визуальный аспект объекта на карте. Пример: метка, значок, обводка или заливка, примененная к геометрии, и многое другое. Необязательный. Если elementType не указан, предполагается, что значение равно 'all' . Подробности использования и допустимые значения см. в справочнике по стилю .
featureType optional
Тип: string optional
Объект или группа объектов, к которым следует применить стиль. Необязательный. Если featureType не указан, предполагается, что значение равно 'all' . Подробности использования и допустимые значения см. в справочнике по стилю .

Интерфейс MapMouseEvent

google.maps . MapMouseEvent Интерфейс google.maps . MapMouseEvent

Этот объект возвращается из различных событий мыши на карте и наложениях и содержит все поля, показанные ниже.

domEvent
Соответствующее собственное событие 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") . См . Библиотеки в API Maps JavaScript .

DARK Темная цветовая схема для карты.
FOLLOW_SYSTEM Цветовая схема выбирается на основе системных предпочтений.
LIGHT Светло -цветовая схема для карты. Значение по умолчанию для устаревших карт JS.

Константы MapTypeId

google.maps . MapTypeId Константы google.maps . MapTypeId

Идентификаторы для общих маптипов. Укажите их по значению или с помощью имени константы. Например, 'satellite' или google.maps.MapTypeId.SATELLITE .

Доступ, вызовов const {MapTypeId} = await google.maps.importLibrary("maps") . См . Библиотеки в API Maps JavaScript .

HYBRID Этот тип карты отображает прозрачный слой основных улиц на спутниковых изображениях.
ROADMAP Этот тип карты отображает нормальную карту улицы.
SATELLITE Этот тип карты отображает спутниковые изображения.
TERRAIN Этот тип карты отображает карты с физическими характеристиками, такими как местность и растительность.

Класс MapTypeRegistry

google.maps . MapTypeRegistry Класс google.maps . MapTypeRegistry

Реестр для экземпляров Maptype, ключа Maptype Id.

Этот класс расширяет MVCObject .

Доступ, вызовов const {MapTypeRegistry} = await google.maps.importLibrary("maps") . См . Библиотеки в API Maps JavaScript .

MapTypeRegistry
MapTypeRegistry()
Параметры: нет
MapTypeRegistry содержит коллекцию пользовательских типов карт, доступных для карты для ее использования. API консультирует этот реестр при предоставлении списка доступных типов карт в управлении, например.
set
set(id, mapType)
Параметры:
  • id : идентификатор string Maptype, чтобы добавить в реестр.
  • mapType : MapType |? Maptype объект для добавления в реестр.
Возвращаемое значение: нет
Устанавливает реестр, чтобы связать идентификатор пропущенного строки с пройденным Maptype.
Унаследован: addListener , bindTo , get , notify , setValues , unbind , unbindAll

Интерфейс ограничения карты

google.maps . MapRestriction Интерфейс google.maps . MapRestriction

Ограничение, которое можно применить к карте. Просмотр карты не будет превышать эти ограничения.

latLngBounds
При установке пользователь может только паном и масштабировать внутри заданных границ. Границы могут ограничивать как долготу, так и широту, или могут ограничивать только широту. Для ограничений только широты используются продоки на западе и востоке -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 |null
Возвращает карту, на которой отображается этот слой.
setMap
setMap(map)
Параметры:
  • map : Map optional
Возвращаемое значение: нет
Образует слой на указанной карте. Если карта установлена ​​на null , слой будет удален.
setOptions
setOptions(options)
Параметры:
Возвращаемое значение: нет
Унаследован: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll

Интерфейс TrafficLayerOptions

google.maps . TrafficLayerOptions Интерфейс google.maps . TrafficLayerOptions

Объект Trafficlayeroptions, используемый для определения свойств, которые могут быть установлены на трафике.

autoRefresh optional
Тип: boolean optional
По умолчанию: true
Обычный уровень трафика автоматически обновляется с обновленной информацией.
map optional
Тип: Map optional
Карта, на которой можно отобразить уровень трафика.

Класс TransitLayer

google.maps . TransitLayer Класс google.maps . TransitLayer

Транзитный слой.

Этот класс расширяет MVCObject .

Доступ, вызовов const {TransitLayer} = await google.maps.importLibrary("maps") . См . Библиотеки в API Maps JavaScript .

TransitLayer
TransitLayer()
Параметры: нет
Слой, который отображает транзитные линии.
getMap
getMap()
Параметры: нет
Возвращаемое значение: Map |null
Возвращает карту, на которой отображается этот слой.
setMap
setMap(map)
Параметры:
  • map : Map optional
Возвращаемое значение: void
Образует слой на указанной карте. Если карта установлена ​​на null , слой будет удален.
Унаследован: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll

Класс BicyclingLayer

google.maps . BicyclingLayer Класс google.maps . BicyclingLayer

Слой, показывающий велосипедные дорожки и пути.

Этот класс расширяет MVCObject .

Доступ, вызовов const {BicyclingLayer} = await google.maps.importLibrary("maps") . См . Библиотеки в API Maps JavaScript .

BicyclingLayer
BicyclingLayer()
Параметры: нет
Слой, который отображает велосипедные дорожки и дорожки и демонстрирует большие дороги.
getMap
getMap()
Параметры: нет
Возвращаемое значение: Map |null
Возвращает карту, на которой отображается этот слой.
setMap
setMap(map)
Параметры:
  • map : Map optional
Возвращаемое значение: void
Образует слой на указанной карте. Если карта установлена ​​на 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 Интерфейс 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 Указывает, что карта является векторной картой.

Интерфейс MapCapabilities

google.maps . MapCapabilities Интерфейс google.maps . MapCapabilities

Объект, содержащий снимок того, какие возможности в настоящее время доступны для карты. Обратите внимание, что это не обязательно означает, что соответствующие модули загружаются или инициализируются, а скорее, что текущая карта имеет разрешение на использование этих API. Смотрите свойства для списка возможных возможностей.

isAdvancedMarkersAvailable optional
Тип: boolean optional
Если это правда, эта карта настроена правильно, чтобы позволить использовать расширенные маркеры. Обратите внимание, что вы все равно должны импортировать библиотеку marker , чтобы использовать расширенные маркеры. См .
isDataDrivenStylingAvailable optional
Тип: boolean optional
Если True, эта карта настроена должным образом для использования стиля, управляемого данными, по крайней мере, для одного FeatureLayer. См. Https://goo.gle/gmp-data-diaven-styling и https://goo.gle/gmp-featurelayerisavailable для получения дополнительной информации.
isWebGLOverlayViewAvailable optional
Тип: boolean optional
Если True, эта карта настроена правильно, чтобы разрешить использование WebGLOverlayView .