Урок - Карты в Google Maps API 3.

В этой части курса мы будем говорить о свойствах и методах Карт.

Карты 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) - изменение масштаба карты.