`

google map api ---类GMap2

    博客分类:
  • gis
阅读更多

class GMap2

对类 GMap2 实例化以创建地图。这是 API 中的中心类。其他的都是辅助类。

构造函数

构造函数 描述
GMap2(container, opts?) 在给定的 HTML 容器中创建新的地图,该容器通常是一个 DIV 元素。如果可选参数 opts.mapTypes 中没有给出地图类型集,则使用默认的集合 G_DEFAULT_MAP_TYPES。如果可选参数 opts.size 中没有给出大小,则使用 container 的大小。如果给出了 opts.size,则相应地调整地图容器元素的大小。请参阅 class GMapOptions

方法

配置

方法 返回值 描述
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 开始)
enableScrollWheelZoom() none 启用使用鼠标滚轮缩放。注:默认情况下禁用滚轮缩放。(自 2.78 开始)
disableScrollWheelZoom() none 禁用使用鼠标滚轮缩放。注:默认情况下禁用滚轮缩放。(自 2.78 开始)
scrollWheelZoomEnabled() Boolean 返回一个布尔值,表示是否启用了滚轮缩放。(自 2.78 开始)

控件

方法 返回值 描述
addControl(control, position?) none 将控件添加到地图。地图上的位置由可选的 position 参数确定。如果此参数不存在,则使用由 GControl.getDefaultPosition() 方法确定的控件默认位置。一个控件实例只能向地图中添加一次。
removeControl(control) none 从地图中删除控件。如果控件从未被添加到地图中,则该操作不起任何作用。
getContainer() Node 返回包含地图的 DOM 对象。由 GControl.initialize() 使用。

地图类型

方法 返回值 描述
getMapTypes() Array of GMapType 返回在此地图中注册的地图类型数组。
getCurrentMapType() GMapType 返回当前选中的地图类型。
setMapType(type) none 选择给定的新地图类型。类型必须是为地图所知的类型。请参阅构造函数和方法 addMapType()
addMapType(type) none 将新地图类型添加到地图中。有关如何定义自定义地图类型的信息,请参阅 GMapType 部分。
removeMapType(type) none 从地图中删除地图类型。将更新通过 GMapTypeControl 显示的按钮集,并触发 removemaptype 事件。

地图状态

方法 返回值 描述
isLoaded() Boolean 当且仅当地图在创建后就用 setCenter() 进行初始化时,返回 true
getCenter() GLatLng 返回地图当前视图中心点的地理坐标。
getBounds() GLatLngBounds 返回地图视图的可视矩形区域,用地理坐标表示。
getBoundsZoomLevel(bounds) Number 返回给定矩形区域恰好可以放在地图视图中时的缩放级别。缩放级别要按当前选中的地图类型计算。如果还未选择地图类型,将使用地图类型列表中列出的第一个类型。
getSize() GSize 返回地图视图的大小(以像素表示)。
getZoom() Number 返回当前的缩放级别。

修改地图状态

方法 返回值 描述
setCenter(center, zoom?, type?) none 按给定的中心点设置地图视图。也可以同时设置缩放级别和地图类型。地图类型必须是为地图所知的类型。请参阅构造函数和方法 addMapType()。必须在构造地图后先调用此方法,才能设置地图的初始状态。在构造后先调用地图上的其他操作是错误的。
panTo(center) none 将地图的中心点更改为给定的点。如果该点在当前地图视图中已经可见,则以平移动画的方式更改中心点。
panBy(distance) none 按给定的距离(以像素表示)开始平移动画。
panDirection(dx, dy) none 在指定方向上开始平移动画,移动幅度为地图宽度的一半,+1 是向右或向下方向,-1 是向左或向上方向。
setZoom(level) none 将缩放级别设置为给定的新值。
zoomIn() none 按 1 递增缩放级别。
zoomOut() none 按 1 递减缩放级别。
savePosition() none 存储当前的地图位置和缩放级别,以便以后用 returnToSavedPosition() 重新还原。
returnToSavedPosition() none 恢复用 savePosition() 保存的地图视图。
checkResize() none 通知地图其容器大小已更改。在更改了容器 DOM 对象的大小后调用此方法,以便地图能够适应新的大小。

叠加层

方法 返回值 描述
addOverlay(overlay) none 将叠加层添加到地图中,并触发 addoverlay 事件。
removeOverlay(overlay) none 从地图中删除叠加层。如果地图中存在叠加层,则会触发 removeoverlay 事件。
clearOverlays() none 从地图中删除所有叠加层,并触发 clearoverlays 事件。
getPane(pane) Node 返回包含 pane 所标识的层中的对象的 DIV。GOverlay 实例在方法 GOverlay.initialize() 中调用它,以便在地图上绘制这些实例自身。

信息窗口

方法 返回值 描述
openInfoWindow(point, node, opts?) none 在给定的点打开简单的信息窗口。在地图上将地图平移到使打开的信息窗口完全可见的位置。信息窗口的内容为 DOM 节点。
openInfoWindowHtml(point, html, opts?) none 在给定的点打开简单的信息窗口。在地图上将地图平移到使打开的信息窗口完全可见的位置。信息窗口的内容显示为 HTML 文本。
openInfoWindowTabs(point, tabs, opts?) none 在给定的点打开带标签页的信息窗口。在地图上将地图平移到使打开的信息窗口完全可见的位置。信息窗口的内容为 DOM 节点。
openInfoWindowTabsHtml(point, tabs, opts?) none 在给定的点打开带标签页的信息窗口。在地图上将地图平移到使打开的信息窗口完全可见的位置。信息窗口的内容显示为 HTML 文本。
showMapBlowup(point, opts?) none 在给定的点打开信息窗口,窗口内包含地图上环绕此点的一个近景视图。
updateInfoWindow(tabs, onupdate?) none 更新当前打开的 GInfoWindow 对象的内容,而不重新定位。这样,就会按新内容的大小来调整信息窗口的大小。对信息窗口内容进行实际更改后,将调用可选的 onupdate 回调函数。(自 2.85 开始)
updateCurrentTab(modifier, onupdate?) none 更新当前选中的标签页会引起对 GInfoWindow 对象的大小调整,而不重置。modifier 函数用于修改当前选中的标签页,并且将 GInfoWindowTab 作为参数传递。在信息窗口显示新内容后,调用可选的 onupdate 回调函数。(自 2.85 开始)
closeInfoWindow() none 关闭当前打开的信息窗口。
getInfoWindow() GInfoWindow 返回此地图的信息窗口对象。如果还没有信息窗口,将创建一个信息窗口,但不显示它。此操作不受 enableInfoWindow() 影响。

坐标变换

方法 返回值 描述
fromLatLngToDivPixel(latlng) GPoint 计算含有可拖拽地图的 DOM 元素中的地理位置所对应的像素坐标。为自定义叠加层实现 GOverlay.redraw() 方法时,需要用此方法计算自定义叠加层的位置。
fromDivPixelToLatLng(pixel) GLatLng 计算含有可拖拽地图的 div 中的像素坐标所对应的地理坐标。实现与自定义叠加层的交互时需要使用此方法。
fromContainerPixelToLatLng(pixel) GLatLng 计算页面含有地图的 DOM 元素中的像素坐标点所对应的地理坐标。实现自定义控件与地图的交互时需要使用此方法。

事件

事件 参数 描述
addmaptype type 向地图中添加地图类型时会触发此事件。
removemaptype type 从地图中删除地图类型时会触发此事件。
click overlay, point 用鼠标单击地图时会触发此事件。如果单击了某个标记,则该标记将通过 overlay 参数传递给事件处理程序,并且还在标记上触发 click 事件。否则,被单击点的地理坐标将在 point 参数中传递。
dblclick overlay, point 双击地图时触发会此事件。注意,双击标记时不触发此事件。被双击点的地理坐标将在 point 参数中传递。overlay 参数总是设置为 null。(自 2.83 开始)
singlerightclick point, src, overlay? 在地图容器中触发 DOM contextmenu 事件时会触发此事件。如果右击某个标记,则该标记将通过 overlay 参数传递给事件处理程序。被右击点的像素坐标(在包含地图的 DOM 元素中)和 DOM 事件的源元素将分别在 pointsrc 参数中传递。注意,如果在启用了双击缩放的情况下进行右键双击,则缩小地图,不触发 singlerightclick 事件。但是,如果禁用了双击缩放,则触发两个 singlerightclick 事件。(自 2.84 开始)
movestart none 地图视图开始更改时会触发此事件。拖拽操作或调用更改地图视图的方法时也会触发此事件,前者还同时触发 dragstart 事件。
move none 更改地图视图时会触发此事件,并且可能是重复触发。
moveend none 结束地图视图的更改时会触发此事件。
zoomend oldLevel, newLevel 地图到达新的缩放级别时会触发此事件。事件处理程序将接收先前缩放级别和新缩放级别作为参数。
maptypechanged none 选择另一地图类型时会触发此事件。
infowindowopen none 打开信息窗口时会触发此事件。
infowindowbeforeclose none 关闭信息窗口前会触发此事件。(自 2.83 开始)
infowindowclose none 关闭信息窗口时会触发此事件。此事件发生前会触发 infowindowbeforeclose 事件。如果通过再次调用 openInfoWindow*() 在其他点重新打开当前已打开的信息窗口,则会先后触发 infowindowbeforecloseinfowindowcloseinfowindowopen 事件。
addoverlay overlay 当使用 addOverlay() 方法向地图中添加单个叠加层时会触发此事件。新的叠加层将作为参数 overlay 传递到事件处理程序中。
removeoverlay overlay 当使用 removeOverlay() 方法删除单个叠加层时会触发此事件。删除的叠加层将作为参数 overlay 传递到事件处理程序中。
clearoverlays none 当使用 clearOverlays() 方法一次性删除全部叠加层时会触发此事件。
mouseover latlng 当用户将鼠标从地图外面移动到地图上时会触发此事件。
mouseout latlng 当用户将鼠标移离地图时会触发此事件。
mousemove latlng 当用户在地图中移动鼠标时会触发此事件。
dragstart none 当用户开始拖拽地图时会触发此事件。
drag none 当用户拖拽地图时会重复触发此事件。
dragend none 当用户停止拖拽地图时会触发此事件。
load none 当完成地图设置时会触发此事件,并且 isLoaded() 会返回 true。这表示位置、缩放和地图类型都已完成初始化,但可能还在装载图块图像。(自 2.52 开始)
分享到:
评论

相关推荐

    vue2googlemap基于Vue2x和google地图组件

    Vue2googlemap是一个专门为Vue 2.x框架设计的插件,它允许开发者在Vue应用中无缝集成Google Maps API。这个插件将Google Maps的强大功能与Vue的声明式渲染相结合,为开发者提供了更方便的方式来创建交互式的地图应用...

    GOOGLE MAPapi示例

    ### GOOGLE MAP API 示例知识点解析 #### 一、Google Maps JavaScript API 概述 Google Maps JavaScript API 是一个功能强大的工具包,允许开发者将交互式的地图嵌入到网页中。通过使用这个API,开发者可以轻松地...

    Gmap.rar_GMAP_Google api_The Way_google map_google map api

    【GMAP:Google Maps API详解】 Google Maps API(Application Programming Interface)是Google提供的一项强大服务,允许开发者在自己的网站或应用程序中嵌入交互式地图,实现各种定制化的地图功能。"Gmap.rar" ...

    引用Gmap API实例

    Gmap API,全称为Google Maps API,是Google提供的一款强大的地图集成工具,允许开发者将Google Maps无缝地融入到自己的网站或应用中。本实例聚焦于使用jQuery与Gmap API的结合,即`jquery-gmap3-4.1`库,以实现更...

    demo.zip_DEMO_Google api_MapView_google map api demo_google map

    GOOGLE MAP api 7个案例。 CurrentAddress 得到当前位置 gMap 地形 路线 GoogleMapDemo 当前位置 MAP 绘制路线 MapView 放大缩小 WeatherMap 在MAP上添加图片 WorldCities 城市经纬度的切换 以及 动画切换效果

    gmap 谷歌地图api

    2. **基本地图嵌入**:通过`<script>`标签引入谷歌地图API库,并使用JavaScript代码初始化地图,设置中心点坐标和地图类型。例如: ```html <div id="map"> <script src="https://maps.googleapis....

    google map API 的应用

    1. **加载API**:通过`<script>`标签引入Google Map API的JavaScript库,指定API版本(v=2)和你的API密钥。 2. **创建地图容器**:使用`<div id="map_canvas">`创建一个用于显示地图的HTML元素,并设定宽度和高度。...

    Google Map MarkerCluster使用簡介

    Google Map MarkerCluster 是 Google Map API 中的一個功能強大且實用的工具,它可以幫助開發者快速實現地圖標記的聚合功能。下面是 MarkerCluster 的使用簡介: MarkerCluster 的主要功能是將多個標記點聚合到一個...

    Google Map API

    - **Map2类**:这是表示地图的类,提供了地图的各种属性和方法,如添加图层、改变视图等。 - **谷歌可视化API**:除了基本地图服务,Google Map API还包括了用于数据可视化的工具,如图表、热力图等。 - **...

    GoogleMap api 中文

    《GoogleMap API 中文详解》 GoogleMap API 是一套强大的工具,允许开发者在网页或应用中集成 Google 地图服务,实现地图展示、定位、路径规划等功能。本文将深入介绍如何使用 GoogleMap API 创建基本的地图功能,...

    google map api 实例

    支持ie6+,可以直接输入中文获得地图.基本可以满足任何网站的需求。官方api地址: http://www.codechina.org/doc/google/gmapapi/

    google地图api文档

    Map2 类是 Google 地图 API 的一个重要类,用于管理和控制地图。Map2 类提供了丰富的方法和事件,用于控制和交互地图。 9. 谷歌可视化 API 谷歌可视化 API 是 Google 地图 API 的一项功能,允许开发者在地图上添加...

    GMAP.rar_GMAP_delphi map_google delphi_google map_google map del

    标题中的"GMAP.rar_GMAP_delphi map_google delphi_google map_google map del"表明这是一个与Delphi编程语言相关的项目,特别地,它涉及到在Delphi应用中集成和使用Google Maps服务。"Google Map Test Code"的描述...

    googlemap js v3 gmap

    谷歌地图JavaScript API V3(简称gmap)是Google提供的一款强大的地图开发工具,它允许开发者在网页上嵌入交互式地图,实现各种定制化的地图功能。这个压缩包文件包含了一系列有关gmap的教程章节,从基础到进阶,...

    GMap api 与jquery结合使用

    GMap API是Google提供的一个强大的地图服务接口,而jQuery则是一个广泛使用的JavaScript库,它简化了DOM操作,使得代码更加简洁易懂。通过将两者结合,我们可以利用jQuery的便利性来处理GMap API的各种复杂任务。 ...

    google map api 使用文档

    gmap = new GMap2(document.getElementById("gmap")); var centerat = new GLatLng(34.74,113.62); gmap.addControl(new GLargeMapControl()); gmap.addControl(new GMapTypeControl()); gmap.setCenter...

    Google_Map_Api_谷歌地图接口整理

    var map = new GMap2(document.getElementById('map_div'), {mapType: G_MAP_TYPE_ROADMAP}); ``` 这里,`container`参数是一个DOM元素,通常是`div`,`opts`参数包含构造函数选项,如地图类型。 `GMap2`对象提供了...

    Googlemap_API教程

    《Googlemap_API教程详解》 在IT开发领域,Googlemap_API是一个强大的工具,它允许开发者在网站或应用中集成Google地图的功能,实现地理位置信息的展示、路径规划等复杂任务。本教程将深入讲解如何使用Googlemap_...

Global site tag (gtag.js) - Google Analytics