TransitRouteOptions
此类表示TransitRoute构造函数的可选参数。它没有构造函数，但可通过对象字面量形式表示。
属性 类型 描述
renderOptions RenderOptions 搜索结果的呈现设置
policy TransitPolicy 公交导航的策略参数
pageCapacity Number 返回方案的个数
onSearchComplete Function 检索完成后的回调函数。参数：results: TransitRouteResult，公交导航结果
onMarkersSet Function 标注添加完成后的回调函数。参数：pois: Array ，起点和目的地数组。transfers: Array ，公交车站数组
onInfoHtmlSet Function 气泡内容创建后的回调函数。参数：poi: LocalResultPoi，表示当前气泡对应的点（可以是起点、终点或换乘车站）html: HTMLElement，气泡内的DOM元素
onPolylinesSet Function 折线添加完成后的回调函数。参数：lines: Array ，公交线路数组。routes: Array ，步行线路数组，通过Route.getPolyline()方法可得到对应的折线覆盖物
onResultsHtmlSet Function 结果列表添加完成后的回调函数。参数：container: 结果列表所用的HTML元素
TransitPolicy
此常量表示公交方案的策略。
常量 描述
BMAP_TRANSIT_POLICY_LEAST_TIME 最少时间
BMAP_TRANSIT_POLICY_LEAST_TRANSFER 最少换乘
BMAP_TRANSIT_POLICY_LEAST_WALKING 最少步行
BMAP_TRANSIT_POLICY_AVOID_SUBWAYS 不乘地铁
TransitRouteResult
此类表示路线导航的结果，没有构造函数，通过访问TransitRoute.getResults()方法或TransitRoute的onSearchComplete回调函数参数获得。
属性 类型 描述
policy TransitPolices 公交导航策略
city String 本次检索所在的城市
moreResultsUrl String 更多结果的链接，到百度地图进行搜索
方法 返回值 描述
getStart() LocalResultPoi 返回起点
getEnd() LocalResultPoi 返回终点
getNumPlans() Number 返回方案个数
getPlan(i: Number) TransitRoutePlan 返回索引指定的方案。索引0表示第一条方案
TransitRoutePlan
此类表示一条公交出行方案。没有构造函数，通过TransitRouteResult.getPlan()方法获得。
方法 返回值 描述
getNumLines() Number 返回方案包含的公交线路段数
getLine(i: Number) Line 返回方案包含的某条公交线路
getNumRoutes() Number 返回方案包含的步行线路段数
getRoute(i: Number) Route 返回方案包含的某条步行线路
getDistance(format: Boolean) String | Number 返回方案总距离。当format参数为true时，返回方案距离字符串（包含单位），当format为false时，仅返回数值（单位为米）信息。默认参数为true
getDuration(format: Boolean) String | Number 返回方案总时间。当format参数为true时，返回描述时间的字符串（包含单位），当format为false时，仅返回数值（单位为秒）信息。默认参数为true
getDescription(includeHtml: Boolean) String 返回方案描述文本，默认包含HTML标签。当includeHtml为false时，方案描述不包含HTML标签

LineType
此枚举类型表示不同类型的公共交通线路。
常量 描述
BMAP_LINE_TYPE_BUS 公交车
BMAP_LINE_TYPE_SUBWAY 地铁
BMAP_LINE_TYPE_FERRY 渡轮
WalkingRoute
用于获取步行路线规划方案。
构造函数 描述
WalkingRoute(location:Map| Point| String, opts:WalkingRouteOptions) 创建一个步行导航实例。location表示检索区域，类型可为地图实例、坐标点或城市名称的字符串。当参数为地图实例时，检索位置由当前地图中心点确定；当参数为坐标时，检索位置由该点所在位置确定；当参数为城市名称时，检索会在该城市内进行
方法 返回值 描述
search(start: String | Point|LocalResultPoi, end: String | Point|LocalResultPoi) none 发起检索。 start: 起点，参数可以是关键字、坐标点（自1.1版本支持）或者LocalSearchPoi实例。 end: 终点，参数可以是关键字、坐标点（自1.1版本支持）或者LocalSearchPoi实例
getResults() WalkingRouteResult 返回最近一次检索的结果
clearResults() none 清除最近一次检索的结果
enableAutoViewport() none 启用自动调整地图层级，当指定了搜索结果所展现的地图时有效
disableAutoViewport() none 禁用自动调整地图层级
setLocation(location: Map| Point| String) none 设置检索范围，参数类型可以为地图实例、坐标点或字符串。例：setLocation("北京市")
setSearchCompleteCallback(callback: Function) none 设置检索结束后的回调函数。 参数： results: WalkingRouteResult
setMarkersSetCallback(callback: Function) none 设置添加标注后的回调函数。 参数： pois: Array ，起点和目的地点数组。通过marker属性可得到其对应的标注
setInfoHtmlSetCallback(callback: Function) none 设置气泡打开后的回调函数。 参数： poi: LocalResultPoi，通过其marker属性可得到当前的标注。 html: HTMLElement，气泡内的DOM元素
setPolylinesSetCallback(callback: Function) none 设置添加路线后的回调函数。 参数： routes: Array ，步行线路数组，通过Route.getPolyline()方法可得到对应的折线覆盖物
setResultsHtmlSetCallback(callback: Function) none 设置结果列表创建后的回调函数。 参数： container: 结果列表所用的HTML元素
getStatus() StatusCodes 返回状态码
toString() String 返回类型说明
WalkingRouteOptions
此类表示WalkingRoute构造函数的可选参数。
属性 类型 描述
renderOptions RenderOptions 搜索结果呈现设置
onSearchComplete Function 检索完成后的回调函数。 参数： results: WalkingRouteResult
onMarkersSet Function 标注添加完成后的回调函数。 参数： pois: Array ，起点和目的地点数组，。通过marker属性可得到其对应的标注
onPolylinesSet Function 折线添加完成后的回调函数。 参数： routes: Array ，步行线路数组，通过Route.getPolyline()方法可得到对应的折线覆盖物
onInfoHtmlSet Function 标注气泡内容创建后的回调函数。 参数： poi: LocalResultPoi，通过其marker属性可得到当前的标注。 html: HTMLElement，气泡内的DOM元素
onResultsHtmlSet Function 结果列表添加完成后的回调函数。 参数： container: 结果列表所用的HTML元素
WalkingRouteResult
此类表示路线导航的结果，没有构造函数，通过访问WalkingRoute.getResults()方法或WalkingRoute的onSearchComplete回调函数参数获得。
属性 类型 描述
city String 本次检索所在的城市
方法 返回值 描述
getStart() LocalResultPoi 返回起点
getEnd() LocalResultPoi 返回终点
getNumPlans() Number 返回方案个数
getPlan(i: Number) RoutePlan 返回索引指定的方案。索引0表示第一条方案

