Класс карты
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 считывает размер карты как 0x0 и, следовательно, не выполняет никаких действий. Чтобы изменить область просмотра, когда карта скрыта, установите для карты значение visibility: hidden , тем самым гарантируя, что блок div карты будет иметь фактический размер. Для векторных карт этот метод устанавливает наклон и направление карты в нулевые значения по умолчанию. Вызов этого метода может привести к плавной анимации при панорамировании и масштабировании карты для соответствия границам. Наличие анимации этим методом зависит от внутренней эвристики. |
getBounds | getBounds() Параметры: нет Возвращаемое значение: LatLngBounds |undefined Границы широты/долготы текущего окна просмотра. Возвращает границы текущей области просмотра по широте и долготе. Если отображается более одной копии мира, границы по долготе находятся в диапазоне от -180 до 180 градусов включительно. Если карта ещё не инициализирована или не заданы центр и масштаб, результат undefined . Для векторных карт с ненулевым наклоном или направлением возвращаемые границы по широте и долготе представляют собой наименьший ограничивающий прямоугольник, включающий видимую область области просмотра карты. Для получения точной видимой области области просмотра карты см. MapCanvasProjection.getVisibleRegion |
getCenter | getCenter() Параметры: нет Возвращаемое значение: LatLng |undefined |
getClickableIcons | getClickableIcons() Параметры: нет Возвращаемое значение: boolean|undefined Возвращает кликабельность значков на карте. Значок карты представляет собой точку интереса (POI). Если возвращаемое значение равно true , то значки на карте кликабельны. |
| getDatasetFeatureLayer(datasetId) Параметры:
Возвращаемое значение: FeatureLayer Возвращает FeatureLayer для указанного datasetId . Идентификаторы наборов данных необходимо настроить в консоли Google Cloud. Если идентификатор набора данных не связан со стилем карты или если стилизация, управляемая данными, недоступна (нет идентификатора карты, нет векторных фрагментов, нет слоёв объектов, управляемых данными, или наборов данных, настроенных в стиле карты), регистрируется ошибка, а результирующее значение FeatureLayer.isAvailable будет равно false. |
getDiv | getDiv() Параметры: нет Возвращаемое значение: HTMLElement Элемент mapDiv карты. |
getFeatureLayer | getFeatureLayer(featureType) Параметры:
Возвращаемое значение: FeatureLayer Возвращает FeatureLayer указанного типа FeatureType . FeatureLayer должен быть включён в консоли Google Cloud. Если 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) Параметры:
Возвращаемое значение: нет Управляет возможностью нажатия на значки карты. Значок карты представляет собой точку интереса (POI). Чтобы отключить возможность нажатия на значки карты, передайте этому методу значение false . |
setHeading | setHeading(heading) Параметры:
Возвращаемое значение: нет Устанавливает направление по компасу для карты, измеряемое в градусах от направления на север. Для растровых карт этот метод применим только к аэрофотоснимкам. |
setHeadingInteractionEnabled | setHeadingInteractionEnabled(headingInteractionEnabled) Параметры:
Возвращаемое значение: нет Устанавливает, включены ли взаимодействия с направлением. Этот параметр действует только для векторной карты. Если не задано в коде, будет использоваться облачная конфигурация для идентификатора карты (при наличии). |
setMapTypeId | setMapTypeId(mapTypeId) Параметры:
Возвращаемое значение: нет |
setOptions | setOptions(options) Параметры:
Возвращаемое значение: нет |
setRenderingType | setRenderingType(renderingType) Параметры:
Возвращаемое значение: нет Устанавливает текущий тип рендеринга карты. |
setStreetView | setStreetView(panorama) Параметры:
Возвращаемое значение: нет Привязывает панораму StreetViewPanorama к карте. Эта панорама переопределяет панораму StreetViewPanorama по умолчанию, позволяя карте привязываться к внешней панораме за пределами карты. Установка значения панорамы в null привязывает встроенную панораму по умолчанию обратно к карте. |
setTilt | setTilt(tilt) Параметры:
Возвращаемое значение: нет Для векторных карт задаёт угол наклона карты. Допустимые значения ограничены уровнем масштабирования карты. Для растровых карт управляет поведением автоматического переключения для угла падения карты. Единственные допустимые значения: 0 и 45 . setTilt(0) заставляет карту всегда использовать вид сверху 0° независимо от уровня масштабирования и области просмотра. setTilt(45) заставляет угол наклона автоматически переключаться на 45 всякий раз, когда доступно изображение под углом 45° для текущего уровня масштабирования и области просмотра, и переключаться обратно на 0, когда изображение под углом 45° недоступно (это поведение по умолчанию). Изображение под углом 45° доступно только для satellite и hybrid типов карт, в некоторых местах и на некоторых уровнях масштабирования. Примечание: getTilt возвращает текущий угол наклона, а не значение, установленное setTilt . Поскольку getTilt и setTilt ссылаются на разные вещи, не bind() свойство tilt ; это может привести к непредсказуемым эффектам. |
setTiltInteractionEnabled | setTiltInteractionEnabled(tiltInteractionEnabled) Параметры:
Возвращаемое значение: нет Определяет, включены ли взаимодействия с наклоном. Этот параметр действует только для векторной карты. Если не задано в коде, будет использоваться облачная конфигурация для идентификатора карты (при наличии). |
setZoom | setZoom(zoom) Параметры:
Возвращаемое значение: нет Устанавливает масштаб карты. |
Унаследовано: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll | |
События | |
|---|---|
bounds_changed | function() Аргументы: нет Это событие срабатывает при изменении границ области просмотра. |
center_changed | function() Аргументы: нет Это событие возникает при изменении свойства центра карты. |
click | function(event) Аргументы:
Это событие срабатывает при щелчке пользователя на карте. Возвращается событие MapMouseEvent со свойствами для выбранного местоположения, если только не был нажат значок местоположения; в этом случае возвращается событие IconMouseEvent с идентификатором местоположения. IconMouseEvent и MapMouseEvent идентичны, за исключением того, что у IconMouseEvent есть поле идентификатора местоположения. Событие всегда можно рассматривать как MapMouseEvent, если идентификатор местоположения не важен. Событие click не срабатывает, если был нажат маркер или информационное окно. |
contextmenu | function(event) Аргументы:
Это событие вызывается, когда в контейнере карты вызывается событие DOM contextmenu. |
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 значки карты неактивны. Значок карты обозначает точку интереса (POI). |
colorScheme optional | Тип: ColorScheme |string optional По умолчанию: ColorScheme.LIGHT Начальная цветовая схема карты. Этот параметр можно задать только при инициализации карты. |
controlSize optional | Тип: number optional Размер элементов управления, отображаемых на карте, в пикселях. Это значение необходимо указать непосредственно при создании карты. Последующее изменение этого значения может привести к undefined состоянию элементов управления. Управляет только элементами управления, созданными самим API Карт. Не масштабирует пользовательские элементы управления, созданные разработчиками. |
disableDefaultUI optional | Тип: boolean optional Включает/отключает все кнопки пользовательского интерфейса по умолчанию. Могут быть переопределены по отдельности. Не отключает управление с клавиатуры, которое отдельно контролируется параметром MapOptions.keyboardShortcuts . Не отключает управление жестами, которое отдельно контролируется параметром MapOptions.gestureHandling . |
disableDoubleClickZoom optional | Тип: boolean optional Включает/отключает масштабирование и центрирование по двойному щелчку. Включено по умолчанию. Примечание : использовать это свойство не рекомендуется . Чтобы отключить масштабирование при двойном щелчке, можно использовать свойство |
| Тип: boolean optional Если false , перетаскивание карты запрещено. По умолчанию перетаскивание включено. |
draggableCursor optional | Тип: string optional Имя или URL курсора, отображаемого при наведении указателя мыши на перетаскиваемую карту. Это свойство использует атрибут cursor css для изменения значка. Как и в случае со свойством css, необходимо указать хотя бы один резервный курсор, не являющийся URL-адресом. Например: draggableCursor: 'url( http://www.example.com/icon.png ), auto;' . |
draggingCursor optional | Тип: string optional Имя или URL курсора, отображаемого при перетаскивании карты. Это свойство использует атрибут cursor css для изменения значка. Как и в случае со свойством css, необходимо указать хотя бы один резервный курсор, не являющийся URL-адресом. Например: draggingCursor: 'url( http://www.example.com/icon.png ), auto;' . |
fullscreenControl optional | Тип: boolean optional Включенное/выключенное состояние полноэкранного элемента управления. |
fullscreenControlOptions optional | Тип: FullscreenControlOptions optional Параметры отображения для полноэкранного управления. |
| |