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

Главная » Курсы » Курс Google Maps 3, примеры использования. » Урок - Карты в Google Maps API 3.

Обучающий онлайн курс
Google Maps 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) - изменение масштаба карты.