DrivingRoute
此类用于获取驾车路线规划方案。
构造函数 描述
DrivingRoute(location:Map| Point| String, opts:DrivingRouteOptions) 创建一个驾车导航实例，其中location表示检索区域，类型可为地图实例、坐标点或城市名称的字符串。当参数为地图实例时，检索位置由地图当前的中心点确定；当参数为坐标时，检索位置由该点所在位置确定；当参数为城市名称时，检索会在该城市内进行
方法 返回值 描述
search(start: String | Point|LocalResultPoi, end: String | Point|LocalResultPoi, options: object) none 发起检索。 start: 起点，参数可以是关键字、坐标点（自1.1版本支持）和LocalSearchPoi实例。 end: 终点，参数可以是关键字、坐标点（自1.1版本支持）或LocalSearchPoi实例。 option:{startCity:String,endCity:string,waypoints:array } startCity表示是驾车查询的起点城市，可以是城市名或者城市编码，endCity表示驾车查询的终点城市，可以是城市名或者城市编码,waypoints途经点集合，最多支持10个途经点，可以是名称也可以是坐标
getResults() DrivingRouteResult 返回最近一次检索的结果
clearResults() none 清除最近一次检索的结果
enableAutoViewport() none 启用自动调整地图层级，当指定了搜索结果所展现的地图时有效
disableAutoViewport() none 禁用自动调整地图层级
setLocation(location: Map| Point| String) none 设置检索范围，参数类型可以为地图实例、坐标点或字符串。例：setLocation("北京市")
setPolicy(policy: DrivingPolicy) none 设置路线规划策略，参数为策略常量
setSearchCompleteCallback(callback: Function) none 设置检索结束后的回调函数。 参数： results: DrivingRouteResult
setMarkersSetCallback(callback: Function) none 设置添加标注后的回调函数。 参数： pois: Array，起点和目的地点数组，通过marker属性可得到其对应的标注
setInfoHtmlSetCallback(callback: Function) none 设置气泡打开后的回调函数。 参数： poi: LocalResultPoi，通过marker属性可得到当前的标注。html: HTMLElement，气泡内的DOM元素
setPolylinesSetCallback(callback: Function) none 设置添加路线后的回调函数。 参数： routes: Array ，驾车线路数组，通过Route.getPolyline()方法可得到对应的折线覆盖物
setResultsHtmlSetCallback(callback: Function) none 设置结果列表创建后的回调函数。 参数： container: 结果列表所用的HTML元素
getStatus() StatusCodes 返回状态码
toString() String 返回类型说明
DrivingRouteOptions
此类表示DrivingRoute构造函数的可选参数。
属性 类型 描述
renderOptions RenderOptions 结果呈现设置
policy DrivingPolicy 驾车策略
onSearchComplete Function 检索完成后的回调函数。参数： results: DrivingRouteResult
onMarkersSet Function 标注添加完成后的回调函数。 参数： pois: Array ，起点和目的地点数组，通过marker属性可得到其对应的标注
onInfoHtmlSet Function 标注气泡内容创建后的回调函数。 参数： poi: LocalResultPoi，通过marker属性可得到当前的标注。html: HTMLElement，气泡内的DOM元素
onPolylinesSet Function 折线添加完成后的回调函数。 参数： routes: Array ，驾车线路数组，通过Route.getPolyline()方法可得到对应的折线覆盖物
onResultsHtmlSet Function 结果列表添加完成后的回调函数。 参数： container: 结果列表所用的HTML元素
DrivingRouteResult
此类表示路线导航的结果，没有构造函数，通过DrivingRoute.getResults()方法或DrivingRoute的onSearchComplete回调函数参数获得。
属性 类型 描述
policy DrivingPolicy 驾车导航策略
city String 本次检索所在的城市
moreResultsUrl String 更多结果的链接，到百度地图进行搜索
taxiFare TaxiFare 出租车费用信息。注意，此属性在部分城市有效，无效时为null
方法 返回值 描述
getStart() LocalResultPoi 返回起点
getEnd() LocalResultPoi 返回终点
getNumPlans() Number 返回方案个数
getPlan(i: Number) RoutePlan 返回索引指定的方案。索引0表示第一条方案
DrivingPolicy
此枚举类型表示驾车方案的策略配置。
常量 描述
BMAP_DRIVING_POLICY_LEAST_TIME 最少时间
BMAP_DRIVING_POLICY_LEAST_DISTANCE 最短距离
BMAP_DRIVING_POLICY_AVOID_HIGHWAYS 避开高速

