Image overlays

Интерфейс MapType

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

Этот интерфейс определяет тип карты и обычно используется для пользовательских типов карт. Не меняется.
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 Tile to release.
Возвращаемое значение: 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

google.maps.ImageMapType class
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 Tile to release.
Возвращаемое значение: нет.
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

google.maps.GroundOverlay class
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.
Возвращаемое значение: нет.
Отображает наложение на земную поверхность на указанной карте. Если для карты задано значение null, наложение удаляется.
setOpacity
setOpacity(opacity)
Параметры:
  • opacity: number.
Возвращаемое значение: нет.
Задает прозрачность наложения.
Унаследованные: 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

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

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

const {StyledMapType} = await google.maps.importLibrary("maps");
StyledMapType
StyledMapType(styles[, options])
Параметры:
Создает стилизованный элемент 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 Tile to release.
Возвращаемое значение: нет.
Унаследованные: 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
Название, которое будет показываться в элементе управления типом карты.