Image overlays

Интерфейс MapType

интерфейс google.maps.MapType
реализован ImageMapType, StyledMapType

Этот интерфейс определяет тип карты и обычно используется для пользовательских типов карт. Не меняется.
maxZoom
Тип: number
Максимальный уровень масштабирования для карты при выводе этого MapType. Обязательно для основных типов MapType, игнорируется для накладываемых типов MapType.
minZoom
Тип: number
Минимальный уровень масштабирования для карты при выводе этого MapType. Дополнительно. Значение по умолчанию – 0.
radius
Тип: number
Радиус планеты для данной карты в метрах. Дополнительно. По умолчанию радиус экватора Земли составляет 6 378 137 метров.
alt
необязательно
Тип: string optional
Текст Alt, который должен отображаться при наведении курсора на кнопку MapType в MapTypeControl. Необязательное поле.
name
необязательно
Тип: string optional
Имя для показа в MapTypeControl. Необязательное поле.
projection
необязательно
Тип: Projection optional
Проекция, используемая для показа этого MapType. Дополнительно. Значение по умолчанию – Mercator.
tileSize
необязательно
Тип: Size optional
Размеры каждого фрагмента. Обязательно.
getTile
getTile(tileCoord, zoom, ownerDocument)
Параметры:
  • tileCoord: Point Координаты фрагмента.
  • zoom: number Масштаб мозаики.
  • ownerDocument: Document Документ, которому принадлежит этот элемент.
Возвращаемое значение: Element|null – результирующий элемент.
Возвращает фрагмент для заданных координат фрагмента (x, y) и уровень масштабирования. Этот фрагмент будет добавлен к заданному ownerDocument. Недоступно для базовых типов карт.
releaseTile
releaseTile(tile)
Параметры:
  • tile: Element optional карточка, которую можно выпустить.
Возвращаемое значение: void
Освобождает заданный фрагмент, выполняя любую необходимую очистку. Предоставленный фрагмент уже будет удален из документа. Необязательное поле.

Интерфейс Projection

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

Интерфейс прогнозирования.
fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
Параметры:
Возвращаемое значение: Point|null
Преобразует цилиндр LatLng в плоскость Point. Этот интерфейс задает функцию, которая преобразует заданные значения LatLng в мировые координаты на проекции карты. Служба Maps API вызывает этот метод, если нужно отметить точки на экране. Объекты Projection должны реализовывать этот метод, но могут возвращать null, если проекция не может рассчитать Point.
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
Параметры:
  • pixel: Point
  • noClampNoWrap: boolean optional
Возвращаемое значение: LatLng|null
Этот интерфейс задает функцию, которая преобразует мировые координаты в проекции карты в значения LatLng. Служба Maps API вызывает этот метод, если требуется перевести действия на экране в положения на карте. Объекты Projection должны реализовывать этот метод, но могут возвращать null, если проекция не может рассчитать LatLng.

Класс ImageMapType

class google.maps.ImageMapType extends MVCObject implements MapType
library "maps"

Этот класс реализует интерфейс MapType и предоставляется для визуализации фрагментов изображения.

const {ImageMapType} = await google.maps.importLibrary("maps");
ImageMapType
ImageMapType(opts)
Параметры:
Создает ImageMapType с помощью предоставленных ImageMapTypeOptions.
alt
Тип: string optional
maxZoom
Тип: number
minZoom
Тип: number
name
Тип: string optional
projection
Тип: Projection optional
radius
Тип: number
tileSize
Тип: Size optional
getOpacity
getOpacity()
Параметры: нет.
Возвращаемое значение: number opacity Текущая прозрачность.
Возвращает уровень прозрачности (от 0 (прозрачный) до 1.0) фрагментов ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
Параметры:
  • tileCoord: Point optional Координаты фрагмента.
  • zoom: number Масштаб мозаики.
  • ownerDocument: Document optional Документ, которому принадлежит этот элемент.
Возвращаемое значение: Element|null – результирующий элемент.
releaseTile
releaseTile(tileDiv)
Параметры:
  • tileDiv: Element optional карточка, которую можно выпустить.
Возвращаемое значение: нет.
setOpacity
setOpacity(opacity)
Параметры:
  • opacity: number Новое значение прозрачности.
Возвращаемое значение: нет.
Задает уровень прозрачности (от 0 (прозрачный) до 1.0) фрагментов ImageMapType.
Унаследованные: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll.
tilesloaded
function()
Аргументы: нет.
Это событие активируется, когда загрузка видимых фрагментов завершена.

Интерфейс ImageMapTypeOptions

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