TaxiFare
此类表示出租车费用信息，没有构造函数，通过对象字面量形式表示。
属性 类型 描述
day TaxiFareDetail 白天费用
night TaxiFareDetail 夜间费用。注意，部分城市没有夜间费用，此时此属性为null，且同时白天费用表示全天费用
distance Number 出租车里程，单位为米
remark String 出租车备注信息
TaxiFareDetail
此类表示出租车具体费用信息，没有构造函数，通过对象字面量形式表示。
属性 类型 描述
initialFare Number 出租车起步价
unitFare Number 出租车单价
totalFare Number 出租车费用总价
RoutePlan
此类表示一条驾车或步行出行方案。它没有构造函数，可通过DrivingRouteResult.getPlan()方法或WalkingRouteResult类的getPlan()方法获得。
方法 返回值 描述
getNumRoutes() Number 返回方案包含的线路的个数
getRoute(i: Number) Route 返回方案中索引指定的线路。索引0表示第一条线路
getDistance(format: Boolean) String | Number 返回方案总距离。当format参数为true时，返回方案距离字符串（包含单位），当format为false时，仅返回数值（单位为米）信息。默认参数为true
getDuration(format: Boolean) String | Number 返回方案总时间。当format参数为true时，返回描述时间的字符串（包含单位），当format为false时，仅返回数值（单位为秒）信息。默认参数为true
getDragPois() Array<LocalResultPoi> 获取通过拖拽方式产生的途径点。注意，这里的LocalResultPoi只有title和point属性
Route
此类表示一条驾车或步行路线。
方法 返回值 描述
getNumSteps() Number 返回路线包含的关键点个数
getStep(i: Number) Step 返回索引指定的关键点，驾车和步行适用。索引0表示第一个关键点
getDistance(format: Boolean) String | Number 返回路线距离，当format为false时仅返回数值
getIndex() Number 返回本路线在方案中的索引位置
getPolyline() Polyline 返回路线对应的覆盖物，仅当结果自动添加到地图上时有效
getPath() Array< Point> 返回路线的地理坐标点数组
getRouteType() RouteTypes 返回路线类型，可区分是驾车还是步行线路
RouteType
常量表示不同的线路类型。
常量 描述
BMAP_ROUTE_TYPE_DRIVING 驾车线路
BMAP_ROUTE_TYPE_WALKING 步行线路
Step
此类表示驾车或步行路线中的一个关键点。它没有构造函数，通过Route.getStep()方法获得。
方法 返回值 描述
getPosition() Point 返回关键点地理坐标
getIndex() Number 返回本关键点在路线中的位置索引
getDescription(includeHtml: Boolean) String 返回关键点描述文本，默认包含HTML标签。当includeHtml为false时，描述文本不包含HTML标签
getDistance(format: Boolean) String | Number 返回到下一个关键点的距离，当format为false时仅返回数值（单位为米）

HighlightModes
此常量用于描述对象当前状态。
常量 描述
BMAP_HIGHLIGHT_STEP 驾车结果展现中点击列表后的展现点步骤
BMAP_HIGHLIGHT_ROUTE 驾车结果展现中点击列表后的展现路段
Geocoder
类用于获取用户的地址解析。
构造函数 描述
Geocoder() 创建一个地址解析器的实例
方法 返回值 描述
getPoint(address: String, callback: Function, city: String) none 对指定的地址进行解析。如果地址定位成功，则以地址所在的坐标点Point为参数调用回调函数。否则，回调函数的参数为null。city为地址所在的城市名，例如“北京市”
getLocation(point: Point, callback: Function, options:LocationOptions) none 对指定的坐标点进行反地址解析。如果解析成功，则回调函数的参数为GeocoderResult对象，否则回调函数的参数为null
GeocoderResult
此类表示Geocoder的地址解析结果。它在地址解析的回调函数的参数中返回，不可实例化。
属性 类型 描述
point Point 坐标点
address String 地址描述
addressComponents AddressComponent 结构化的地址描述
surroundingPois Array< LocalResultPoi> 附近的POI点
business String 商圈字段，代表此点所属的商圈
AddressComponent
此类表示地址解析结果的层次化地址信息，没有构造函数，通过对象字面量形式表示。
属性 类型 描述
streetNumber String 门牌号码
street String 街道名称
district String 区县名称
city String 城市名称
province String 省份名称
LocationOptions
此类表示Geocoder的地址解析请求的可选参数。它不可实例化。
属性 类型 描述
poiRadius Number 附近POI所处于的最大半径，默认为100米
numPois Number 返回的POI点个数，默认为10个。取值范围
LocalCity
此类用于获取用户所在的城市位置信息。(根据用户IP自动定位到城市)
构造函数 描述
LocalCity(opts: LocalCityOptions) 创建一个获取本地城市位置的实例
方法 返回值 描述
get(callback: Function) none 当获取城市信息后，回调函数会被调用，其参数为类型为LocalCityResult对象
LocalCityOptions
此类表示LocalCity的可选参数。它没有构造函数，但可通过对象字面量表示。
属性 类型 描述
renderOptions RenderOptions 结果呈现设置，当给定map参数时，改地图将自动将视野定位到当前城市
LocalCityResult
此类表示LocalCity的定位结果。
属性 类型 描述
center Point 城市所在中心点
level Number 展示当前城市的最佳地图级别，如果您在使用此对象时提供了map实例，则地图级别将根据您提供的地图大小进行调整
name String 城市名称

