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 事件的源元素将分别在 point 和 src 参数中传递。注意,如果在启用了双击缩放的情况下进行右键双击,则缩小地图,不触发 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*() 在其他点重新打开当前已打开的信息窗口,则会先后触发 infowindowbeforeclose 、infowindowclose 和 infowindowopen 事件。 |
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是一个专门为Vue 2.x框架设计的插件,它允许开发者在Vue应用中无缝集成Google Maps API。这个插件将Google Maps的强大功能与Vue的声明式渲染相结合,为开发者提供了更方便的方式来创建交互式的地图应用...
### GOOGLE MAP API 示例知识点解析 #### 一、Google Maps JavaScript API 概述 Google Maps JavaScript API 是一个功能强大的工具包,允许开发者将交互式的地图嵌入到网页中。通过使用这个API,开发者可以轻松地...
【GMAP:Google Maps API详解】 Google Maps API(Application Programming Interface)是Google提供的一项强大服务,允许开发者在自己的网站或应用程序中嵌入交互式地图,实现各种定制化的地图功能。"Gmap.rar" ...
Gmap API,全称为Google Maps API,是Google提供的一款强大的地图集成工具,允许开发者将Google Maps无缝地融入到自己的网站或应用中。本实例聚焦于使用jQuery与Gmap API的结合,即`jquery-gmap3-4.1`库,以实现更...
GOOGLE MAP api 7个案例。 CurrentAddress 得到当前位置 gMap 地形 路线 GoogleMapDemo 当前位置 MAP 绘制路线 MapView 放大缩小 WeatherMap 在MAP上添加图片 WorldCities 城市经纬度的切换 以及 动画切换效果
2. **基本地图嵌入**:通过`<script>`标签引入谷歌地图API库,并使用JavaScript代码初始化地图,设置中心点坐标和地图类型。例如: ```html <div id="map"> <script src="https://maps.googleapis....
1. **加载API**:通过`<script>`标签引入Google Map API的JavaScript库,指定API版本(v=2)和你的API密钥。 2. **创建地图容器**:使用`<div id="map_canvas">`创建一个用于显示地图的HTML元素,并设定宽度和高度。...
Google Map MarkerCluster 是 Google Map API 中的一個功能強大且實用的工具,它可以幫助開發者快速實現地圖標記的聚合功能。下面是 MarkerCluster 的使用簡介: MarkerCluster 的主要功能是將多個標記點聚合到一個...
- **Map2类**:这是表示地图的类,提供了地图的各种属性和方法,如添加图层、改变视图等。 - **谷歌可视化API**:除了基本地图服务,Google Map API还包括了用于数据可视化的工具,如图表、热力图等。 - **...
《GoogleMap API 中文详解》 GoogleMap API 是一套强大的工具,允许开发者在网页或应用中集成 Google 地图服务,实现地图展示、定位、路径规划等功能。本文将深入介绍如何使用 GoogleMap API 创建基本的地图功能,...
支持ie6+,可以直接输入中文获得地图.基本可以满足任何网站的需求。官方api地址: http://www.codechina.org/doc/google/gmapapi/
Map2 类是 Google 地图 API 的一个重要类,用于管理和控制地图。Map2 类提供了丰富的方法和事件,用于控制和交互地图。 9. 谷歌可视化 API 谷歌可视化 API 是 Google 地图 API 的一项功能,允许开发者在地图上添加...
标题中的"GMAP.rar_GMAP_delphi map_google delphi_google map_google map del"表明这是一个与Delphi编程语言相关的项目,特别地,它涉及到在Delphi应用中集成和使用Google Maps服务。"Google Map Test Code"的描述...
谷歌地图JavaScript API V3(简称gmap)是Google提供的一款强大的地图开发工具,它允许开发者在网页上嵌入交互式地图,实现各种定制化的地图功能。这个压缩包文件包含了一系列有关gmap的教程章节,从基础到进阶,...
GMap API是Google提供的一个强大的地图服务接口,而jQuery则是一个广泛使用的JavaScript库,它简化了DOM操作,使得代码更加简洁易懂。通过将两者结合,我们可以利用jQuery的便利性来处理GMap 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...
var map = new GMap2(document.getElementById('map_div'), {mapType: G_MAP_TYPE_ROADMAP}); ``` 这里,`container`参数是一个DOM元素,通常是`div`,`opts`参数包含构造函数选项,如地图类型。 `GMap2`对象提供了...
《Googlemap_API教程详解》 在IT开发领域,Googlemap_API是一个强大的工具,它允许开发者在网站或应用中集成Google地图的功能,实现地理位置信息的展示、路径规划等复杂任务。本教程将深入讲解如何使用Googlemap_...