Профессиональный пакет API Карт Google
Те же замечательные карты плюс SLA, поддержка и контроль рекламы
Теперь API Карт Google интегрирован с загрузчиком AJAX API Google, который создает общее пространство имен для загрузки и использования AJAX API Google. Эта инфраструктура позволяет использовать дополнительное пространство имен google.maps.* для всех классов, методов и свойств, на данный момент используемых в API Карт Google, заменяя обычный префикс G этим пространством имен. Не беспокойтесь, существующее пространство имен G будет также поддерживаться.
Например, объект GMap2 в API Карт Google можно также определить как google.maps.Map2.
Обратите внимание, что в этом справочном руководстве рассмотрено только существующее пространство имен G.
Это самый важный класс в API Карт. Другие классы, описанные в этом справочном руководстве, сгруппированы по целям.
Чтобы создать карту, создайте экземпляр класса GMap2. Это основной класс в API. Все остальные классы лишь вспомогательные.
| Конструктор | Описание |
|---|---|
GMap2(container:Node,
opts?:GMapOptions)
|
Создает карту внутри указанного HTML-контейнера, который обычно представлен элементом DIV. Если набор типов карт не указан в необязательном аргументе opts.mapTypes, по умолчанию используется набор G_DEFAULT_MAP_TYPES. Если размер не указан в необязательном аргументе opts.size, используется размер контейнера container. Если аргумент opts.size указан, размер элемента контейнера изменяется соответствующим образом. Дополнительные сведения приведены в разделе class GMapOptions. Обратите внимание, что перед использованием карту нужно центрировать. Для этого нужно сразу же вызвать метод GMap2.setCenter(), чтобы инициализировать карту, созданную с помощью этого конструктора.
|
| Метод | Возвращаемое значение | Описание |
|---|---|---|
enableDragging()
|
None |
Включает перемещение карты (по умолчанию включено). |
disableDragging()
|
None |
Отключает перемещение карты. |
draggingEnabled()
|
Boolean |
Возвращает значение true, если перемещение карты включено. |
enableInfoWindow()
|
None |
Включает выполнение операций с информационном окном на карте (по умолчанию включено). |
disableInfoWindow()
|
None |
Закрывает информационное окно, если оно открыто, и отключает возможность открытия нового окна. |
infoWindowEnabled()
|
Boolean |
Возвращает значение true, если отображение информационного окна включено. |
enableDoubleClickZoom()
|
None |
Включает увеличение и уменьшение карты посредством двойного нажатия (по умолчанию включено). (Начиная с версии 2.58) |
disableDoubleClickZoom()
|
None |
Отключает увеличение и уменьшение карты посредством двойного нажатия. (Начиная с версии 2.58) |
doubleClickZoomEnabled()
|
Boolean |
Возвращает значение true, если масштабирование посредством двойного нажатия включено.(Начиная с версии 2.58) |
enableContinuousZoom()
|
None |
Включает непрерывное плавное масштабирование для некоторых браузеров (по умолчанию отключено). (Начиная с версии 2.58) |
disableContinuousZoom()
|
None |
Отключает непрерывное плавное масштабирование. (Начиная с версии 2.58) |
continuousZoomEnabled()
|
Boolean |
Возвращает значение true, если непрерывное плавное масштабирование включено.(Начиная с версии 2.58) |
enableGoogleBar()
|
None |
Включает GoogleBar, интегрированный элемент управления поиском, на карте. Если включен, он занимает место логотипа Powered by Google, используемого по умолчанию. Обратите внимание, что по умолчанию элемент управления поиском не включен. Обратите внимание, что на данный момент GoogleBar несовместим с плагином Google Планета Земля, используемым картами типа GMapType.G_SATELLITE_3D_MAP, поэтому он будет отключен, если этот плагин используется.(Начиная с версии 2.92) |
disableGoogleBar()
|
None |
Отключает GoogleBar, интегрированный элемент управления поиском. Если он отключен, то на занимаемом им месте показывается логотип Powered by Google, используемый по умолчанию. Обратите внимание, что по умолчанию этот элемент управления уже отключен. (Начиная с версии 2.92) |
enableScrollWheelZoom()
|
None |
Включает масштабирование с помощью колесика мыши. Обратите внимание, что по умолчанию оно отключено. (Начиная с версии 2.78) |
disableScrollWheelZoom()
|
None |
Отключает масштабирование с помощью колесика мыши. Обратите внимание, что по умолчанию оно отключено. (Начиная с версии 2.78) |
scrollWheelZoomEnabled()
|
Boolean |
Возвращает логическое значение, указывающее, включено ли масштабирование с помощью колесика мыши. (Начиная с версии 2.78) |
enablePinchToZoom()
|
None |
Включает масштабирование с помощью движения пальцев на iPhone и iPod. Обратите внимание, что по умолчанию оно отключено. (Начиная с версии 2.143) |
disablePinchToZoom()
|
None |
Отключает масштабирование с помощью движения пальцев на iPhone и iPod. Обратите внимание, что по умолчанию оно отключено. (Начиная с версии 2.143) |
pinchToZoomEnabled()
|
Boolean |
Возвращает логическое значение, указывающее, включено ли масштабирование с помощью движения пальцев. (Начиная с версии 2.143) |
getDefaultUI()
|
Object |
Возвращает объект GMapUIOptions, содержащий параметры и элементы пользовательского интерфейса, используемые по умолчанию для объекта карты, беря за основу интерфейс maps.google.com.
(Начиная с версии 2.147) |
setUIToDefault()
|
None |
Добавляет параметры и элементы пользовательского интерфейса, используемые по умолчанию и указанные в методе getDefaultUI(), для объекта карты.
(Начиная с версии 2.147) |
setUI(ui:GMapUIOptions)
|
None |
Добавляет параметры и элементы пользовательского интерфейса, указанные в параметре ui, представляющем измененную копию возвращенного методом getDefaultUI() объекта.(Начиная с версии 2.147) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
addControl(control:GControl,
position?:GControlPosition)
|
None |
Добавляет элемент управления на карту. Положение на карте определяется необязательным аргументом position. Если аргумент не указан, используется положение по умолчанию, определенное в методе GControl.getDefaultPosition(). Экземпляр элемента управления можно добавить на карту только один раз. |
removeControl(control:GControl)
|
None |
Удаляет элемент управления с карты. Если элемент не добавлен, не выполняет никаких действий. |
getContainer()
|
Node |
Возвращает объект DOM, содержащий карту. Используется в GControl.initialize(). |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
getMapTypes()
|
GMapType[] |
Возвращает массив типов, зарегистрированных для этой карты. |
getCurrentMapType()
|
GMapType |
Возвращает выбранный тип карты. |
setMapType(type:GMapType)
|
None |
Выбирает указанный тип карты. Этот тип должен быть известен карте. См. описание конструктора и метода addMapType(). |
addMapType(type:GMapType)
|
None |
Добавляет новый тип для карты. Определение пользовательских типов карт описано в разделе GMapType. |
removeMapType(type:GMapType)
|
None |
Удаляет тип для карты. Удаляет кнопки, отображаемые с помощью классов GMapTypeControl или GHierarchicalMapTypeControl, и вызывает событие removemaptype. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
isLoaded()
|
Boolean |
Возвращает значение true, если после создания карта была инициализирована с помощью метода setCenter(). |
getCenter()
|
GLatLng |
Возвращает географические координаты центральной точки области просмотра карты. |
getBounds()
|
GLatLngBounds |
Возвращает географические координаты видимой прямоугольной области просмотра карты. |
getBoundsZoomLevel(bounds:GLatLngBounds)
|
Number |
Возвращает коэффициент масштаба, при котором показывается только указанная прямоугольная область просмотра карты. Этот коэффициент определяется для выбранного типа карты. Если тип не выбран, используется первый из списка типов. |
getSize()
|
GSize |
Возвращает размер видимой области просмотра карты в пикселях. |
getZoom()
|
Number |
Возвращает используемый коэффициент масштабирования. |
getDragObject()
|
GDraggableObject |
Возвращает используемый картой перетаскиваемый объект. (Начиная с версии 2.93) |
getEarthInstance(callback:Function(instance: GEPlugin))
|
None |
Получает экземпляр плагина браузера Google Планета Земля, прикрепленный к карте, и вызывает переданную функцию обратного вызова по готовности получения команд, при этом передавая экземпляр плагина (объект GEPlugin) в качестве параметра.
Эта функция обратного вызова может быть вызвана сразу, если уже был создан экземпляр плагина посредством указания типа карты Google Планета Земля с помощью метода GMap2.setMapType(G_SATELLITE_3D_MAP). Если экземпляр еще не создан, вызов метода getEarthInstance приведет к инициализации плагина Google Планета Земля. (Именно в связи с асинхронным поведением этому методу требуется функция обратного вызова.)
Примечание. Если при инициализации произойдет ошибка, функция обратного вызова передаст параметр null.
Обратите внимание, что пока экземпляр плагина не создан, тип карты Планета Земля не будет установлен в качестве текущего. Для этого явно вызовите метод GMap2.setMapType(G_SATELLITE_3D_MAP) или позвольте пользователю выбрать этот тип карты с помощью объекта MapTypeControl. Информацию об использовании объекта GEPlugin можно найти в Руководстве для разработчиков по API Google Планета Земля.(Начиная с версии 2.113) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
setCenter(center:GLatLng,
zoom?:Number,
type?:GMapType)
|
None |
Центрирует область просмотра карты по указанной точке. Дополнительно устанавливает коэффициент масштаба и тип карты. Этот тип должен быть известен карте. См. описание конструктора и метода addMapType(). Этот метод нужно вызывать после создания, чтобы установить начальное состояние карты. Запрещается вызывать методы созданного объекта GMap2 до вызова этой функции.
|
panTo(center:GLatLng)
|
None |
Изменяет центральную точку карты на указанную. Если в текущей области просмотра карты эта точка видна, изменение выполняется в виде плавной анимации. |
panBy(distance:GSize)
|
None |
Выполняет анимированное панорамирование на указанное расстояние в пикселях. |
panDirection(dx:one of -1 0 +1,
dy:one of -1 0 +1)
|
None |
Выполняет анимированное панорамирование на половину ширины карты в указанных направлениях. +1 означает вправо и вниз, а -1 – влево и вверх. |
setZoom(level:Number)
|
None |
Устанавливает указанное значение коэффициента масштабирования. |
zoomIn(latlng?:GLatLng,
doCenter?:Boolean,
doContinuousZoom?:Boolean)
|
None |
Увеличивает коэффициент масштабирования до следующего значения. Если указан необязательный аргумент latlng, карта попытается сохранить это местоположение при увеличении карты. (Обратите внимание, что местоположение latlng присутствует на уменьшенной карте.) Если указан необязательный аргумент doCenter, карта будет центрирована в указанной точке latlng.
|
zoomOut(latlng?:GLatLng,
doContinuousZoom?:Boolean)
|
None |
Уменьшает коэффициент масштабирования до предыдущего значения. Если указан аргумент latlng, карта останется в области указанной точки. Если аргумент doContinuousZoom принимает значение true, будет выполнено непрерывное масштабирование при ее уменьшении. |
savePosition()
|
None |
Сохраняет текущее положение карты и коэффициент масштабирования для дальнейшего вызова метода returnToSavedPosition(). |
returnToSavedPosition()
|
None |
Восстанавливает область просмотра карты, сохраненную с помощью метода savePosition(). |
checkResize()
|
None |
Уведомляет карту об изменении размера ее контейнера. Вызывайте этот метод при изменении объекта контейнера DOM. Таким образом, карта будет подстроена под нужный размер. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
addOverlay(overlay:GOverlay)
|
None |
Добавляет наложение на карту и вызывает событие addoverlay. |
removeOverlay(overlay:GOverlay)
|
None |
Удаляет наложение на карте. Не стоит пытаться удалить наложение, отсутствующее на карте. При успешном вызове возникает событие removeoverlay. |
clearOverlays()
|
None |
Удаляет все наложения на карте и вызывает событие clearoverlays. |
getPane(pane:GMapPane)
|
Node |
Возвращает элемент DIV, содержащий объект в слое, определенном аргументом pane. Используется экземплярами класса GOverlay в методе GOverlay.initialize() для их отображения на карте. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
openInfoWindow(latlng:GLatLng,
node:Node,
opts?:GInfoWindowOptions)
|
None |
Открывает простое информационное окно в указанной точке. Панорамирует карту, чтобы полностью отображалось открытое информационное окно. Содержание информационного окна указывается в виде узла DOM. |
openInfoWindowHtml(latlng:GLatLng,
html:String,
opts?:GInfoWindowOptions)
|
None |
Открывает простое информационное окно в указанной точке. Панорамирует карту, чтобы полностью отображалось открытое информационное окно. Содержание информационного окна указывается в виде текста HTML. |
openInfoWindowTabs(latlng:GLatLng,
tabs:GInfoWindowTab[],
opts?:GinfoWindowOptions)
|
None |
Открывает информационное окно с вкладками в указанной точке. Панорамирует карту, чтобы полностью отображалось открытое информационное окно. Содержание информационного окна указывается в виде узлов DOM. |
openInfoWindowTabsHtml(latlng:GLatLng,
tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Открывает информационное окно с вкладками в указанной точке. Панорамирует карту, чтобы полностью отображалось открытое информационное окно. Содержание информационного окна указывается в виде текста HTML. |
showMapBlowup(latlng:GLatLng,
opts?:GInfoWindowOptions)
|
None |
Открывает информационное окно в указанной точке крупным планом на карте. |
updateInfoWindow(tabs:GInfoWindowTab[],
onupdate?:Function)
|
None |
Обновляет содержание открытого объекта GInfoWindow, не изменяя его положение. Размер окна подстраивается под новое содержание. Необязательная функция обратного вызова onupdate вызывается при изменении содержания информационного окна.
(Начиная с версии 2.85) |
updateCurrentTab(modifier:Function,
onupdate?:Function)
|
None |
Обновляет выбранную вкладку, изменяя размер объекта GInfoWindow, но не изменяя его положение. Функция modifier используется для изменения выбранной вкладки и передает объект GInfoWindowTab в качестве аргумента. Необязательная функция обратного вызова onupdate вызывается при отображении нового содержания информационного окна.(Начиная с версии 2.85) |
closeInfoWindow()
|
None |
Закрывает открытое информационное окно. |
getInfoWindow()
|
GInfoWindow |
Возвращает объект информационного окна этой карты. Если оно еще не существует, оно создается, но не отображается. На эту операцию метод enableInfoWindow() не влияет. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
fromContainerPixelToLatLng(pixel:GPoint)
|
GLatLng |
Рассчитывает географические координаты точки, координаты которой указаны в пикселях в элементе DOM, содержащем карту на странице. Этот метод пригодится при реализации взаимодействия пользовательских элементов управления с картой. |
fromLatLngToContainerPixel(latlng:GLatLng)
|
GPoint |
Рассчитывает пиксельные координаты точки в элементе DOM, содержащем карту на странице, по ее географическим координатам.
(Начиная с версии 2.100) |
fromLatLngToDivPixel(latlng:GLatLng)
|
GPoint |
Рассчитывает пиксельные координаты точки в элементе DOM, содержащем перетаскиваемую карту, по ее географическим координатам. Этот метод пригодится для изменения положения пользовательского наложения при реализации для него метода GOverlay.redraw(). |
fromDivPixelToLatLng(pixel:GPoint)
|
GLatLng |
Рассчитывает географические координаты точки по ее пиксельным координатам в элементе DIV, содержащем перетаскиваемую карту. Этот метод пригодится при реализации взаимодействия с пользовательскими наложениями, не расширяющими интерфейс GOverlay. Если искомый результат не получен, попробуйте использовать метод fromContainerPixelToLatLng. |
| Событие | Описание |
|---|---|
addmaptype(type:GMapType)
|
Это событие вызывается при добавлении типа для карты. |
removemaptype(type:GMapType)
|
Это событие вызывается при удалении типа для карты. |
click(overlay:GOverlay,
latlng:GLatLng,
overlaylatlng:GLatLng)
|
Это событие вызывается при нажатии пользователя на карту с помощью мыши. Событие click передает аргументы, зависящие от контекста нажатия и того, было ли оно сделано на наложении, которое можно активировать нажатием. Если нет, то аргумент overlay принимает значение null, а аргумент latlng содержит географические координаты нажатой точки. При нажатии пользователем на наложение, которое является clickable (например, GMarker, GPolygon, GPolyline или GInfoWindow) аргумент overlay содержит объект наложения, а аргумент overlaylatlng – координаты нажатого объекта. Кроме того, событие click также вызывается на самом наложении.
|
dblclick(overlay:GOverlay,
latlng:GLatLng)
|
Это событие вызывается при двойном нажатии на карте. Обратите внимание, что это событие не вызывается при двойном нажатии на маркере или другом наложении, которое можно активировать нажатием. Географические координаты дважды нажатой точки передаются в аргументе latlng. Аргумент overlay всегда принимает значение null.
(Начиная с версии 2.83) |
singlerightclick(point:GPoint,
src:Element,
overlay?:GOverlay)
|
Это событие вызывается, если в контейнере карты возникло событие DOM contextmenu. Если нажатие правой кнопкой мыши выполнено на маркере или другом наложении, которое можно активировать нажатием, оно передается в обработчик событий в аргументе overlay. Пиксельные координаты (в элементе DOM, содержащем карту) нажатой правой кнопкой мыши точки и исходный элемент события DOM передаются в аргументах point и src. Обратите внимание, что если масштабирование включается по двойному нажатию левой и правой кнопки мыши, карта уменьшается и событие singlerightclick не вызывается. Однако, если масштабирование по двойному нажатию отключено, вызываются оба события singlerightclick.(Начиная с версии 2.84) |
movestart()
|
Это событие вызывается в начале изменения области просмотра карты. Это может произойти при перетаскивании, в случае чего также вызывается событие dragstart, или при вызове метода изменения области просмотра карты. |
move()
|
Это событие вызывается (вероятно неоднократно) при изменении области просмотра карты. |
moveend()
|
Это событие вызывается по окончании изменения области просмотра карты. |
zoomend(oldLevel:Number,
newLevel:Number)
|
Это событие вызывается при изменении коэффициента масштабирования на новое значение. Обработчик событий получает предыдущее и новое значения в качестве аргументов. |
maptypechanged()
|
Это событие вызывается при выборе другого типа карты. |
infowindowopen()
|
Это событие вызывается при открытии информационного окна. |
infowindowbeforeclose()
|
Это событие вызывается перед закрытием информационного окна. (Начиная с версии 2.83) |
infowindowclose()
|
Это событие вызывается при закрытии информационного окна. Перед этим событием вызывается событие infowindowbeforeclose. Если открытое окно повторно открывается в другой точке путем вызова метода openInfoWindow*(), события вызываются в следующем порядке: infowindowbeforeclose, infowindowclose и infowindowopen. |
addoverlay(overlay:GOverlay)
|
Это событие вызывается при добавлении одного объекта наложения на карту с помощью метода addOverlay(). Новый объект передается обработчику событий в качестве аргумента overlay. |
removeoverlay(overlay:GOverlay)
|
Это событие вызывается при удалении одного наложения с карты с помощью метода removeOverlay(). Удаленный объект передается обработчику событий в качестве аргумента overlay. |
clearoverlays()
|
Это событие вызывается при удалении всех наложений с карты с помощью метода clearOverlays(). |
mouseover(latlng:GLatLng)
|
Это событие вызывается, когда пользователь наводит курсор мыши на карту. |
mouseout(latlng:GLatLng)
|
Это событие вызывается, когда пользователь уводит курсор мыши за пределы карты. |
mousemove(latlng:GLatLng)
|
Это событие вызывается, когда пользователь двигает по карте курсор мыши. |
dragstart()
|
Это событие вызывается в начале перетаскивания карты. |
drag()
|
Это событие неоднократно вызывается при перетаскивании карты. |
dragend()
|
Это событие вызывается по окончании перетаскивания карты. |
load()
|
Это событие вызывается по завершении создания карты. Метод isLoaded() вернет значение true. Это означает, что инициализированы положение, масштабирование и тип карты, однако загрузка изображений фрагментов может быть еще не закончена.(Начиная с версии 2.52) |
tilesloaded()
|
Это событие вызывается по завершении загрузки всех фрагментов.
(Начиная с версии 2.140) |
Объект GBounds представляет собой область на карте в пиксельных координатах. Обратите внимание, что прямоугольную область в географических координатах представляет объект GLatLngBounds.
| Конструктор | Описание |
|---|---|
GBounds(points:GPoint[])
|
Создает прямоугольную область, содержащую все указанные точки points. |
| Свойство | Тип | Описание |
|---|---|---|
minX
|
Number |
Координата x левой границы прямоугольной области. |
minY
|
Number |
Координата y верхней границы прямоугольной области. |
maxX
|
Number |
Координата x правой границы прямоугольной области. |
maxY
|
Number |
Координата y нижней границы прямоугольной области. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
toString()
|
String |
Возвращает строку, содержащую координаты левого верхнего и нижнего правого углов прямоугольной области, разделенные запятой и заключенные в скобки. |
equals(other:GBounds)
|
Boolean |
Возвращает значение true, если все параметры этого прямоугольной области совпадают с параметрами указанного объекта. (Начиная с версии 2.98) |
mid()
|
GPoint |
Возвращает пиксельные координаты центра прямоугольной области. (Начиная с версии 2.88) |
min()
|
GPoint |
Возвращает пиксельные координаты левого верхнего угла прямоугольной области. |
max()
|
GPoint |
Возвращает пиксельные координаты правого нижнего угла прямоугольной области. |
containsBounds(other:GBounds)
|
Boolean |
Возвращает значение true, если указанная прямоугольная область входит в эту область. |
containsPoint(point:GPoint)
|
Boolean |
Возвращает значение true, если прямоугольная область (включая границы) содержит точку с указанными пиксельными координатами.(Начиная с версии 2.88) |
extend(point:GPoint)
|
None |
Увеличивает область таким образом, чтобы указанная точка оказалась внутри нее. |
Эта функция определяет, можно ли использовать API карт в текущем браузере.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GBrowserIsCompatible()
|
Boolean |
Возвращает значение true, если используемый браузер поддерживает библиотеку API карт. |
Этот класс превращает элемент DOM в перетаскиваемый объект. Статические члены, предназначенные для изменения курсоров перетаскивания, влияют на все последовательно созданные перетаскиваемые объекты, такие как карта, ползунок управления масштабом и прямоугольные области просмотра карты. Члены экземпляров влияют только на один определенный экземпляр. Например, перед созданием карты можно вызвать методы GDraggableObject.setDraggableCursor('default') и GDraggableObject.setDraggingCursor('move'), чтобы получить стиль, который применялся до выпуска версии 2.56 API. Вместо этого можно использовать конструктор карты для задания стиля курсора объекта DraggableObject. Допустимые значения стилей курсоров представлены в спецификации W3C CSS.
| Конструктор | Описание |
|---|---|
GDraggableObject(src:Node,
opts?:GDraggableObjectOptions)
|
Устанавливает обработчики событий таким образом, чтобы можно было перетаскивать исходный элемент. Необязательные параметры левой верхней границы элемента задают его положение. Необязательный контейнер выполняет роль ограничивающего прямоугольника.
(Начиная с версии 2.59) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GDraggableObject.setDraggableCursor(cursor:String)
|
None |
Устанавливает перетаскиваемый курсор для последовательно созданных перетаскиваемых объектов. (Начиная с версии 2.59) |
GDraggableObject.setDraggingCursor(cursor:String)
|
None |
Устанавливает курсор для перетаскивания последовательно созданных перетаскиваемых объектов. (Начиная с версии 2.59) |
GDraggableObject.getDraggingCursor()
|
String |
Возвращает используемый на карте курсор перетаскивания. Если он не задан с помощью статического метода setDraggingCursor(), то этот метод возвращает курсор, по умолчанию используемый картой для элементов управления и маркеров.
(Не рекомендуется начиная версии с 2.164) |
GDraggableObject.getDraggableCursor()
|
String |
Возвращает используемый на карте перетаскиваемый курсор. Если он не задан с помощью статического метода setDraggableCursor(), то этот метод возвращает курсор, по умолчанию используемый картой для элементов управления и маркеров.
(Не рекомендуется начиная версии с 2.164) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
setDraggableCursor(cursor:String)
|
None |
Устанавливает курсор, показываемый, когда курсор мыши находится над перетаскиваемым объектом. (Начиная с версии 2.59) |
setDraggingCursor(cursor:String)
|
None |
Устанавливает курсор, показываемый, когда удерживается кнопка мыши при перемещении перетаскиваемого объекта. (Начиная с версии 2.59) |
moveTo(point:GPoint)
|
None |
Перемещает объект GDraggableObject в указанную точку в абсолютной системе отсчета. Положение задается в пиксельных координатах относительно родительского объекта. Этот метод использует систему координат DOM, в которой координата X увеличивается справа налево, а координата Y – сверху вниз.(Начиная с версии 2.89) |
moveBy(size:GSize)
|
None |
Перемещает объект GDraggableObject на указанный сдвиг. Этот метод использует систему координат DOM, в которой ширина увеличивается справа налево, а высота – сверху вниз.(Начиная с версии 2.89) |
| Событие | Описание |
|---|---|
mousedown()
|
Это событие вызывается в ответ на событие DOM mousedown. Обработка этого события препятствует выполнению действия события DOM mousedown по умолчанию.(Начиная с версии 2.84) |
mouseup()
|
Это событие вызывается в ответ на событие DOM mouseup для перетаскиваемого объекта. Обработка этого события препятствует выполнению действия события DOM mouseup по умолчанию.(Начиная с версии 2.84) |
click()
|
Это событие вызывается при нажатии на перетаскиваемый объект. (Начиная с версии 2.84) |
dragstart()
|
Это событие вызывается в начале перемещения перетаскиваемого объекта (когда пользователь инициализирует перемещение, нажав на перетаскиваемый объект и перемещая его). (Начиная с версии 2.84) |
drag()
|
Неоднократно вызывается при перемещении перетаскиваемого объекта пользователем. (Начиная с версии 2.84) |
dragend()
|
Это событие вызывается по окончании перемещения перетаскиваемого объекта (когда пользователь закончил перемещение). (Начиная с версии 2.84) |
Этот класс предоставляет необязательные аргументы в конструктор GDraggableObject. У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
left
|
Number |
Левая координата начального положения объекта. (Начиная с версии 2.59) |
top
|
Number |
Верхняя координата начального положения объекта. (Начиная с версии 2.59) |
container
|
Node |
Элемент DOM, который будет выполнять роль ограничивающего прямоугольника для перетаскиваемого объекта. (Начиная с версии 2.59) |
draggableCursor
|
String |
Курсор, который нужно показывать при наведении курсора мыши. (Начиная с версии 2.59) |
draggingCursor
|
String |
Курсор, который нужно показывать при перетаскивании. (Начиная с версии 2.59) |
delayDrag
|
Boolean |
По умолчанию событие dragstart вызывается при возникновении события DOM mousedown в перетаскиваемом элементе DOM. Аналогично событие dragend вызывается при возникновении события DOM mouseup. При указании значения true события перетаскивания не вызываются до смещения курсора мыши с положения, где было вызвано событие mousedown или mouseup. По умолчанию это свойство принимает значение false.
(Не рекомендуется начиная с версии 2.146) |
У объекта GInfoWindow нет конструктора. Он создается картой. Доступ к нему осуществляется с помощью метода GMap2.getInfoWindow().
| Метод | Возвращаемое значение | Описание |
|---|---|---|
selectTab(index:Number)
|
None |
Выбирает вкладку с указанным индексом. Это действие аналогично нажатию на соответствующей вкладке. |
hide()
|
None |
Скрывает информационное окно. ПРИМЕЧАНИЕ. При этом информационное окно не закрывается. Его можно снова сделать видимым с помощью метода show(). |
show()
|
None |
Показывает информационное окно, если оно скрыто. |
isHidden()
|
Boolean |
Возвращает значение true, если информационное окно скрыто, в том числе, когда оно закрыто. |
reset(latlng:GLatLng,
tabs:GInfoWindowTab[],
size:GSize,
offset?:GSize,
selectedTab?:Number)
|
None |
Сбрасывает состояние информационного окна. Все аргументы могут принимать значение null. В этом случае значения не изменяются. |
getPoint()
|
GLatLng |
Возвращает географическую точку, к которой привязано информационное окно. Эта точка лежит на верхней границе окна. Она определяется по модулю сдвига в пикселях. |
getPixelOffset()
|
GSize |
Возвращает сдвиг в пикселях верхней границы информационного окна относительно точки карты, к географическим координатам которой привязано информационное окно. |
getSelectedTab()
|
Number |
Возвращает индекс выбранный вкладки, начиная с 0. |
getTabs()
|
GInfoWindowTabs[] |
Возвращает массив вкладок этого информационного окна. (Начиная с версии 2.59) |
getContentContainers()
|
Node[] |
Возвращает массив узлов DOM, хранящих содержание вкладок этого информационного окна. (Начиная с версии 2.59) |
enableMaximize()
|
None |
Включает максимизацию информационного окна. В этом случае окно занимает большую часть карты с содержанием, указанным в свойствах maxContent и maxTitle объекта GInfoWindowOptions. Чтобы методы enableMaximize() и disableMaximize выполнялись, информационное окно нужно открыть с параметром maxContent или maxTitle. Для информационного окна, открытого с параметром maxContent или maxTitle, максимизация включена по умолчанию.
(Начиная с версии 2.93) |
disableMaximize()
|
None |
Отключает максимизацию информационного окна. Его нужно открыть с параметром maxContent или maxTitle. Обратите внимание, что если информационное окно открыто, эта функция удалит кнопку максимизации, но не вернет его в свернутое состояние.
(Начиная с версии 2.93) |
maximize()
|
None |
Максимизирует информационное окно. Оно должно быть открыто с параметром maxContent или maxTitle, и для него не должна быть отключена максимизация с помощью метода disableMaximize.
(Начиная с версии 2.93) |
restore()
|
None |
Восстанавливает состояние информационного окна по умолчанию (отличное от максимизированного). Его нужно открыть с параметром maxContent или maxTitle.(Начиная с версии 2.93) |
| Событие | Описание |
|---|---|
closeclick()
|
Это событие вызывается при нажатии кнопки закрытия. |
maximizeclick()
|
Сигнализирует о том, что информационное окно будет максимизировано. (Начиная с версии 2.93) |
maximizeend()
|
Сигнализирует о завершении максимизации информационного окна. (Начиная с версии 2.93) |
restoreclick()
|
Сигнализирует о том, что состояние информационного окна (отличное от максимизированного) будет восстановлено. (Начиная с версии 2.93) |
restoreend()
|
Сигнализирует о завершении восстановления состояния информационного окна в отличное от максимизированного.
(Начиная с версии 2.93) |
Экземпляры этого класса используются в аргументе opts? методов openInfoWindow(), openInfoWindowHtml(), openInfoWindowTabs(), openInfoWindowTabsHtml(), ряде методов bindInfoWindow*() и методе showMapBlowup() классов GMap2 и GMarker. У этого класса нет конструктора. Его экземпляры создаются в виде литералов объектов JavaScript.
В соответствии с названием этого класса все свойства являются необязательными.
| Свойство | Тип | Описание |
|---|---|---|
selectedTab
|
Number |
Выбирает вкладку с указанным индексом (начиная с 0) вместо первой вкладки (с индексом 0). |
maxWidth
|
Number |
Максимальная ширина содержания информационного окна в пикселях. |
noCloseOnClick
|
Boolean |
Определяет, должно ли закрываться информационное окно по нажатию на карте не в точке маркера. Если принимает значение true, по нажатию на карте информационное окно не закрывается. false является значением по умолчанию.
(Начиная с версии 2.83) |
onOpenFn
|
Function |
Вызывается после открытия информационного окна и отображения содержания. |
onCloseFn
|
Function |
Вызывается при закрытии информационного окна. |
zoomLevel
|
Number |
Относится только к методу showMapBlowup(). Коэффициент масштабирования увеличенной карты в информационном окне. |
mapType
|
GMapType |
Относится только к методу showMapBlowup(). Тип увеличенной карты в информационном окне. |
maxContent
|
String |
Определяет содержание, которое нужно показывать при максимизации информационного окна. Содержание может быть строкой HTML или элементом HTML DOM.
(Начиная с версии 2.93) |
maxTitle
|
String |
Определяет фрагмент, который нужно показывать при максимизации информационного окна. Содержание может быть строкой HTML или элементом HTML DOM.
(Начиная с версии 2.93) |
pixelOffset
|
GSize |
Определяет расстояние в пикселях в направлениях вверх (x) и вправо (y), на которое нужно переместить информационное окно относительно указанной точки GLatLng.
(Начиная с версии 2.98) |
Массив экземпляров этого класса можно передавать в качестве аргумента tabs в методы GMap2.openInfoWindowTabs(), GMap2.openInfoWindowTabsHtml(), GMarker.openInfoWindowTabs(), GMarker.openInfoWindowTabsHtml() и ряд методов GMarker.bindInfoWindow*(). Если массив содержит несколько элементов, информационное окно будет содержать вкладки. Каждый объект InfoWindowTab содержит два элемента: content определяет содержание информационного окна с выбранной вкладкой и label определяет название этой вкладки. Свойства передаются в конструктор в качестве аргументов. Для методов openInfoWindowTabs() элемент content представляет собой узел DOM. В то время как для методов openInfoWindowTabsHtml() элемент content содержит строку HTML.
| Конструктор | Описание |
|---|---|
GInfoWindowTab(label:String,
content:Node or String)
|
Для информационного окна создает структуру вкладок, которую можно передавать в качестве аргумента tabs в методы openInfoWindowTabs*(). |
Создавайте экземпляры этого класса, чтобы задавать действия для клавиш клавиатуры. Клавишам назначены те же действия, что и в приложении карт.
| Клавиши | Действие |
|---|---|
| Стрелки вверх, вниз, вправо, влево | Непрерывно перемещает карту при нажатии клавиши. Чтобы переместить карту по диагонали, нужно нажать две клавиши одновременно. |
| Page Down, Page Up, Home, End | Панорамирует карту на 3/4 от ее размера в указанном направлении с приятной анимацией. Аналогичны действиям кнопок со стрелками в объектах GLargeMapControl и GSmallMapControl. |
| +, - | Увеличивает или уменьшает коэффициент масштабирования. Соответствуют кнопкам + и - в объектах GLargeMapControl и GSmallMapControl. |
| Конструктор | Описание |
|---|---|
GKeyboardHandler(map:GMap2)
|
Устанавливает обработчик событий для карты, переданной в качестве аргумента. |
Это пространство имен содержит вспомогательные методы, которые пригодятся для определения настроек языков, используемых в приложении. Настройки языка часто задаются в настройках браузера, но их можно переопределить в скрипте загрузки API Карт с помощью параметра hl. (Дополнительная информация представлена в статье Локализация API Карт Google.)
Примечание. Поскольку двунаправленные языки, такие как арабский и иврит, влияют на расположение объекта GInfoWindow, эти языки выбираются только при явном запросе соответствующего им параметра hl или путем добавления параметра allow_bidi=true к запросу начальной загрузки API.
Дополнительную информацию о BCP 47 можно найти в документации W3.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GLanguage.getLanguageCode()
|
String |
Возвращает код языка BCP 47, используемый в приложении, например en или pt-BR. (Начиная с версии 2.148) |
GLanguage.isRtl()
|
boolean |
Возвращает значение true, если пользовательский интерфейс приложения настроен под двунаправленные языки, такие как арабский и иврит.(Начиная с версии 2.148) |
Объект GLatLng представляет собой точку с географическими координатами долготы и широты.
Обратите внимание, что, несмотря на то что на обычных проекциях карт долгота привязывается к координате x карты, а широта – к координате y, в начале пишется широта, а только потом долгота, как это принято в картографии.
Обратите внимание, что невозможно изменить координаты объекта GLatLng. Если требуется рассчитать другую точку, нужно создать новый объект.
| Конструктор | Описание |
|---|---|
GLatLng(lat:Number,
lng:Number,
unbounded?:Boolean)
|
Обратите внимание на порядок широты и долготы. Если флажок unbounded принимает значение true, то будут использоваться передаваемые числа. В противном случае широта будет преобразована таким образом, чтобы она была от -90 до +90 градусов, а долгота – от -180 до180 градусов. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
lat()
|
Number |
Возвращает координату широты в градусах в виде числа от -90 до +90. Если в конструкторе установлен флажок unbounded, координата может не попадать в этот интервал. |
lng()
|
Number |
Возвращает координату долготы в градусах в виде числа от -180 до +180. Если в конструкторе установлен флажок unbounded, координата может не попадать в этот интервал. |
latRadians()
|
Number |
Возвращает координату широты в радианах в виде числа от -PI/2 до +PI/2. Если в конструкторе установлен флажок unbounded, координата может не попадать в этот интервал. |
lngRadians()
|
Number |
Возвращает координату долготы в радианах в виде числа от -PI до +PI. Если в конструкторе установлен флажок unbounded, координата может не попадать в этот интервал. |
equals(other:GLatLng)
|
Boolean |
Возвращает значение true, если компоненты точек совпадают в определенных пределах округления. |
distanceFrom(other:GLatLng)
|
Number |
Возвращает расстояние до указанного местоположения в метрах. Приближенно Земля считается сферой, поэтому погрешность определения расстояния может достигать 0.3 процента. См. ниже. (Не рекомендуется начиная с версии 2.89) |
distanceFrom(other:GLatLng,
radius?:Number)
|
Number |
Возвращает расстояние до указанного местоположения в метрах. По умолчанию это расстояние рассчитывается с учетом принятого радиуса Земли по экватору 6 378 137 метров. Земля приблизительно считается сферой, поэтому погрешность определения расстояния может достигать 0,3 процента, особенно на полюсах. Чтобы рассчитать расстояние между координатами radius не на Земле, а на других сферах, следует передать дополнительный аргумент GLatLng.(Начиная с версии 2.89) |
toUrlValue()
|
String |
Эта версия метода не рекомендуется. Следует использовать пересмотренную версию (см. далее), в которой передается необязательный параметр precision.(Не рекомендуется начиная с версии 2.78) |
toUrlValue(precision?:Number)
|
String |
Возвращает строку, представляющую местоположение в формате, подходящем для использования в качестве значения параметра URL (значения разделены запятой и не содержат пробелов). По умолчанию значение определяется с точностью до шестого знака, что соответствует разрешению 11 сантиметров. Чтобы снизить нагрузку на сервер, можно указать меньшую точность с помощью необязательного параметра precision. Обратите внимание, что параметр
precision доступен только начиная с версии 2.78.(Начиная с версии 2.78) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GLatLng.fromUrlValue(latlng:String)
|
GLatLng |
Преобразует указанное значение String, содержащее широту и долготу, в объект GLatLng. Передаваемая строка должна иметь формат "широта,долгота". Пробелы между широтой и долготой будут проигнорированы. Этот метод вернет значение GLatLng с точностью до шестого знака.(Начиная с версии 2.78) |
Эти свойства нужны только для обратной совместимости с функциями обработчика событий версии 1. Их не нужно использовать.
Эти свойства совпадают со значениями, возвращаемыми родительскими методами lng() и lat(), благодаря чему объекты GLatLng появляются вместо объектов GPoint в соответствии с ожиданиями клиента версии 1. Это нужно при использовании объектов GLatLng в сведениях о событии (т. е. в аргументах функций обработчика событий). В отличие от оболочек методов в текущей инфраструктуре невозможно создавать оболочки событий.
| Свойство | Тип | Описание |
|---|---|---|
x
|
Number |
Урезано. |
y
|
Number |
Урезано. |
Экземпляр класса GLatLngBounds представляет собой прямоугольную область в географических координатах, включая область, пересекающую меридиан 180 градусов.
| Конструктор | Описание |
|---|---|
GLatLngBounds(sw?:GLatLng,
ne?:GLatLng)
|
Создает прямоугольную область по точкам в юго-западном и северо-восточном углах. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
equals(other:GLatLngBounds)
|
Boolean |
Возвращает значение true, если все параметры прямоугольных областей совпадают в определенных пределах округления. |
contains(latlng:GLatLng)
|
Boolean |
Возвращает значение true, если точка с указанными географическими координатами попадает в прямоугольную область.(Не рекомендуется начиная с версии 2.88) |
containsLatLng(latlng:GLatLng)
|
Boolean |
Возвращает значение true, если точка с указанными географическими координатами попадает в прямоугольную область.(Начиная с версии 2.88) |
intersects(other:GLatLngBounds)
|
Boolean |
В соответствии с названием. |
containsBounds(other:GLatLngBounds)
|
Boolean |
В соответствии с названием. |
extend(latlng:GLatLng)
|
None |
Увеличивает прямоугольную область таким образом, чтобы она содержала указанную точку. В параллельном направлении она увеличивается по кратчайшему пути. При одинаковых расстояниях она увеличивается в восточном направлении. |
getSouthWest()
|
GLatLng |
Возвращает координаты точки в юго-западном углу прямоугольной области. |
getNorthEast()
|
GLatLng |
Возвращает координаты точки в северо-восточном углу прямоугольной области. |
toSpan()
|
GLatLng |
Возвращает точку GLatLng, координаты которой определяют размер этой прямоугольной области. |
isFullLat()
|
Boolean |
Возвращает значение true, если прямоугольная область простирается от южного полюса до северного. |
isFullLng()
|
Boolean |
Возвращает значение true, если прямоугольная область полностью охватывает Землю в параллельном направлении. |
isEmpty()
|
Boolean |
Возвращает значение true, если прямоугольная область пуста. |
getCenter()
|
GLatLng |
Возвращает координаты точки центра прямоугольной области. (Начиная с версии 2.52) |
Это пространство имен содержит ряд статических методов, которые пригодятся для отладки веб-приложений. При первом использовании одного из методов write*() на странице открывается плавающее окно, в котором отображаются сообщения.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GLog.write(message:String,
color?:String)
|
None |
Записывает сообщение в виде обычного текста в окно журнала. Символы разметки HTML будут преобразованы для отображения в виде символов. |
GLog.writeUrl(url:String)
|
None |
Записывает ссылку на указанный URL-адрес в окно журнала. |
GLog.writeHtml(html:String)
|
None |
Записывает текст в формате HTML в окно журнала. |
Этот класс предоставляет необязательные аргументы в конструктор GMap2. У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
size
|
GSize |
Устанавливает размер карты в пикселях. Размер контейнера, передаваемого в конструктор карты, будет изменен до указанного значения. По умолчанию карта использует размер этого контейнера. |
mapTypes
|
GMapType[] |
Массив типов карт для использования картой. По умолчанию используется G_DEFAULT_MAP_TYPES. Этот параметр можно использовать, чтобы ограничить набор предопределенных типов карт, отображаемых на карте, или передать на карту собственные типы. Также см. GMap2.addMapType(). |
draggableCursor
|
String |
Курсор, который нужно показывать, когда карту можно перетащить. (Начиная с версии 2.59) |
draggingCursor
|
String |
Курсор, который нужно показывать при перетаскивании. (Начиная с версии 2.59) |
googleBarOptions
|
GGoogleBarOptions |
Определяет параметры для конфигурации элемента управления поиском GoogleBar. Эти параметры передаются в литерал объекта GMapOptions при создании карты и используются для создания элемента управления GoogleBar при вызове метода GMap2.enableGoogleBar().(Начиная с версии 2.95) |
backgroundColor
|
String |
Определяет цвет фона фрагментов карты. Цвет нужно указывать в виде допустимого значения стандартного цвета W3C. (Начиная с версии 2.119) |
Эти константы определяют порядок наложения (z-порядок), используемый картой и ее объектами для правильного отображения. Каждая панель содержит набор одинаковых с точки зрения отображения объектов, которые нужно показывать на карте. Каждая панель определяет уникальный z-порядок на карте. Панели с большим значением z-порядка отображаются над панелями с более низким порядком. (Обратите внимание, что можно задавать z-порядок и для объектов внутри одной панели, при этом одни из них будут отображаться над другими.)
Эти константы нужно использовать в случае создания подкласса класса GOverlay. Таким образом на одну из панелей можно добавлять пользовательские наложения.
Следующие константы перечислены в порядке увеличения z-порядка.
| Константа | Описание |
|---|---|
G_MAP_MAP_PANE
|
Нижняя панель, расположенная над всеми фрагментами. |
G_MAP_OVERLAY_LAYER_PANE
|
Содержит ломаные линии, многоугольники, наложения фона и фрагментарные наложения.
(Начиная с версии 2.127) |
G_MAP_MARKER_SHADOW_PANE
|
Содержит теневые изображения маркеров. |
G_MAP_MARKER_PANE
|
Содержит основные изображения маркеров. |
G_MAP_FLOAT_SHADOW_PANE
|
Содержит тень информационного окна. Эта панель расположена над панелью G_MAP_MARKER_PANE, чтобы маркеры показывались в тени информационного окна. |
G_MAP_MARKER_MOUSE_TARGET_PANE
|
Содержит прозрачные элементы, получающие события DOM для маркеров при перемещении курсора мыши. Эта панель находится над панелью G_MAP_FLOAT_SHADOW_PANE, чтобы маркеры, расположенные в тени информационного окна, можно было активировать нажатием. |
G_MAP_FLOAT_PANE
|
Содержит информационное окно. Эта панель расположена над всеми наложениями карты. |
Объект GPoint представляет собой точку на карте с пиксельными координатами. Обратите внимание, что в версии 2 он больше не представляет точку на поверхности Земли с географическими координатами. Точку с географическими координатами теперь представляет объект GLatLng.
В системе координат Карт Google координата x увеличивается слева направо, а координата y – сверху вниз, однако координаты объекта GPoint можно использовать нужным образом.
Обратите внимание, что хотя к параметрам объекта GPoint можно получить доступ как к свойствам x и y, их не рекомендуется изменять, а следует создать объект с другими параметрами.
| Конструктор | Описание |
|---|---|
GPoint(x:Number,
y:Number)
|
Создает объект GPoint. |
| Свойство | Тип | Описание |
|---|---|---|
x
|
Number |
Координата x. (В системе координат Карт Google это значение увеличивается слева направо.) |
y
|
Number |
Координата y. (В системе координат Карт Google это значение увеличивается сверху вниз.) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
equals(other:GPoint)
|
Boolean |
Возвращает значение true, если координаты точек совпадают. |
toString()
|
String |
Возвращает строку, содержащую координаты x и y, разделенные запятой. |
| Константа | Описание |
|---|---|
ORIGIN
|
Константа new GPoint(0, 0). |
Объект GSize представляет размер прямоугольной области карты в пикселях. У объекта размера есть два параметра: width и height. Ширина определяется как разность координат x, а высота – как разность координат y.
Обратите внимание, что хотя к параметрам объекта GSize можно получить доступ как к свойствам width и height, их не рекомендуется изменять, а следует создать объект с другими параметрами.
| Конструктор | Описание |
|---|---|
GSize(width:Number,
height:Number)
|
Создает объект GSize. |
| Свойство | Тип | Описание |
|---|---|---|
width
|
Number |
Параметр ширины. |
height
|
Number |
Параметр высоты. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
equals(other:GSize)
|
Boolean |
Возвращает значение true, если компоненты размеров совпадают. |
toString()
|
String |
Возвращает строку, содержащую параметры ширины и высоты, разделенные запятой. |
| Константа | Описание |
|---|---|
ZERO
|
Константа new GSize(0, 0). |
Эту функцию можно вызывать, чтобы очистить внутренние структуры данных с целью освобождения памяти. Это помогает в работе над различными ошибками браузеров, которые приводят к утечке памяти в веб-приложениях. Эту функцию нужно вызывать в обработчике запросов unload своей страницы. После вызова этой функции созданные на странице объекты не будут правильно работать.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GUnload()
|
None |
Удаляет все зарегистрированные обработчики событий, чтобы предотвратить утечку памяти. Этот метод нужно вызывать в качестве обработчика для события unload. |
Эта константа указывает версию API, используемого для страницы. Дополнительная информация об этой версии представлена на странице Обновления API.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
()
|
None |
Возвращает версию API, используемого для страницы. |
Это пространство имен содержит функции, которые можно использовать для регистрации обработчиков событий – пользовательских и DOM – и для вызова пользовательских событий. Все события, определенные этим API, являются пользовательскими и вызываются с помощью метода GEvent.trigger().
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GEvent.addListener(source:Object,
event:String,
handler:Function)
|
GEventListener |
Регистрирует обработчик для пользовательского события на исходном объекте. Возвращает дескриптор, который можно в конечном счете использовать для отмены регистрации обработчика. Обработчик событий будет вызываться с this в качестве исходного объекта. |
GEvent.addDomListener(source:Node,
event:String,
handler:Function)
|
GEventListener |
Регистрирует обработчик для пользовательского события на исходном объекте. Исходный объект должен быть узлом DOM. Возвращает дескриптор, который можно в конечном счете использовать для отмены регистрации обработчика. Обработчик событий будет вызываться с this в качестве исходного объекта. Чтобы зарегистрировать обработчик событий, эта функция использует методы DOM для текущего браузера. |
GEvent.removeListener(handle:GEventListener)
|
None |
Удаляет обработчик, добавленный с помощью метода addListener() или addDomListener(). |
GEvent.clearListeners(source:Object or Node,
event:String)
|
None |
Удаляет все обработчики указанного объекта для указанного события, добавленные с помощью метода addListener() или addDomListener(). |
GEvent.clearInstanceListeners(source:Object or Node)
|
None |
Удаляет все обработчики указанного объекта для всех событий, добавленные с помощью метода addListener() или addDomListener(). |
GEvent.clearNode(source:Node)
|
None |
Рекурсивно вызывает метод clearInstanceListeners на указанном узле и всех его дочерних узлах. |
GEvent.trigger(source:Object,
event:String,
...)
|
None |
Вызывает пользовательское событие исходного объекта. Все необязательные аргументы, указанные после event, передаются в качестве аргументов в функции обработчиков событий. |
GEvent.bind(source:Object,
event:String,
object:Object,
method:Function)
|
GEventListener |
Регистрирует вызов метода на указанном объекте в качестве обработчика для пользовательского события исходного объекта. Возвращает дескриптор, который можно в конечном счете использовать для отмены регистрации обработчика. |
GEvent.bindDom(source:Node,
event:String,
object:Object,
method:Function)
|
GEventListener |
Регистрирует вызов метода на указанном объекте в качестве обработчика для пользовательского события исходного объекта. Возвращает дескриптор, который можно в конечном счете использовать для отмены регистрации обработчика. |
GEvent.callback(object:Object,
method:Function)
|
Function |
Регистрирует функцию обратного вызова method, которая вызывается на объекте object. |
GEvent.callbackArgs(object:Object,
method:Function,
...)
|
Function |
Регистрирует функцию обратного вызова method, которая вызывается на объекте object. Все необязательные аргументы, указанные после method, передаются в качестве аргументов method при вызове возвращенной функции. |
| Событие | Описание |
|---|---|
clearlisteners(event?:String)
|
Это событие вызывается на объекте при вызове на нем метода clearListeners() или clearInstanceListeners(). Разумеется, событие вызывается перед выполнением функций. |
Этот класс скрытый. У него нет методов и конструктора. Его экземпляры возвращаются из метода GEvent.addListener() или GEvent.addDomListener(), а затем передаются обратно в метод GEvent.removeListener().
Этот интерфейс реализуется своими элементами управления. Его можно использовать, чтобы добавлять пользовательские элементы управления на карту. Это можно делать с помощью метода GMap2.addControl().
В отличие от наложений, которые привязываются к самой карте, элементы управления привязываются к области просмотра, т. е. при перемещении карты они не перемещаются.
| Конструктор | Описание |
|---|---|
GControl(printable?:Boolean,
selectable?:Boolean)
|
Создает экземпляр прототипа для нового класса элемента управления. Флажок printable указывает, что элемент управления должен выводиться на печать. Флажок selectable указывает, что элемент управления должен содержать текст, который можно выбрать. |
Эти методы вызываются картой при добавлении элемента управления на карту с помощью метода GMap2.addControl(). Поэтому эти методы не вызываются вами, а лишь реализуются.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
printable()
|
Boolean |
Возвращает карте логическое значение, определяющее, должен ли элемент управления выводиться на печать. |
selectable()
|
Boolean |
Возвращает карте логическое значение, определяющее, должен ли элемент управления содержать текст, который можно выбрать. |
initialize(map:GMap2)
|
Node |
Вызывается картой, чтобы элемент управления мог сам себя инициализировать. Элемент управления будет использовать метод GMap2.getContainer(), чтобы получить элемент DOM, содержащий карту, и добавит себя на нее. Он вернет добавленный элемент. |
getDefaultPosition()
|
GControlPosition |
Возвращает карте положение в области просмотра, в котором по умолчанию отобразится элемент управления. Он будет переопределен вторым аргументом в методе GMap2.addControl(). |
| Константа | Описание |
|---|---|
G_ANCHOR_TOP_RIGHT
|
Элемент управления будет привязан к правому верхнему углу карты. |
G_ANCHOR_TOP_LEFT
|
Элемент управления будет привязан к левому верхнему углу карты. |
G_ANCHOR_BOTTOM_RIGHT
|
Элемент управления будет привязан к правому нижнему углу карты. |
G_ANCHOR_BOTTOM_LEFT
|
Элемент управления будет привязан к левому нижнему углу карты. |
Доступны реализации интерфейса interface
GControl.
| Конструктор | Описание |
|---|---|
GSmallMapControl()
|
Создает элемент управления с кнопками для перемещения в четырех направления и масштабирования. |
GLargeMapControl()
|
Создает элемент управления с кнопками для перемещения в четырех направления и масштабирования, а также с ползунком масштаба. |
GSmallZoomControl()
|
Создает элемент управления с кнопками для масштабирования. |
GLargeMapControl3D()
|
Создает элемент управления в виде трехмерного объекта с кнопками для перемещения в четырех направлениях и масштабирования, а также с ползунком масштаба. |
GSmallZoomControl3D()
|
Создает элемент управления в виде трехмерного объекта с кнопками для масштабирования. |
GScaleControl()
|
Создает элемент управления, показывающий масштаб карты. |
GMapTypeControl()
|
Создает стандартный элемент управления типами карт для выбора типа и переключения между типами с помощью кнопок. |
GMenuMapTypeControl()
|
Создает элемент управления типами карт с раскрывающимся списком для выбора типа и переключения между типами. |
GHierarchicalMapTypeControl()
|
Создает элемент управления типами карт с вложенными элементами для выбора типа и переключения между поддерживаемыми типами с помощью кнопок и вложенных флажков. |
GOverviewMapControl()
|
Создает сворачиваемую обзорную мини-карту в углу основной карты для определения местоположения и навигации (путем перемещения). Объект GOverviewMapControl создает обзорную карту с черной границей в один пиксель. Обратите внимание, что в отличие от других элементов управления этот элемент можно разместить только в правом нижнем углу карты (G_ANCHOR_BOTTOM_RIGHT).
|
GNavLabelControl()
|
Создает·динамический элемент навигации по иерархии, представляющий текущее окно просмотра в виде набора вложенных компонентов адреса. Кроме того, этот элемент управления предоставляет ссылки для навигации, которые позволяют переходить по отдельным компонентам адреса.
(Начиная с версии 2.141) |
Этот класс задает положение элемента управления в области просмотра карты. Положение определяется углом карты, к которому элемент управления привязывается, и сдвигом относительно него. Положение можно передавать в качестве необязательного аргумента position в методGMap2.addControl(). Оно возвращается методом GControl.getDefaultPosition().
| Конструктор | Описание |
|---|---|
GControlPosition(anchor:enum GControlAnchor,
offset:GSize)
|
Создает спецификацию для положения элемента управления. |
Объект GHierarchicalMapTypeControl представляет собой элемент управления типами карт с вложенными элементами для выбора типа и переключения между поддерживаемыми типами с помощью кнопок и вложенных флажков. Элементы управления станут доступными для всех прикрепленных к карте типов карт в момент создания элемента управления.
Добавленные к карте типы будут представлены в виде кнопок как и в обычном объекте GMapTypeControl. Однако типы карт, определенные как подтипы других типов (см. метод addRelationship() ниже), появятся в виде флажков в подменю под родительской кнопкой.
По умолчанию карты поддерживают набор G_DEFAULT_MAP_TYPES. Помимо него можно добавлять типы карт напрямую с помощью метода GMap2.addMapType(). Элементы управления станут доступными для всех прикрепленных к карте типов карт в момент создания элемента управления. Обратите внимание, что поскольку подтипы отображаются в виде флажков, их можно заменить родительскими или дочерними элементами в подменю.
| Конструктор | Описание |
|---|---|
GHierarchicalMapTypeControl()
|
Создает элемент управления. По умолчанию тип карты G_HYBRID_MAP становится дочерним типом G_SATELLITE_MAP. Если это не нужно, это отношение можно удалить, вызвав метод clearRelationships(). |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
addRelationship(parentType:GMapType,
childType:GMapType,
childText?:String,
isDefault?:Boolean)
|
None |
Регистрирует родительско-дочернее отношение между типами карт с элементом управления. Если указан параметр childText, он будет показан рядом с флажком дочернего типа карты вместо его названия. Если параметр isDefault принимает значение true, дочерний тип карты будет выбран по умолчанию. Обратите внимание, что все отношения нужно установить до добавления элемента управления. (Добавление отношений после добавления элемента управления ни к чему не приведет.)(Начиная с версии 2.94) |
removeRelationship(mapType:GMapType)
|
None |
Удаляет все отношения указанного типа карты для элемента управления. (Начиная с версии 2.94) |
clearRelationships()
|
None |
Удаляет все отношения для элемента управления. (Начиная с версии 2.94) |
Google предоставляет ряд предопределенных типов карт. Помимо них можно определить пользовательские типы с помощью этого класса. Чтобы показать их на карте, используйте конструктор GMap2 или метод GMap2.addMapType(). Чтобы добавить (а не заменить) слои фрагментов карты, посмотрите описание объекта GTileLayerOverlay.
Можно создавать подклассы этого класса. При создании экземпляра в качестве прототипа можно опустить ряд аргументов конструктора. Конструктор подкласса должен вызывать конструктор GMapType с помощью метода call().
| Конструктор | Описание |
|---|---|
GMapType(layers:GTileLayer[],
projection:GProjection,
name:String,
opts?:GMapTypeOptions)
|
Создает тип карты с указанными слоями фрагментов, проекцией, названием и дополнительными параметрами. |
Чаще всего эти методы вызываются картой, для которой предназначен тип, но некоторые из них можно вызывать и извне карты, например getBoundsZoomLevel().
| Метод | Возвращаемое значение | Описание |
|---|---|---|
getSpanZoomLevel(center:GLatLng,
span:GLatLng,
viewSize:GSize)
|
Number |
Возвращает карте коэффициент масштаба, при котором область карты, определенная центральной точкой и диапазоном, попадает в область просмотра указанного размера в пикселях. |
getBoundsZoomLevel(bounds:GLatLngBounds,
viewSize:GSize)
|
None |
Возвращает карте коэффициент масштаба, при котором область карты, определенная границами, попадает в область просмотра указанного размера в пикселях. |
getName(short?:Boolean)
|
String |
Возвращает карте название типа карты, которое нужно использовать в качестве текста кнопки в объекте GMapTypeControl. |
getProjection()
|
GProjection |
Возвращает карте проекцию для этого типа карты. |
getTileSize()
|
Number |
Возвращает карте размер фрагмента этого типа карты в пикселях. Фрагменты считаются квадратными. Для всех слоев фрагментов размер фрагмента одинаковый. |
getTileLayers()
|
GTileLayer[] |
Возвращает карте массив слоев фрагментов. |
getMinimumResolution()
|
Number |
Возвращает карте минимальный коэффициент масштаба, при котором определен этот тип карты. |
getMaximumResolution()
|
Number |
Возвращает карте максимальный коэффициент масштаба, при котором определен этот тип карты. |
getMaxZoomAtLatLng(latlng:GLatLng,
callback:Function,
opt_targetZoom:number)
|
None |
Отправляет запрос к серверам Google, чтобы определить максимальный коэффициент масштаба, для которого существуют изображения для этого типа карты в указанной точке GLatLng. Эта функция обратного вызова будет вызвана с ответом, содержащим код состояния status. При успешном выполнении запроса будет возвращено значение zoom максимального коэффициента масштаба. Если параметр opt_targetZoom указан, будут рассматриваться только коэффициенты масштаба до его значения. Обратите внимание, что эта функция реализована только для изображений со спутника для типов карт G_SATELLITE_MAP и G_HYBRID_MAP.(Начиная с версии 2.158) |
getTextColor()
|
String |
Возвращает карте цвет, который лучше всего подходит для текста, накладываемого на карту. Используется для цвета текста сообщения с информацией об авторских правах, которое отображается с помощью соответствующего элемента управления. |
getLinkColor()
|
String |
Возвращает карте цвет, который лучше всего подходит для гиперссылок, накладываемых на карту. Используется для цвета ссылок на условия предоставления услуг, которые отображаются с помощью соответствующего элемента управления. |
getErrorMessage()
|
String |
Возвращает карте сообщение об ошибке, которое отображается в областях или при коэффициенте масштабирования, когда для этого типа карты нет фрагментов. |
getCopyrights(bounds:GLatLngBounds,
zoom:Number)
|
String[] |
Возвращает карте сообщения с информацией об авторских правах, соответствующей региону, определенному параметром bounds, при указанном коэффициенте масштаба. Этот метод используется сообщением с информацией об авторских правах, отображаемым на карте. |
getUrlArg()
|
String |
Возвращает карте значение, которое используется в качестве параметра URL, чтобы определить этот тип карты в постоянных ссылках на эту область просмотра карты. На данный момент этот метод используется только приложениями карт. |
getAlt()
|
String |
Возвращает карте замещающий текст для этого типа карты. (Начиная с версии 2.86) |
| Константа | Описание |
|---|---|
G_NORMAL_MAP
|
Обычная двумерная карта. Используется по умолчанию. |
G_SATELLITE_MAP
|
Фотографическая карта. |
G_HYBRID_MAP
|
Комбинация фотографий и слоя обычной карты с основными магистралями. |
G_PHYSICAL_MAP
|
Физическая карта, например, с информацией о рельефе и растительности местности. По умолчанию этот тип не включен в элементы управления типами карт. (Начиная с версии 2.94) |
G_MAPMAKER_NORMAL_MAP
|
Обычная двумерная карта с фрагментами, созданными с помощью Google Map Maker.
Примечание. При использовании этого типа пользователи смогут просматривать карты только в странах, где запущен Google Map Maker. (Начиная с версии 2.145) |
G_MAPMAKER_HYBRID_MAP
|
Слой с главными улицами, созданный с помощью Google Map Maker, на фотографиях со спутника.
Примечание. При использовании этого типа пользователи смогут просматривать карты только в странах, где запущен Google Map Maker. (Начиная с версии 2.145) |
G_MOON_ELEVATION_MAP
|
Карта рельефа поверхности Луны, затемненная в соответствии с высотой над уровнем моря. По умолчанию этот тип не включен в элементы управления типами карт. (Начиная с версии 2.95) |
G_MOON_VISIBLE_MAP
|
Фотографии, сделанные с орбиты Луны. По умолчанию этот тип не включен в элементы управления типами карт. (Начиная с версии 2.95) |
G_MARS_ELEVATION_MAP
|
Карта рельефа поверхности Марса, затемненная в соответствии с высотой над уровнем моря. По умолчанию этот тип не включен в элементы управления типами карт. (Начиная с версии 2.95) |
G_MARS_VISIBLE_MAP
|
Фотографии, сделанные с орбиты Марса. По умолчанию этот тип не включен в элементы управления типами карт. (Начиная с версии 2.95) |
G_MARS_INFRARED_MAP
|
Инфракрасная карта поверхности Марса, где теплые области светлее, а прохладные области – темнее.
(Начиная с версии 2.95) |
G_SKY_VISIBLE_MAP
|
Звездная карта всей небесной сферы.
(Начиная с версии 2.95) |
G_SATELLITE_3D_MAP
|
Полностью интерактивная трехмерная модель Земли с фотографиями со спутника, отображаемая с помощью плагина браузера Google Планета Земля. По умолчанию этот тип не включен в элементы управления типами карт.
При добавлении этого типа на карту появится элемент управления для типа карты Google Планета Земля. Кроме того, он будет инициализирован при нажатии пользователем на элементе управления. Если в браузере пользователя не установлен плагин Google Планета Земля, при первом выборе этого типа карты пользователя попросят загрузить и установить этот плагин, а затем перезапустить свой браузер. У пользователей, установивших этот плагин, при выборе этого типа карты на карте будет создан экземпляр планеты Земля и показана ее трехмерная модель. Чтобы получить этот экземпляр и манипулировать им с помощью API Google Планета Земля, используйте метод GMap2.getEarthInstance().
На данный момент для этого типа карты доступны маркеры, информационные окна и ломаные линии. Другие функции не поддерживаются. В будущих выпусках мы планируем добавить поддержку дополнительных функций. (Начиная с версии 2.113) |
G_DEFAULT_MAP_TYPES
|
Массив из первых трех предопределенных типов карт, описанных выше (G_NORMAL_MAP, G_SATELLITE_MAP и G_HYBRID_MAP). |
G_MAPMAKER_MAP_TYPES
|
Массив из типов карт, созданных с помощью Map Maker и описанных выше (G_MAPMAKER_NORMAL_MAP, G_SATELLITE_MAP и G_MAPMAKER_HYBRID_MAP). |
G_MOON_MAP_TYPES
|
Массив из двух типов карт Луны, описанных выше (G_MOON_ELEVATION_MAP и G_MOON_VISIBLE_MAP). |
G_MARS_MAP_TYPES
|
Массив из трех типов карт Марса, описанных выше (G_MARS_ELEVATION_MAP, G_MARS_VISIBLE_MAP и G_MARS_INFRARED_MAP). |
G_SKY_MAP_TYPES
|
Массив из одной карты неба, описанной выше (G_SKY_VISIBLE_MAP). |
| Событие | Описание |
|---|---|
newcopyright(copyright:GCopyright)
|
Это событие вызывается при добавлении информации об авторских правах в коллекцию одного из слоев фрагментов для этого типа карты. |
Объект GMapTypeControl представляет собой стандартный элемент управления типами карт для выбора типа и переключения между типами с помощью кнопок. Элементы управления станут доступными для всех прикрепленных к карте типов карт в момент создания элемента управления.
По умолчанию карты поддерживают набор G_DEFAULT_MAP_TYPES. Помимо него можно явно добавить типы карт с помощью метода GMap2.addMapType(). Чтобы сохранить место на карте, вместо этого класса можно использовать класс GHierarchicalMapTypeControl с "вложенными" типами карт или класс GMenuMapTypeControl с раскрывающимся списком типов.
| Конструктор | Описание |
|---|---|
GMapTypeControl(useShortNames?:Boolean)
|
Создает объект GMapTypeControl с короткими (замещающими) названиями, если параметр useShortNames принимает значение true, и длинными названиями по умолчанию. |
Экземпляры этого класса используются в качестве аргумента opts? конструктора GMapType. У этого класса нет конструктора. Экземпляр класса создается в виде литерала объекта JavaScript.
| Свойство | Тип | Описание |
|---|---|---|
shortName
|
String |
Устанавливает сокращенное название для типа карты, возвращаемое методом GMapType.getName(true). По умолчанию оно совпадает со свойствомname. |
urlArg
|
String |
Устанавливает аргумент URL типа карты, возвращаемый методом GMapType.getUrlArg(). По умолчанию используется пустая строка. |
maxResolution
|
Number |
Устанавливает максимальный коэффициент масштабирования карт этого типа, возвращаемый методом GMapType.getMaximumResolution(). По умолчанию используется максимальное среди значений всех слоев фрагментов. |
minResolution
|
Number |
Устанавливает минимальный коэффициент масштабирования карт этого типа, возвращаемый методом GMapType.getMinimumResolution(). По умолчанию используется минимальное среди значений всех слоев фрагментов. |
tileSize
|
Number |
Устанавливает размер фрагмента, возвращаемый методом GMapType.getTileSize(). По умолчанию используется значение 256. |
textColor
|
String |
Устанавливает цвет текста, возвращаемый методом GMapType.getTextColor(). По умолчанию используется значение "black". |
linkColor
|
String |
Устанавливает цвет текста, возвращаемый методом GMapType.getLinkColor(). По умолчанию используется значение "#7777cc". |
errorMessage
|
String |
Определяет сообщение об ошибке, возвращаемое методом GMapType.getErrorMessage(). По умолчанию используется пустая строка. |
alt
|
String |
Устанавливает замещающий текста для типа карты, возвращаемый методом GMapType.getAlt(). По умолчанию используется пустая строка.(Начиная с версии 2.64) |
radius
|
Number |
Устанавливает радиус для типа карты в виде значения переданного типа Number в метрах. По умолчанию используется 6 378 137 метров, т. е. экваториальный радиус Земли.(Начиная с версии 2.89) |
Этот класс предоставляет набор параметров пользовательского интерфейса для карты.
| Конструктор | Описание |
|---|---|
GMapUIOptions(opt_size:GSize)
|
Создает набор параметров пользовательского интерфейса, которые принимают значения по умолчанию, подходящие для карты указанного размера. "Небольшой" картой считается карта меньше 400 пикселей в ширину или 300 пикселей в высоту. "Большой" картой считается карта размера 400х300 пикселей или более. |
| Свойство | Тип | Описание |
|---|---|---|
maptypes.normal
|
Boolean |
Значение true этого свойства означает, что на карту необходимо добавить обычный тип карты (G_NORMAL_MAP). По умолчанию используется значение true.
(Начиная с версии 2.147) |
maptypes.satellite
|
Boolean |
Значение true этого свойства означает, что на карту необходимо добавить тип карты с изображениями со спутника (G_SATELLITE_MAP). По умолчанию используется значение true.
(Начиная с версии 2.147) |
maptypes.hybrid
|
Boolean |
Значение true этого свойства означает, что на карту необходимо добавить тип гибридной карты (G_HYBRID_MAP). По умолчанию используется значение true.
(Начиная с версии 2.147) |
maptypes.physical
|
Boolean |
Значение true этого свойства означает, что на карту необходимо добавить тип физической карты (с ландшафтом) (G_PHYSICAL_MAP). По умолчанию используется значение true.
(Начиная с версии 2.147) |
zoom.scrollwheel
|
Boolean |
Значение true этого свойства означает, что на карте должно быть доступно масштабирование с помощью колесика мыши. По умолчанию используется значение true.
(Начиная с версии 2.147) |
zoom.doubleclick
|
Boolean |
Значение true этого свойства означает, что на карте должно быть доступно масштабирование посредством двойного нажатия. По умолчанию используется значение true.
(Начиная с версии 2.147) |
keyboard
|
Boolean |
Значение true этого свойства означает, что для карты должен быть доступен объект GKeyboardHandler. По умолчанию используется значение true.
(Начиная с версии 2.147) |
controls.largemapcontrol3d
|
Boolean |
Значение true этого свойства означает, что на карту необходимо добавить объект GLargeMapControl3D. Для "больших" карт по умолчанию используется значение true.
(Начиная с версии 2.147) |
controls.smallzoomcontrol3d
|
Boolean |
Значение true этого свойства означает, что на карту необходимо добавить объект GSmallZoomControl3D. Для "небольших" карт по умолчанию используется значение true.
(Начиная с версии 2.147) |
controls.maptypecontrol
|
Boolean |
Значение true этого свойства означает, что на карту необходимо добавить объект GMapTypeControl. Для "больших" карт по умолчанию используется значение true.
(Начиная с версии 2.147) |
controls.menumaptypecontrol
|
Boolean |
Значение true этого свойства означает, что на карту необходимо добавить объект GMenuMapTypeControl. Для "небольших" карт по умолчанию используется значение true.
(Начиная с версии 2.147) |
controls.scalecontrol
|
Boolean |
Значение true этого свойства означает, что на карту необходимо добавить объект GScaleControl. Для "больших" карт по умолчанию используется значение true.
(Начиная с версии 2.147) |
Объект GMenuMapTypeControl представляет собой элемент управления типами карт для выбора типа и переключения между поддерживаемыми типами с помощью раскрывающегося меню. Элементы управления станут доступными для всех прикрепленных к карте типов карт в момент создания элемента управления.
По умолчанию карты поддерживают набор G_DEFAULT_MAP_TYPES. Помимо него можно явно добавить типы карт с помощью метода GMap2.addMapType().
| Конструктор | Описание |
|---|---|
GMenuMapTypeControl(useShortNames?:Boolean)
|
Создает объект GMenuMapTypeControl с короткими (замещающими) названиями, если параметр useShortNames принимает значение true, и длинными названиями по умолчанию. |
Объект GNavLabelControl представляет собой динамический элемент навигации по иерархии, определяющий текущее окно просмотра в виде набора вложенных компонентов адреса. Кроме того, этот элемент управления предоставляет ссылки для навигации, которые позволяют переходить по отдельным компонентам адреса.
По умолчанию этот элемент управления расположен в правом верхнем углу окна просмотра. Он скрывается по истечении 10 секунд бездействия и появляется по нажатию или при изменении окна просмотра на карте. Кроме того, он не показывается, если недоступен адрес текущего окна просмотра.
| Конструктор | Описание |
|---|---|
GNavLabelControl()
|
Создает объект GNavLabelControl.(Начиная с версии 2.141) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
setMinAddressLinkLevel(level:Number)
|
None |
Устанавливает минимальный уровень компонента адреса, для которого в элементе предоставляется ссылка. Например, если уровень равен 0, показываются ссылки на все компоненты адреса "США > Нью-Йорк > Бруклин". Если же уровень равен 2, предоставляется ссылка только на Бруклин. По умолчанию используется значение 0. (Начиная с версии 2.162) |
Объект авторских прав содержит сведения о сообщении с информацией об авторских правах, соответствующей региону карты в указанной прямоугольной области при указанном коэффициенте масштабирования. Этот тип вам пригодится только при реализации пользовательских типов карт или слоев фрагментов.
| Конструктор | Описание |
|---|---|
GCopyright(id:Number,
bounds:GLatLngBounds,
minZoom:Number,
text:String)
|
Создает объект с информацией об авторских правах с указанными свойствами. |
| Свойство | Тип | Описание |
|---|---|---|
id
|
Number |
Уникальный идентификатор информации об авторских правах. |
minZoom
|
Number |
Минимальный коэффициент масштаба, при котором применима эта информация. |
bounds
|
GLatLngBounds |
Регион, к которому применима эта информация. |
text
|
String |
Текст сообщения с информацией об авторских правах. |
Этот класс следует использовать для управления сообщениями с информацией об авторских правах, показываемых на карте пользовательского типа. Если вы не разрабатываете пользовательские типы карт, этот класс вам не понадобится. Коллекция сообщений содержит сведения о сообщениях с информацией об авторских правах, соответствующих региону карты при определенном коэффициенте масштабирования. Это очень важно для типов карт, представляющих неоднородные данные, например изображения со спутника.
| Конструктор | Описание |
|---|---|
GCopyrightCollection(prefix?:String)
|
У сообщений с информацией об авторских правах из одной коллекции будет одинаковый префикс, указанный в качестве аргумента. Например, "Imagery (C) 2006". |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
addCopyright(copyright:GCopyright)
|
None |
Добавляет объект с информацией об авторских правах в коллекцию. |
getCopyrights(bounds:GLatLngBounds,
zoom:Number)
|
String[] |
Возвращает всю информацию об авторских правах, которая применима к указанному региону карты при указанном коэффициенте масштабирования. Пример: [ "Google", "Keyhole" ] |
getCopyrightNotice(bounds:GLatLngBounds,
zoom:Number)
|
String |
Возвращает префикс и всю соответствующую информацию об авторских правах, которая применима к указанному региону карты при указанном коэффициенте масштабирования. Пример: "Imagery (C) 2006 Google, Keyhole" |
| Событие | Описание |
|---|---|
newcopyright(copyright:GCopyright)
|
Это событие вызывается при добавлении новой информации об авторских правах в коллекцию. |
Этот объект создает на карте прямоугольное наложение, размеры которого определены объектом GLatLngBounds.
| Конструктор | Описание |
|---|---|
GGroundOverlay(imageUrl:String,
bounds:GLatLngBounds)
|
Создает наложение фона по URL изображения и его границам. (Начиная с версии 2.79) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
hide()
|
None |
Скрывает наложение фона, если оно видимо. Обратите внимание, что если наложение фона видимо, эта функция вызывает событие GGroundOverlay.visibilitychanged.(Начиная с версии 2.87) |
isHidden()
|
Boolean |
Возвращает значение true, если наложение фона скрыто. В противном случае возвращает false. (Начиная с версии 2.87) |
show()
|
None |
Показывает наложение фона, если оно скрыто. Обратите внимание, что если наложение фона скрыто, эта функция вызывает событие GGroundOverlay.visibilitychanged.(Начиная с версии 2.87) |
supportsHide()
|
Boolean |
Всегда возвращает значение true.(Начиная с версии 2.87) |
| Событие | Описание |
|---|---|
visibilitychanged(isVisible:Boolean)
|
Это событие вызывается при изменении состояния видимости наложения фона: с видимого на скрытое и наоборот. Аргумент isVisible указывает конечное состояние видимости наложения фона после изменения.
(Начиная с версии 2.77) |
Значок используется для отображения объекта GMarker на карте. Из-за проблем совместимости браузеров сопоставление значка достаточно трудоемкий процесс. Обратите внимание, что если не нужно использовать собственный значок, можно использовать значок по умолчанию G_DEFAULT_ICON.
| Конструктор | Описание |
|---|---|
GIcon(copy?:GIcon,
image?:String)
|
Создает объект значка. Если в качестве необязательного аргумента copy указан другой значок, его свойства копируются. В противном случае они не задаются. Необязательный аргумент image устанавливает значение свойства image. |
| Константа | Описание |
|---|---|
G_DEFAULT_ICON
|
Значок, показываемый вместо маркеров по умолчанию. |
| Свойство | Тип | Описание |
|---|---|---|
image
|
String |
URL основного изображения значка. |
shadow
|
String |
URL теневого изображения значка. |
iconSize
|
GSize |
Размер основного изображения значка в пикселях. |
shadowSize
|
GSize |
Размер теневого изображения в пикселях. |
iconAnchor
|
GPoint |
Пиксельная координата относительно левого верхнего угла изображения значка, в которой он привязан к карте. |
infoWindowAnchor
|
GPoint |
Пиксельная координата относительно левого верхнего угла изображения значка, в которой информационное окно привязано к этому значку. |
printImage
|
String |
URL замещающего основного изображения значка, выводимого при печати в браузерах, не поддерживающих обработку объекта GIcon.image, используемого по умолчанию. В таком случае для браузера Internet Explorer нужно указывать замещающее изображение, поскольку он не может напечатать значки в виде прозрачных изображений PNG. Обратите внимание, что браузеры, которые могут выводить на печать изображение image, используемое по умолчанию, проигнорируют это свойство. |
mozPrintImage
|
String |
URL замещающего непрозрачного изображения значка, выводимого при печати в браузерах, не поддерживающих обработку прозрачных изображений PNG (например, указанного в свойстве GIcon.image, используемого по умолчанию) или прозрачных изображений GIF (указанных в свойстве GIcon.printImage). Для ранних версий браузера Firefox/Mozilla для печати требуются непрозрачные изображения. Обратите внимание, что браузеры, которые могут выводить на печать изображение image, используемое по умолчанию, проигнорируют это свойство. |
printShadow
|
String |
URL теневого изображения, используемого при печати карт. Это должно быть изображение GIF, поскольку большинство браузеров не могут выводить на печать изображения PNG. |
transparent
|
String |
URL виртуальной прозрачной версии основного изображения значка, предназначенной для захвата событий нажатия в Internet Explorer. Это изображение должно быть 24-разрядной версией основного изображения значка в формате PNG с прозрачностью 99 процентов такой же формы и размера, что и основной значок. |
imageMap
|
Number[] |
Массив целых значений, представляющих координаты x и y изображения, которые используются для определения части изображения значка, которую можно активировать нажатием в браузерах, отличных от Internet Explorer. |
maxHeight
|
Integer |
Определяет расстояние в пикселях, на которое маркер может увеличиться в вертикальном направлении при перемещении. (Начиная с версии 2.79) |
dragCrossImage
|
String |
Определяет URL изображения перекрестия при перемещении значка. (Начиная с версии 2.79) |
dragCrossSize
|
GSize |
Определяет размер в пикселях изображения перекрестия при перемещении значка. (Начиная с версии 2.79) |
dragCrossAnchor
|
GPoint |
Определяет сдвиг в пикселях (относительно значения свойства iconAnchor) изображения перекрестия при перемещении значка. (Начиная с версии 2.79) |
Этот класс создает экземпляр предопределенного слоя наложения, состоящего из коллекции связанных элементов. Он реализует интерфейс GOverlay и поэтому добавляется на карту с помощью метода GMap2.addOverlay().
| Конструктор | Описание |
|---|---|
GLayer(layerId:String)
|
Создает слой с указанным идентификатором. Список поддерживаемых слоев представлен на странице http://spreadsheets.google.com/pub?key=p9pdwsai2hDN-cAocTLhnag. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
hide()
|
None |
Скрывает наложение, но сохраняет его место в стеке наложений. |
show()
|
None |
Отображает ранее скрытый объект GLayer. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GLayer.isHidden(layerId:String)
|
None |
Возвращает значение true, если слой наложения скрыт или не добавлен на карту с помощью метода GMap2.addOverlay(). В противном случае возвращает false. |
Объект GMarker отмечает положение на карте. Он реализует интерфейс GOverlay и поэтому добавляется на карту с помощью метода GMap2.addOverlay().
Для объекта маркера определено свойство latlng, которое задает географическое положение точки привязки маркера к карте, и свойство icon. Если аргумент icon не указан в конструкторе, по умолчанию используется значок G_DEFAULT_ICON.
После добавления маркера на карту с его помощью можно открывать информационное окно этой карты. Объект маркера вызывает события мыши и информационного окна.
| Конструктор | Описание |
|---|---|
GMarker(latlng:GLatLng,
icon?:GIcon,
inert?:Boolean)
|
Создает маркер в точке latlng, указанной в виде объекта GPoint или GLatLng со значком icon или G_DEFAULT_ICON. Если флажок inert принимает значение true, маркер нельзя активировать нажатием и он не вызывает никаких событий.(Не рекомендуется начиная с версии 2.50) |
GMarker(latlng:GLatLng,
opts?:GMarkerOptions)
|
Создает маркер в точке latlng с параметрами, указанными в виде объекта GMarkerOptions. По умолчанию маркеры можно активировать нажатием. Для них используется значок G_DEFAULT_ICON.(Начиная с версии 2.50) |
Перед вызовом этих методов маркер нужно добавить на карту.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
openInfoWindow(content:Node,
opts?:GInfoWindowOptions)
|
None |
Открывает информационное окно карты над значком маркера. Содержание информационного окна указывается в виде узла DOM. Применяется только параметр GInfoWindowOptions.maxWidth. |
openInfoWindowHtml(content:String,
opts?:GInfoWindowOptions)
|
None |
Открывает информационное окно карты над значком маркера. Содержание информационного окна указывается в виде строки текста HTML. Применяется только параметр GInfoWindowOptions.maxWidth. |
openInfoWindowTabs(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Открывает информационное окно карты с вкладками над значком маркера. Содержание информационного окна указывается в виде массива вкладок, содержание которых задается в виде узлов DOM. Применяются только параметры GInfoWindowOptions.maxWidth и InfoWindowOptions.selectedTab. |
openInfoWindowTabsHtml(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Открывает информационное окно карты с вкладками над значком маркера. Содержание информационного окна указывается в виде массива вкладок, содержание которых задается в виде строк текста HTML. Применяются только параметры InfoWindowOptions.maxWidth и InfoWindowOptions.selectedTab. |
bindInfoWindow(content:Node,
opts?:GInfoWindowOptions)
|
None |
Связывает указанный узел DOM с маркером. Содержание этого узла будет автоматически показываться в информационном окне при нажатии на маркер. Чтобы удалить связь, укажите null в качестве значения параметра content.(Начиная с версии 2.85) |
bindInfoWindowHtml(content:String,
opts?:GInfoWindowOptions)
|
None |
Связывает указанный текст HTML с маркером. HTML-cодержание будет автоматически показываться в информационном окне при нажатии на маркер. Чтобы удалить связь, укажите null в качестве значения параметра content.(Начиная с версии 2.85) |
bindInfoWindowTabs(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Связывает указанные объекты GInfoWindowTab (заданные в виде узлов DOM) с маркером. Содержание этих узлов вкладок будет автоматически показываться в информационном окне при нажатии на маркер. Чтобы удалить связь, укажите null в качестве значения параметра tabs.(Начиная с версии 2.85) |
bindInfoWindowTabsHtml(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Связывает указанные объекты GInfoWindowTab (заданные в виде строк текста HTML) с маркером. HTML-cодержание этих вкладок будет автоматически показываться в информационном окне при нажатии на маркер. Чтобы удалить связь, укажите null в качестве значения параметра tabs.(Начиная с версии 2.85) |
closeInfoWindow()
|
None |
Закрывает информационное окно, если оно относится к этому маркеру. (Начиная с версии 2.85) |
showMapBlowup(opts?:GInfoWindowOptions)
|
None |
Открывает информационное окно карты над значком маркера. Информационное окно содержит увеличенную карту области вокруг маркера. Применяются только параметры InfoWindowOptions.zoomLevel и InfoWindowOptions.mapType. |
getIcon()
|
GIcon |
Возвращает значок icon маркера, указанный в конструкторе. |
getTitle()
|
String |
Возвращает название маркера, указанное в конструкторе в свойстве GMarkerOptions.title. Если название не определено, возвращает undefined.(Начиная с версии 2.85) |
getPoint()
|
GLatLng |
Возвращает географические координаты точки привязки маркера, указанные в конструкторе или с помощью метода setPoint().(Не рекомендуется начиная с версии 2.88) |
getLatLng()
|
GLatLng |
Возвращает географические координаты точки привязки маркера, указанные в конструкторе или с помощью метода setLatLng().(Начиная с версии 2.88) |
setPoint(latlng:GLatLng)
|
None |
Устанавливает географические координаты точки привязки маркера. (Не рекомендуется начиная с версии 2.88) |
setLatLng(latlng:GLatLng)
|
None |
Устанавливает географические координаты точки привязки маркера. (Начиная с версии 2.88) |
enableDragging()
|
None |
Включает возможность перемещения маркера по карте. Для этого маркер должен быть инициализирован с GMarkerOptions.draggable = true. |
disableDragging()
|
None |
Отключает возможность перемещения маркера по карте. |
draggable()
|
Boolean |
Возвращает значение true, если маркер инициализирован в конструкторе следующим образом: GMarkerOptions.draggable =
true. В противном случае возвращает значение false.
|
draggingEnabled()
|
Boolean |
Возвращает значение true, если пользователи могут перемещать маркер по карте.
|
setImage(url:String)
|
None |
Устанавливает изображение по URL url в качестве основного изображения маркера. Обратите внимание, что печатное и теневое изображения не настраиваются. Поэтому этот метод в первую очередь предназначен для применения эффектов выделения или изменения яркости, а не для существенных изменений в виде маркера.
(Начиная с версии 2.75) |
hide()
|
None |
Скрывает отображаемый маркер. Обратите внимание, что если маркер видим, эта функция вызывает событие GMarker.visibilitychanged. (Начиная с версии 2.77) |
show()
|
None |
Показывает маркер, если он скрыт. Обратите внимание, что если маркер скрыт, эта функция вызывает событие GMarker.visibilitychanged. (Начиная с версии 2.77) |
isHidden()
|
Boolean |
Возвращает значение true, если маркер скрыт. В противном случае возвращает false. (Начиная с версии 2.77) |
Все эти события вызываются, если для маркера не задано свойство inert (см. конструктор).
| Событие | Описание |
|---|---|
click(latlng:GLatLng)
|
Это событие вызывается при нажатии на значке маркера. Передает текущую координату маркера в аргументе latlng. Обратите внимание, что это событие также вызывается для карты. В обработчик событий маркер передается в качестве первого аргумента. |
dblclick(latlng:GLatLng)
|
Это событие вызывается при двойном нажатии на значке маркера. Передает текущую координату маркера в аргументе latlng. Обратите внимание, что это событие не вызывается для карты, поскольку при двойном нажатии всегда осуществляется центрирование карты. |
mousedown(latlng:GLatLng)
|
Это событие вызывается при возникновении события DOM mousedown для маркера. Передает текущую координату маркера в аргументе latlng. Обратите внимание, что маркер прекратит событие DOM mousedown, что предотвратит перемещение карты. |
mouseup(latlng:GLatLng)
|
Это событие вызывается при возникновении события DOM mouseup для маркера. Передает текущую координату маркера в аргументе latlng. Обратите внимание, что маркер не прекратит событие DOM mousedown, поскольку такое поведение однозначно для обработчика перемещения карты. |
mouseover(latlng:GLatLng)
|
Это событие вызывается при перемещении курсора мыши в область значка маркера. Передает текущую координату маркера в аргументе latlng. |
mouseout(latlng:GLatLng)
|
Это событие вызывается при перемещении курсора мыши за пределы области значка маркера. Передает текущую координату маркера в аргументе latlng. |
infowindowopen()
|
Это событие вызывается при открытии информационного окна по нажатию на маркере. |
infowindowbeforeclose()
|
Это событие вызывается перед закрытием информационного окна, открытого по нажатию на маркере. (Начиная с версии 2.83) |
infowindowclose()
|
Это событие вызывается при закрытии информационного окна, открытого по нажатию на маркере. Это происходит при закрытии информационного окна, при его открытии по нажатию на другом маркере или карте. Перед этим событием вызывается событие infowindowbeforeclose. |
remove()
|
Это событие вызывается при удалении маркера с карты с помощью метода GMap2.removeOverlay() или GMap2.clearOverlays(). |
dragstart(latlng:GLatLng)
|
Если маркер можно перемещать, вызывается в начале перемещения маркера. Передает текущую координату маркера в аргументе latlng. |
drag(latlng:GLatLng)
|
Если маркер можно перемещать, вызывается при перемещении маркера. Передает текущую координату маркера в аргументе latlng. |
dragend(latlng:GLatLng)
|
Если маркер можно перемещать, вызывается по окончании перемещения маркера. Передает текущую координату маркера в аргументе latlng. |
visibilitychanged(isVisible:Boolean)
|
Это событие вызывается при изменении состояния видимости маркера (с видимого на скрытое и наоборот). Аргумент isVisible указывает состояние видимости маркера после изменения.
(Начиная с версии 2.77) |
Этот класс используется для управления видимостью сотен маркеров на карте, основываясь на текущем окне просмотра и коэффициенте масштабирования. Этот класс не рекомендуется использовать. Вместо него разработчикам следует использовать Диспетчер маркеров с открытым исходным кодом.
| Конструктор | Описание |
|---|---|
GMarkerManager(map:GMap,
opts?:GMarkerManagerOptions)
|
Создает диспетчер маркеров, который управляет видимостью маркеров на указанной карте.
(Начиная с версии 2.67) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
addMarkers(markers:GMarker[],
minZoom:Number,
maxZoom?:Number)
|
None |
Добавляет набор маркеров в диспетчер. Маркеры добавляются на карту только после вызова метода refresh(). На карте они показываются, только если они попадают в текущее окно просмотра и коэффициент масштабирования карты больше или равен значению minZoom. Если указано значение maxZoom, маркеры автоматически удаляются, если коэффициент масштабирования больше указанного.
(Начиная с версии 2.67) |
addMarker(marker:GMarker,
minZoom:Number,
maxZoom?:Number)
|
None |
Добавляет один маркер в коллекцию маркеров, которой управляет этот диспетчер. Если маркер попадает в текущее окно просмотра, а коэффициент масштабирования – в указанный диапазон, то маркер сразу же добавляется на карту. Как и в методе addMarkers, параметр minZoom и необязательный параметр maxZoom определяют диапазон коэффициентов масштабирования, при которых должен показываться маркер.
(Начиная с версии 2.67) |
refresh()
|
None |
Заставляет диспетчер обновить маркеры на карте. Это метод нужно вызывать, если маркеры были добавлены с помощью метода addMarkers.
(Начиная с версии 2.67) |
getMarkerCount(zoom:Number)
|
Number |
Возвращает общее количество маркеров, которые могут отображаться при указанном коэффициенте масштабирования. В него могут входить маркеры, отображаемые при более низких коэффициентах.
(Начиная с версии 2.67) |
| Событие | Описание |
|---|---|
changed(bounds:GBounds,
markerCount:Number)
|
Это событие вызывается при добавлении на карту или удалении с нее маркеров, которыми управляет диспетчер. Функцию обработчика событий нужно подготовить для получения двух аргументов. Один представляет границы видимой прямоугольной области, а второй передает количество показанных на карте маркеров. |
Этот класс предоставляет необязательные аргументы в конструктор GMarkerManager. У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
borderPadding
|
Number |
Определяет дополнительный отступ в пикселях вне текущего окна просмотра, отслеживаемый диспетчером. Маркеры, попадающие в этот отступ, добавляются на карту, даже если они не полностью видны.
(Начиная с версии 2.67) |
maxZoom
|
Number |
Устанавливает максимальный коэффициент масштабирования, отслеживаемый диспетчером. Если не указан, диспетчер использует максимальный коэффициент масштабирования карты. Это значение также используется при добавлении маркеров в диспетчер без дополнительного параметра maxZoom.
(Начиная с версии 2.67) |
trackMarkers
|
Boolean |
Определяет, должен ли диспетчер отслеживать перемещения маркеров. Чтобы перемещать управляемые маркеры с помощью метода setPoint, в качестве значения этого параметра нужно установить true. false является значением по умолчанию.
(Начиная с версии 2.67) |
Экземпляры этого класса используются в аргументе opts? конструктора класса GMarker. У этого класса нет конструктора. Экземпляр класса создается в виде литерала объекта JavaScript.
В соответствии с названием этого класса все свойства являются необязательными.
| Свойство | Тип | Описание |
|---|---|---|
icon
|
GIcon |
Определяет значок для этого класса. Если не указан, используется G_DEFAULT_ICON.(Начиная с версии 2.50) |
dragCrossMove
|
Boolean |
При обычном перемещении маркер поднимается и остается около курсора. Если указать значение true, маркер останется под курсором, который переместится вниз. По умолчанию используется значение false.(Начиная с версии 2.63) |
title
|
String |
Эта строка появляется в виде подсказки для маркера, т. е. она используется в качестве атрибута title для элементов HTML.(Начиная с версии 2.50) |
clickable
|
Boolean |
Определяет, можно ли маркер активировать нажатием. Маркеры, которые нельзя активировать нажатием или переместить, являются инертными, потребляют меньше ресурсов и не воспринимают события. По умолчанию используется значение true, что означает, что если этот параметр не указан, маркер можно активировать нажатием.(Начиная с версии 2.50) |
draggable
|
Boolean |
Определяет, могут ли пользователи перемещать маркер. Для перетаскиваемых маркеров требуется больше ресурсов, чем для маркеров, которые можно активировать нажатием. Перетаскиваемый маркер также можно активировать нажатием. По умолчанию он может перемещаться вверх-вниз. Кроме того, включено автоматическое панорамирование. По умолчанию используется значение false.(Начиная с версии 2.61) |
bouncy
|
Boolean |
Определяет, должен ли маркер перемещаться вверх-вниз после перемещения. По умолчанию используется значение false.(Начиная с версии 2.61) |
bounceGravity
|
Number |
После перемещения это число используется для определения ускорения маркера во время перемещения вверх-вниз. По умолчанию используется значение 1.(Начиная с версии 2.61) |
autoPan
|
Boolean |
Осуществляет автоматическое панорамирование при перемещении маркера у границ. Если маркер перетаскиваемый, по умолчанию используется значение true.(Начиная с версии 2.87) |
zIndexProcess
|
Function |
Эта функция используется для изменения z-порядка маркеров при наложении на карту, а также вызывается при открытии их информационного окна. По умолчанию маркеры, которые располагаются южнее, находятся выше маркеров, которые располагаются севернее. Эта функция передается в объекте GMarker и возвращает новый z-порядок.(Начиная с версии 2.98) |
hide
|
Boolean |
Если принимает значение true, указывает, что на карте изначально должен быть скрыт объект GMarker. Чтобы отобразить его, вызовите метод GMarker.show(). По умолчанию используется значение false.
(Начиная с версии 2.139) |
Эта реализация интерфейса GProjection для проекции Меркатора используется всеми предопределенными типами карт.
| Конструктор | Описание |
|---|---|
GMercatorProjection(zoomlevels:Number)
|
Создает проекцию Меркатора для указанного количества коэффициентов масштабирования. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
fromLatLngToPixel(latlng:GLatLng,
zoom:Number)
|
GPoint |
Дополнительные сведения приведены в разделе GProjection |
fromPixelToLatLng(pixel:GPoint,
zoom:Number,
unbounded?:Boolean)
|
GLatLng |
Дополнительные сведения приведены в разделе GProjection |
tileCheckRange(tile:GPoint,
zoom:Number,
tilesize:Number)
|
None |
Дополнительные сведения приведены в разделе GProjection |
getWrapWidth(zoom:Number)
|
None |
Дополнительные сведения приведены в разделе GProjection Проекция Меркатора является периодической в параллельном направлении, поэтому она возвращает ширину карты всей поверхности Земли в пикселях при указанном коэффициенте масштабирования.(Начиная с версии 2.46) |
Этот интерфейс реализуется классами GMarker, GPolyline, GTileLayerOverlay и GInfoWindow в библиотеке API Карт. Его можно использовать, чтобы показывать на карте наложения пользовательского типа. Экземпляр интерфейса GOverlay можно поместить на карту с помощью метода GMap2.addOverlay(). Затем карта вызовет метод GOverlay.initialize() для экземпляра наложения, чтобы изначально отобразить его на карте. При изменении области просмотра карта вызовет метод GOverlay.redraw(), чтобы при необходимости изменить положение наложения. Экземпляр наложения может использовать метод GMap2.getPane(), чтобы прикрепить себя к одному или нескольким элементам контейнера DOM.
| Конструктор | Описание |
|---|---|
GOverlay()
|
Создает фиктивные реализации методов. Однако при наследовании этого класса в конструкторе производного класса для полноты нужно вызывать этот конструктор. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GOverlay.getZIndex(latitude:Number)
|
Number |
Возвращает значение CSS z-index для указанной широты. Рассчитывает z-порядок таким образом, чтобы наложения, расположенные южнее, находились поверх наложений, расположенных севернее. В результате получается трехмерное представление наложений маркеров. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
initialize(map:GMap2)
|
None |
Вызывается картой после добавления наложения на карту с помощью метода GMap2.addOverlay(). Наложение может отображаться на разных панелях карты, которые можно получить с помощью метода GMap2.getPane(). |
remove()
|
None |
Вызывается картой после удаления наложения с карты с помощью метода GMap2.removeOverlay() или GMap2.clearOverlays(). В этот момент наложение должно удалиться. |
copy()
|
GOverlay |
Возвращает свою неинициализированную копию, которую можно добавить на карту. |
redraw(force:Boolean)
|
None |
Вызывается картой при изменении области просмотра. Аргумент force будет принимать значение true, если изменение коэффициента масштабирования или сдвига в пикселях области просмотра привело к необходимости пересчета пиксельных координат. |
getKml(callback:Function)
|
None |
Используется для асинхронного получения представления KML наложения. Функция обратного вызова вызывается с аргументом в виде одной строки, частью строки KML, представляющей наложение, или значением null, если представление KML недоступно. Строка KML не будет включать объявление XML и корневой элемент <kml>.(Начиная с версии 2.167) |
| Событие | Описание |
|---|
Экземпляры этого класса используются в методах enableEditing объектов GPolyline и GPolygon. У этого класса нет конструктора. Экземпляр класса создается в виде литерала объекта JavaScript.
В соответствии с названием этого класса все свойства являются необязательными.
| Свойство | Тип | Описание |
|---|---|---|
maxVertices
|
Number |
Определяет максимальное количество вершин, допустимое для ломаной линии. Если максимум достигнут, вершины добавляться не будут. (Начиная с версии 2.111) |
fromStart
|
Boolean |
Определяет, должен ли метод enableDrawing добавлять вершины с начала, а не с конца. По умолчанию они добавляются с конца. (Начиная с версии 2.111) |
Экземпляры этого класса используются в методе setStrokeStyle классов GPolyline и GPolygon и методе setFillStyle класса GPolygon. У этого класса нет конструктора. Экземпляр класса создается в виде литерала объекта JavaScript.
В соответствии с названием этого класса все свойства являются необязательными.
| Свойство | Тип | Описание |
|---|---|---|
color
|
String |
Определяет цвет в виде строки, содержащей шестнадцатеричный код цвета в HTML, т. е. #RRGGBB.
(Начиная с версии 2.111) |
weight
|
Number |
Определяет толщину линии в пикселях. (Начиная с версии 2.111) |
opacity
|
Number |
Определяет непрозрачность ломаной линии в виде дробного числа от 0 (прозрачная) до 1 (непрозрачная). (Начиная с версии 2.111) |
Он очень похож на класс GPolyline, только в нем можно дополнительно указывать цвет заливки и непрозрачность.
| Конструктор | Описание |
|---|---|
GPolygon(latlngs:GLatLng[],
strokeColor?:String,
strokeWeight?:Number,
strokeOpacity?:Number,
fillColor?:Number,
fillOpacity?:Number,
opts?:GPolygonOptions)
|
Создает многоугольник из массива вершин. Цвета (colors) указываются в виде строки, содержащей шестнадцатеричный код цвета в HTML, т. е. #RRGGBB. Аргумент weight определяет толщину линии в пикселях. Аргумент opacities указывается в виде числа от 0 до 1. Символы строки будут сглаженными и полупрозрачными.(Начиная с версии 2.69) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GPolygon.fromEncoded(polylines:encoded polylines[],
fill?:Boolean,
color?:String,
opacity?:Number,
outline?:Boolean)
|
GPolygon |
Создает многоугольник (состоящий из набора ломаных линий) из строк с обобщенными координатами и коэффициентами масштабирования. Аргумент polylines содержит ассоциативный массив последовательных ломаных линий, представленных в формате, описанном в документации по методу GPolyline.fromEncoded . Аргумент fill определяет, нужно ли заполнить многоугольник указанным цветом color. Аргументы opacity и outline определяют, нужно ли применить к многоугольнику цвет, толщину и непрозрачность ломаной линии. Если для ломаных линий указаны разные значения, используются значения для первой ломаной линии.
(Начиная с версии 2.78) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
deleteVertex(index:Number)
|
None |
Удаляет вершину многоугольника с указанным индексом и обновляет его форму соответствующим образом. Объект GPolygon должен быть добавлен на карту с помощью метода GMap2.addOverlay().
(Начиная с версии 2.111) |
disableEditing()
|
None |
Отменяет действие метода enableEditing, удаляя все контрольные точки линии и запрещая пользователю ее редактировать.
(Начиная с версии 2.111) |
enableDrawing(opts?:GPolyEditingOptions)
|
None |
Позволяет пользователю создать объект GPolygon, нажав на дополнительные точки на карте. Объект GPolygon должен быть добавлен на карту с помощью метода GMap2.addOverlay(), даже если многоугольник не заполнен и его вершины не определены. При каждом нажатии добавляется дополнительная вершина на границу многоугольника. Рисование можно завершить по двойному нажатию или по нажатию на первой точке, таким образом очертив контур фигуры. В этой точке при успешном создании многоугольника будет вызвано событие endline, в противном случае – событие cancelline, однако при этом фигура не будет удалена с карты.
(Начиная с версии 2.111) |
enableEditing(opts?:GPolyEditingOptions)
|
None |
Разрешает изменение существующей границы объекта GPolygon. Если эта возможность включена, пользователи могут выбирать и перемещать существующие вершины. Объект GPolygon должен быть добавлен на карту с помощью метода GMap2.addOverlay(). До тех пор, пока текущее количество вершин не превышает ограничение на их количество, указанное в свойстве maxVertices объекта GPolyEditingOptions, на ребра многоугольника добавляются фиктивные промежуточные точки. Пользователи могут интерполировать новые вершины, нажимая на них и перемещая их. При добавлении или перемещении вершины вызывается событие lineupdated.
(Начиная с версии 2.111) |
getVertexCount()
|
Number |
Возвращает количество вершин многоугольника. (Начиная с версии 2.69) |
getVertex(index:Number)
|
GLatLng |
Возвращает вершину многоугольника с указанным индексом. (Начиная с версии 2.69) |
getArea()
|
Number |
Возвращает площадь многоугольника (в квадратных метрах). При этом Земля считается сферой. (Начиная с версии 2.85) |
getBounds()
|
GLatLngBounds |
Возвращает границы многоугольника. (Начиная с версии 2.85) |
hide()
|
None |
Скрывает многоугольник, если он видим и метод GPolygon.supportsHide возвращает значение true. Обратите внимание, что если многоугольник видим, эта функция вызывает событие GPolygon.visibilitychanged.(Начиная с версии 2.87) |
insertVertex(index:Number,
latlng:GLatLng)
|
None |
Добавляет вершину с указанным индексом в многоугольник. Объект GPolygon должен быть добавлен на карту с помощью метода GMap2.addOverlay().
(Начиная с версии 2.111) |
isHidden()
|
Boolean |
Возвращает значение true, если многоугольник скрыт. В противном случае возвращает false. (Начиная с версии 2.87) |
show()
|
None |
Показывает многоугольник, если он скрыт. Обратите внимание, что если многоугольник скрыт, эта функция вызывает событие GPolygon.visibilitychanged.(Начиная с версии 2.87) |
supportsHide()
|
Boolean |
Возвращает значение true, если для объектов GPolygon в текущей среде поддерживается метод GPolygon.hide(). В противном случае возвращает false. (Начиная с версии 2.87) |
setFillStyle(style:GPolyStyleOptions)
|
None |
Изменяет стиль заполнения многоугольника. Объект GPolygon должен быть добавлен на карту с помощью метода GMap2.addOverlay().
(Начиная с версии 2.111) |
setStrokeStyle(style:GPolyStyleOptions)
|
None |
Изменяет стиль линии границы многоугольника. Объект GPolygon должен быть добавлен на карту с помощью метода GMap2.addOverlay().
(Начиная с версии 2.111) |
| Событие | Описание |
|---|---|
remove()
|
Это событие вызывается при удалении многоугольника с карты с помощью метода GMap2.removeOverlay() или GMap2.clearOverlays(). |
visibilitychanged(isVisible:Boolean)
|
Это событие вызывается при изменении состояния видимости многоугольника: с видимого на скрытое и наоборот. Аргумент isVisible указывает состояние видимости многоугольника после изменения.
(Начиная с версии 2.87) |
click(latlng:GLatLng)
|
Это событие вызывается при нажатии на многоугольнике. Передает координату нажатой точки многоугольника в аргументе latlng. Обратите внимание, что после этого события вызывается событие нажатия карты, в котором многоугольник передается в качестве аргумента overlay.
(Начиная с версии 2.88) |
mouseover()
|
Это событие вызывается при перемещении курсора мыши в многоугольник.
(Начиная с версии 2.111) |
mouseout()
|
Это событие вызывается при перемещении курсора мыши за пределы многоугольника.
(Начиная с версии 2.111) |
lineupdated()
|
Это событие вызывается при изменении стиля или формы многоугольника.
(Начиная с версии 2.111) |
endline()
|
Это событие вызывается по завершении рисования многоугольника пользователем (начатого с вызова метода GPolyline.enableDrawing).
(Начиная с версии 2.111) |
cancelline()
|
Это событие вызывается при прерывании рисования многоугольника пользователем (начатого с вызова метода GPolyline.enableDrawing).
(Начиная с версии 2.111) |
Экземпляры этого класса используются в конструкторе объектов GPolygon. У этого класса нет конструктора. Экземпляр класса создается в виде литерала объекта JavaScript.
В соответствии с названием этого класса все свойства являются необязательными.
| Свойство | Тип | Описание |
|---|---|---|
clickable
|
Boolean |
Определяет, можно ли многоугольник активировать нажатием. По умолчанию используется значение true, т. е. если значение параметра не указано, многоугольник можно активировать нажатием.
(Начиная с версии 2.91) |
mouseOutTolerance
|
number |
Определяет расстояние (в пикселях), на которое должен быть перемещен курсор мыши за пределы многоугольника до вызова события mouseout.
(Начиная с версии 2.158) |
Экземпляр этого класса представляет собой наложение на карту в виде ломаной линии. Оно создается с помощью возможностей браузера по работе с векторной графикой, если он ими обладает, или с помощью наложенных изображений с серверов Google в противном случае.
| Конструктор | Описание |
|---|---|
GPolyline(latlngs:GLatLng[],
color?:String,
weight?:Number,
opacity?:Number,
opts?:GPolylineOptions)
|
Создает ломаную линию из массива точек. Цвета (color) указываются в виде строки, содержащей шестнадцатеричный код цвета в HTML, т. е. #RRGGBB. Аргумент weight определяет толщину линии в пикселях. Аргумент opacity указывается в виде числа от 0 до 1. Символы строки будут сглаженными и полупрозрачными. |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GPolyline.fromEncoded(color?:String,
weight?:Number,
opacity?:Number,
latlngs:String,
zoomFactor:Number,
levels:String,
numLevels:Number)
|
GPolyline |
Создает ломаную линию из строк с обобщенными координатами и коэффициентами масштабирования. Аргумент color указывает цвет в виде строки, содержащей шестнадцатеричный код цвета в HTML, т. е. #RRGGBB. Аргумент weight указывает толщину линии в пикселях. Аргумент opacity указывается в виде числа от 0 до 1. Аргумент latlngs содержит строку с преобразованными координатами широты и долготы. Аргумент levels содержит строку с группами преобразованных коэффициентов масштабирования. Аргумент numLevels определяет количество коэффициентов масштабирования в преобразованной строке levels. Аргумент zoomFactor определяет коэффициент увеличения между смежными наборами коэффициентов масштабирования в преобразованной строке levels. Оба эти значения определяют точность масштабирования levels преобразованной ломаной линии. Символы строки будут сглаженными и полупрозрачными.(Начиная с версии 2.63) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
deleteVertex(index:Number)
|
None |
Удаляет вершину ломаной линии с указанным индексом и обновляет ее форму соответствующим образом. Объект GPolyline должен быть добавлен на карту с помощью метода GMap2.addOverlay().
(Начиная с версии 2.111) |
disableEditing()
|
None |
Отменяет действие метода enableEditing, удаляя все контрольные точки линии и запрещая пользователю ее редактировать.
(Начиная с версии 2.111) |
enableDrawing(opts?:GPolyEditingOptions)
|
None |
Позволяет пользователю создавать (или изменять) объект GPolyline, нажав на дополнительные вершины на карте. Объект GPolyline должен быть добавлен на карту с помощью метода GMap2.addOverlay(), даже если вершины ломаной линии не определены. При каждом нажатии добавляется дополнительная вершина на ломаную линию. Рисование можно завершить по двойному нажатию или по повторному нажатию на последней добавленной точке. В этой точке при успешном создании ломаной линии будет вызвано событие endline, в противном случае – событие cancelline, однако при этом линия не будет удалена с карты. При изменении существующего объекта GPolyline вершины связаны с начальной или конечной точкой существующей ломаной линии в соответствии со значением необязательного параметра GPolyEditingOptions.fromStart.
(Начиная с версии 2.111) |
enableEditing(opts?:GPolyEditingOptions)
|
None |
Разрешает изменение существующей ломаной линии GPolyline. Если эта возможность включена, пользователи могут выбирать и перемещать существующие вершины. Объект GPolyline должен быть добавлен на карту с помощью метода GMap2.addOverlay(). До тех пор, пока текущее количество вершин не превышает ограничение на их количество, указанное в свойстве maxVertices объекта GPolyEditingOptions, на отрезки ломаной линии добавляются фиктивные промежуточные точки. Пользователи могут интерполировать новые вершины, нажимая и перемещая их. При добавлении или перемещении вершины вызывается событие lineupdated.
(Начиная с версии 2.111) |
getVertexCount()
|
Number |
Возвращает количество вершин ломаной линии. (Начиная с версии 2.46) |
getVertex(index:Number)
|
GLatLng |
Возвращает вершину ломаной линии с указанным индексом. (Начиная с версии 2.46) |
getLength()
|
Number |
Возвращает длину ломаной линии (в метрах) на сферической поверхности Земли. (Начиная с версии 2.85) |
getBounds()
|
GLatLngBounds |
Возвращает крайние вершины ломаной линии. (Начиная с версии 2.85) |
hide()
|
None |
Скрывает ломаную линию, если она видима и метод GPolyline.supportsHide() возвращает значение true. Обратите внимание, что если ломаная линия видима, эта функция вызывает событие GPolyline.visibilitychanged.(Начиная с версии 2.87) |
insertVertex(index:Number,
latlng:GLatLng)
|
None |
Добавляет точку с указанным индексом на ломаную линию и обновляет ее форму. Объект GPolyline должен быть добавлен на карту с помощью метода GMap2.addOverlay().
(Начиная с версии 2.111) |
isHidden()
|
Boolean |
Возвращает значение true, если ломаная линия скрыта. В противном случае возвращает false. (Начиная с версии 2.87) |
show()
|
None |
Показывает ломаную линию, если она скрыта. Обратите внимание, что если ломаная линия скрыта, эта функция вызывает событие GPolyline.visibilitychanged.(Начиная с версии 2.87) |
supportsHide()
|
Boolean |
Возвращает значение true, если для объектов GPolyline в текущей среде поддерживается метод GPolyline.hide(). В противном случае возвращает false. (Начиная с версии 2.87) |
setStrokeStyle(style:GPolyStyleOptions)
|
None |
Изменяет стиль ломаной линии. Объект GPolyline должен быть добавлен на карту с помощью метода GMap2.addOverlay().
(Начиная с версии 2.111) |
| Событие | Описание |
|---|---|
remove()
|
Это событие вызывается при удалении ломаной линии с карты с помощью метода GMap2.removeOverlay() или GMap2.clearOverlays(). |
visibilitychanged(isVisible:Boolean)
|
Это событие вызывается при изменении состояния видимости ломаной линии: с видимого на скрытое и наоборот. Аргумент isVisible указывает состояние видимости ломаной линии после изменения.
(Начиная с версии 2.87) |
click(latlng:GLatLng)
|
Это событие вызывается при нажатии на ломаную линию кнопкой мыши. Передает координату нажатой точки ломаной линии в аргументе latlng. Обратите внимание, что после этого события вызывается событие click карты, в котором многоугольник передается в качестве аргумента overlay.
(Начиная с версии 2.88) |
mouseover()
|
Это событие вызывается при перемещении курсора мыши на ломаную линию.
(Начиная с версии 2.111) |
mouseout()
|
Это событие вызывается при перемещении курсора мыши с ломаной линии.
(Начиная с версии 2.111) |
lineupdated()
|
Это событие вызывается при изменении стиля или формы ломаной линии.
(Начиная с версии 2.111) |
endline()
|
Это событие вызывается по завершении рисования линии пользователем (начатого с вызова метода GPolyline.enableDrawing).
(Начиная с версии 2.111) |
cancelline()
|
Это событие вызывается при прерывании рисования линии пользователем (начатого с вызова метода GPolyline.enableDrawing).
(Начиная с версии 2.111) |
Экземпляры этого класса используются в конструкторе объектов GPolyline. У этого класса нет конструктора. Экземпляр класса создается в виде литерала объекта JavaScript.
В соответствии с названием этого класса все свойства являются необязательными.
| Свойство | Тип | Описание |
|---|---|---|
clickable
|
Boolean |
Определяет, можно ли ломаную линию активировать нажатием. По умолчанию используется true, т. е. если параметр не указан, ломаную линию можно активировать нажатием.
(Начиная с версии 2.91) |
geodesic
|
Boolean |
Визуализирует каждое звено ломаной линии в виде части геодезической линии (фрагмента "большого круга"). Геодезическая линия представляет кратчайший путь между точками на поверхности Земли.
(Начиная с версии 2.84) |
mouseOutTolerance
|
number |
Определяет расстояние (в пикселях), на которое должен быть перемещен курсор мыши перпендикулярно ломаной линии до вызова события mouseout.
(Начиная с версии 2.158) |
Это интерфейс для проекций карт. Экземпляр проекции карты передается в конструктор объекта GMapType. Этот интерфейс реализуется классом class GMercatorProjection, который используется всеми предопределенными типами карт. Этот интерфейс следует реализовывать, чтобы определить типы карт с другими проекциями.
Эти методы вызываются картой. Их нужно реализовать.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
fromLatLngToPixel(latlng:GLatLng,
zoom:Number)
|
GPoint |
Возвращает координаты в пикселях точки с указанными географическими координатами при указанном коэффициенте масштабирования на карте. |
fromPixelToLatLng(pixel:GPoint,
zoom:Number,
unbounded?:Boolean)
|
GLatLng |
Возвращает географические координаты точки с указанными координатами в пикселях при указанном коэффициенте масштабирования на карте. Флажок unbounded позволяет не связывать географические координаты по долготе при переходе через меридиан -180 или 180 градусов. |
tileCheckRange(tile:GPoint,
zoom:Number,
tilesize:Number)
|
Boolean |
Возвращается карте логическое значение, определяющее, находится ли индекс фрагмента в допустимых для типа карты пределах. В противном случае на карте отображается пустой фрагмент. Он также может изменить индекс фрагмента tile, чтобы он соответствовал другому экземпляру того же фрагмента в случае, если карта содержит несколько копий модели Земли, а значит такой же фрагмент расположен в других координатах. |
getWrapWidth(zoom:Number)
|
Number |
Возвращает карте периодичность координаты x, а именно количество пикселей, через которое изображение карты повторяется, поскольку она разрывается в одном месте при охвате Земли. По умолчанию возвращает значение Infinity, т. е. карта не повторяется. Этот метод используется, чтобы рассчитать положение наложений в областях просмотра, содержащих несколько копий модели Земли (это обычно происходит при малых коэффициентах масштабирования).(Начиная с версии 2.46) |
Этот объект представляет собой прямоугольное наложенное на карту изображение, положение которого при изменении окна просмотра не изменяется. Примерами использования технологии ScreenOverlays являются компасы, логотипы и рекламные изображения.
| Конструктор | Описание |
|---|---|
GScreenOverlay(imageUrl:String,
screenXY:GScreenPoint,
overlayXY:GScreenPoint,
size:GScreenSize)
|
Создает наложенное на экран изображение по URL и отображает его на экране в соответствии со значениями параметров screenXY, overlayXY и size. Параметр overlayXY определяет точку на наложенном изображении (или за его пределами), привязанного к точке экрана screenXY. Его можно использовать для эффективного кадрирования изображения. Параметр screenXY определяет точку относительно начальной точки экрана (левого нижнего угла), к которой привязано наложенное изображение.(Начиная с версии 2.92) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
hide()
|
None |
Скрывает наложение на экране, если оно видимо. Обратите внимание, что если наложение видимо на экране, эта функция вызывает событие GScreenOverlay.visibilitychanged.(Начиная с версии 2.92) |
isHidden()
|
Boolean |
Возвращает значение true, если наложение скрыто. В противном случае возвращает false. (Начиная с версии 2.92) |
show()
|
None |
Показывает наложение на экране, если оно скрыто. Обратите внимание, что если наложение на экране скрыто, эта функция вызывает событие GScreenOverlay.visibilitychanged.(Начиная с версии 2.92) |
supportsHide()
|
Boolean |
Всегда возвращает значение true.(Начиная с версии 2.92) |
| Событие | Описание |
|---|---|
visibilitychanged(isVisible:Boolean)
|
Это событие вызывается при изменении состояния видимости наложения на экране: с видимого на скрытое и наоборот. Аргумент isVisible указывает состояние видимости наложения на экране после изменения.
(Начиная с версии 2.92) |
Объект GScreenPoint определяет точку в окне просмотра карты по координатам X и Y, каждая из которых представлена в виде доли или целого числа в зависимости от значений необязательных параметров конструктора.
| Конструктор | Описание |
|---|---|
GScreenPoint(x:Number,
y:Number,
xunits?:String,
yunits?:String)
|
Создает объект GScreenPoint. Координаты x и y могут быть представлены в виде относительных или абсолютных значений, путем передачи значений fraction и pixels в параметры xunits и yunits. По умолчанию используется значение pixels.
(Начиная с версии 2.92) |
| Свойство | Тип | Описание |
|---|---|---|
x
|
Number |
Координата x. Увеличивается справа налево. |
y
|
Number |
Координата y. Увеличивается сверху вниз. |
xunits
|
String |
Определяет тип единиц измерения, который нужно использовать для координаты x. Чтобы задавать положение относительно размера карты, укажите fraction. При использовании абсолютных значений укажите pixels. По умолчанию используются абсолютные значения. |
yunits
|
String |
Определяет тип единиц измерения, который нужно использовать для координаты y. Чтобы задавать положение относительно размера карты, укажите fraction. При использовании абсолютных значений укажите pixels. По умолчанию используются абсолютные значения. |
Объект GScreenSize определяет размер прямоугольной области карты с помощью параметров width и height. В зависимости от значений необязательных параметров конструктора каждый из этих параметров может представлять либо долю от размера карты, либо абсолютный размер в пикселях.
| Конструктор | Описание |
|---|---|
GScreenSize(width:Number,
height:Number,
xunits?:String,
yunits?:String)
|
Создает объект GScreenSize. Координаты width и height могут быть представлены в виде относительных или абсолютных значений путем передачи значений fraction и pixels в параметры xunits и yunits. По умолчанию для аргументов width и height используется значение pixel.
(Начиная с версии 2.92) |
| Свойство | Тип | Описание |
|---|---|---|
width
|
Number |
Параметр ширины прямоугольной области карты. Обратите внимание, что в зависимости от значения свойства GScreen.yunits это значения можно задавать в виде относительного или абсолютного значения. |
height
|
Number |
Параметр высоты прямоугольной области карты. Обратите внимание, что в зависимости от значения свойства GScreen.yunits это значения можно задавать в виде относительного или абсолютного значения. |
xunits
|
String |
Определяет тип единиц измерения, который нужно использовать для свойства GScreenSize.width. Чтобы задавать положение относительно размера карты, укажите fraction. При использовании абсолютных значений укажите pixel. По умолчанию используются абсолютные значения. |
yunits
|
String |
Определяет тип единиц измерения, который нужно использовать для свойства GScreenSize.height. Чтобы задавать положение относительно размера карты, укажите fraction. При использовании абсолютных значений укажите pixel. По умолчанию используются абсолютные значения. |
Этот интерфейс нужно реализовывать, чтобы добавить на карту пользовательские слои фрагментов с помощью объекта GMapType или GTileLayerOverlay. В реализации этого интерфейса нужно использовать экземпляр класса GTileLayer в качестве прототипа, поскольку он обрабатывает информацию об авторских правах.
| Конструктор | Описание |
|---|---|
GTileLayer(copyrights:GCopyrightCollection,
minResolution:Number,
maxResolution:Number,
options?:GTileLayerOptions)
|
При создании экземпляра в качестве прототипа можно опустить ряд аргументов конструктора. Конструктор подкласса должен вызывать этот конструктор с помощью метода call(). Необязательный параметр options указывает набор параметров GTileLayerOptions, которые нужно передавать в виде литерала объекта. |
Эти методы вызываются картой и типом карты, для которого предназначен этот слой фрагмента. При реализации пользовательского слоя фрагмента нужно реализовать методы, отмеченные как абстрактные.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
minResolution()
|
Number |
Возвращает типу карты минимальный коэффициент масштабирования слоя фрагмента. |
maxResolution()
|
Number |
Возвращает типу карты максимальный коэффициент масштабирования слоя фрагмента. |
getTileUrl(tile:GPoint,
zoom:Number)
|
String |
Абстрактный. Возвращает карте URL фрагмента карты с индексами фрагментов, указанными в свойствах x и y объекта GPoint при указанном коэффициенте масштабирования. |
isPng()
|
Boolean |
Абстрактный. Возвращает карте логическое значение, определяющее, предоставлены ли фрагменты в формате PNG и, соответственно, могут быть прозрачными. В противном случае используется GIF. |
getOpacity()
|
Number |
Абстрактный. Возвращает типу карты коэффициент непрозрачности слоя фрагмента. 1.0 означает непрозрачный, 0.0 – прозрачный. |
getCopyright(bounds:GLatLngBounds,
zoom:Number)
|
String |
Абстрактный. Возвращает карте сообщения с информацией об авторских правах, которая применима к указанному региону карты при указанном коэффициенте масштабирования, для этого слоя фрагмента. Этот метод используется для создания сообщений с информацией об авторских правах объекта GMapType, к которому принадлежит этот слой фрагмента.(Начиная с версии 2.89) |
| Событие | Описание |
|---|---|
newcopyright(copyright:GCopyright)
|
Это событие вызывается при добавлении информации об авторских правах в соответствующую коллекцию этого слоя фрагмента. |
Этот класс предоставляет необязательные аргументы в интерфейс GTileLayer. У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
opacity
|
Number |
Определяет коэффициент непрозрачности фрагмента от 0.0 (прозрачный) до 1.0 (непрозрачный). По умолчанию используется 1.0. |
isPng
|
Boolean |
Определяет, находятся ли фрагменты в формате PNG. |
tileUrlTemplate
|
String |
Определяет шаблон URL-адресов фрагментов, которые будут изменяться при каждом запросе фрагмента таким образом, чтобы они ссылались на уникальный фрагмент в системе координат существующего фрагмента. При определении шаблона в конструкторе GTileLayer можно динамически получать фрагменты в этой системе координат точно так же, как это реализовано в Картах Google.
Шаблоны должны быть следующего вида: http://host/tile?x={X}&y={Y}&z={Z}.png
где X и Y – координаты широты и долготы фрагмента, а Z – коэффициент масштабирования. Например, http://host/tile?x=3&y=27&z=5.png. |
draggingCursor
|
String |
Курсор, который нужно показывать при перетаскивании. (Начиная с версии 2.59) |
Объект GTileLayerOverlay добавляет на карту объект GTileLayer. Он реализует интерфейс GOverlay и поэтому добавляется на карту с помощью метода GMap2.addOverlay(). Объект GTileLayer размещается над существующим изображением карты. Чтобы заменить им изображение, используйте объект GTileLayer в пользовательском объекте GMapType.
| Конструктор | Описание |
|---|---|
GTileLayerOverlay(tileLayer:GTileLayer,
opts?:GTileLayerOverlayOptions)
|
Создает объект GOverlay, который содержит объект tileLayer.(Начиная с версии 2.61) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
hide()
|
None |
Скрывает наложение, но сохраняет его место в стеке наложений. (Начиная с версии 2.71) |
isHidden()
|
None |
Возвращает значение true, если слой фрагментного наложения скрыт. В противном случае возвращает false.(Начиная с версии 2.87) |
show()
|
None |
Отображает ранее скрытый объект GTileLayerOverlay.(Начиная с версии 2.71) |
refresh()
|
None |
Перезагружает все видимые фрагменты, прикрепленные к объекту GTileLayerOverlay.(Начиная с версии 2.132) |
supportsHide()
|
None |
Всегда возвращает значение true.(Начиная с версии 2.87) |
getTileLayer()
|
None |
Возвращает используемый слой фрагментного наложения. (Начиная с версии 2.83) |
Этот класс предоставляет необязательные аргументы в конструктор GTileLayerOverlayOptions. У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
zPriority
|
Number |
zPriority содержит значение относительного z-порядка для этого объекта TileLayerOverlay. Слои фрагментов с большими значениями визуализируются над слоями с меньшими значениями.(Начиная с версии 2.110) |
Объект GAdsManager получает рекламу AdSense для Карт и размещает ее на указанной карте. Реклама отображается в выбранном стиле style. Кроме того, в соответствии с ним ее можно увеличивать путем нажатия на нее. Объект GAdsManager выбирает рекламу AdSense, основываясь на текущем окне просмотра и тексте сообщений на странице. Обратите внимание, что при добавлении объекта GAdsManager на карту, нужно явно включить его с помощью метода enable().
| Конструктор | Описание |
|---|---|
GAdsManager(map:GMap2,
publisherId:String,
adsManagerOptions?:GAdsManagerOptions)
|
Создает объект GAdsManager, который запрашивает рекламу AdSense с серверов Google. Параметр map определяет карту, на которой этот объект GAdsManager должен разместить рекламу. Параметр publisherId указывает аккаунт AdSense разработчика. Параметр adsManagerOptions представляет собой литерал объекта GAdsManagerOptions.(Начиная с версии 2.85) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
enable()
|
None |
Включает получение рекламы. По умолчанию реклама не запрашивается. (Начиная с версии 2.85) |
disable()
|
None |
Отключает получение рекламы. (Начиная с версии 2.85) |
Этот класс передает необязательные аргументы в конструктор GAdsManager. У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
style
|
GAdsManagerStyle |
Стиль размещения рекламы AdSense на картах. (Начиная с версии 2.158) |
maxAdsOnMap
|
Number |
Максимальное количество рекламных сообщений, которые можно одновременно показывать на карте. По умолчанию используется 10. На самом деле получается гораздо меньше. (Начиная с версии 2.85) |
channel
|
Number |
Номер канала AdSense, используемый для получения рекламы. Каналы представляют собой дополнительную функцию для издателей AdSense, которую они могут использовать для отслеживания прибыли от рекламы из разных источников. (Начиная с версии 2.85) |
minZoomLevel
|
Number |
Минимальный коэффициент масштабирования, при котором нужно показывать рекламу. Значение по умолчанию – 6. (Начиная с версии 2.85) |
position
|
GControlPosition |
Положение на карте, в котором нужно размещать рекламу при использовании в качестве стиля GAdsManagerOptions.style G_ADSMANAGER_STYLE_ADUNIT. По умолчанию в этом стиле реклама размещается в правом нижнем углу карты.(Начиная с версии 2.158) |
Эти константы определяют стиль рекламы, размещаемой посредством объекта GAdsManager. Стиль определяется в свойстве GAdsManagerOptions.style.
| Константа | Описание |
|---|---|
G_ADSMANAGER_STYLE_ADUNIT
|
Определяет, что объекту GAdsManager нужно размещать контекстную рекламу во фрейме на карте.(Начиная с версии 2.163) |
G_ADSMANAGER_STYLE_ICON
|
Определяет, что объекту GAdsManager нужно размещать рекламные сообщения в виде отдельных значков на карте.(Начиная с версии 2.163) |
Этот класс используется для прямого взаимодействия с серверами Google с целью получения географических кодов для указанных пользователем адресов. Кроме того, у геокодера есть собственный кэш адресов, который позволяет выполнять одинаковые запросы без повторного обращения к серверу. Общепринято не использовать функции GClientGeocoder в цикле. Разработчикам, которым нужно выполнить геокодирование большого числа адресов, следует использовать наш Геокодер HTTP.
| Конструктор | Описание |
|---|---|
GClientGeocoder(cache?:GGeocodeCache)
|
Создает экземпляр геокодера, который напрямую обращается к серверам Google. Необязательный параметр cache позволяет создавать пользовательский кэш известных адресов на стороне клиента. Если он не указан, используется объект GFactualGeocodeCache.
(Начиная с версии 2.55) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
getLatLng(address:String,
callback:function)
|
None |
Отправляет запрос серверам Google на геокодирование указанного адреса. Если адрес успешно определен, вызывается определенная пользователем функция обратного вызова с точкой GLatLng. В противном случае она вызывается со значением null. В случае неточно определенного адреса в функцию обратного вызова передается только наиболее подходящая точка.
(Начиная с версии 2.55) |
getLocations(address:String,
callback:function)
|
None |
Этот метод выполняет геокодирование, т. е. преобразование адреса из общепринятого формата в пару координат широты и долготы. Метод getLocations() отправляет запрос к службе геокодирования Google на преобразование указанного адреса address и обработку ответа в указанной функции callback.Поскольку эта служба должна обращаться к серверу Google, для обработки ответа нужно также передать метод callback. Ответ будет содержать код состояния Status и при успешном выполнении запроса один или несколько объектов
Placemark. Обратите внимание, что начиная с версии 2.133 этот метод дополнен. Теперь в нем можно передавать объекты GLatLng для обратного геокодирования, как это описано в следующем пункте справочного руководства.
(Начиная с версии 2.55) |
getLocations(latlng:GLatLng,
callback:function)
|
None |
Этот метод выполняет обратное геокодирование, т.е. преобразование адреса из пары координат широты и долготы в общепринятый формат. Объект getLocations() отправляет запрос к службе геокодирования Google на преобразование указанных координат latlng в адрес и передачу ответа в функцию callback.Поскольку эта служба должна обращаться к серверу Google, для обработки ответа нужно также передать метод callback. Ответ будет содержать код состояния Status и при успешном выполнении запроса один или несколько объектов
Placemark.Обратите внимание, что вместо этого метод может передавать строку String с адресом, как описано выше. В этом случае служба выполнит обычное геокодирование. Однако, если в качестве первого аргумента указать объект GLatLng, служба выполнит обратное геокодирование.(Начиная с версии 2.133) |
getCache()
|
GGeocodeCache |
Возвращает используемый кэш геокодирования или значение null, если кэширование на стороне клиента не выполняется.
(Начиная с версии 2.55) |
setCache(cache:GGeocodeCache)
|
None |
Запускает процесс кэширования на стороне клиента. Если этот метод вызывается со значением null аргумента cache, кэширование на стороне клиента отключено. При создании нового кэша ранее сохраненные адреса удаляются.
(Начиная с версии 2.55) |
setViewport(bounds:GLatLngBounds)
|
None |
Указывает геокодеру приблизить результаты геокодирования к указанному окну просмотра. Окно просмотра определено в виде прямоугольной области GLatLngBounds. Обратите внимание, что окно просмотра не ограничивает результаты, однако оно повышает их приоритет.
(Начиная с версии 2.82) |
getViewport()
|
GLatLngBounds |
Возвращает окно просмотра для приближения результатов геокодирования геокодера. Окно просмотра определено в виде прямоугольной области GLatLngBounds.
(Начиная с версии 2.82) |
setBaseCountryCode(countryCode:String)
|
None |
Указывает геокодеру сместить результаты поиска, как если бы они были отправлены с домена верхнего уровня страны (ccTLD). Геокодирование поддерживается только для стран, где оно поддерживается на Картах Google. Большинство кодов ccTLD идентичны кодам ISO 3166-1 с некоторыми существенными исключениями. Например, ccTLD Великобритании – "uk" ( Обратите внимание, что по умолчанию используется домен, с которого первоначально загружен API Карт. Коды стран не чувствительны к регистру. (Начиная с версии 2.82) |
getBaseCountryCode()
|
String |
Возвращает текущий код страны, используемый указанным геокодером. (Если код страны не используется, этот метод возвращает null.)
(Начиная с версии 2.82) |
reset()
|
None |
Сбрасывает геокодер. В частности, этот метод вызывает метод GGeocodeCache.reset() для кэша на стороне клиента, если он используется геокодером.
(Начиная с версии 2.55) |
Этот класс можно использовать, чтобы получать маршруты проезда и показывать их на карте и/или на текстовой панели.
| Конструктор | Описание |
|---|---|
GDirections(map?:GMap2,
panel?:Element)
|
Создает экземпляр объекта маршрута для запроса маршрутов проезда и хранения полученных результатов. Этот объект может затем создавать маршруты проезда на основе этого запроса с помощью метода GDirections.load().В конструкторе можно использовать объект карты (для отображения на ней ломаных линий маршрутов) и/или элемента DIV панели (для отображения на ней текстового описания маршрутов). Если передается аргумент map, то при расчете нового маршрута на карту добавляется ломаная линия и связанные с результатом маркеры в виде наложений. Аналогично, при передаче аргумента panel текстовое описание полученного в результате маршрута добавляется на указанную панель DIV, заменяя ее текущее содержание.Если один из аргументов принимает значение null, связанные с ними элементы не отображаются за исключением случаев, когда они явно запрошены в методе GDirections.load(). (См. ниже.)
Кроме того, объект содержит три прослушивателя событий, которые можно перехватить:
(Начиная с версии 2.81) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
load(query:String,
queryOpts?:GDirectionsOptions)
|
None |
Выполняет новый запрос маршрутов. Параметр query представляет собой строку, содержащую действительные маршруты, например "из: Санкт-Петербург в: Москва" или "из: Санкт-Петербург в: Москва в: Сочи". По умолчанию, если в конструкторе объекта GDirections была указана карта, запрашивается результат в виде ломаной линии. Аналогично, если была указана панель с текстом, запрашивается подробное текстовое описание. В противном случае в результате будет получена лишь краткая информация о маршрутах.Чтобы переопределить это поведение (например, запрашивать результат в виде ломаной линии, даже когда карта не прикреплена к этому объекту), вызывающие методы могут использовать необязательный параметр queryOpts. Дополнительную информацию можно найти в документации по объекту GDirectionsOptions.
Получив результаты запроса маршрутов, этот объект удаляет старые результаты, заменяя их новыми, и обновляет карту и/или панель, добавляя новые результаты. Результаты состоят из нескольких маршрутов (объектов типа
Если метод (Начиная с версии 2.81) |
loadFromWaypoints(waypoints:Array,
queryOpts?:GDirectionsOptions)
|
None |
Выполняет новый запрос маршрутов, предоставляя в качестве исходных данных массив пунктов, а не одну строку. Этот массив максимально может содержать 25 пунктов маршрута. Каждый элемент маршрута представляет собой строку, содержащую указанный адрес или точку с координатами широты и долготы. Дополнительную информацию о поведении этого метода можно найти в описании метода GDirections.load().
(Начиная с версии 2.81) |
clear()
|
None |
Удаляет существующие результаты запроса маршрутов, наложенную на карту и панель графику и отменяет все запросы load(), находящиеся в состоянии ожидания.
(Начиная с версии 2.81) |
getStatus()
|
Object |
Возвращает состояние запроса маршрутов. Возвращается объект следующей формы: { код: 200 запрос: "маршруты" } Код состояния может быть одним из значений, определенных для объекта GGeoStatusCode.
(Начиная с версии 2.81) |
getBounds()
|
GLatLngBounds |
Этот метод используется, чтобы получить ограничивающий прямоугольник для результата запроса маршрутов. Возвращает объект GLatLngBounds или значение null, если результаты недоступны.
(Начиная с версии 2.81) |
getNumRoutes()
|
Number |
Возвращает количество маршрутов в результате. В случае успешного запроса оно должно равняться общему количеству указанных пунктов минус 1. Если результаты недоступны (поскольку не был выполнен запрос или предыдущий запрос не был выполнен успешно), этот метод возвращает 0.
(Начиная с версии 2.81) |
getRoute(i:Number)
|
GRoute |
Возвращает объект GRoute для i-го маршрута в ответе.
(Начиная с версии 2.81) |
getNumGeocodes()
|
Number |
Возвращает количество записей в результате, для которых выполнено геокодирование. В случае успешного запроса оно должно равняться общему количеству указанных пунктов. Если результаты недоступны (поскольку не был выполнен запрос или предыдущий запрос не был выполнен успешно), этот метод возвращает 0.
(Начиная с версии 2.81) |
getGeocode(i:Number)
|
Object |
Возвращает результат геокодирования для i-го пункта. Структура этого объекта совпадает со структурой одного местоположения в ответе от объекта GClientGeocoder.
(Начиная с версии 2.81) |
getCopyrightsHtml()
|
String |
Возвращает строку HTML, содержащую информацию об авторских правах для этого результата.
(Начиная с версии 2.81) |
getSummaryHtml()
|
String |
Возвращает фрагмент кода HTML, содержащий краткую информацию о длине и времени прохождения для всего запроса маршрутов. Обратите внимание, что эта информация возвращается объектом GDirections, с которым не связана ни карта, ни элемент DIV.
(Начиная с версии 2.81) |
getDistance()
|
Object |
Возвращает литерал объекта, представляющей общую длину для запроса маршрутов (по всем маршрутам). Объект содержит два поля: поле meters, содержащее числовое значение расстояния (в метрах), и строку html, содержащую локализованное представление расстояния в единицах измерения, принятых в стране отправления набора маршрутов.
(Начиная с версии 2.81) |
getDuration()
|
Object |
Возвращает литерал объекта, представляющей общее время прохождения для запроса маршрутов (всех маршрутов). Объект содержит два поля: поле seconds, содержащее числовое значение времени (в секундах), и строку html, содержащую локализованное представление времени.
(Начиная с версии 2.81) |
getPolyline()
|
GPolyline |
Возвращает объект GPolyline, связанный с ответом на запрос маршрутов. Обратите внимание, что это одна ломаная линия, представляющая все маршруты в ответе. Этот объект будет определен только после загрузки всех результатов запроса маршрутов (т. е. вызова события load).
(Начиная с версии 2.81) |
getMarker(i:Number)
|
GMarker |
Возвращает маркер связанный с i-й географической точкой. Этот объект вернет ненулевые результаты только после загрузки всех результатов запроса маршрутов (т. е. вызова события load).
(Начиная с версии 2.81) |
Этот класс предоставляет необязательные аргументы в методы GDirections.load() и GDirections.loadFromWaypoints(). У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
locale
|
String |
Языковой стандарт, который нужно использовать для результатов запроса маршрутов. Например, en_US, fr, fr_CA и т. д. |
travelMode
|
GTravelModes |
Способ передвижения, например на автомобиле (по умолчанию) или пешком. Обратите внимание, что при прокладке пешеходных маршрутов нужно указывать панель <div>, которая должна содержать предупреждение для пользователей.(Начиная с версии 2.129) |
avoidHighways
|
Boolean |
Если принимает значение true, при прокладке маршрутов будет предпринята попытка избегать автомагистрали. Обратите внимание, что маршруты все равно могут пролегать через автомагистрали, если не найдены подходящие альтернативы.(Начиная с версии 2.124) |
getPolyline
|
Boolean |
По умолчанию методы GDirections.load*() получают данные для ломаной линии, только если карта прикреплена к объекту GDirections. Это поле можно использовать, чтобы переопределить это поведение и получать данные для ломаной линии, даже когда карта не прикреплена к объекту маршрутов. |
getSteps
|
Boolean |
По умолчанию методы GDirections.load*() получают данные участков, только если панель прикреплена к объекту GDirections. Это поле можно использовать, чтобы переопределить это поведение и получать данные участков, даже когда панель не прикреплена к объекту маршрутов. |
preserveViewport
|
Boolean |
По умолчанию, если к объекту маршрутов прикреплена карта, карта центрируется и масштабируются в соответствии с ограничивающим прямоугольником для результатов запроса маршрутов. Если этот параметр принимает значение true, окно просмотра для этого запроса не изменяется (если его положение задано). |
Эта функция предоставляет удобный способ асинхронного получения ресурса по URL. Обратите внимание, что поскольку для выполнения запроса используется объект XmlHttpRequest, он подпадает под политику одного источника при написании скриптов для нескольких сайтов. Она заключается в том, что URL должен находиться на том же сервере, что и URL текущего документа, выполняющего код. Поэтому обычно излишне использовать абсолютный URL для аргумента url. Лучше указывать только абсолютный или относительный путь. Возникающие исключения, например ошибки безопасности, должны обрабатывать вызывающие методы.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
GDownloadUrl(url:String,
onload:Function,
postBody?:String,
postContentType?:String)
|
None |
Получает ресурс по указанному URL-адресу и вызывает функцию onload с двумя аргументами: текстом документа и HTTP-кодом состояния. Если время ожидания запроса истекло, функцию onload можно вызвать со значением null в качестве первого аргумента и -1 в качестве второго. По умолчанию эта функция отправляет HTTP-запрос GET. Чтобы вместо этого отправить HTTP-запрос POST, передайте данные с необязательным аргументом postBody. Если тип данных отличен от application/x-www-form-urlencoded, передайте тип содержания в виде строки в аргументе postContentType. Этот метод подпадает под ограничения по написанию скриптов для разных сайтов. Обратите внимание, что этот метод использует базовую реализацию API XmlHttpRequest браузера. |
Этот класс усовершенствует базовый класс GGeocodeCache, накладывая более строгие ограничения на кэшированные результаты. Он кэширует только ответы, вероятность изменения которых в течение короткого промежутка времени очень мала.
| Конструктор | Описание |
|---|---|
GFactualGeocodeCache()
|
Создает кэш, хранящий только фактические ответы.
(Начиная с версии 2.55) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
isCachable(reply:Object)
|
Boolean |
Переопределяет реализацию этого метода, используемую по умолчанию, таким образом, чтобы он выполнял более тщательную проверку кода состояния. Считаются кэшируемыми только ответы с кодом состояния Status.code G_GEO_SUCCESS и недопустимые ответы. Ответы, время ожидания которых истекло или в ходе выполнения которых возникла ошибка сервера, не кэшируются.
(Начиная с версии 2.55) |
Для этого перечислимого типа не определены символьные константы.
| Константа | Описание |
|---|---|
0
|
Неизвестное местоположение.
(Начиная с версии 2.59) |
1
|
Точность на уровне страны.
(Начиная с версии 2.59) |
2
|
Точность на уровне региона (штат, область, префектура и т. д.) уровень точности.
(Начиная с версии 2.59) |
3
|
Точность на уровне составных частей регионов (район, муниципалитет и т. д.) уровень точности.
(Начиная с версии 2.59) |
4
|
Точность на уровне города (поселка).
(Начиная с версии 2.59) |
5
|
Точность на уровне почтового индекса.
(Начиная с версии 2.59) |
6
|
Точность на уровне улицы.
(Начиная с версии 2.59) |
7
|
Точность на уровне перекрестка.
(Начиная с версии 2.59) |
8
|
Точность на уровне адреса.
(Начиная с версии 2.59) |
9
|
Точность на уровне здания (название постройки, дома, торговый центр, и т. д.) уровень точности.
(Начиная с версии 2.105) |
Числовые эквиваленты символьных констант указаны в скобках.
| Константа | Описание |
|---|---|
G_GEO_SUCCESS |
Запрос выполнен без ошибок. Адрес успешно проанализирован, и его географический код возвращен.
(Начиная с версии 2.55) |
G_GEO_BAD_REQUEST |
Запрос маршрутов не удалось выполнить успешно. Например, запрос мог быть отклонен, если он содержал больше допустимого количества пунктов.
(Начиная с версии 2.81) |
G_GEO_SERVER_ERROR |
Запрос на геокодирование, запрос маршрутов или максимального коэффициента масштабирования не удалось выполнить успешно. Однако точная причина сбоя неизвестна.
(Начиная с версии 2.55) |
G_GEO_MISSING_QUERY |
HTTP-параметр q отсутствует, или его значение неизвестно. Для запросов на геокодирование это означает, что адрес не указан, а для запросов маршрутов – что не указан запрос.
(Начиная с версии 2.81) |
G_GEO_MISSING_ADDRESS |
Синоним для константы G_GEO_MISSING_QUERY.
(Начиная с версии 2.55) |
G_GEO_UNKNOWN_ADDRESS |
Не удалось найти географическое положение для указанного адреса. Причиной может быть то, что адрес относительно новый или неправильный.
(Начиная с версии 2.55) |
G_GEO_UNAVAILABLE_ADDRESS |
Геокод для указанного адреса или трасса для запрошенный маршрута не могут быть выданы по юридическим причинам или в силу ограничений контракта.
(Начиная с версии 2.55) |
G_GEO_UNKNOWN_DIRECTIONS |
Объекту GDirections не удалось проложить маршруты между указанным в запросе пунктами. Обычно это происходит, если для указанных пунктов маршрут недоступен или если для этого региона у нас нет данных маршрутов.
(Начиная с версии 2.81) |
G_GEO_BAD_KEY |
Заданный ключ недействителен или не соответствует домену, для которого он был задан.
(Начиная с версии 2.55) |
G_GEO_TOO_MANY_QUERIES |
Превзойден предел запросов для заданного ключа за текущий 24-часовой период или слишком много запросов было отправлено за слишком короткий промежуток времени. Если запросы отправляются параллельно или короткими циклами, используйте таймер или паузу в своем коде, чтобы предотвратить слишком быструю отправку.
(Начиная с версии 2.55) |
Объект GGeoXml добавляет географический объект на карту из файла XML (например, файла KML), размещенного на общедоступном веб-сервере. Он реализует интерфейс GOverlay и поэтому добавляется на карту с помощью метода GMap2.addOverlay().
| Конструктор | Описание |
|---|---|
GGeoXml(urlOfXml:String,
callback?:function)
|
Создает объект GOverlay, представляющий файл XML. Необязательная функция обратного вызова вызывается по завершении загрузки файла XML объектом GGeoXml.
(Не рекомендуется начиная с версии 2.108) |
GGeoXml(urlOfXml:String)
|
Создает объект GOverlay, представляющий файл XML.
(Начиная с версии 2.108) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
getTileLayerOverlay()
|
GTileLayerOverlay |
Объекты GGeoXml могут создавать фрагментные наложения в целях оптимизации в ряде случаев. Этот метод возвращает слой фрагментного наложения (если он доступен). Обратите внимание, что фрагментное наложение может принимать значение null, если оно не нужно, или файл GGeoXml еще не до конца загружен.(Не рекомендуется начиная с версии 2.141) |
getDefaultCenter()
|
GLatLng |
Возвращает центральную точку окна просмотра, используемую по умолчанию, в виде координат широты и долготы. Эту функцию нужно вызывать после загрузки файла.
(Начиная с версии 2.84) |
getDefaultSpan()
|
GLatLng |
Возвращает интервал окна просмотра в виде координаты широты и долготы. Эту функцию нужно вызывать после загрузки файла.
(Начиная с версии 2.84) |
getDefaultBounds()
|
GLatLngBounds |
Возвращает ограничивающий прямоугольник окна просмотра, используемого по умолчанию. Эту функцию нужно вызывать после загрузки файла.
(Начиная с версии 2.84) |
gotoDefaultViewport(map:GMap2)
|
None |
Устанавливает окно просмотра, указанное по умолчанию в файле XML, в качестве окна просмотра карты.
(Начиная с версии 2.84) |
hasLoaded()
|
Boolean |
Проверяет, завершена ли загрузка файла XML. Если да, то возвращает значение true, а если нет – false.
(Начиная с версии 2.84) |
hide()
|
None |
Скрывает дочерние наложения, созданные объектом GGeoXml, если они видимы и метод supportsHide() для них возвращает значение true. Обратите внимание, что этот метод вызовет соответствующее событие visibilitychanged для каждого наложения (например, GMarker.visibilitychanged, GGroundOverlay.visibilitychanged и т. д.). Если наложение, для которого метод supportsHide() возвращает значение true, скрыто, этот метод не выполняет никаких действий.
(Начиная с версии 2.87) |
isHidden()
|
Boolean |
Возвращает значение true, если объект GGeoXml скрыт с помощью метода GGeoXml.hide(). В противном случае возвращает false. (Начиная с версии 2.87) |
loadedCorrectly()
|
Boolean |
Проверяет, загружен ли файл XML правильно. Если да, то возвращает значение true, а если нет – false. Если загрузка файла XML не завершена, возвращаемое этим методом значение не определено.
(Не рекомендуется начиная с версии 2.146) |
show()
|
None |
Показывает скрытые дочерние наложения, созданные объектом GGeoXml. Обратите внимание, что этот метод вызовет соответствующее событие visibilitychanged для каждого наложения (например, GMarker.visibilitychanged, GGroundOverlay.visibilitychanged).
(Начиная с версии 2.87) |
supportsHide()
|
Boolean |
Всегда возвращает значение true.(Начиная с версии 2.87) |
| Событие | Описание |
|---|---|
load()
|
Это событие вызывается, если файл XML объекта GGeoXml полностью загружен и все связанные наложения отображены на карте или если файл XML загружен неправильно.(Начиная с версии 2.108) |
Этот класс поддерживает для карты соответствие адресов и известных местоположений. Хотя этот класс совершенно работоспособен, он разработан в качестве базового класса, предназначенного для создания усовершенствованного кэша.
| Конструктор | Описание |
|---|---|
GGeocodeCache()
|
Создает новый кэш для хранения соответствия адресов и местоположений на карте. Этот конструктор сразу вызывает метод GGeocodeCache.reset.
(Начиная с версии 2.55) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
get(address:String)
|
Object |
Возвращает ответ, сохраненный для указанного адреса address. Если для этого адреса ответ не сохранен, этот метод возвращает значение null.
(Начиная с версии 2.55) |
isCachable(reply:Object)
|
Boolean |
Возвращает логическое значение, определяющее, нужно ли кэшировать указанный ответ. По умолчанию для объекта reply выполняются элементарные проверки. В частности, этот класс проверяет, что объект не принимает значение null и у него есть поле name. Чтобы определить более точные условия для объекта reply, этот метод можно переопределить, расширив классы.
(Начиная с версии 2.55) |
put(address:String,
reply:Object)
|
None |
Сохраняет указанный ответ reply для указанного адреса address. Этот метод вызывает метод GGeocodeCache.isCachable, чтобы проверить, что можно закэшировать объект reply. При положительном результате он кэширует ответ reply для указанного адреса GGeocodeCache.toCanoninical, нормализованного с помощью метода.
(Начиная с версии 2.55) |
reset()
|
None |
Удаляет все ответы из кэша. После вызова этого метода кэш пуст.
(Начиная с версии 2.55) |
toCanonical(address:String)
|
String |
Возвращает принятую каноническую форму адреса. Он преобразует значение параметра address в строчные символы, заменяет запятые пробелами, а несколько пробелов – одним.
(Начиная с версии 2.55) |
Объект GGoogleBar предоставляет возможности локального поиска в приложениях API Карт, позволяя пользователям искать и находить нужные места для локальных списков. У объекта GGoogleBar нет конструктора. Он создается картой. Доступ к нему осуществляется с помощью метода GMap2.enableGoogleBar(). Обратите внимание, что на данный момент GoogleBar несовместим с плагином Google Планета Земля, который используется картами типа GMapType.G_SATELLITE_3D_MAP. Он будет отключен, если этот плагин используется.
Этот класс определяет параметры, передаваемые в параметре adsOptions в объект GGoogleBarOptions. У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
client
|
String |
Это свойство определяет идентификатор клиента аккаунта Google AdSense для поиска. Указав этот параметр, можно получать прибыль от рекламы, показываемой в результатах поиска GoogleBar. (Начиная с версии 2.149) |
channel
|
String |
Это свойство определяет номер канала для аккаунта Google AdSense для поиска, если он был установлен. Каналы AdSense позволяют проводить рекламные кампании и определять наиболее прибыльные источники дохода. Обратите внимание, что каналы связаны с идентификаторами клиентов, поэтому при указании канала также нужно передавать параметр client.(Начиная с версии 2.149) |
adsafe
|
String |
Это свойство определяет уровень безопасности, который нужно использовать для результатов рекламы в объекте GGoogleBar. Уровни безопасности рекламы определяют уровень фильтрации материалов "для взрослых", применяемый к результатам поиска. Возможны четыре значения: high (используется по умолчанию) указывает, что реклама для взрослых не отображается; medium указывает, что реклама для взрослых, например реклама алкоголя, может показываться при соответствующем запросе пользователя, однако это не относится к рекламе сексуального или порнографического содержания; low указывает, что реклама для взрослых, в том числе порнографического содержания может показываться при соответствующем запросе пользователя; off указывает, что показывается вся реклама. Другие значения игнорируются.(Начиная с версии 2.149) |
language
|
String |
Определяет язык, на котором нужно показывать рекламу. Языки задаются в виде кодов языков BCP 47 (например, en для английского, а pt-BR для бразильского португальского). (Начиная с версии 2.149) |
Эти константы передаются в свойстве GGoogleBarOptions.linkTarget. Они определяют окно назначения для ссылок в информационных окнах с результатами.
| Константа | Описание |
|---|---|
G_GOOGLEBAR_LINK_TARGET_BLANK
|
Соответствует окну назначения _blank. |
G_GOOGLEBAR_LINK_TARGET_PARENT
|
Соответствует окну назначения _parent. |
G_GOOGLEBAR_LINK_TARGET_SELF
|
Соответствует окну назначения _self. |
G_GOOGLEBAR_LINK_TARGET_TOP
|
Соответствует окну назначения _top. |
Эти константы ограничивают тип результатов, возвращаемых локальным поиском, выполненным с помощью GGoogleBar. Поведение в ходе поиска задается в свойстве GGoogleBarOptions.listingTypes.
| Константа | Описание |
|---|---|
G_GOOGLEBAR_TYPE_BLENDED_RESULTS
|
Определяет, что поиск, выполняемый с помощью GGoogleBar, должен возвращать результаты всех типов (KML, предприятия, географические точки и т. д.).(Начиная с версии 2.113) |
G_GOOGLEBAR_TYPE_KMLONLY_RESULTS
|
Определяет, что поиск, выполняемый с помощью GGoogleBar, должен возвращать только результаты из проиндексированных файлов KML, KMZ и GeoRSS.(Начиная с версии 2.113) |
G_GOOGLEBAR_TYPE_LOCALONLY_RESULTS
|
Определяет, что поиск, выполняемый с помощью GGoogleBar, должен возвращать только результаты в виде списка предприятий и географических точек.(Начиная с версии 2.113) |
Этот класс определяет параметры, передаваемые в параметре googleBarOptions в объект GMapOptions. У него нет конструктора. Его экземпляр создается в виде литерала объекта. Обратите внимание, что объект GGoogleBar так же как и объект GInfoWindow не создается путем вызова конструктора, а автоматически прикрепляется к объекту карты и включается с помощью описанных здесь свойств.
| Свойство | Тип | Описание |
|---|---|---|
showOnLoad
|
Boolean |
Если это свойство принимает значение true, то на карте отображается текстовое окно поиска GoogleBar (если элемент управления включен, а карта загружена). По умолчанию текстовое окно поиска в элементе управления скрыто и отображается только по нажатию на увеличительную лупу элемента. Обратите внимание, что если свойство style принимает значение new, текстовое окно поиска GoogleBar всегда показывается, а это свойство игнорируется.(Начиная с версии 2.95) |
style
|
String |
Это свойство определяет стиль, используемый объектом GGoogleBar. При указании в качестве значения свойства style new для GoogleBar используется пересмотренный вид и стиль. (Этот стиль станет стилем по умолчанию в ближайшем будущем.)(Начиная с версии 2.149) |
adsOptions
|
GGoogleBarAdsOptions |
Это свойство определяет параметры, которые нужно использовать для отображения рекламы с помощью объекта GGoogleBar. По умолчанию реклама в GoogleBar включена. Эти параметры нужно использовать, чтобы добавить информацию об отображении рекламы и аккаунтах AdSense, с которыми ее нужно связать (с целью извлечения прибыли).(Начиная с версии 2.149) |
linkTarget
|
GGoogleBarLinkTarget |
Это свойство определяет окно назначения для ссылок в результатах поиска объекта GoogleBar. По умолчанию используется значение G_GOOGLEBAR_LINK_TARGET_BLANK, т. е. ссылки будут открываться в новом окне.(Начиная с версии 2.95) |
listingTypes
|
GGoogleBarListingTypes |
Это свойство определяет типы результатов поиска, возвращаемых и отображаемых с помощью GoogleBar. По умолчанию используется тип G_GOOGLEBAR_TYPE_BLENDED_RESULTS, при котором отображаются результаты в виде объектов KML и результаты локального поиска (списки предприятий и ориентиры).(Начиная с версии 2.113) |
resultList
|
GGoogleBarResultList or Element |
Это свойство определяет стиль списка результатов поиска для объекта GoogleBar, который может принимать одно из следующих значений: G_GOOGLEBAR_RESULT_LIST_INLINE (используется по умолчанию) – результаты поиска отображаются в виде таблицы над окном поиска; G_GOOGLEBAR_RESULT_LIST_SUPPRESS – вместо списка отображаются кнопки перехода; элемент DOM уровня блоков Element – список помещается в выбранный контейнер (обычно элемент <div>).(Начиная с версии 2.95) |
suppressInitialResultSelection
|
Boolean |
Установка этого свойства подавляет отображение первого результата в собственном информационном окне по завершении поиска в GoogleBar (это поведение используется по умолчанию).(Начиная с версии 2.95) |
suppressZoomToBounds
|
Boolean |
Установка этого свойства подавляет автоматическое панорамирование и масштабирование набора результатов по завершении поиска в GoogleBar. (Это свойство переопределяет поведение по умолчанию.)(Начиная с версии 2.95) |
onIdleCallback
|
Function |
Это свойство определяет функцию обратного вызова, которая вызывается, когда объект GoogleBar завершил поиск, а результаты не получены.(Начиная с версии 2.95) |
onSearchCompleteCallback
|
Function |
Это свойство определяет функцию обратного вызова, которая вызывается, когда объект GoogleBar завершил поиск и результаты получены. Ей передается объект GlocalSearch, связанный с элементом управления. Эта функция обратного вызова вызывается до размещения результатов на карте или в списке.(Начиная с версии 2.95) |
onGenerateMarkerHtmlCallback
|
Function |
Это свойство определяет функцию обратного вызова, которая вызывается при открытии информационного окна для маркера результата поиска. Функции нужно передавать объект GMarker, созданную строку HTML и объект GlocalSearchResult (в указанном порядке). В свою очередь она должна возвращать измененную строку HTML, которую нужно показывать в информационном окне.(Начиная с версии 2.95) |
onMarkersSetCallback
|
Function |
Определяет функцию обратного вызова, которая вызывается по завершении создания маркеров GGoogleBar и размещения их на карте. Этой функции нужно передавать массив объектов в форме {result: GlocalSearch, marker: GMarker}.(Начиная с версии 2.95) |
Эти константы передаются в свойстве GGoogleBarOptions.resultList. Они определяют характер отображения списка результатов.
| Константа | Описание |
|---|---|
G_GOOGLEBAR_RESULT_LIST_INLINE
|
Соответствует стилю, используемому по умолчанию, когда список результатов показывается в форме таблицы на карте. |
G_GOOGLEBAR_RESULT_LIST_SUPPRESS
|
Соответствует стилю, используемому по умолчанию, когда список результатов скрыт и заменен кнопками следующий и предыдущий. |
Этот класс определяет позицию камеры при просмотре фотографий улиц. У него нет конструктора. Его экземпляр создается в виде литерала объекта. Все свойства являются необязательными.
| Свойство | Тип | Описание |
|---|---|---|
yaw
|
Number |
Угол поворота от географического севера в градусах. Географический север – 0 градусов, восток – 90, юг – 180, запад – 270.
(Начиная с версии 2.104) |
pitch
|
Number |
Угол отклонения относительно начального угла наклона при просмотре улиц в градусах . Изменяется от 90 градусов (прямо вверх) до -90 градусов (прямо вниз).
(Начиная с версии 2.104) |
zoom
|
Number |
Коэффициент масштабирования. У минимального изображения он равен 0, а затем увеличивается при увеличении карты. (Начиная с версии 2.104) |
Объекты этого класса создаются объектом GDirections. Они хранят информацию о каждом отдельном маршруте из результатов поиска маршрутов. У этого класса нет общего конструктора. Клиенты не должны создавать объекты этого класса напрямую.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
getNumSteps()
|
Number |
Возвращает количество участков в маршруте.
(Начиная с версии 2.81) |
getStep(i:Number)
|
GStep |
Возвращает объект GStep для i-го участка маршрута.
(Начиная с версии 2.81) |
getStartGeocode()
|
Object |
Возвращает результат геокодирования для начального пункта маршрута. Структура этого объекта совпадает со структурой одного местоположения в ответе от объекта GClientGeocoder.
(Начиная с версии 2.83) |
getEndGeocode()
|
Object |
Возвращает результат геокодирования для конечного пункта маршрута. Структура этого объекта совпадает со структурой одного местоположения в ответе от объекта GClientGeocoder.
(Начиная с версии 2.83) |
getEndLatLng()
|
GLatLng |
Возвращает объект GLatLng для конечного пункта вместе с ломаной линией маршрута. Обратите внимание, что этот пункт может отличаться от координат широты и долготы в методе GRoute.getEndGeocode(), поскольку метод getEndLatLng() всегда возвращает пункт, привязанный к дорожной сети. Не существует метода, соответствующего методу getStartLatLng(), поскольку это аналогично вызову метода GRoute.getStep(0).getLatLng().
(Начиная с версии 2.81) |
getSummaryHtml()
|
String |
Возвращает фрагмент кода HTML, содержащий краткую информацию о длине и времени прохождения для этого маршрута.
(Начиная с версии 2.81) |
getDistance()
|
Object |
Возвращает литерал объекта, представляющий общую длину маршрута. Структуру этого объекта можно посмотреть в описании метода GDirections.getDistance().
(Начиная с версии 2.81) |
getDuration()
|
Object |
Возвращает литерал объекта, представляющий общее время прохождения маршрута. Структуру этого объекта можно посмотреть в описании метода GDirections.getDuration().
(Начиная с версии 2.81) |
Объекты этого класса создаются объектом GDirections. Они хранят информацию об одном участке маршрута из результатов поиска маршрутов. У этого класса нет общего конструктора. Клиенты не должны создавать объекты этого класса напрямую.
| Метод | Возвращаемое значение | Описание |
|---|---|---|
getLatLng()
|
GLatLng |
Возвращает объект GLatLng для конечного пункта вместе с ломаной линией этого участка.
(Начиная с версии 2.81) |
getPolylineIndex()
|
Number |
Возвращает индекс начального пункта вместе с ломаной линией этого участка.
(Начиная с версии 2.81) |
getDescriptionHtml()
|
String |
Возвращает строку HTML, содержащую описание этого участка.
(Начиная с версии 2.81) |
getDistance()
|
Object |
Возвращает литерал объекта, представляющий общую длину участка. Структуру этого объекта можно посмотреть в описании метода GDirections.getDistance().
(Начиная с версии 2.81) |
getDuration()
|
Object |
Возвращает литерал объекта, представляющий время прохождения участка. Структуру этого объекта можно посмотреть в описании метода GDirections.getDuration().
(Начиная с версии 2.81) |
Объект GStreetviewClient выполняет поиск данных Street View по параметрам, передаваемым этими методами.
| Конструктор | Описание |
|---|---|
GStreetviewClient()
|
Создает объект GStreetviewClient.
(Начиная с версии 2.104) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
getNearestPanoramaLatLng(latlng:GLatLng,
callback:Function(GLatLng))
|
None |
Находит точку GLatLng ближайшего панорамного изображения для указанной точки и передает ее в указанную функцию обратного вызова. Если такого изображения нет или происходит ошибка сервера, в функцию передается значение null.
(Начиная с версии 2.104) |
getNearestPanorama(latlng:GLatLng,
callback:Function(GStreetviewData))
|
None |
Получает данные ближайшего панорамного изображения для указанной точки и передает их в указанную функцию обратного вызова в виде объекта GStreetviewData.
(Начиная с версии 2.104) |
getPanoramaById(panoId:string,
callback:Function(GStreetviewData))
|
None |
Получает данные панорамного изображения с указанным идентификатором для указанной точки и передает их в указанную функцию обратного вызова в виде объекта GStreetviewData. Идентификаторы панорамных изображений уникальны. Они не изменяются в ходе сессии, однако могут изменяться между ними.
(Начиная с версии 2.104) |
Числовые эквиваленты символьных констант указаны в скобках.
| Константа | Описание |
|---|---|
SUCCESS |
Успех (Начиная с версии 2.104) |
SERVER_ERROR |
Сервер не отвечает на запросы. (Начиная с версии 2.104) |
NO_NEARBY_PANO |
Фотографии не найдены. (Начиная с версии 2.104) |
Этот класс представляет сведения о панорамном изображении. У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
location
|
GStreetviewLocation |
Данные о положении. (Начиная с версии 2.104) |
copyright
|
String |
Локализованная информация об авторских правах. (Начиная с версии 2.104) |
links
|
GStreetviewLink[] |
Ссылки на близлежащие панорамные изображения, если они есть. (Начиная с версии 2.104) |
code
|
GStreetviewClient.ReturnValues |
Код состояния. См{\lang1033 .}GStreetviewClient.ReturnValues.(Начиная с версии 2.104) |
Этот класс предоставляет ссылку с одного объекта GStreetviewLocation на ближайший объект GStreetviewLocation. У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
yaw
|
Number |
Угол поворота от текущего местоположения до близлежащего. (Начиная с версии 2.104) |
description
|
String |
Локализованная строка, описывающая близлежащее место. (Начиная с версии 2.104) |
panoId
|
String |
Уникальный идентификатор для близлежащего панорамного изображения. Он не изменяется в ходе одной сессии, но может изменяться между ними. (Начиная с версии 2.104) |
Этот класс определяет местоположение при просмотре фотографий улиц. У него нет конструктора. Его экземпляр создается в виде литерала объекта.
| Свойство | Тип | Описание |
|---|---|---|
latlng
|
GLatLng |
Координаты широты и долготы панорамного изображения. (Начиная с версии 2.104) |
pov
|
GPov |
Начальная точка обзора. (Начиная с версии 2.104) |
description
|
String |
Локализованная строка, описывающая место. (Начиная с версии 2.104) |
panoId
|
String |
Уникальный идентификатор панорамного изображения. Он не изменяется в ходе одной сессии, но может изменяться между ними. (Начиная с версии 2.104) |
Объект GStreetviewOverlay предоставляет возможность выделения местоположений, для которых доступны данные Street View. Этот класс реализует интерфейс GOverlay. Его объекты можно добавлять на карту с помощью метода map.addOverlay и удалять с помощью метода map.removeOverlay.
| Конструктор | Описание |
|---|---|
GStreetviewOverlay()
|
Создает объект GStreetviewOverlay, который реализует интерфейс GOverlay.(Начиная с версии 2.104) |
| Событие | Описание |
|---|---|
changed(hasStreetviewData:Boolean)
|
Это событие вызывается при изменении состояния данных Street View для текущего окна просмотра. Оно вызывается при перемещении карты из области, где данные Street View доступны, в область, где их нет, или наоборот. Оно также вызывается, когда добавление объекта GStreetviewOverlay на карту приводит к появлению данных Street View в окне просмотра. Параметр hasStreetviewData будет принимать значение true, если для окна просмотра доступны данные Street View, и false в противном случае.
(Начиная с версии 2.120) |
Объект GStreetviewPanorama содержит экземпляр средства просмотра Street View Flash®. Каждый объект этого класса содержит отдельный экземпляр уникального вида. Этот объект обычно встраивается в объект контейнера, такой как DIV. Его вид можно изменять с помощью методов этого класса. Данные Street View недоступны для всех местоположений. Используйте объект GStreetviewClient или GStreetviewOverlay, чтобы определить, доступны ли данные Street View для местоположения.
| Конструктор | Описание |
|---|---|
GStreetviewPanorama(container:Node,
opts?:GStreetviewPanoramaOptions)
|
Создает объект GStreetviewPanorama с соответствующим средством просмотра Flash в указанном контейнере. Это средство не отображается, пока не будет задано местоположение, или в необязательном объекте opts GStreetviewPanoramaOptions, или путем вызова метода setLocationAndPOV.
(Начиная с версии 2.104) |
| Метод | Возвращаемое значение | Описание |
|---|---|---|
remove()
|
None |
Удаляет экземпляр средства просмотра Flash, связанного с этим объектом из DOM. Эту функцию нужно вызывать до удаления элемента контейнера HTML. В противном случае ряд браузеров не сможет удалить средство просмотра Flash.
(Начиная с версии 2.104) |
setContainer(container:Node)
|
None |