Maps

Класс MapElement

class google.maps.MapElement extends HTMLElement implements MapElementOptions
library "maps"

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>

<gmp-map
  center="lat,lng"
  heading-interaction-disabled
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  rendering-type="value-name"
  tilt-interaction-disabled
  zoom="number">
</gmp-map>

const {MapElement} = await google.maps.importLibrary("maps");

Интерфейс MapElementOptions

интерфейс google.maps.MapElementOptions
реализован MapElement

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

Класс ZoomChangeEvent

class google.maps.ZoomChangeEvent extends Event
library "maps"

Это событие создается при отслеживании изменения масштаба.

const {ZoomChangeEvent} = await google.maps.importLibrary("maps");

Класс Map

class google.maps.Map extends MVCObject
library "maps"

const {Map} = await google.maps.importLibrary("maps");

Методы
fitBounds	fitBounds(bounds[, padding]) Параметры: bounds: LatLngBounds|LatLngBoundsLiteral граница для показа. padding: number|Padding optional Поля в пикселях. Границы будут вписаны в ту часть карты, которая останется после удаления отступов. Числовое значение задает одинаковые поля со всех четырех сторон. Укажите здесь 0, чтобы сделать fitBounds идемпотентным для результата getBounds. Возвращаемое значение: нет. Задает окно просмотра с указанными границами. Примечание. Если для карты задано значение display: none, функция fitBounds считывает размер карты как 0 x 0 и поэтому ничего не делает. Чтобы изменить область просмотра, когда карта скрыта, задайте для карты значение visibility: hidden. Это позволит убедиться, что у элемента div карты есть фактический размер. Для векторных карт этот метод устанавливает наклон и ориентацию карты на нулевые значения по умолчанию. Вызов этого метода может привести к плавной анимации, когда карта панорамируется и масштабируется в соответствии с границами. Будет ли этот метод анимирован, зависит от внутренней эвристики.
getBounds	getBounds() Параметры: нет. Возвращаемое значение: LatLngBounds|undefined Границы широты и долготы текущей области просмотра. Возвращает широту/долготу границ текущего окна просмотра. Если видно несколько копий мира, границы долготы находятся в диапазоне от -180 до 180 градусов включительно. Если карта ещё не инициализирована или не заданы центр и масштаб, возвращается значение undefined. Для векторных карт с ненулевым наклоном или направлением возвращаемые границы широты и долготы представляют собой наименьшую ограничивающую рамку, которая включает видимую область просмотра карты. Чтобы узнать, как получить точную видимую область просмотра карты, ознакомьтесь с разделом MapCanvasProjection.getVisibleRegion.
getCenter	getCenter() Параметры: нет. Возвращаемое значение: LatLng|undefined Возвращает позицию, отображаемую в центре карты. Обратите внимание, что этот объект LatLng не упакован. Подробнее: LatLng. Если центр или границы не заданы, возвращается значение undefined.
getClickableIcons	getClickableIcons() Параметры: нет. Возвращаемое значение: boolean|undefined Возвращает кликабельность значков на карте. Значок на карте обозначает объект инфраструктуры. Если возвращается значение true, то на значки на карте можно нажимать.
getDatasetFeatureLayer	getDatasetFeatureLayer(datasetId) Параметры: datasetId: string Возвращаемое значение: FeatureLayer Возвращает FeatureLayer для указанного datasetId. Идентификаторы наборов данных необходимо настроить в консоли Google Cloud. Если идентификатор набора данных не связан со стилем карты или стили на основе данных недоступны (не настроены идентификатор карты, векторные фрагменты, слои объектов или наборы данных), будет зарегистрирована ошибка и возвращено значение FeatureLayer.isAvailable.
getDiv	getDiv() Параметры: нет. Возвращаемое значение: HTMLElement mapDiv карты.
getFeatureLayer	getFeatureLayer(featureType) Параметры: featureType: 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) Параметры: cameraOptions: 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) Параметры: latlng: LatLng|LatLngLiteral Возвращаемое значение: нет.
setClickableIcons	setClickableIcons(value) Параметры: value: boolean Возвращаемое значение: нет. Определяет, можно ли нажимать на значки на карте. Значок на карте обозначает объект инфраструктуры. Чтобы отключить кликабельность значков на карте, передайте этому методу значение false.
setHeading	setHeading(heading) Параметры: heading: number Возвращаемое значение: нет. Задает направление по компасу для карты, измеряемое в градусах от направления на север. Для растровых карт этот метод применяется только к аэрофотоснимкам.
setHeadingInteractionEnabled	setHeadingInteractionEnabled(headingInteractionEnabled) Параметры: headingInteractionEnabled: boolean Возвращаемое значение: нет. Определяет, включено ли взаимодействие с заголовками. Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна).
setMapTypeId	setMapTypeId(mapTypeId) Параметры: mapTypeId: MapTypeId|string Возвращаемое значение: нет.
setOptions	setOptions(options) Параметры: options: MapOptions optional Возвращаемое значение: нет.
setRenderingType	setRenderingType(renderingType) Параметры: renderingType: 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° доступны только для типов карт 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.

Интерфейс MapOptions

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

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

Интерфейс MapTypeStyle

интерфейс google.maps.MapTypeStyle

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

Интерфейс MapMouseEvent

interface google.maps.MapMouseEvent
extended by Data.MouseEvent, FeatureMouseEvent, IconMouseEvent, PolyMouseEvent

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

Интерфейс IconMouseEvent

interface google.maps.IconMouseEvent extends MapMouseEvent

Этот объект отправляется в событии, когда пользователь нажимает на значок на карте. Идентификатор места хранится в элементе placeId. Чтобы информационное окно по умолчанию не показывалось, вызовите метод stop() для этого события. Подробнее об идентификаторах мест в руководстве для разработчиков Places API.

Константы ColorScheme

константы google.maps.ColorScheme
библиотека "core"

Идентификаторы цветовых схем карт. Укажите их по значению или по названию константы. Примеры: 'FOLLOW_SYSTEM' или google.maps.ColorScheme.FOLLOW_SYSTEM.

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом ColorSchemeString.

const {ColorScheme} = await google.maps.importLibrary("core");

Константы MapTypeId

константы google.maps.MapTypeId
библиотека "maps"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом MapTypeIdString.

const {MapTypeId} = await google.maps.importLibrary("maps");

Класс MapTypeRegistry

class google.maps.MapTypeRegistry extends MVCObject
library "maps"

Реестр для экземпляров MapType, упорядоченный по идентификаторам MapType.

const {MapTypeRegistry} = await google.maps.importLibrary("maps");

Интерфейс MapRestriction

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

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

Класс TrafficLayer

class google.maps.TrafficLayer extends MVCObject
library "maps"

Слой "Пробки".

const {TrafficLayer} = await google.maps.importLibrary("maps");

Интерфейс TrafficLayerOptions

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

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

Класс TransitLayer

class google.maps.TransitLayer extends MVCObject
library "maps"

Слой общественного транспорта.

const {TransitLayer} = await google.maps.importLibrary("maps");

Класс BicyclingLayer

class google.maps.BicyclingLayer extends MVCObject
library "maps"

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

const {BicyclingLayer} = await google.maps.importLibrary("maps");

Интерфейс CameraOptions

interface google.maps.CameraOptions
extended by CameraParams

Используется для настройки параметров камеры карты.

Интерфейс VisibleRegion

интерфейс google.maps.VisibleRegion

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

Константы RenderingType

константы google.maps.RenderingType
библиотека "maps"

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом RenderingTypeString.

const {RenderingType} = await google.maps.importLibrary("maps");

Интерфейс MapCapabilities

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

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