Класс карты
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 . |
| |