Geolocation
返回用户当前的位置。此方法利用浏览器的geolocation接口获取用户当前位置，不支持的浏览器将无法获取。
构造函数 描述
Geolocation() 创建Geolocation对象实例
方法 返回值 描述
getCurrentPosition(callback: function, options: PositionOptions) none 返回用户当前位置。当定位成功时，回调函数的参数为GeolocationResult对象，否则为null
getStatus() StatusCode 返回状态码，当定位成功后，状态码为：BMAP_STATUS_SUCCESS，如果为其他状态码表示不能获取您当前的位置
GeolocationResult
此类作为Geolocation的getCurrentPosition方法的回调函数参数，不可实例化。
属性 类型 描述
point Point 坐标点
accuracy Number 定位精确程度，单位为米
PositionOptions
此类作为getCurrentPosition的可选参数，不能实例化。
属性 类型 描述
enableHighAccuracy Boolean 要求浏览器获取最佳结果
timeout Number 超时时间
maximumAge Number 允许返回指定时间内的缓存结果。如果此值为0，则浏览器将立即获取新定位结果

BusLineSearch
公交路线搜索类。
构造函数 描述
BusLineSearch(location:Map| Point| String, options:BusLineSearchOptions) 创建公交线搜索类。其中location表示检索区域，其类型可为地图实例、坐标点或城市名称的字符串。当参数为地图实例时，检索位置由当前地图中心点确定；当参数为坐标时，检索位置由该点所在位置确定；当参数为城市名称时，检索会在该城市内进行
方法 返回值 描述
getBusList(keyword: String) none 在用户配置的回调函数中返回公交列表结果，其类型为BusListResult
getBusLine(busLstItem: BusListItem) none 在用户配置的回调函数中返回该条线路的公交信息，其类型为BusLine类型
clearResults() none 清除本次公交线检索结果
enableAutoViewport() none 启用自动调整地图视野功能
disableAutoViewport() none 禁用自动调整地图视野功能
setLocation(location: Map| Point| String) none 设置检索范围，参数类型可以为地图实例、坐标点或字符串。例：setLocation("北京市")
getStatus() StatusCodes 返回状态码
toString() String 返回类型说明
setGetBusListCompleteCallback(callback: Function) none 设置公交列表查询后的回调函数。参数：rs: BusListResult类型
setGetBusLineCompleteCallback(callback: Function) none 设置公交线路查询后的回调函数。参数：rs: BusLine类型
setBusListHtmlSetCallback(callback: Function) none 公交列表结果页渲染后回调函数。参数：container: HTMLElement，结果列表所用的HTML元素
(callback: Function) none 公交线路结果页渲染后回调函数。参数：container: HTMLElement，结果列表所用的HTML元素
(callback: Function) none 添加公交线时候回调函数。参数：ply:Polyline 公交线路几何对象
(callback: Function) none 添加公交站点时候回调函数。参数：sts:Array 公交站坐标组成的Marker对象数组
BusLineSearchOptions
此类表示BusLineSearch类的可选参数，没有构造参数，可以通过对象字面量表示
属性 类型 描述
renderOptions RenderOptions RenderOptions结果呈现设置
onGetBusListComplete Function 设置公交列表查询后的回调函数.参数：rs: BusListResult类型
onGetBusLineComplete Function 设置公交线路查询后的回调函数.参数：rs: BusLine类型
onBusListHtmlSet Function 公交列表结果页渲染后回调函数.参数：container: HTMLElement，结果列表所用的HTML元素
onBusLineHtmlSet Function 公交线路结果页渲染后回调函数.参数：container: HTMLElement，结果列表所用的HTML元素
onPolylinesSet Function 添加公交线时候回调函数.参数：ply:Polyline 公交线路几何对象
onMarkersSet Function 添加公交站点时候回调函数.参数：sts:Array 公交站坐标组成的Marker对象数组
BusListResult
公交列表查询成功回调函数的参数对象
属性 类型 描述
keyword String 本次检索关键字
city String 本次检索所在城市
moreResultsUrl String 到百度地图查看url
方法 返回值 描述
getNumBusList() Number 公交列表个数
getBusListItem(i: Number) BusListItem 获取某一个具体的公交列表中的对象。0表示上行，1表示下行

