Google 地图 API 参考

Google地图API参考北京新兴桥中心2009-04-25Google地图API现在与GoogleAJAXAPI加载器集成，后者为加载和使用多个GoogleAJAXAPI创建了一个公共的名称空间。此框架允许您对Google地图API中当前使用的所有类、方法和属性使用google.maps.*可选名称空间，用此名称空间替换普通的G前缀。不要担心：现有的G名称空间依然受支持。例如，Google地图API中的GMap2对象也可以定义为google.maps.Map2.注意，此参考文档仅针对现有G名称空间。如果您想要在地图上显示您的内容，则需要了解以下类、类型和函数：GMap2GMapOptionsGInfoWindowGInfoWindowTabGInfoWindowOptionsGMarkerGMarkerOptionsGPolylineGPolylineOptionsGPolygonGPolygonOptionsGGroundOverlayGIconGPointGSizeGBoundsGLatLngGLatLngBoundsGControlGTileLayerOptionsGEventGEventListenerGXmlHttpGXmlGXsltGLogGDraggableObjectGDraggableObjectOptionsGGeoStatusCodeGClientGeocoderGGeocodeCacheGFactualGeocodeCacheGMarkerManagerGMarkerManagerOptionsGGeoXmlGDownloadUrlGBrowserIsCompatible如果想要通过实现您自己的控件、叠加层或地图类型来扩展地图API的功能，那么您同样需要了解以下类和类型：GMapPaneGOverlayGControlGControlPositionGMapTypeGMapTypeOptionsGTileLayerGTileLayerOverlayGCopyrightGProjectionGMercatorProjectionGControlAnchorGCopyrightCollectionclassGMap2对类GMap2实例化以创建地图。这是API中的中心类。其他的都是辅助类。构造函数构造函数描述GMap2(container,opts?)在给定的HTML容器中创建新的地图，该容器通常是一个DIV元素。如果可选参数opts.mapTypes中没有给出地图类型集，则使用默认的集合G_DEFAULT_MAP_TYPES。如果可选参数opts.size中没有给出大小，则使用container的大小。如果给出了opts.size，则相应地调整地图容器元素的大小。请参阅classGMapOptions。方法配置方法返回值描述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()ArrayofGMapType返回在此地图中注册的地图类型数组。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元素中的像素坐标点所对应的地理坐标。实现自定义控件与地图的交互时需要使用此方法。事件事件参数描述addmaptypetype向地图中添加地图类型时会触发此事件。removemaptypetype从地图中删除地图类型时会触发此事件。clickoverlay,point用鼠标单击地图时会触发此事件。如果单击了某个标记，则该标记将通过over