В этой части курса мы будем говорить о свойствах и методах Карт.
Карты Google Maps API 3 создаются с помощью команды "new google.maps.Map(mapDiv:Node, opts?:MapOptions)":
var centerLatLng = new google.maps.LatLng(50.435132,30.55777); var mapOptions = { zoom: 10, mapTypeId: google.maps.MapTypeId.ROADMAP, center: centerLatLng } var map = new google.maps.Map(document.getElementById("map"), mapOptions);
При создании карты возможно задать следующие параметры:
- backgroundColor (string) - Цвет используемый для фона DIV-элементав котором расположена карта. Этот цвет виден только тогда, пока название не загружена пользовательская карта. Этот параметр возможно задать только во время создания карты.
- center (LatLng) - Обязательный параметр! Указывает центр карты.
- disableDefaultUI (boolean) - включает/отключает элементы управления (инициируемые по умолчанию). С помощью других опций включение/отключение возможно индивидуально.
- disableDoubleClickZoom (boolean) - включает/отключает увеличение и центрирование по двойному клику. По умолчанию включено.
- draggable (boolean) - если false, карту нельзя перемещять. Перемещение включено, по умолчанию.
- draggableCursor (string) - название или url изображения курсора над перетаскиваемыми объектами.
- draggingCursor (string) - название или url изображения курсора при перетаскивании объекта.
- heading (number) - the heading for aerial imagery in degrees measured clockwise from cardinal direction North. Headings are snapped to the nearest available angle for which imagery is available.
- keyboardShortcuts (boolean) - если false, отключается управление картой с клавиатуры. По умолчанию keyboardShortcuts равно true.
- mapMaker (boolean) - True if Map Maker tiles should be used instead of regular tiles.
- mapTypeControl (boolean) - при создании карты включает/выключает элементы управления картой.
- mapTypeControlOptions (MapTypeControlOptions) - установка элементов управления карты, при создании карты.
- mapTypeId (MapTypeId) - обязательный параметр, указывает тип карты.
- maxZoom (number) - максимальный уровень масштаба, который будет отображаться на карте.
- minZoom (number) - минимальный уровеь масштаба, который будет отображаться на карте.
- noClear (boolean) - если true, не очищать содержимое DIV-контейнера карты.
- overviewMapControl (boolean) - включает/отключает элемент управления Обзор(Overview).
- overviewMapControlOptions (OverviewMapControlOptions) - параметры для элемента управления Обзор(Overview).
- panControl (boolean) - включает/отключает элемент управления Pan.
- panControlOptions (PanControlOptions) - параметры для элемента управления Pan.
- rotateControl (boolean) - включает/отключает элемент управления Поворот(Rotate).
- rotateControlOptions (RotateControlOptions) - параметры для элемента управления Поворот(Rotate).
- scaleControl (boolean) - включает/отключает элемент управления Шкала(Scale ).
- scaleControlOptions (ScaleControlOptions) - параметры для элемента управления Шкала(Scale ).
- scrollwheel (boolean) - если false, отключается скролирование для увеличения/уменьшения масштаба карты. По умолчанию скролирование масштаба включено.
- streetView (StreetViewPanorama) - для отображения уличного просмотра (Street View) при указании на карте. Если есть указанная панорама, то по умолчанию отображается в DIV-элементе карты.
- streetViewControl (boolean) - первоначальная настрока для отображения элемента управления Маркер уличного просмотра(Street View Pegman). Этот элемент управления является частью пользовательского интерфейса по умолчанию и может быть установлен в false, когда нет необходимости уличного просмотра, например при отсутсвии отображения дорог..
- streetViewControlOptions (StreetViewControlOptions) - тут можно догадаться что такое streetViewControlOptions. =))
- styles (Array.<MapTypeStyle>) - стили для применения к каждому из типов карт по умолчанию. Обратите внимание, что стили будут применяться только к метками геометрии в Спутниково/Гибрид и Ландшафных режимах.
- tilt (number) - угол падения на карте, измеряется в градусах от плоскости окна до плоскости карты. В настоящее врмя поддерживаются два значения: 0 (отсутсвие угла падения) и 45 градусов. Доступно только в Спутниковой и Гибридной типах карта, в некоторых местах и при определенных уровнях масштабирования.
- zoom (number) - Обязательный параметр! Первоначальный масштаб.
- zoomControl (boolean) показать/скрыть элемент управления Масштаб(Zoom).
- zoomControlOptions (ZoomControlOptions) - параметры отображения элемента управления Масштаб (Zoom).
Методы Map-объекта:
- fitBounds(bounds:LatLngBounds) - указывает окно просмотра, для указанных границ.
- getBounds() - возвращает LatLngBounds-объект, границы просмотра в текущем окне. Если видно более одной копии мира, то диапозон по долготе будет от -180 до 180 градусов. Если карта не инициализована, или центр карты не установлен, то результат будет NULL или undefined.
- getCenter() - вернет LatLng-объект, позицию центра карты. Заметим, что LatLng-объект без обертки.
- getDiv() - вернет DIV-элемент в котором отображается карта.
- getHeading() - возвращает число, параметр компаса аэрофотоснимков.Измеряется в градусах от севера.
- getMapTypeId() - возвращает MapTypeId-объект или строку.
- getProjection() Projection Returns the current Projection. If the map is not yet initialized (i.e. the mapType is still null) then the result is null. Listen to projection_changed and check its value to ensure it is not null.
- getStreetView() - возвращает StreetViewPanorama-объект, по умолчанию вернет StreetViewPanorama-объект связанный с картой, или установленный с помощью метода setStreetView(). Изменения в streetViewControl-объекте карты будут отражены в панораме.
- getTilt() - возвращает число, угол наклона аэро снимков (доступно для Спутниковой и Гибридной карты) измеряется в градусах от плоскости окна на плоскости карты. Значение 0 указывает на отсутствие угла падения (без наклона), а 45 ° изображение будет возвращать значение 45.
- getZoom() - возвращает число, текущий масштаб карты.
- panBy(x:number, y:number) - указывает параметры изменения сдвига карты в пикселях. Если расстояние меньше высоты и ширины карты, то сдвиг будет анимированным. Обратите внимание, что координатная система увеличивается с запада на восток (для X значения) и с севера на юг(для Y значения).
- panTo(latLng:LatLng) - перейти к точке указаной в LatLng-объекте. Если точка находится в виджимой области то сдвиг будет анимированный.
- panToBounds(latLngBounds:LatLngBounds) - сдвинуть карту к минимальным границам, которые будут содержать границы указанные в LatLngBounds-объекте.
- setCenter(latlng:LatLng) - устанавливат центр карты в соответствии с указанным LatLng-объектом.
- setHeading(heading:number) - устанавливает компас для аэрофотосъемки. Отсчет в градусах от направления на Север.
- setMapTypeId(mapTypeId:MapTypeId|string) - сменить тип карты.
- setOptions(options:MapOptions) - установить параметры карты.
- setStreetView(panorama:StreetViewPanorama) - связывает Панораму(StreetViewPanorama) с картой. Указанная панорама переопределяет панораму созданную по умолчанию, для связи с внешней панорамой. Укажите NULL для возвращения к значению по умолчанию для текущей карты.
- setTilt(tilt:number) - устанавливает угол падения для аэрофотосъемки (только для Спутниковых и Гибридных типов карт) измеряется в градусах от плоскости окна к плоскости карты. Поддерживается только значения 0, что указывает на отсутствие угла падения (без наклона), и 45 указывает на наклон 45 градусов.
- setZoom(zoom:number) - изменение масштаба карты.
Параметр mapTypeControl. Скрытие переключения типа карт в Google Maps API 3.
Параметр mapTypeControlOption. Изменение переключателя типа карты в Google Maps API 3.
Параметр navigationControl. Скрытие переключения типа карт в Google Maps API 3.
Параметр mapTypeControlOption. Измнение внешнего вида панели навигации картой в Google Maps API 3.
Параметр scaleControl. Скрытие переключения типа карт в Google Maps API 3.
Параметр streetViewControl. Скрытие уличного просмотра карты в Google Maps API 3.