BusLine
表示公交线路结果的公交线，没有构造函数，通过检索回调函数获得。
属性 类型 描述
name String 线路名称
startTime String 首班车时间
endTime String 末班车时间
company String 公交线路所属公司
方法 返回值 描述
getNumBusStations() Number 获取公交站点个数
getBusStation(i: Number) BusStation 获取某一个具体的公交站对象
getPath() Array< Point> 返回公交线地理坐标点数组
getPolyline() Polyline 获取公交线几何对象, 仅当结果自动添加到地图上时有效
Line
此类表示一条公交线路。没有构造函数，通过TransitRoutePlan.getLine()方法得到。
属性 类型 描述
title String 公交线路全称
type LineType 公交线路类型
方法 返回值 描述
getNumViaStops() Number 返回公交线路途径的车站个数
getGetOnStop() LocalResultPoi 返回上车站
getGetOffStop() LocalResultPoi 返回下车站
getPath() Array< Point> 返回线路对应的地理坐标点数组，在公交方案中，地理坐标只给出方案涉及的部分
getPolyline() Polyline 返回公交线路对应的折线覆盖物
getDistance(format: Boolean) String | Number 当format为true时，返回本段公交线路的距离字符串（包含单位），当format为false时仅返回数值（单位为米）。默认参数为true
BusListItem
一个具体公交对象
属性 类型 描述
name String 公交线名称
BusStation公交站点对象
属性 类型 描述
name String 站点名称
position Point 站点坐标
Autocomplete
Autocomplete是结果提示、自动完成类。
构造函数 描述
Autocomplete(options: AutocompleteOptions) 创建自动完成的实例
方法 返回值 描述
show() none 显示提示列表
hide() none 隐藏提示列表
setTypes(types: type<Array>) none 修改请求数据类型。types定义方法详见AutocompleteOptions
setLocation(location: String | Map|Point) none 设置检索区域
search(keywords: string) none 发起某个关键字的提示请求，会引起onSearchComplete的回调
getResults() AutocompleteResult 获取结果列表
setInputValue(keyword: string) none 设置绑定的input控件的值，且不会出现下拉列表
dispose() none 销毁自动完成对象
事件 参数 描述
onconfirm {type,target,item} 回车选中某条记录后触发 item : { index : 1 /*高亮的记录，所属返回结果的index*/ ,value : {}/*结果数据，见AutocompleteResultPoi*/ }
onhighlight {type,target,fromitem,toitem} 键盘或者鼠标移动，某条记录高亮之后，触发 fromitem: { /*上一条记录的信息*/ index : 2 /*高亮的记录，所属返回结果的index*/ ,value : {}/*结果数据，见AutocompleteResultPoi*/ }, toitem : {/*当前记录的信息，与fromitem结构一致*/}
AutocompleteOptions
本类是Autocomplete类的可选参数对象
属性 类型 描述
location String | Map|Point 设定返回结果的所属范围。例如“北京市”
types Array<String> 返回数据类型。两种设置方式，第一种为默认值（即设置值为空），将返回所有数据。如地图初始化为北京，在输入框中输入“小”，输入框下会出现包含“小”关键字的多种类型（如餐饮、地名等）的提示词条。第二种设置值为"city"，将返回省市区县乡镇街道地址类型数据。如地图初始化为北京，在输入框中输入“小”，输入框下会出现“小金县”的地点名称类的提示词条
onSearchComplete Function 在input框中输入字符后，发起列表检索，完成后的回调函数。 参数：AutocompleteResult
input String | HTMLElement 文本输入框元素或其id
AutocompleteResultPoi
自动完成类获取的单个POI点的信息
属性 类型 描述
province String 省名
City String 城市名
district String 区县名称
street String 街道名称
streetNumber String 门牌号码
business String 商户名
AutocompleteResult
自动完成检索完成回调函数的参数对象
属性 类型 描述
keyword String 检索关键字
方法 返回值 描述
getPoi(i: Number) AutocompleteResultPoi 结果数组
getNumPois() Number 结果总数
Boundary
此类表示一个行政区域的边界。
构造函数 描述
Boundary() 创建行政区域搜索的对象实例
方法 返回值 描述
get(name: String, callback: function) null 返回行政区域的边界。 name: 查询省、直辖市、地级市、或县的名称。 callback:执行查询后，数据返回到客户端的回调函数，数据以回调函数的参数形式返回。返回结果是一个数组，数据格式如下： arr[0] = "x1, y1; x2, y2; x3, y3; ..." arr[1] = "x1, y1; x2, y2; x3, y3; ..." arr[2] = "x1, y1; x2, y2; ..." … 否则回调函数的参数为null

Convertor
用于将其他坐标系的坐标转换为百度坐标。
构造函数 描述
Convertor() 创建一个坐标转换的实例
方法 返回值 描述
translate(points: Array<BMap.Point>, from: number, to: number, callback: function) none 对指定的点数组进行坐标转换，转换规则为从from到to，转换完成后调用callback，callback的参数为Object 。一次最多10个点，from和to的含义请参照Web服务API
TranslateResults
此类是Convertor.translate()中回调函数的参数。
属性 类型 描述
status number 转换结果状态吗，参考Web服务API
points Array<BMap.Point> 转换完成的点数组，点顺序和转换前一致
StatusCode
此常量用于描述对象当前状态。
常量 描述
BMAP_STATUS_SUCCESS 检索成功。对应数值“0”
BMAP_STATUS_CITY_LIST 城市列表。对应数值“1”
BMAP_STATUS_UNKNOWN_LOCATION 位置结果未知。对应数值“2”
BMAP_STATUS_UNKNOWN_ROUTE 导航结果未知。对应数值“3”
BMAP_STATUS_INVALID_KEY 非法密钥。对应数值“4”
BMAP_STATUS_INVALID_REQUEST 非法请求。对应数值“5”
BMAP_STATUS_PERMISSION_DENIED 没有权限。对应数值“6”
BMAP_STATUS_SERVICE_UNAVAILABLE 服务不可用。对应数值“7”
BMAP_STATUS_TIMEOUT 超时。对应数值“8”

