Избранное | Русский | Войти

Справочное руководство по API Карт Google

Теперь API Карт Google интегрирован с загрузчиком AJAX API Google, который создает общее пространство имен для загрузки и использования AJAX API Google. Эта инфраструктура позволяет использовать дополнительное пространство имен google.maps.* для всех классов, методов и свойств, на данный момент используемых в API Карт Google, заменяя обычный префикс G этим пространством имен. Не беспокойтесь, существующее пространство имен G будет также поддерживаться.

Например, объект GMap2 в API Карт Google можно также определить как google.maps.Map2.

Обратите внимание, что в этом справочном руководстве рассмотрено только существующее пространство имен G.

Основной класс:

      Это самый важный класс в API Карт. Другие классы, описанные в этом справочном руководстве, сгруппированы по целям.

      Базовые классы:

      Классы событий:

        Классы управления:

        Классы наложения:

        Классы служб:

        Класс GMap2

        Чтобы создать карту, создайте экземпляр класса 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

        Объект 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 Увеличивает область таким образом, чтобы указанная точка оказалась внутри нее.

        К началу

        Функция GBrowserIsCompatible

        Эта функция определяет, можно ли использовать API карт в текущем браузере.

        Функция

        Метод Возвращаемое значение Описание
        GBrowserIsCompatible() Boolean Возвращает значение true, если используемый браузер поддерживает библиотеку API карт.

        К началу

        Класс GDraggableObject

        Этот класс превращает элемент 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)

        К началу

        Класс GDraggableObjectOptions

        Этот класс предоставляет необязательные аргументы в конструктор 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

        У объекта 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)

        К началу

        Класс GInfoWindowOptions

        Экземпляры этого класса используются в аргументе 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)

        К началу

        Класс GInfoWindowTab

        Массив экземпляров этого класса можно передавать в качестве аргумента 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*().

        К началу

        Класс GKeyboardHandler

        Создавайте экземпляры этого класса, чтобы задавать действия для клавиш клавиатуры. Клавишам назначены те же действия, что и в приложении карт.

        Клавиши Действие
        Стрелки вверх, вниз, вправо, влево Непрерывно перемещает карту при нажатии клавиши. Чтобы переместить карту по диагонали, нужно нажать две клавиши одновременно.
        Page Down, Page Up, Home, End Панорамирует карту на 3/4 от ее размера в указанном направлении с приятной анимацией. Аналогичны действиям кнопок со стрелками в объектах GLargeMapControl и GSmallMapControl.
        +, - Увеличивает или уменьшает коэффициент масштабирования. Соответствуют кнопкам + и - в объектах GLargeMapControl и GSmallMapControl.

        Конструктор

        Конструктор Описание
        GKeyboardHandler(map:GMap2) Устанавливает обработчик событий для карты, переданной в качестве аргумента.

        К началу

        Пространство имен GLanguage

        Это пространство имен содержит вспомогательные методы, которые пригодятся для определения настроек языков, используемых в приложении. Настройки языка часто задаются в настройках браузера, но их можно переопределить в скрипте загрузки 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

        Объект 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

        Экземпляр класса 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)

        К началу

        Пространство имен GLog

        Это пространство имен содержит ряд статических методов, которые пригодятся для отладки веб-приложений. При первом использовании одного из методов write*() на странице открывается плавающее окно, в котором отображаются сообщения.

        Статические методы

        Метод Возвращаемое значение Описание
        GLog.write(message:String, color?:String) None Записывает сообщение в виде обычного текста в окно журнала. Символы разметки HTML будут преобразованы для отображения в виде символов.
        GLog.writeUrl(url:String) None Записывает ссылку на указанный URL-адрес в окно журнала.
        GLog.writeHtml(html:String) None Записывает текст в формате HTML в окно журнала.

        К началу

        Класс GMapOptions

        Этот класс предоставляет необязательные аргументы в конструктор 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)

        К началу

        Переменная перечислимого типа GMapPane

        Эти константы определяют порядок наложения (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

        Объект 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

        Объект 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).

        К началу

        Функция GUnload

        Эту функцию можно вызывать, чтобы очистить внутренние структуры данных с целью освобождения памяти. Это помогает в работе над различными ошибками браузеров, которые приводят к утечке памяти в веб-приложениях. Эту функцию нужно вызывать в обработчике запросов unload своей страницы. После вызова этой функции созданные на странице объекты не будут правильно работать.

        Функция

        Метод Возвращаемое значение Описание
        GUnload() None Удаляет все зарегистрированные обработчики событий, чтобы предотвратить утечку памяти. Этот метод нужно вызывать в качестве обработчика для события unload.

        К началу

        Константа G_API_VERSION

        Эта константа указывает версию API, используемого для страницы. Дополнительная информация об этой версии представлена на странице Обновления API.

        Константа

        Метод Возвращаемое значение Описание
        () None Возвращает версию API, используемого для страницы.

        К началу

        Пространство имен GEvent

        Это пространство имен содержит функции, которые можно использовать для регистрации обработчиков событий – пользовательских и 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(). Разумеется, событие вызывается перед выполнением функций.

        К началу

        Класс GEventListener

        Этот класс скрытый. У него нет методов и конструктора. Его экземпляры возвращаются из метода GEvent.addListener() или GEvent.addDomListener(), а затем передаются обратно в метод GEvent.removeListener().

        К началу

        Интерфейс GControl

        Этот интерфейс реализуется своими элементами управления. Его можно использовать, чтобы добавлять пользовательские элементы управления на карту. Это можно делать с помощью метода 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().

        К началу

        Переменная перечислимого типа GControlAnchor

        Константы

        Константа Описание
        G_ANCHOR_TOP_RIGHT Элемент управления будет привязан к правому верхнему углу карты.
        G_ANCHOR_TOP_LEFT Элемент управления будет привязан к левому верхнему углу карты.
        G_ANCHOR_BOTTOM_RIGHT Элемент управления будет привязан к правому нижнему углу карты.
        G_ANCHOR_BOTTOM_LEFT Элемент управления будет привязан к левому нижнему углу карты.

        К началу

        Класс GControl

        Доступны реализации интерфейса interface GControl.

        Конструктор

        Конструктор Описание
        GSmallMapControl() Создает элемент управления с кнопками для перемещения в четырех направления и масштабирования.
        GLargeMapControl() Создает элемент управления с кнопками для перемещения в четырех направления и масштабирования, а также с ползунком масштаба.
        GSmallZoomControl() Создает элемент управления с кнопками для масштабирования.
        GLargeMapControl3D() Создает элемент управления в виде трехмерного объекта с кнопками для перемещения в четырех направлениях и масштабирования, а также с ползунком масштаба.
        GSmallZoomControl3D() Создает элемент управления в виде трехмерного объекта с кнопками для масштабирования.
        GScaleControl() Создает элемент управления, показывающий масштаб карты.
        GMapTypeControl() Создает стандартный элемент управления типами карт для выбора типа и переключения между типами с помощью кнопок.
        GMenuMapTypeControl() Создает элемент управления типами карт с раскрывающимся списком для выбора типа и переключения между типами.
        GHierarchicalMapTypeControl() Создает элемент управления типами карт с вложенными элементами для выбора типа и переключения между поддерживаемыми типами с помощью кнопок и вложенных флажков.
        GOverviewMapControl() Создает сворачиваемую обзорную мини-карту в углу основной карты для определения местоположения и навигации (путем перемещения). Объект GOverviewMapControl создает обзорную карту с черной границей в один пиксель. Обратите внимание, что в отличие от других элементов управления этот элемент можно разместить только в правом нижнем углу карты (G_ANCHOR_BOTTOM_RIGHT).
        GNavLabelControl() Создает·динамический элемент навигации по иерархии, представляющий текущее окно просмотра в виде набора вложенных компонентов адреса. Кроме того, этот элемент управления предоставляет ссылки для навигации, которые позволяют переходить по отдельным компонентам адреса.

        (Начиная с версии 2.141)

        К началу

        Класс GControlPosition

        Этот класс задает положение элемента управления в области просмотра карты. Положение определяется углом карты, к которому элемент управления привязывается, и сдвигом относительно него. Положение можно передавать в качестве необязательного аргумента position в методGMap2.addControl(). Оно возвращается методом GControl.getDefaultPosition().

        Конструктор

        Конструктор Описание
        GControlPosition(anchor:enum GControlAnchor, offset:GSize) Создает спецификацию для положения элемента управления.

        К началу

        Класс GHierarchicalMapTypeControl

        Объект 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)

        К началу

        Класс GMapType

        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

        Объект GMapTypeControl представляет собой стандартный элемент управления типами карт для выбора типа и переключения между типами с помощью кнопок. Элементы управления станут доступными для всех прикрепленных к карте типов карт в момент создания элемента управления.

        По умолчанию карты поддерживают набор G_DEFAULT_MAP_TYPES. Помимо него можно явно добавить типы карт с помощью метода GMap2.addMapType(). Чтобы сохранить место на карте, вместо этого класса можно использовать класс GHierarchicalMapTypeControl с "вложенными" типами карт или класс GMenuMapTypeControl с раскрывающимся списком типов.

        Конструктор

        Конструктор Описание
        GMapTypeControl(useShortNames?:Boolean) Создает объект GMapTypeControl с короткими (замещающими) названиями, если параметр useShortNames принимает значение true, и длинными названиями по умолчанию.

        К началу

        Класс GMapTypeOptions

        Экземпляры этого класса используются в качестве аргумента 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

        Этот класс предоставляет набор параметров пользовательского интерфейса для карты.

        Конструктор

        Конструктор Описание
        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

        Объект GMenuMapTypeControl представляет собой элемент управления типами карт для выбора типа и переключения между поддерживаемыми типами с помощью раскрывающегося меню. Элементы управления станут доступными для всех прикрепленных к карте типов карт в момент создания элемента управления.

        По умолчанию карты поддерживают набор G_DEFAULT_MAP_TYPES. Помимо него можно явно добавить типы карт с помощью метода GMap2.addMapType().

        Конструктор

        Конструктор Описание
        GMenuMapTypeControl(useShortNames?:Boolean) Создает объект GMenuMapTypeControl с короткими (замещающими) названиями, если параметр useShortNames принимает значение true, и длинными названиями по умолчанию.

        К началу

        Класс GNavLabelControl

        Объект GNavLabelControl представляет собой динамический элемент навигации по иерархии, определяющий текущее окно просмотра в виде набора вложенных компонентов адреса. Кроме того, этот элемент управления предоставляет ссылки для навигации, которые позволяют переходить по отдельным компонентам адреса.

        По умолчанию этот элемент управления расположен в правом верхнем углу окна просмотра. Он скрывается по истечении 10 секунд бездействия и появляется по нажатию или при изменении окна просмотра на карте. Кроме того, он не показывается, если недоступен адрес текущего окна просмотра.

        Конструктор

        Конструктор Описание
        GNavLabelControl() Создает объект GNavLabelControl.

        (Начиная с версии 2.141)

        Методы

        Метод Возвращаемое значение Описание
        setMinAddressLinkLevel(level:Number) None Устанавливает минимальный уровень компонента адреса, для которого в элементе предоставляется ссылка. Например, если уровень равен 0, показываются ссылки на все компоненты адреса "США > Нью-Йорк > Бруклин". Если же уровень равен 2, предоставляется ссылка только на Бруклин. По умолчанию используется значение 0.

        (Начиная с версии 2.162)

        К началу

        Класс GCopyright

        Объект авторских прав содержит сведения о сообщении с информацией об авторских правах, соответствующей региону карты в указанной прямоугольной области при указанном коэффициенте масштабирования. Этот тип вам пригодится только при реализации пользовательских типов карт или слоев фрагментов.

        Конструктор

        Конструктор Описание
        GCopyright(id:Number, bounds:GLatLngBounds, minZoom:Number, text:String) Создает объект с информацией об авторских правах с указанными свойствами.

        Свойства

        Свойство Тип Описание
        id Number Уникальный идентификатор информации об авторских правах.
        minZoom Number Минимальный коэффициент масштаба, при котором применима эта информация.
        bounds GLatLngBounds Регион, к которому применима эта информация.
        text String Текст сообщения с информацией об авторских правах.

        К началу

        Класс GCopyrightCollection

        Этот класс следует использовать для управления сообщениями с информацией об авторских правах, показываемых на карте пользовательского типа. Если вы не разрабатываете пользовательские типы карт, этот класс вам не понадобится. Коллекция сообщений содержит сведения о сообщениях с информацией об авторских правах, соответствующих региону карты при определенном коэффициенте масштабирования. Это очень важно для типов карт, представляющих неоднородные данные, например изображения со спутника.

        Конструктор

        Конструктор Описание
        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) Это событие вызывается при добавлении новой информации об авторских правах в коллекцию.

        К началу

        Класс GGroundOverlay

        Этот объект создает на карте прямоугольное наложение, размеры которого определены объектом 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)

        К началу

        Класс GIcon

        Значок используется для отображения объекта 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)

        К началу

        Класс GLayer

        Этот класс создает экземпляр предопределенного слоя наложения, состоящего из коллекции связанных элементов. Он реализует интерфейс 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

        Объект 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

        Этот класс используется для управления видимостью сотен маркеров на карте, основываясь на текущем окне просмотра и коэффициенте масштабирования. Этот класс не рекомендуется использовать. Вместо него разработчикам следует использовать Диспетчер маркеров с открытым исходным кодом.

        Конструктор

        Конструктор Описание
        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) Это событие вызывается при добавлении на карту или удалении с нее маркеров, которыми управляет диспетчер. Функцию обработчика событий нужно подготовить для получения двух аргументов. Один представляет границы видимой прямоугольной области, а второй передает количество показанных на карте маркеров.

        К началу

        Класс GMarkerManagerOptions

        Этот класс предоставляет необязательные аргументы в конструктор GMarkerManager. У него нет конструктора. Его экземпляр создается в виде литерала объекта.

        Свойства

        Свойство Тип Описание
        borderPadding Number Определяет дополнительный отступ в пикселях вне текущего окна просмотра, отслеживаемый диспетчером. Маркеры, попадающие в этот отступ, добавляются на карту, даже если они не полностью видны.

        (Начиная с версии 2.67)

        maxZoom Number Устанавливает максимальный коэффициент масштабирования, отслеживаемый диспетчером. Если не указан, диспетчер использует максимальный коэффициент масштабирования карты. Это значение также используется при добавлении маркеров в диспетчер без дополнительного параметра maxZoom.

        (Начиная с версии 2.67)

        trackMarkers Boolean Определяет, должен ли диспетчер отслеживать перемещения маркеров. Чтобы перемещать управляемые маркеры с помощью метода setPoint, в качестве значения этого параметра нужно установить true. false является значением по умолчанию.

        (Начиная с версии 2.67)

        К началу

        Класс GMarkerOptions

        Экземпляры этого класса используются в аргументе 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)

        К началу

        Класс GMercatorProjection

        Эта реализация интерфейса 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)

        К началу

        Интерфейс GOverlay

        Этот интерфейс реализуется классами 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)

        События

        Событие Описание

        К началу

        Класс GPolyEditingOptions

        Экземпляры этого класса используются в методах enableEditing объектов GPolyline и GPolygon. У этого класса нет конструктора. Экземпляр класса создается в виде литерала объекта JavaScript.

        Свойства

        В соответствии с названием этого класса все свойства являются необязательными.

        Свойство Тип Описание
        maxVertices Number Определяет максимальное количество вершин, допустимое для ломаной линии. Если максимум достигнут, вершины добавляться не будут.

        (Начиная с версии 2.111)

        fromStart Boolean Определяет, должен ли метод enableDrawing добавлять вершины с начала, а не с конца. По умолчанию они добавляются с конца.

        (Начиная с версии 2.111)

        К началу

        Класс GPolyStyleOptions

        Экземпляры этого класса используются в методе setStrokeStyle классов GPolyline и GPolygon и методе setFillStyle класса GPolygon. У этого класса нет конструктора. Экземпляр класса создается в виде литерала объекта JavaScript.

        Свойства

        В соответствии с названием этого класса все свойства являются необязательными.

        Свойство Тип Описание
        color String Определяет цвет в виде строки, содержащей шестнадцатеричный код цвета в HTML, т. е. #RRGGBB.

        (Начиная с версии 2.111)

        weight Number Определяет толщину линии в пикселях.

        (Начиная с версии 2.111)

        opacity Number Определяет непрозрачность ломаной линии в виде дробного числа от 0 (прозрачная) до 1 (непрозрачная).

        (Начиная с версии 2.111)

        К началу

        класс GPolygon

        Он очень похож на класс 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)

        К началу

        Класс GPolygonOptions

        Экземпляры этого класса используются в конструкторе объектов GPolygon. У этого класса нет конструктора. Экземпляр класса создается в виде литерала объекта JavaScript.

        Свойства

        В соответствии с названием этого класса все свойства являются необязательными.

        Свойство Тип Описание
        clickable Boolean Определяет, можно ли многоугольник активировать нажатием. По умолчанию используется значение true, т. е. если значение параметра не указано, многоугольник можно активировать нажатием.

        (Начиная с версии 2.91)

        mouseOutTolerance number Определяет расстояние (в пикселях), на которое должен быть перемещен курсор мыши за пределы многоугольника до вызова события mouseout.

        (Начиная с версии 2.158)

        К началу

        Класс GPolyline

        Экземпляр этого класса представляет собой наложение на карту в виде ломаной линии. Оно создается с помощью возможностей браузера по работе с векторной графикой, если он ими обладает, или с помощью наложенных изображений с серверов 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)

        К началу

        Класс GPolylineOptions

        Экземпляры этого класса используются в конструкторе объектов GPolyline. У этого класса нет конструктора. Экземпляр класса создается в виде литерала объекта JavaScript.

        Свойства

        В соответствии с названием этого класса все свойства являются необязательными.

        Свойство Тип Описание
        clickable Boolean Определяет, можно ли ломаную линию активировать нажатием. По умолчанию используется true, т. е. если параметр не указан, ломаную линию можно активировать нажатием.

        (Начиная с версии 2.91)

        geodesic Boolean Визуализирует каждое звено ломаной линии в виде части геодезической линии (фрагмента "большого круга"). Геодезическая линия представляет кратчайший путь между точками на поверхности Земли.

        (Начиная с версии 2.84)

        mouseOutTolerance number Определяет расстояние (в пикселях), на которое должен быть перемещен курсор мыши перпендикулярно ломаной линии до вызова события mouseout.

        (Начиная с версии 2.158)

        К началу

        Интерфейс GProjection

        Это интерфейс для проекций карт. Экземпляр проекции карты передается в конструктор объекта 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)

        К началу

        Класс GScreenOverlay

        Этот объект представляет собой прямоугольное наложенное на карту изображение, положение которого при изменении окна просмотра не изменяется. Примерами использования технологии 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

        Объект 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

        Объект 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. По умолчанию используются абсолютные значения.

        К началу

        Интерфейс GTileLayer

        Этот интерфейс нужно реализовывать, чтобы добавить на карту пользовательские слои фрагментов с помощью объекта 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) Это событие вызывается при добавлении информации об авторских правах в соответствующую коллекцию этого слоя фрагмента.

        К началу

        Класс GTileLayerOptions

        Этот класс предоставляет необязательные аргументы в интерфейс 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

        Объект 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

        Этот класс предоставляет необязательные аргументы в конструктор GTileLayerOverlayOptions. У него нет конструктора. Его экземпляр создается в виде литерала объекта.

        Свойства

        Свойство Тип Описание
        zPriority Number zPriority содержит значение относительного z-порядка для этого объекта TileLayerOverlay. Слои фрагментов с большими значениями визуализируются над слоями с меньшими значениями.

        (Начиная с версии 2.110)

        К началу

        Класс GAdsManager

        Объект 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)

        К началу

        Класс GAdsManagerOptions

        Этот класс передает необязательные аргументы в конструктор 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)

        К началу

        Переменная перечислимого типа GAdsManagerStyle

        Эти константы определяют стиль рекламы, размещаемой посредством объекта GAdsManager. Стиль определяется в свойстве GAdsManagerOptions.style.

        Константы

        Константа Описание
        G_ADSMANAGER_STYLE_ADUNIT Определяет, что объекту GAdsManager нужно размещать контекстную рекламу во фрейме на карте.

        (Начиная с версии 2.163)

        G_ADSMANAGER_STYLE_ICON Определяет, что объекту GAdsManager нужно размещать рекламные сообщения в виде отдельных значков на карте.

        (Начиная с версии 2.163)

        К началу

        Класс GClientGeocoder

        Этот класс используется для прямого взаимодействия с серверами 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" (.co.uk), тогда как ее ISO 3166-1 –·"GB".

        Обратите внимание, что по умолчанию используется домен, с которого первоначально загружен API Карт. Коды стран не чувствительны к регистру.

        (Начиная с версии 2.82)

        getBaseCountryCode() String Возвращает текущий код страны, используемый указанным геокодером. (Если код страны не используется, этот метод возвращает null.)

        (Начиная с версии 2.82)

        reset() None Сбрасывает геокодер. В частности, этот метод вызывает метод GGeocodeCache.reset() для кэша на стороне клиента, если он используется геокодером.

        (Начиная с версии 2.55)

        К началу

        Класс GDirections

        Этот класс можно использовать, чтобы получать маршруты проезда и показывать их на карте и/или на текстовой панели.

        Конструктор

        Конструктор Описание
        GDirections(map?:GMap2, panel?:Element) Создает экземпляр объекта маршрута для запроса маршрутов проезда и хранения полученных результатов. Этот объект может затем создавать маршруты проезда на основе этого запроса с помощью метода GDirections.load().

        В конструкторе можно использовать объект карты (для отображения на ней ломаных линий маршрутов) и/или элемента DIV панели (для отображения на ней текстового описания маршрутов).

        Если передается аргумент map, то при расчете нового маршрута на карту добавляется ломаная линия и связанные с результатом маркеры в виде наложений. Аналогично, при передаче аргумента panel текстовое описание полученного в результате маршрута добавляется на указанную панель DIV, заменяя ее текущее содержание.

        Если один из аргументов принимает значение null, связанные с ними элементы не отображаются за исключением случаев, когда они явно запрошены в методе GDirections.load(). (См. ниже.)

        Кроме того, объект содержит три прослушивателя событий, которые можно перехватить:

        • load: это событие вызывается, если доступны результаты запроса маршрутов, полученные с помощью метода GDirections.load(). Обратите внимание, что метод load() инициализирует новый запрос, который в свою очередь вызывает событие load по окончании загрузки результатов запроса. Это событие вызывается до добавления элементов наложения на карту или панель.
        • "addoverlay": это событие происходит после добавления на карту или в элементы DIV ломаных линий или текстовых компонентов маршрута. Обратите внимание, что событие addoverlay не вызывается при отсутствии прикрепленных к объекту GDirections элементов.
        • "error": это событие происходит в случае ошибки при запросе маршрута. Дополнительные сведения об ошибке можно получить с помощью метода GDirections.getStatus(). При возникновении события error события load и addoverlay не вызываются.

        (Начиная с версии 2.81)

        Методы

        Метод Возвращаемое значение Описание
        load(query:String, queryOpts?:GDirectionsOptions) None Выполняет новый запрос маршрутов. Параметр query представляет собой строку, содержащую действительные маршруты, например "из: Санкт-Петербург в: Москва" или "из: Санкт-Петербург в: Москва в: Сочи". По умолчанию, если в конструкторе объекта GDirections была указана карта, запрашивается результат в виде ломаной линии. Аналогично, если была указана панель с текстом, запрашивается подробное текстовое описание. В противном случае в результате будет получена лишь краткая информация о маршрутах.

        Чтобы переопределить это поведение (например, запрашивать результат в виде ломаной линии, даже когда карта не прикреплена к этому объекту), вызывающие методы могут использовать необязательный параметр queryOpts. Дополнительную информацию можно найти в документации по объекту GDirectionsOptions.

        Получив результаты запроса маршрутов, этот объект удаляет старые результаты, заменяя их новыми, и обновляет карту и/или панель, добавляя новые результаты. Результаты состоят из нескольких маршрутов (объектов типа GRoute) по одному на каждую пару пунктов (адресов), указанных в запросе. В свою очередь маршруты состоят из нескольких участков (объектов типа GStep).

        Если метод load() вызывается до выполнения предыдущего вызова метода load(), предыдущий запрос отменяется. Поэтому, чтобы получать результаты запроса маршрутов последовательно, можно использовать один объект GDirections. Однако, чтобы выполнять несколько запросов параллельно, нужно использовать несколько объектов GDirections.

        (Начиная с версии 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)

        К началу

        Класс GDirectionsOptions

        Этот класс предоставляет необязательные аргументы в методы 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, окно просмотра для этого запроса не изменяется (если его положение задано).

        К началу

        Функция GDownloadUrl

        Эта функция предоставляет удобный способ асинхронного получения ресурса по 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 браузера.

        К началу

        Класс GFactualGeocodeCache

        Этот класс усовершенствует базовый класс GGeocodeCache, накладывая более строгие ограничения на кэшированные результаты. Он кэширует только ответы, вероятность изменения которых в течение короткого промежутка времени очень мала.

        Конструктор

        Конструктор Описание
        GFactualGeocodeCache() Создает кэш, хранящий только фактические ответы.

        (Начиная с версии 2.55)

        Методы

        Метод Возвращаемое значение Описание
        isCachable(reply:Object) Boolean Переопределяет реализацию этого метода, используемую по умолчанию, таким образом, чтобы он выполнял более тщательную проверку кода состояния. Считаются кэшируемыми только ответы с кодом состояния Status.code G_GEO_SUCCESS и недопустимые ответы. Ответы, время ожидания которых истекло или в ходе выполнения которых возникла ошибка сервера, не кэшируются.

        (Начиная с версии 2.55)

        К началу

        Переменная перечислимого типа GGeoAddressAccuracy

        Для этого перечислимого типа не определены символьные константы.

        Константы

        Константа Описание
        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)

        К началу

        Переменная перечислимого типа GGeoStatusCode

        Числовые эквиваленты символьных констант указаны в скобках.

        Константы

        Константа Описание
        G_GEO_SUCCESS
        = 200
        Запрос выполнен без ошибок. Адрес успешно проанализирован, и его географический код возвращен.

        (Начиная с версии 2.55)

        G_GEO_BAD_REQUEST
        = 400
        Запрос маршрутов не удалось выполнить успешно. Например, запрос мог быть отклонен, если он содержал больше допустимого количества пунктов.

        (Начиная с версии 2.81)

        G_GEO_SERVER_ERROR
        = 500
        Запрос на геокодирование, запрос маршрутов или максимального коэффициента масштабирования не удалось выполнить успешно. Однако точная причина сбоя неизвестна.

        (Начиная с версии 2.55)

        G_GEO_MISSING_QUERY
        = 601
        HTTP-параметр q отсутствует, или его значение неизвестно. Для запросов на геокодирование это означает, что адрес не указан, а для запросов маршрутов – что не указан запрос.

        (Начиная с версии 2.81)

        G_GEO_MISSING_ADDRESS
        = 601
        Синоним для константы G_GEO_MISSING_QUERY.

        (Начиная с версии 2.55)

        G_GEO_UNKNOWN_ADDRESS
        = 602
        Не удалось найти географическое положение для указанного адреса. Причиной может быть то, что адрес относительно новый или неправильный.

        (Начиная с версии 2.55)

        G_GEO_UNAVAILABLE_ADDRESS
        = 603
        Геокод для указанного адреса или трасса для запрошенный маршрута не могут быть выданы по юридическим причинам или в силу ограничений контракта.

        (Начиная с версии 2.55)

        G_GEO_UNKNOWN_DIRECTIONS
        = 604
        Объекту GDirections не удалось проложить маршруты между указанным в запросе пунктами. Обычно это происходит, если для указанных пунктов маршрут недоступен или если для этого региона у нас нет данных маршрутов.

        (Начиная с версии 2.81)

        G_GEO_BAD_KEY
        = 610
        Заданный ключ недействителен или не соответствует домену, для которого он был задан.

        (Начиная с версии 2.55)

        G_GEO_TOO_MANY_QUERIES
        = 620
        Превзойден предел запросов для заданного ключа за текущий 24-часовой период или слишком много запросов было отправлено за слишком короткий промежуток времени. Если запросы отправляются параллельно или короткими циклами, используйте таймер или паузу в своем коде, чтобы предотвратить слишком быструю отправку.

        (Начиная с версии 2.55)

        К началу

        Класс GGeoXml

        Объект 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() Создает новый кэш для хранения соответствия адресов и местоположений на карте. Этот конструктор сразу вызывает метод 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

        Объект GGoogleBar предоставляет возможности локального поиска в приложениях API Карт, позволяя пользователям искать и находить нужные места для локальных списков. У объекта GGoogleBar нет конструктора. Он создается картой. Доступ к нему осуществляется с помощью метода GMap2.enableGoogleBar(). Обратите внимание, что на данный момент GoogleBar несовместим с плагином Google Планета Земля, который используется картами типа GMapType.G_SATELLITE_3D_MAP. Он будет отключен, если этот плагин используется.

        К началу

        Класс GGoogleBarAdsOptions

        Этот класс определяет параметры, передаваемые в параметре 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)

        К началу

        Переменная перечислимого типа GGoogleBarLinkTarget

        Эти константы передаются в свойстве GGoogleBarOptions.linkTarget. Они определяют окно назначения для ссылок в информационных окнах с результатами.

        Константы

        Константа Описание

        К началу

        Переменная перечислимого типа GGoogleBarListingTypes

        Эти константы ограничивают тип результатов, возвращаемых локальным поиском, выполненным с помощью 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)

        К началу

        Класс GGoogleBarOptions

        Этот класс определяет параметры, передаваемые в параметре 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)

        К началу

        Переменная перечислимого типа GGoogleBarResultList

        Эти константы передаются в свойстве GGoogleBarOptions.resultList. Они определяют характер отображения списка результатов.

        Константы

        Константа Описание
        G_GOOGLEBAR_RESULT_LIST_INLINE Соответствует стилю, используемому по умолчанию, когда список результатов показывается в форме таблицы на карте.
        G_GOOGLEBAR_RESULT_LIST_SUPPRESS Соответствует стилю, используемому по умолчанию, когда список результатов скрыт и заменен кнопками следующий и предыдущий.

        К началу

        Класс GPov

        Этот класс определяет позицию камеры при просмотре фотографий улиц. У него нет конструктора. Его экземпляр создается в виде литерала объекта. Все свойства являются необязательными.

        Свойства

        Свойство Тип Описание
        yaw Number Угол поворота от географического севера в градусах. Географический север – 0 градусов, восток – 90, юг – 180, запад – 270.

        (Начиная с версии 2.104)

        pitch Number Угол отклонения относительно начального угла наклона при просмотре улиц в градусах . Изменяется от 90 градусов (прямо вверх) до -90 градусов (прямо вниз).

        (Начиная с версии 2.104)

        zoom Number Коэффициент масштабирования. У минимального изображения он равен 0, а затем увеличивается при увеличении карты.

        (Начиная с версии 2.104)

        К началу

        Класс GRoute

        Объекты этого класса создаются объектом 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)

        К началу

        Класс GStep

        Объекты этого класса создаются объектом 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

        Объект 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)

        К началу

        Переменная перечислимого типа GStreetviewClient.ReturnValues

        Числовые эквиваленты символьных констант указаны в скобках.

        Константы

        Константа Описание
        SUCCESS
        = 200
        Успех

        (Начиная с версии 2.104)

        SERVER_ERROR
        = 500
        Сервер не отвечает на запросы.

        (Начиная с версии 2.104)

        NO_NEARBY_PANO
        = 600
        Фотографии не найдены.

        (Начиная с версии 2.104)

        К началу

        Класс GStreetviewData

        Этот класс представляет сведения о панорамном изображении. У него нет конструктора. Его экземпляр создается в виде литерала объекта.

        Свойства

        Свойство Тип Описание
        location GStreetviewLocation Данные о положении.

        (Начиная с версии 2.104)

        copyright String Локализованная информация об авторских правах.

        (Начиная с версии 2.104)

        code GStreetviewClient.ReturnValues Код состояния. См{\lang1033 .}GStreetviewClient.ReturnValues.

        (Начиная с версии 2.104)

        К началу

        Этот класс предоставляет ссылку с одного объекта GStreetviewLocation на ближайший объект GStreetviewLocation. У него нет конструктора. Его экземпляр создается в виде литерала объекта.

        Свойства

        Свойство Тип Описание
        yaw Number Угол поворота от текущего местоположения до близлежащего.

        (Начиная с версии 2.104)

        description String Локализованная строка, описывающая близлежащее место.

        (Начиная с версии 2.104)

        panoId String Уникальный идентификатор для близлежащего панорамного изображения. Он не изменяется в ходе одной сессии, но может изменяться между ними.

        (Начиная с версии 2.104)

        К началу

        Класс GStreetviewLocation

        Этот класс определяет местоположение при просмотре фотографий улиц. У него нет конструктора. Его экземпляр создается в виде литерала объекта.

        Свойства

        Свойство Тип Описание
        latlng GLatLng Координаты широты и долготы панорамного изображения.

        (Начиная с версии 2.104)

        pov GPov Начальная точка обзора.

        (Начиная с версии 2.104)

        description String Локализованная строка, описывающая место.

        (Начиная с версии 2.104)

        panoId String Уникальный идентификатор панорамного изображения. Он не изменяется в ходе одной сессии, но может изменяться между ними.

        (Начиная с версии 2.104)

        К началу

        Класс GStreetviewOverlay

        Объект 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

        Объект 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