Этот класс используется для создания MapType, который осуществляет видеообработку фрагментов изображения.
alt
необязательно
Тип: string optional
Текст Alt, который должен отображаться при наведении курсора на кнопку MapType в MapTypeControl.
getTileUrl
необязательно
Тип: function(Point, number): (string optional) optional
Возвращает строку (URL) для заданных координат фрагмента (x, y) и уровень масштабирования.
maxZoom
необязательно
Тип: number optional
Максимальный уровень масштабирования для карты при выводе этого MapType.
minZoom
необязательно
Тип: number optional
Минимальный уровень масштабирования для карты при выводе этого MapType. Необязательное поле.
name
необязательно
Тип: string optional
Имя для показа в MapTypeControl.
opacity
необязательно
Тип: number optional
Параметр непрозрачности, который должен применяться к фрагментам. Непрозрачность должна быть указана в виде числа с плавающей запятой в диапазоне от 0 до 1,0, где 0 обозначает полную прозрачность, а 1 – полную непрозрачность.
tileSize
необязательно
Тип: Size optional
Размер фрагмента.

Класс GroundOverlay

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

Наложение прямоугольного изображения на карту. 

const {GroundOverlay} = await google.maps.importLibrary("maps");
GroundOverlay
GroundOverlay(url, bounds[, opts])
Параметры:
Создает наземное наложение на основе URL изображения и его LatLngBounds. Изображение масштабируется в соответствии с текущими границами, а для проецирования используется текущая проекция карты.
getBounds
getBounds()
Параметры: нет.
Возвращаемое значение: LatLngBounds|null
Возвращает LatLngBounds этого оверлея.
getMap
getMap()
Параметры: нет.
Возвращаемое значение: Map|null
Возвращает карту, на которой отображается это наложение на земную поверхность.
getOpacity
getOpacity()
Параметры: нет.
Возвращаемое значение: number
Возвращает непрозрачность этого наземного наложения.
getUrl
getUrl()
Параметры: нет.
Возвращаемое значение: string
Получает URL спроектированного изображения.
setMap
setMap(map)
Параметры:
  • map: Map optional
Возвращаемое значение: void
Отображает наложение на земную поверхность на указанной карте. Если для карты задано значение null, наложение удаляется.
setOpacity
setOpacity(opacity)
Параметры:
  • opacity: number
Возвращаемое значение: void
Задает прозрачность наложения.
Унаследованные: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll.
click
function(event)
Аргументы:
Это событие активируется, когда событие клика DOM активируется в GroundOverlay.
dblclick
function(event)
Аргументы:
Срабатывает, когда в DOM для элемента GroundOverlay запускается событие dblclick.

Интерфейс GroundOverlayOptions

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

Этот объект определяет свойства, которые можно задать для объекта GroundOverlay.
clickable
необязательно
Тип: boolean optional
Если задано значение true, наземное наложение может получать события мыши.
map
необязательно
Тип: Map optional
Карта, на которой должно отображаться наложение.
opacity
необязательно
Тип: number optional
По умолчанию: 1.0.
Прозрачность оверлея, выраженная в виде значения от 0 до 1. Необязательное поле.

Класс StyledMapType

class google.maps.StyledMapType extends MVCObject implements MapType
library "maps"

Создает MapType с собственным стилем.

const {StyledMapType} = await google.maps.importLibrary("maps");
StyledMapType
StyledMapType(styles[, options])
Параметры:
  • styles: Array<MapTypeStyle optional> optional Стили, которые нужно применить.
  • options: StyledMapTypeOptions optional Параметры типа стилизованной карты.
Создает стилизованный элемент MapType с указанными параметрами. StyledMapType принимает массив MapTypeStyle, каждый MapTypeStyle из которых последовательно применяется к карте. Если в более позднем правиле MapTypeStyle используются те же селекторы и свойства MapTypeStyler, что и в более раннем MapTypeStyle, то более позднее правило переопределит более раннее MapTypeStyle.

Обратите внимание, что StyledMapType не поддерживается, если задан идентификатор карты. Если вы используете оба метода, то получите предупреждение в консоли.
alt
Тип: string
maxZoom
Тип: number
minZoom
Тип: number
name
Тип: string
projection
Тип: Projection optional
radius
Тип: number
tileSize
Тип: Size optional
getTile
getTile(tileCoord, zoom, ownerDocument)
Параметры:
  • tileCoord: Point optional Координаты фрагмента.
  • zoom: number Масштаб мозаики.
  • ownerDocument: Document optional Документ, которому принадлежит этот элемент.
Возвращаемое значение: Element|null – результирующий элемент.
releaseTile
releaseTile(tile)
Параметры:
  • tile: Element optional карточка, которую можно выпустить.
Возвращаемое значение: void
Унаследованные: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll.

Интерфейс StyledMapTypeOptions

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

Этот класс используется для указания параметров при создании StyledMapType. Эти настройки нельзя изменить после создания экземпляра StyledMapType.
alt
необязательно
Тип: string optional
Текст, который будет показываться при наведении указателя мыши на кнопку MapType в элементе управления типом карты.
maxZoom
необязательно
Тип: number optional
Максимальный уровень масштабирования карты при отображении этого объекта MapType. Необязательное поле.
minZoom
необязательно
Тип: number optional
Минимальный уровень масштабирования карты при показе этого объекта (MapType). Необязательное поле.
name
необязательно
Тип: string optional
Название, которое будет показываться в элементе управления типом карты.