全景类
Panorama
此类用来展示某位置的全景视图，可以单独放置在一个div容器中，也可以放在Map类的容器中。
构造函数 描述
Panorama(container: String | HTMLElement, opts: PanoramaOptions) 在给定的结点中创建全景
方法 返回值 描述
getLinks() Array<PanoramaLink> 获取全景中道路指示信息
getId() String 获取当前全景的id
getPosition() Point 获取当前全景的位置，通过经纬度描述
getPov() PanoramaPov 获取当前全景的视角
getZoom() Number 获取当前全景的级别
setId(id: String) none 设置全景的id
setPosition(position:Point) none 设置全景的位置
setPov(pov:PanoramaPov) none 设置全景的视角
setZoom(zoom: Number) none 设置全景的级别
enableScrollWheelZoom() none 开启鼠标滚轮缩放功能。仅对PC上有效
disableScrollWheelZoom() none 关闭鼠标滚轮缩放功能
show() none 显示全景
hide() none 隐藏全景
addOverlay(overlay:PanoramaLabel) none 全景场景内添加覆盖物
removeOverlay(overlay:PanoramaLabel) none 删除全景内的覆盖物
getSceneType() Enum PanoramaSceneType 获取全景的类型（室外景返回BMAP_PANORAMA_STREET_SCENE、室内景返回BMAP_PANORAMA_INDOOR_SCENE）
setOptions(opts:PanoramaOptions) none 设置全景可配置参数
setPanoramaPOIType() Enum PanoramaPOIType 设置全景外景场景点内可见的POI类型，默认为隐藏所有类型poi
事件 参数 描述
position_changed none 全景位置发生变化时触发
links_changed none 全景相邻道路发生变化时触发，通常是在位置变化时，异步获取新数据之后触发
pov_changed none 全景视角发生变化时触发
zoom_changed none 全景级别发生变化时触发
scene_type_changed none 全景场景点类型改变（室内景、室外景）时触发
PanoramaOptions
此类为Panorama类构造函数的可选参数，使用对象字面量形式表示，不可实例化。
属性 类型 描述
navigationControl boolean 是否显示全景的导航控件，默认为true
linksControl boolean 是否显示道路指示控件。默认为true
indoorSceneSwitchControl boolean 是否显示全景室内场景的切换控件，默认为false，仅对室内景生效
albumsControl boolean 是否显示相册控件，默认为false
albumsControlOptions AlbumsControlOptions 全景相册控件配置参数
PanoramaLink
此类用来描述全景中道路指示中相邻全景的信息。使用对象字面量形式表示，不可实例化。
属性 类型 描述
description String 相连全景的描述信息
heading Number 相连道路的方向，正北方向为0，正东为90，正南为180，正西为270
id String 相邻全景的id
PanoramaPov
此类描述全景的视角。使用对象字面量形式表示，不可实例化。
属性 类型 描述
heading Number 水平方向的角度，正北方向为0，正东为90，正南为180，正西为270
pitch Number 竖直方向的角度，向上最大到90度，向下最大到-90度。（在某些场景下，俯角可能无法到达最大值）
PanoramaService
此类用来检索全景数据信息。
构造函数 描述
PanoramaService() 在创建检索全景数据信息类的实例
方法 返回值 描述
getPanoramaById(id: String, callback: function, data: PanoramaData) none 根据全景id返回全景数据，当获取不到数据时，回调函数参数为null
getPanoramaByLocation(point: Point, radius: number, callback: function, data:PanoramaData) none 根据坐标及半径返回该范围内的全景数据；不设置半径参数时，默认半径为50米；当获取不到数据时，回调函数参数为null
PanoramaData
通过PanoramaService类检索获得。使用对象字面量形式表示，不可实例化。
属性 类型 描述
id String 全景id
description String 全景的描述信息
links Array< PanoramaLink> 全景相邻道路信息
position Point 全景的地理坐标
tiles PanoramaTileData 全景图块信息
PanoramaTileData
此类是图块数据信息，不可实例化。
属性 类型 描述
centerHeading Number 整个全景图中心位置的方位（单位角度）
tileSize Size 图块展示的尺寸（单位像素），注意这个尺寸与实际的图片尺寸可能不同
worldSize Size 整个全景图的尺寸（单位像素）
PanoramaLabel
该类提供在全景中添加标签功能。
构造函数 描述
PanoramaLabel(content: String, opts:PanoramaLabelOptions) 构造函数，在全景中创建一个标签,content参数表示标签的文本内容，opts参数包含标签的经纬度坐标和高度
方法 返回值 描述
setPosition(position: Point) none 设置标签的经纬度坐标
getPosition() Point 获取标签的经纬度坐标
getPov() PanoramaPov 获取标签与全景中心点的视角
setContent(content: String) none 设置标签显示内容
getContent() String 获取标签的显示内容
show() none 设置标签可见
hide() none 设置标签不可见
setAltitude(altitude: Number) none 设置标签距离地面的高度
getAltitude() Number 获取标签距离地面的高度
addEventListener() none 注册事件
removeEventListener() none 移除事件
事件 参数 描述
click type,target 单击标签时触发该事件
mouseover type,target 鼠标移入标签时触发该事件
mouseout type,target 鼠标移出标签时触发该事件
remove type,target 删除标签时触发该事件

PanoramaLabelOptions
此类为PanoramaLabel类构造函数的可选参数，使用对象字面量形式表示，不可实例化。
属性 类型 描述
position Point 文本标注的地理位置
altitude Number 文本标注在全景场景点中距地面的高度。（javascript全景实现方式暂不支持），默认为2米
AlbumsControlOptions
此类为全景相册控件的可选参数，使用对象字面量形式表示，不可实例化。
属性 类型 描述
anchor ControlAnchor 相册控件的停靠位置
offset Size 相册的偏移量
maxWidth Number | String 相册控件的最大宽度，可以设置总宽度百分比(例如50%) 或者像素数字（500）,默认值为100%
imageHeight Number 相册内图片的高度。默认为80px。（为保证图片比例，只设置高度，宽度自如会拉宽）
PanoramaSceneType
常量区分室内场景和室外场景，其中室内景包括酒店内部、景区内部及高校内部等。
常量 描述
BMAP_PANORAMA_INDOOR_SCENE 全景场景点的类型为室内场景
BMAP_PANORAMA_STREET_SCENE 全景场景点的类型为室外场景
PanoramaPOIType
常量表示要在全景内显示的poi类型。
常量 描述
BMAP_PANORAMA_POI_HOTEL 酒店类
BMAP_PANORAMA_POI_CATERING 餐饮类
BMAP_PANORAMA_POI_MOVIE 电影院
BMAP_PANORAMA_POI_TRANSIT 公交站点
BMAP_PANORAMA_POI_INDOOR_SCENE 室内景
BMAP_PANORAMA_POI_NONE 无，即隐藏所有的poi类型

