Google地图使用API介绍

Google地图API参考帮助Google地图API现在与GoogleAJAXAPI载入器集成，后者创建了一个公共命名空间，以便载入和使用多个GoogleAJAXAPI。该框架可让您将可选google.maps.*命名空间用于当前在Google地图API中使用的所有类、方法和属性，使用此命名空间替换常规G前缀。不要担心，现有G命名空间仍能得到支持。例如，Google地图API中的GMap2对象还可以定义为google.maps.Map2。请注意，此参考文档仅指现有G命名空间。如果只是要使用地图显示内容，则需要了解以下类、类型和函数：GMap2GMapOptionsGGoogleBarOptionsGInfoWindowGInfoWindowTabGInfoWindowOptionsGMarkerGMarkerOptionsGPolylineGPolylineOptionsGPolyEditingOptionsGPolyStyleOptionsGPolygonGPolygonOptionsGScreenOverlayGScreenPointGScreenSizeGGroundOverlayGIconGPointGSizeGBoundsGLatLngGLatLngBoundsGControlGTileLayerOptionsGTileLayerOverlayOptionsGEventGEventListenerGXmlHttpGXmlGXsltGLogGDraggableObjectGDraggableObjectOptionsGGeoStatusCodeGGeoAddressAccuracyGClientGeocoderGGeocodeCacheGFactualGeocodeCacheGMarkerManagerGMarkerManagerOptionsGGeoXmlGDownloadUrlGBrowserIsCompatibleGDirectionsGDirectionsOptionsGTravelModesGRouteGStepGTrafficOverlayGTrafficOverlayOptionsGAdsManagerGAdsManagerOptionsGStreetviewPanoramaGStreetviewPanoramaOptionsGStreetviewOverlayGStreetviewClientGStreetviewClient.ReturnValuesGStreetviewDataGStreetviewLocationGStreetviewLinkGPovGStreetviewPanorama.ErrorValues如果您要通过实现自己的控件、叠加层或地图类型来扩展地图API的功能，则还需要了解以下类和类型：GGoogleBarListingTypesGGoogleBarLinkTargetGGoogleBarResultListGMapPaneGOverlayGControlGControlPositionGControlAnchorGMapTypeControlGMenuMapTypeControlGHierarchicalMapTypeControlGMapTypeGMapTypeOptionsGLayerGTileLayerGTileLayerOverlayGCopyrightCollectionGCopyrightGProjectionGMercatorProjectionGMap2类对GMap2类进行实例化以创建地图。这是API中的中心类。其他都是辅助类。构造函数构造函数说明GMap2(container:Node,opts?:GMapOptions)在指定的HTML容器中创建新的地图，该容器通常是一个DIV元素。如果可选参数opts.mapTypes中没有给出地图类型集合，则使用默认的集合G_DEFAULT_MAP_TYPES。如果可选参数opts.size中没有给出大小，则使用container的大小。如果给出了opts.size，则相应地调整地图容器元素的大小。请参见classGMapOptions。注意：需要先将地图居中，才能使用该地图。您应该立即调用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。如果启用，该控件会取代默认的“由Google强力驱动”徽标。请注意，该控件默认情况下未启用。（自2.92开始）disableGoogleBar()None禁用GoogleBar集成搜索控件。如果禁用，默认的“由Google强力驱动”徽标会占据以前放置此控件的位置。请注意，该控件已经默认禁用。（自2.92开始）enableScrollWheelZoom()None启用使用鼠标滚轮缩放。注意：默认情况下禁用滚轮缩放。（自2.78开始）disableScrollWheelZoom()None禁用使用鼠标滚轮缩放。注意：默认情况下禁用滚轮缩放。（自2.78开始）scrollWheelZoomEnabled()Boolean返回一个表示是否启用滚轮缩放的布尔值。（自2.78开始）控件方法返回说明值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当且仅当地图在创建后使用setCenter()进行初始化时，返回true。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地球实例以前已通过设置Google地球地图类型（通过GMap2.setMapType(G_SATELLITE_3D_MAP)）进行了实例化，可能会立即触发该回调函数。如果实例尚未创建，调用getEarthInstance会初始化Google地球插件。（这种异步行为就是该方法需要回调的原因。）注意：如果初始化遇到错误，回调函数将传递null参数。请注意，尽管该方法会创建Google地球实例，但不会将Google地球地图类型设置为当前视图。要执行此操作，请显式地调用GMap2.setMapType(G_SATELLITE_3D_MAP)，或让用户通过MapTypeControl选择此地图类型。请参见Google地球API开发人员指南，以获取有关怎样使用GEPlugin对象的详细信息。（自2.113开始）修改地图状态方法返回值说明setCenter(center:GLatLng,None按指定的中心设置地图视图。也可以同时设置缩放zoom?:Number,type?:GMapType)级别和地图类型。地图类型必须是地图已知的类型。请参见构造函数和方法addMapType()。必须在构造后先调用此方法，才能设置地图的初始状态。在调用此函数之前调用对新构造的GMap2对象执行的操作，这是错误的。panTo(center:GLatLng)None将地图的中心点更改为指定的点。如果该点已经在当前的地图视图中可见，则会以平滑动画的方式移动中心点。panBy(distance:GSize)None以动画方式平移指定的距离（以像素为单位）。panDirection(dx:oneof-10+1,dy:oneof-10+1)None以动画方式向指示方向平移地图宽度的一半。+1是向右向下，-1是向左向上。setZoom(level:Number)None将缩放级别设置为指定的新值。zoomIn()None将缩放级别加1。zoomOut()None将缩放级别减1。savePosition()None存储当前的地图位置和缩放级别，以便以后用returnToSavedPosition()重新调用。returnToSavedPosition()None恢复用savePosition()保存的地图视图。checkResize()None通知地图其容器大小