Класс 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, к которому можно получить доступ с помощью свойства MapElement.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-атрибут:
|
headingInteractionDisabled |
Тип:
boolean optionalПо умолчанию:
false.Определяет, может ли пользователь управлять направлением камеры (поворотом). Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна).
HTML-атрибут:
|
innerMap |
Тип:
MapСсылка на Map, который MapElement использует внутри. |
internalUsageAttributionIds |
Тип:
Iterable<string> optionalПо умолчанию:
null.Добавляет идентификатор атрибуции использования в инициализатор, что помогает Google понять, какие библиотеки и примеры полезны для разработчиков, например использование библиотеки кластеризации маркеров. Чтобы отказаться от отправки идентификатора атрибуции использования, можно удалить это свойство или заменить его значение пустой строкой. Будут отправлены только уникальные значения. Изменения этого значения после создания экземпляра могут игнорироваться.
HTML-атрибут:
|
mapId |
Тип:
string optionalИдентификатор карты. Этот параметр нельзя задать или изменить после создания экземпляра карты.
Map.DEMO_MAP_ID можно использовать, чтобы попробовать функции, для которых требуется идентификатор карты, но не требуется включение облачных сервисов.HTML-атрибут:
|
renderingType |
Тип:
RenderingType optionalПо умолчанию:
RenderingType.VECTOR.Тип карты: растровая или векторная. Этот параметр нельзя задать или изменить после создания экземпляра карты. Если он не задан, тип отрисовки будет определяться облачной конфигурацией для идентификатора карты (если доступно). Обратите внимание, что векторные карты могут быть доступны не на всех устройствах и не во всех браузерах. В таких случаях будет использоваться растровая карта.
HTML-атрибут:
|
tiltInteractionDisabled |
Тип:
boolean optionalПо умолчанию:
false.Определяет, может ли пользователь управлять наклоном камеры. Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна).
HTML-атрибут:
|
zoom |
Тип:
number optionalУровень масштабирования карты. Допустимые значения масштабирования – это числа от нуля до поддерживаемого максимального уровня масштабирования. Чем больше значение масштаба, тем выше разрешение.
HTML-атрибут:
|
Методы | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidНастраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener… |
removeEventListener |
removeEventListener(type, listener[, options])Параметры:
Возвращаемое значение:
voidУдаляет из целевого объекта прослушиватель событий, ранее зарегистрированный с помощью addEventListener. Подробнее removeEventListener… |
События | |
|---|---|
gmp-zoomchange |
function(event)Аргументы:
Это событие вызывается при изменении свойства масштабирования карты. |
Интерфейс 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
класс
Это событие создается при отслеживании изменения масштаба.
Этот класс расширяет Event.
Чтобы получить доступ, позвоните по номеру const {ZoomChangeEvent} = await google.maps.importLibrary("maps").
Подробнее о библиотеках Maps JavaScript API…
Класс Map
google.maps.Map
класс
Этот класс расширяет MVCObject.
Чтобы получить доступ, позвоните по номеру const {Map} = await google.maps.importLibrary("maps").
Подробнее о библиотеках Maps JavaScript API…
Конструктор | |
|---|---|
Map |
Map(mapDiv[, opts])Параметры:
Создает новую карту в указанном контейнере HTML (обычно DIV). |
Константы | |
|---|---|
DEMO_MAP_ID |
Идентификатор карты, который можно использовать в примерах кода, где он требуется. Этот идентификатор карты не предназначен для использования в рабочих приложениях и не может использоваться для функций, требующих облачной конфигурации (например, облачных стилей). |
Свойства | |
|---|---|
controls |
Тип:
Array<MVCArray<HTMLElement>>Дополнительные элементы управления, присоединяемые к карте. Чтобы добавить элемент управления на карту, добавьте его узел <div> в массив MVCArray, соответствующий позиции ControlPosition, в которой он должен отображаться. |
data |
Тип:
DataЭкземпляр Data, привязанный к карте. Добавьте объекты в этот объект Data, чтобы удобно показывать их на карте. |
mapTypes |
Тип:
MapTypeRegistryРеестр экземпляров MapType по строковому идентификатору. |
overlayMapTypes |
Дополнительные типы карт для наложения. Наложения отображаются поверх базовых карт, к которым они прикреплены, в том же порядке, в каком они перечислены в массиве overlayMapTypes (чем выше у наложения значение индекса, тем выше находится его слой). |
Методы | |
|---|---|
fitBounds |
fitBounds(bounds[, padding])Параметры:
Возвращаемое значение: нет.
Задает окно просмотра с указанными границами. Примечание. Если для карты задано значение display: none, функция fitBounds считывает размер карты как 0 x 0 и поэтому ничего не делает. Чтобы изменить область просмотра, когда карта скрыта, задайте для карты значение visibility: hidden. Это позволит убедиться, что у элемента div карты есть фактический размер. Для векторных карт этот метод устанавливает наклон и ориентацию карты на нулевые значения по умолчанию. Вызов этого метода может привести к плавной анимации, когда карта панорамируется и масштабируется в соответствии с границами. Будет ли этот метод анимирован, зависит от внутренней эвристики. |
getBounds |
getBounds()Параметры: нет.
Возвращаемое значение:
LatLngBounds|undefined границы широты и долготы текущей области просмотра.Возвращает широту/долготу границ текущего окна просмотра. Если видно несколько копий мира, границы долготы находятся в диапазоне от -180 до 180 градусов включительно. Если карта ещё не инициализирована или не заданы центр и масштаб, возвращается значение undefined. Для векторных карт с ненулевым наклоном или направлением возвращаемые границы широты и долготы представляют собой наименьшую ограничивающую рамку, которая включает видимую область просмотра карты. Чтобы узнать, как получить точную видимую область просмотра карты, ознакомьтесь с разделом MapCanvasProjection.getVisibleRegion. |
getCenter |
getCenter()Параметры: нет.
Возвращаемое значение:
LatLng|undefined |
getClickableIcons |
getClickableIcons()Параметры: нет.
Возвращаемое значение:
boolean|undefinedВозвращает кликабельность значков на карте. Значок на карте обозначает объект инфраструктуры. Если возвращается значение true, то на значки на карте можно нажимать. |
|
getDatasetFeatureLayer(datasetId)Параметры:
Возвращаемое значение:
FeatureLayerВозвращает FeatureLayer для указанного datasetId. Идентификаторы наборов данных необходимо настроить в консоли Google Cloud. Если идентификатор набора данных не связан со стилем карты или стили на основе данных недоступны (не настроены идентификатор карты, векторные фрагменты, слои объектов или наборы данных), будет зарегистрирована ошибка и возвращено значение FeatureLayer.isAvailable. |
getDiv |
getDiv()Параметры: нет.
Возвращаемое значение:
HTMLElement mapDiv карты. |
getFeatureLayer |
getFeatureLayer(featureType)Параметры:
Возвращаемое значение:
FeatureLayerВозвращает FeatureLayer определенного FeatureType. В консоли Google Cloud должен быть включен FeatureLayer. Если на карте нет слоя 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Возвращает текущий тип отрисовки карты. |
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)Параметры:
Возвращаемое значение: нет.
Определяет, можно ли нажимать на значки на карте. Значок на карте обозначает объект инфраструктуры. Чтобы отключить кликабельность значков на карте, передайте этому методу значение 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° доступны только для типов карт 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. Событие click не активируется, если пользователь нажал на маркер или информационное окно. |
contextmenu |
function(event)Аргументы:
Это событие активируется, когда в контейнере карты активируется событие contextmenu структуры DOM. |
dblclick |
function(event)Аргументы:
Это событие активируется, когда пользователь дважды нажимает на карту. Обратите внимание, что событие клика иногда срабатывает один раз, а иногда дважды, прямо перед этим. |
drag |
function()Аргументы: нет
Это событие активируется многократно во время перетаскивания карты. |
dragend |
function()Аргументы: нет
Это событие активируется, когда пользователь прекращает перетаскивать карту. Примечание. Событие dragend НЕ активируется, когда пользователь прекращает панорамирование карты с помощью клавиатуры. Чтобы определить, когда пользователь прекратил панорамирование или перетаскивание карты, используйте событие 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()Аргументы: нет
Это событие активируется при изменении renderingType. |
tilesloaded |
function()Аргументы: нет
Это событие активируется, когда загрузка видимых фрагментов завершена. |
tilt_changed |
function()Аргументы: нет
Это событие вызывается при изменении свойства наклона карты. |
zoom_changed |
function()Аргументы: нет
Это событие вызывается при изменении свойства масштабирования карты. |
|
function(event)Аргументы:
Это событие активируется, когда пользователь нажимает на карту правой кнопкой мыши. |
Интерфейс 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, значки на карте неактивны. Значок на карте обозначает объект инфраструктуры. |
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Включает/выключает масштабирование и размещение по центру при двойном нажатии. Включено по умолчанию. Примечание. Использовать это свойство не рекомендуется. Чтобы отключить изменение масштаба двойным кликом, можно использовать свойство |
|
Тип:
boolean optionalЕсли false, запрещает перетаскивание и масштабирование карты с помощью мыши и жестов. Перетаскивание включено по умолчанию. |
draggableCursor optional |
Тип:
string optionalНазвание или URL курсора, который будет показываться при наведении указателя мыши на перетаскиваемую карту. Это свойство использует атрибут CSS cursor, чтобы изменить значок. Как и в случае со свойством CSS, необходимо указать хотя бы один резервный курсор, который не является URL. Пример: draggableCursor: 'url(http://www.example.com/icon.png), auto;'. |
draggingCursor optional |
Тип:
string optionalНазвание или URL курсора, который будет показываться при перетаскивании карты. Это свойство использует атрибут CSS cursor, чтобы изменить значок. Как и в случае со свойством 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.Определяет, может ли пользователь управлять направлением камеры (поворотом). Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна). |
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 карты. |
|
Тип:
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 optionalStreetViewPanorama, которая будет показана, когда пользователь перетащит человечка Просмотра улиц на карту. Если панорама не указана, то при перетаскивании человечка в элементе div карты будет показана панорама StreetViewPanorama по умолчанию. |
streetViewControl optional |
Тип:
boolean optionalПервоначальное включенное/выключенное состояние для элемента управления человечком в просмотре улиц. Этот элемент управления является частью интерфейса по умолчанию и должен иметь значение false, если на карте не должно быть наложения дорог Просмотра улиц (например, на карте, отличной от Google Планета Земля). |
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° доступны только для типов карт satellite и hybrid, в некоторых местоположениях и на некоторых уровнях масштабирования. Примечание. Метод getTilt возвращает текущий угол наклона, а не значение, заданное этим параметром. Поскольку getTilt и этот параметр относятся к разным вещам, не bind() свойство tilt, так как это может привести к непредсказуемым последствиям. |
tiltInteractionEnabled optional |
Тип:
boolean optionalПо умолчанию:
false.Определяет, может ли пользователь управлять наклоном камеры. Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна). |
zoom optional |
Тип:
number optionalНачальный уровень масштабирования карты. Допустимые значения масштабирования – это числа от нуля до поддерживаемого максимального уровня масштабирования. Чем больше значение масштаба, тем выше разрешение. |
zoomControl optional |
Тип:
boolean optionalВключенное/выключенное состояние элемента управления масштабированием. |
zoomControlOptions optional |
Тип:
ZoomControlOptions optionalПараметры отображения для элемента управления масштабированием. |
Интерфейс MapTypeStyle
google.maps.MapTypeStyle
интерфейс
MapTypeStyle – это набор селекторов и стилизаторов, определяющих стиль карты. Селекторы указывают, на какие объекты и элементы карты нужно повлиять, а параметры стилей – как именно их нужно изменить. Подробную информацию можно найти в справочнике по стилям.
Свойства | |
|---|---|
stylers |
Правила стилей, которые нужно применить к выбранным объектам и элементам карты. Правила применяются в том порядке, в котором они указаны в массиве. Рекомендации по использованию и допустимые значения приведены в справочной документации. |
elementType optional |
Тип:
string optionalЭлемент, к которому нужно применить стиль. Элемент – это визуальный аспект объекта на карте. Например, это может быть ярлык, значок, обводка или заливка, примененная к геометрии. Необязательное поле. Если значение elementType не указано, по умолчанию применяется 'all'. Подробные сведения об использовании и допустимых значениях приведены в справочной документации. |
featureType optional |
Тип:
string optionalОбъект или группа объектов, к которым применяется стиль. Необязательное поле. Если значение featureType не указано, по умолчанию применяется 'all'. Подробные сведения об использовании и допустимых значениях приведены в справочной документации. |
Интерфейс 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
интерфейс
Этот объект отправляется в событии, когда пользователь нажимает на значок на карте. Идентификатор места хранится в элементе placeId. Чтобы информационное окно по умолчанию не показывалось, вызовите метод stop() для этого события. Подробнее об идентификаторах мест в руководстве для разработчиков Places API.
Этот интерфейс расширяет MapMouseEvent.
Свойства | |
|---|---|
placeId optional |
Тип:
string optionalИдентификатор места, на которое нажал пользователь. Этот идентификатор места можно использовать для запроса дополнительной информации об объекте, на который нажал пользователь. Подробнее об идентификаторах мест в руководстве для разработчиков Places API. |
Унаследованные:
domEvent,
latLng
| |
Методы | |
|---|---|
Унаследованные:
stop
|
Константы 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
константы
Идентификаторы для распространенных типов карт. Укажите их по значению или по названию константы. Примеры: 'satellite' или google.maps.MapTypeId.SATELLITE.
Чтобы получить доступ, позвоните по номеру const {MapTypeId} = await google.maps.importLibrary("maps").
Подробнее о библиотеках Maps JavaScript API…
Константы | |
|---|---|
HYBRID |
Тип карты с прозрачным слоем главных улиц поверх спутниковых снимков. |
ROADMAP |
Этот тип карты показывает обычную карту улиц. |
SATELLITE |
Фотографическая карта. |
TERRAIN |
Тип карты с физическими элементами, такими как рельеф и растительность. |
Класс MapTypeRegistry
google.maps.MapTypeRegistry
класс
Реестр для экземпляров MapType, упорядоченный по идентификаторам MapType.
Этот класс расширяет MVCObject.
Чтобы получить доступ, позвоните по номеру const {MapTypeRegistry} = await google.maps.importLibrary("maps").
Подробнее о библиотеках Maps JavaScript API…
Конструктор | |
|---|---|
MapTypeRegistry |
MapTypeRegistry()Параметры: нет.
MapTypeRegistry содержит набор собственных типов карт, доступных для использования. API обращается к этому реестру, когда предоставляет список доступных типов карт в элементах управления. |
Методы | |
|---|---|
set |
set(id, mapType)Параметры:
Возвращаемое значение: нет.
Создает реестр, который должен связывать переданный строковый идентификатор с переданным MapType. |
Унаследованные:
addListener,
bindTo,
get,
notify,
setValues,
unbind,
unbindAll
| |
Интерфейс MapRestriction
google.maps.MapRestriction
интерфейс
Ограничение, которое можно применить к карте. Область просмотра карты не будет выходить за эти ограничения.
Свойства | |
|---|---|
latLngBounds |
Если задать этот параметр, пользователь сможет панорамировать и масштабировать карту только в пределах указанных границ. Границы могут ограничивать как долготу, так и широту, или только широту. Если вы хотите задать только широту, укажите для западной и восточной долготы значения -180 и 180 соответственно, например latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}. |
strictBounds optional |
Тип:
boolean optionalГраницы можно сделать более строгими, установив для флага strictBounds значение true. Это ограничит возможность уменьшения масштаба, чтобы все, что находится за пределами ограниченной области, оставалось скрытым. Значение по умолчанию – false. Это означает, что пользователь может уменьшать масштаб до тех пор, пока в области просмотра не окажется вся ограниченная область, возможно, включая области за ее пределами. |
Класс TrafficLayer
google.maps.TrafficLayer
класс
Слой "Пробки".
Этот класс расширяет MVCObject.
Чтобы получить доступ, позвоните по номеру const {TrafficLayer} = await google.maps.importLibrary("maps").
Подробнее о библиотеках Maps JavaScript API…
Конструктор | |
|---|---|
TrafficLayer |
TrafficLayer([opts])Параметры:
Слой, отображающий дорожные пробки на данный момент. |
Методы | |
|---|---|
getMap |
getMap()Параметры: нет.
Возвращаемое значение:
Map|nullВозвращает карту, на которой отображается этот слой. |
setMap |
setMap(map)Параметры:
Возвращаемое значение: нет.
Показывает слой на указанной карте. Если для карты задано значение null, слой будет удален. |
setOptions |
setOptions(options)Параметры:
Возвращаемое значение: нет.
|
Унаследованные:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll.
| |
Интерфейс TrafficLayerOptions
google.maps.TrafficLayerOptions
интерфейс
Объект TrafficLayerOptions, используемый для определения свойств, которые можно задать для TrafficLayer.
Свойства | |
|---|---|
autoRefresh optional |
Тип:
boolean optionalПо умолчанию:
true.Обновляется ли слой трафика автоматически. |
map optional |
Тип:
Map optionalКарта, на которой нужно показать слой загруженности дорог. |
Класс TransitLayer
google.maps.TransitLayer
класс
Слой общественного транспорта.
Этот класс расширяет MVCObject.
Чтобы получить доступ, позвоните по номеру const {TransitLayer} = await google.maps.importLibrary("maps").
Подробнее о библиотеках Maps JavaScript API…
Конструктор | |
|---|---|
TransitLayer |
TransitLayer()Параметры: нет.
Слой, на котором показаны маршруты общественного транспорта. |
Методы | |
|---|---|
getMap |
getMap()Параметры: нет.
Возвращаемое значение:
Map|nullВозвращает карту, на которой отображается этот слой. |
setMap |
setMap(map)Параметры:
Возвращаемое значение:
voidПоказывает слой на указанной карте. Если для карты задано значение null, слой будет удален. |
Унаследованные:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll.
| |
Класс BicyclingLayer
google.maps.BicyclingLayer
класс
Слой, показывающий велосипедные дорожки и выделенные полосы.
Этот класс расширяет MVCObject.
Чтобы получить доступ, позвоните по номеру const {BicyclingLayer} = await google.maps.importLibrary("maps").
Подробнее о библиотеках Maps JavaScript API…
Конструктор | |
|---|---|
BicyclingLayer |
BicyclingLayer()Параметры: нет.
Слой, который показывает велосипедные дорожки и выделенные полосы, перемещая большие дороги на более низкий уровень. |
Методы | |
|---|---|
getMap |
getMap()Параметры: нет.
Возвращаемое значение:
Map|nullВозвращает карту, на которой отображается этот слой. |
setMap |
setMap(map)Параметры:
Возвращаемое значение:
voidПоказывает слой на указанной карте. Если для карты задано значение null, слой будет удален. |
Унаследованные:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll.
| |
Интерфейс CameraOptions
google.maps.CameraOptions
интерфейс
Используется для настройки параметров камеры карты.
Свойства | |
|---|---|
center optional |
Тип:
LatLngLiteral|LatLng optional |
heading optional |
Тип:
number optional |
tilt optional |
Тип:
number optional |
zoom optional |
Тип:
number optional |
Интерфейс VisibleRegion
google.maps.VisibleRegion
интерфейс
Содержит четыре точки, определяющие четырехугольник, который является видимой областью карты. На векторной карте с наклоном этот многоугольник может быть трапецией, а не прямоугольником.
Свойства | |
|---|---|
farLeft |
Тип:
LatLng |
farRight |
Тип:
LatLng |
latLngBounds |
Тип:
LatLngBoundsСамая маленькая ограничивающая рамка, включающая видимую область. |
nearLeft |
Тип:
LatLng |
nearRight |
Тип:
LatLng |
Константы RenderingType
google.maps.RenderingType
константы
Чтобы получить доступ, позвоните по номеру const {RenderingType} = await google.maps.importLibrary("maps").
Подробнее о библиотеках Maps JavaScript API…
Константы | |
|---|---|
RASTER |
Указывает, что карта растровая. |
UNINITIALIZED |
Указывает, что пока неизвестно, является ли карта векторной или растровой, поскольку инициализация карты ещё не завершена. |
VECTOR |
Указывает, что карта является векторной. |
Интерфейс MapCapabilities
google.maps.MapCapabilities
интерфейс
Объект, содержащий снимок возможностей, доступных в настоящее время для карты. Это не обязательно означает, что соответствующие модули загружены или инициализированы, а лишь то, что у текущей карты есть разрешение на использование этих API. Список возможных функций приведен в свойствах.
Свойства | |
|---|---|
isAdvancedMarkersAvailable optional |
Тип:
boolean optionalЕсли возвращается значение true, карта настроена правильно и на ней можно использовать расширенные маркеры. Обратите внимание, что для использования расширенных маркеров вам по-прежнему нужно импортировать библиотеку marker. Подробную информацию можно найти на странице https://goo.gle/gmp-isAdvancedMarkersAvailable. |
isDataDrivenStylingAvailable optional |
Тип:
boolean optionalЕсли значение true, то карта настроена правильно и позволяет использовать стили на основе данных хотя бы для одного FeatureLayer. Дополнительную информацию можно найти на страницах https://goo.gle/gmp-data-driven-styling и https://goo.gle/gmp-FeatureLayerIsAvailable. |
isWebGLOverlayViewAvailable optional |
Тип:
boolean optionalЕсли задано значение True, карта настроена правильно и позволяет использовать WebGLOverlayView. |