示例DEMO
一、地图示例
1、地图展示
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html,#allmap {width: 100%;height: 100%;overflow: hidden;margin:0;font-family:"微软雅黑";}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<title>地图展示</title>
</head>
<body>
<div id="allmap"></div>
</body>
</html>
<script type="text/javascript">
// 百度地图API功能
var map = new BMap.Map("allmap"); // 创建Map实例
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11); // 初始化地图,设置中心点坐标和地图级别
map.addControl(new BMap.MapTypeControl()); //添加地图类型控件
map.setCurrentCity("北京"); // 设置地图显示的城市 此项是必须设置的
map.enableScrollWheelZoom(true); //开启鼠标滚轮缩放
</script>
2、异步加载地图
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html,#allmap {width: 100%;height: 100%;overflow: hidden;margin:0;font-family:"微软雅黑";}
</style>
<title>异步加载地图</title>
</head>
<body>
<div id="allmap"></div>
</body>
</html>
<script type="text/javascript">
//百度地图API功能
function loadJScript() {
var script = document.createElement("script");
script.type = "text/javascript";
script.src = "http://api.map.baidu.com/api?v=2.0&ak=您的密钥&callback=init";
document.body.appendChild(script);
}
function init() {
var map = new BMap.Map("allmap"); // 创建Map实例
var point = new BMap.Point(116.404, 39.915); // 创建点坐标
map.centerAndZoom(point,15);
map.enableScrollWheelZoom(); //启用滚轮放大缩小
}
window.onload = loadJScript; //异步加载地图
</script>
同步加载、异步加载、延迟加载、预加载
（1）、同步加载
平常默认用的都是同步加载。
同步模式又称阻塞模式，会阻止浏览器的后续处理，停止了后续的文件的解析，执行，如图像的渲染。流览器之所以会采用同步模式，是因为加载的js文件中有对dom的操作，重定向，输出document等默认行为，所以同步才是最安全的。通常会把要加载的js放到body结束标签之前，使得js可在页面最后加载，尽量减少阻塞页面的渲染。
（2）、异步加载
异步加载也叫非阻塞模式加载，浏览器在下载js的同时，同时还会执行后续的页面处理。
在script标签内，用js创建一个script元素并插入到document中，这种就是异步加载js文件了。
同步加载流程是瀑布模型，异步加载流程是并发模型。
同步：发送http请求→获取返回结果→分析结果→跳转下一页
异步：发送http请求→跳转下一页（不需要等待请求结果，对结果的处理在另一个线程中）
（3）、延迟加载（lazy loading）
前面解决了异步加载（async loading）问题，再谈谈什么是延迟加载。
延迟加载：有些 js 代码并不是页面初始化的时候就立刻需要的，而稍后的某些情况才需要的。延迟加载就是一开始并不加载这些暂时不用的js，而是在需要的时候或稍后再通过js 的控制来异步加载。
也就是将 js 切分成许多模块，页面初始化时只加载需要立即执行的 js ，然后其它 js 的加载延迟到第一次需要用到的时候再加载。
特别是页面有大量不同的模块组成，很多可能暂时不用或根本就没用到。
就像图片的延迟加载，在图片出现在可视区域内时（在滚动条下拉）才加载显示图片。
（4）、预加载
预加载是一种浏览器机制，使用浏览器空闲时间来预先下载/加载用户接下来很可能会浏览的页面/资源，当用户访问某个预加载的链接时，如果从缓存命中,页面就得以快速呈现。

3、同时加载两个地图
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html {width: 100%;height: 100%;overflow: hidden;margin:0;font-family:"微软雅黑";}
#map1_container,#map2_container {width:100%;height:50%;float:left;overflow: hidden;margin:0;}
#allmap1{margin:0 0 3px;height:100%;}
#allmap2{margin:3px 0 0;height:100%;}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<title>同时加载两个地图</title>
</head>
<body>
<div id="map1_container"><div id="allmap1"></div></div>
<div id="map2_container"><div id="allmap2"></div></div>
</body>
</html>
<script type="text/javascript">
//百度地图API功能
//加载第一张地图
var map1 = new BMap.Map("allmap1"); // 创建Map实例
var point1 = new BMap.Point(116.404, 39.915);
map1.centerAndZoom(point1,15);
map1.enableScrollWheelZoom(); //启用滚轮放大缩小
//加载第二张地图
var map2 = new BMap.Map("allmap2"); // 创建Map实例
var point2 = new BMap.Point(116.404, 39.915);
map2.centerAndZoom(point2,15);
map2.enableScrollWheelZoom(); //启用滚轮放大缩小
</script>
4、根据城市名设置地图中心点
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html,#allmap {width: 100%;height: 100%;overflow: hidden;margin:0;font-family:"微软雅黑";}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<title>根据城市名设置地图中心点</title>
</head>
<body>
<div id="allmap"></div>
</body>
</html>
<script type="text/javascript">
// 百度地图API功能
var map = new BMap.Map("allmap"); // 创建Map实例
map.centerAndZoom("上海",15); // 初始化地图,用城市名设置地图中心点
</script>
5、设置地图最大、最小级别
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html,#allmap {width: 100%;height: 100%;overflow: hidden;margin:0;font-family:"微软雅黑";}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<title>设置地图最大、最小级别</title>
</head>
<body>
<div id="allmap"></div>
</body>
</html>
<script type="text/javascript">
// 百度地图API功能
var map = new BMap.Map("allmap",{minZoom:4,maxZoom:8}); // 创建Map实例,设置地图允许的最小/大级别
map.centerAndZoom(new BMap.Point(116.4035,39.915),8);
map.enableScrollWheelZoom(true);
</script>

