Референс-руководство Google Maps

Конструктор Map()

Создание карты Google:

var map = new google.maps.Map(mapCanvas, mapOptions);

Определение и использование

Конструктор Map() создает новую карту в指定的 HTML-элементе (обычно это элемент <div>).

Синтаксис

new google.maps.Map(HTMLElement,MapOptions)

Значение параметра

Параметры Описание
HTMLElement Определить, в哪个 HTML-элементе будет размещена карта.
MapOptions Объект MapOptions для сохранения переменных и опций инициализации карты.

Методы Map()

Метод Вернуть значение Описание
fitBounds(LatLngBounds) None Установить вид, чтобы он включал заданные границы.
getBounds() LatLng,LatLng Вернуть юго-западные и северо-восточные координаты текущего вида.
getCenter() LatLng Вернуть широту и долготу центра карты.
getDiv() Node Вернуть DOM-объект, содержащий карту.
getHeading() number

Вернуть компасный курс навигации аэрофотоснимка.

Применяется для типов карт SATELLITE и HYBRID.
getMapTypeId()
  • HYBRID
  • ROADMAP
  • SATELLITE
  • TERRAIN
 Вернуть текущий тип карты.
getProjection() Projection Вернуть текущую проекцию.
getStreetView() StreetViewPanorama Вернуть default StreetViewPanorama, привязанный к карте.
getTilt() number

Вернуть угол падения света аэрофотоснимка (в градусах).

Применяется для типов карт SATELLITE и HYBRID.
getZoom() number Вернуть текущий уровень масштабирования карты.
panBy(xnumber,ynumber) None Изменить центр карты на заданное расстояние (в пикселях).
panTo(LatLng) None Переместить центр карты на заданные LatLng.
panToBounds(LatLngBounds) None Переместить карту на минимальное количество, необходимое для включения LatLngBounds.
setCenter(LatLng) None Установить широту и долготу центра карты.
setHeading(number) None

Установить компасный курс навигации для аэрофотоснимка.

Измеряется в градусах от базового направления на север.
setMapTypeId(MapTypeId) None Установить тип карты, которую нужно показать.
setOptions(MapOptions) None
setStreetView(StreetViewPanorama) None Привязать StreetViewPanorama к карте.
setTilt(number) None

Установить угол падения света на аэрофотоснимок (в градусах).

Применяется для типов карт SATELLITE и HYBRID.
setZoom(number) None Установить уровень масштаба карты.

Свойства Map()

Свойства Тип Описание
controls Array.<MVCArray.<Node>> Дополнительные контроллеры, добавляемые на карту.
mapTypes MapTypeRegistry Реестр экземпляров MapType по строковому ID.
overlayMapTypes MVCArray.<MapType> Другие типы карт для наложения.

События Map()

Событие Параметры Описание
bounds_changed None Инициируется при изменении границ видимой области.
center_changed None Инициируется при изменении свойства центра карты.
click MouseEvent Инициируется при单击 по карте.
dblclick MouseEvent Инициируется при двойном клике по карте.
drag None Инициируется при перетаскивании карты.
dragend None Инициируется при停止е перетаскивания карты.
dragstart None Инициируется при начале перетаскивания карты.
heading_changed None Инициируется при изменении свойства заголовка карты.
idle None Инициируется при空闲 карты после её поворота или масштабирования.
maptypeid_changed None Инициируется при изменении свойства mapTypeId.
mousemove MouseEvent Инициируется каждый раз, когда курсор мыши перемещается на контейнер карты.
mouseout MouseEvent Инициируется при выходе мыши из контейнера карты.
mouseover MouseEvent Инициируется при входе мыши в контейнер карты.
projection_changed None Инициируется при изменении проекции.
resize None Инициируется при изменении размера (div) карты.
rightclick MouseEvent Инициируется при правом клике по карте.
tilesloaded None Инициируется при завершении загрузки видимых блоков карты.
tilt_changed None Инициируется при изменении свойства наклона карты.
zoom_changed None Инициируется при изменении свойства масштаба карты.

Слой叠加

Конструктор/объект Описание
Marker Создание маркера. (Обратите внимание, что необходимо настроить отображение маркера)
MarkerOptions Опции для рендеринга маркера.
MarkerImage Представляет структуру изображения маркера или тени.
MarkerShape Определение формы маркера, используемой для определения clickable области (тип и координаты)。
Animation Определяет анимацию, которую можно воспроизвести на маркере (подъем или опускание).
InfoWindow Создание информационного окна.
InfoWindowOptions Опции для рендеринга информационного окна.
Polyline Создание ломаной линии (содержит путь и стиль контура).
PolylineOptions Опции для рендеринга ломаной линии.
Polygon Создание многоугольника (содержит путь и контур + стиль заливки).
PolygonOptions Опции для рендеринга многоугольника.
Rectangle Создание прямоугольника (содержит границы и контур + стиль заливки).
RectangleOptions Опции для рендеринга прямоугольника.
Circle Создание круга (содержит центр + радиус и контур + стиль заливки).
CircleOptions Опции для рендеринга круга.
GroundOverlay
GroundOverlayOptions
OverlayView
MapPanes
MapCanvasProjection

Событие

Конструктор/объект Описание
MapsEventListener

У него нет методов и конструктора.

Его экземпляры возвращаются из addListener() и addDomListener(), и в конечном итоге передаются back removeListener().
event Добавление/удаление/トリггинг监听еров событий.
MouseEvent Возвращает различные события мыши с карты и слоев.

Контроллер

Контроллер/объект Описание
MapTypeControlOptions Сохраняет опции для изменения контроллера (положение и стиль).
MapTypeControlStyle Определяет тип контроллера карты, который будет отображаться (выпадающее меню или кнопка).
OverviewMapControlOptions Опции для рендеринга контроллера обзорной карты (распахнутый или сложенный).
PanControlOptions Опции для рендеринга контроллера перемещения (положение).
RotateControlOptions Опции для рендеринга контроллера вращения (положение).
ScaleControlOptions Опции для рендеринга контроллера масштаба (положение и стиль).
ScaleControlStyle Определяет, какой тип масштаба контроллера будет отображаться.
StreetViewControlOptions Опции для рендеринга контроллера Pegman (положение).
ZoomControlOptions Опции для рендеринга контроллера масштабирования (положение и стиль).
ZoomControlStyle 规定要显示哪种缩放控件（大或小）。
Определяет, какой тип масштабного контроллера следует отображать (большой или маленький). ControlPosition