6、移动地图
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html {width: 100%;height: 100%;margin:0;font-family:"微软雅黑";}
#allmap{width:100%;height:500px;}
p{margin-left:5px; font-size:14px;}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<title>移动地图</title>
</head>
<body>
<div id="allmap"></div>
<p>初始化地图，中心点为（116.4035,39.915），缩放级别为8的北京市地图，2秒后，通过改变中心点坐标，地图平移到广州</p>
</body>
</html>
<script type="text/javascript">
// 百度地图API功能
var map = new BMap.Map("allmap");
map.centerAndZoom(new BMap.Point(116.4035,39.915),8);
setTimeout(function(){
map.panTo(new BMap.Point(113.262232,23.154345)); //两秒后移动到广州
}, 2000);
</script>
7、缩放地图
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html {width: 100%;height: 100%;margin:0;font-family:"微软雅黑";}
#allmap{width:100%;height:500px;}
p{margin-left:5px; font-size:14px;}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<title>缩放地图</title>
</head>
<body>
<div id="allmap"></div>
<p>初始化展示中心点为（116.4035,39.915），缩放级别为8的北京市地图，2秒后，通过设置缩放级别将地图放大到14级</p>
</body>
</html>
<script type="text/javascript">
// 百度地图API功能
var map = new BMap.Map("allmap");
map.centerAndZoom(new BMap.Point(116.4035,39.915),8);
setTimeout(function(){
map.setZoom(14);
}, 2000); //2秒后放大到14级
map.enableScrollWheelZoom(true);
</script>
8、拖拽地图
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html,#allmap {width: 100%;height: 100%;overflow: hidden;margin:0;font-family:"微软雅黑";}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<title>拖拽地图</title>
</head>
<body>
<div id="allmap"></div>
</body>
</html>
<script type="text/javascript">
// 百度地图API功能
var map = new BMap.Map("allmap"); // 创建Map实例
map.centerAndZoom(new BMap.Point(116.4035,39.915),8); //初始化时，即可设置中心点和地图缩放级别。
map.enableScrollWheelZoom(true);
map.disableDragging(); //禁止拖拽
setTimeout(function(){
map.enableDragging(); //两秒后开启拖拽
//map.enableInertialDragging(); //两秒后开启惯性拖拽
}, 2000);
</script>
9、设置地图显示范围
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html {width: 100%;height: 100%;margin:0;font-family:"微软雅黑";}
#allmap{width:100%;height:500px;}
p{margin-left:5px; font-size:14px;}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<script type="text/javascript" src="http://api.map.baidu.com/library/AreaRestriction/1.2/src/AreaRestriction_min.js"></script>
<title>设置地图显示范围</title>
</head>
<body>
<div id="allmap"></div>
<p>将地图显示范围设定在指定区域，地图拖出该区域后会重新弹回。</p>
</body>
</html>
<script type="text/javascript">
//百度地图API功能
var map = new BMap.Map("allmap");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 13);
map.enableScrollWheelZoom();
var b = new BMap.Bounds(new BMap.Point(116.027143, 39.772348),new BMap.Point(116.832025, 40.126349));
try {
BMapLib.AreaRestriction.setBounds(map, b);
} catch (e) {
alert(e);
}
</script>

10、获取地图显示范围
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html,#allmap {width: 100%;height: 100%;overflow: hidden;margin:0;font-family:"微软雅黑";}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<title>获取地图显示范围</title>
</head>
<body>
<div id="allmap"></div>
</body>
</html>
<script type="text/javascript">
// 百度地图API功能
var map = new BMap.Map("allmap");
map.centerAndZoom(new BMap.Point(116.4035,39.915), 14);
var bs = map.getBounds(); //获取可视区域
var bssw = bs.getSouthWest(); //可视区域左下角
var bsne = bs.getNorthEast(); //可视区域右上角
alert("当前地图可视范围是：" + bssw.lng + "," + bssw.lat + "到" + bsne.lng + "," + bsne.lat);
</script>
11、获取两点间距离
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html,#allmap {width: 100%;height: 100%;overflow: hidden;margin:0;font-family:"微软雅黑";}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<title>测距</title>
</head>
<body>
<div id="allmap"></div>
</body>
</html>
<script type="text/javascript">
// 百度地图API功能
var map = new BMap.Map("allmap");
map.centerAndZoom("重庆",12); //初始化地图,设置城市和地图级别。
var pointA = new BMap.Point(106.486654,29.490295); // 创建点坐标A--大渡口区
var pointB = new BMap.Point(106.581515,29.615467); // 创建点坐标B--江北区
alert('从大渡口区到江北区的距离是：'+(map.getDistance(pointA,pointB)).toFixed(2)+' 米。'); //获取两点距离,保留小数点后两位
var polyline = new BMap.Polyline([pointA,pointB], {strokeColor:"blue", strokeWeight:6, strokeOpacity:0.5}); //定义折线
map.addOverlay(polyline); //添加折线到地图上
</script>
12、关闭默认地图POI事件
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html,#allmap {width: 100%;height: 100%;overflow: hidden;margin:0;font-family:"微软雅黑";}
</style>
<script type="text/javascript" src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<title>关闭默认地图POI事件</title>//POI意思是Point Of Infomation，地图点信息
</head>
<body>
<div id="allmap"></div>
</body>
</html>
<script type="text/javascript">
// 百度地图API功能
var map = new BMap.Map("allmap", {enableMapClick:false});//构造底图时，关闭底图可点功能
var point = new BMap.Point(116.404, 39.915); // 创建点坐标
map.centerAndZoom(point,12); // 初始化地图,设置中心点坐标和地图级别。
map.enableScrollWheelZoom(); //启用滚轮放大缩小
</script>