地图接口
 
  搜索接口
 
  标注接口
 
  IP定位接口
 
  实时路况接口
 
  逆地理编码接口
 
  公交接口
 
  导航接口
   
  LTBus  LTBusLine  LTBusLinesResult  LTBusRoute  LTBusRouteLine  LTBusRoutesResult  LTBusStation  LTBusStationsResult 
类 LTBus
51ditu Bus API之中的搜索类,这也是Bus API的最主要的类,用来进行公交搜索操作,需要注意的是,因为搜索过程采用的是异步操作,因此运行搜索之后并不能立即得到搜索结果,而是传递一个[搜索结果处理函数]给搜索类,在搜索结果得到后,搜索类会自动的运行该[搜索结果处理函数]并将搜索结果作为参数传递,这样用户就可以得到并处理搜索结果。
构建函数
函数名称 最后更新版本 返回值类型 说明
LTBus() LTBus 创建一个公交搜索类,一个页面上可以根据需求创建多个公交搜索类
方法
函数名称 最后更新版本 返回值类型 说明
setCity(city) 设置公交搜索城市,如果不先指定搜索的城市,将不会开始搜索,用城市名称的中文,例如"北京"
setPageCap(pagecap) 公交查询的最大返回集数默认值是:10,通过这个方法可以修改最大返回集个数,参数必须是整数,否则设置无效。
setFlag(flag) 在get公交查询的名称/坐标模式设置,此方法只接受0|1,默认是0,可以是字符串也可以是数字
0:名称模式
1:坐标模式
setQueryType(queryType) 公交查询的精确/模糊模式设置,此方法只接受0|1|2,默认值是2,可以是字符串格式也可以是数字格式
0:精确模式
1:模糊模式
2:先精确后模糊
setRadius(radius) 公交查询的查询范围,默认范围是:500,最大范围是1千米,单位:米。参数可以是字符串格式也可以是数字格式
setSortType(sortType) 设置公交查询返回结果集的排序方式:
0:距离优先
1:时间优先
3:价格优先
4:月票价格优先
5:刷卡折扣价格优先
5:特殊折扣价格优先
getLineByName(name) LTBusLinesResult 通过公交线路名称向服务器请求公交路线信息,参数name就是公交路线的名称,如:运通114;
范例:获取公交线路信息
getLineById(id) LTBusLinesResult 通过公交线路的ID向服务器请求公交路线信息,参数id就是公交路线的ID;
范例:获取公交线路信息
getLineDetails(line) LTBusLine 通过LTBusLine对象,把此对象的线路轨迹坐标点结果集得到;
范例:获取公交线路信息
getStationByName(name) LTBusStationsResult 通过站点名称向服务器请求公交站点信息,参数name就是公交站点的名称;
范例:获取公交站点信息
getStationByPoint(point) LTBusStationsResult 通过站点坐标向服务器请求公交站点信息,参数point就是公交站点的坐标,类型为:LTPoint;
范例:获取公交站点信息
getRoutesByPoint
(sPoint,ePoint)
LTBusRoutesResult 通过起始终点的坐标可以获得换乘方案的结果集,结果集类型为LTBusRoutesResult,参数类型都是LTPoint
1.sPoint:起点的坐标
2.ePoint:终点的坐标
范例:获取换乘方案信息
getRouteDetail(route) 通过换乘方案对象route(LTBusRoute类型),获取换乘方案的详细信息,包括所换乘的每条线路等
范例:获取换乘方案信息
属性
属性名称 最后更新版本 返回值类型 说明
running Boolean 代表该LTBus对象是否正在运行任务之中,即正在等待服务器返回信息,如果running属性为true的时候进行另一次请求操作,则当前正在运行的请求可能会被终止。
事件
事件名称 最后更新版本 返回值类型 说明
routesloaded (routesResult) 在每次获得两点之间换乘方案结果时触发,即在通过getRoutesByPoint方法发送的请求得到响应后触发,将会把匹配结果类(LTBusRoutesResult对象)作为事件参数返回。
routedetailloaded (route) 在每次获得换乘方案详细信息结果时触发,即在通过getRouteDetail方法发送的请求得到响应后触发,事件参数就是已经加入详细信息的LTBusRoute对象。
lineloaded (line) 在每次获得线路详细信息结果时触发,即在通过getLineByName和getLineById方法发送的请求得到响应后触发,事件参数就是已经加入详细信息的LTBusLine对象。
linedetailloaded (line) 在每次获得线路详细信息结果时触发,即在通过getLineDetails(line)方法发送的请求得到响应后触发,事件参数就是已经加入详细信息的LTBusLine对象,而返回的结果就是此公交线路的轨迹坐标
stationdetailloaded (station) 在每次获得站点详细信息结果时触发,即在通过getStationByName和getStationByPoint方法发送的请求得到响应后触发,事件参数就是已经加入详细信息的LTBusStation对象。
类 LTBusLinesResult
线路名称查询的返回结果类,其中包括了公交线路(lines属性)以及公交线路中的站点列表信息(stations属性)
方法
函数名称 最后更新版本 返回值类型 说明
getLineById(id) LTBusLine 在返回的类型为LTBusLinesResult结果集中,通过公交线路的ID获得公交路线信息
getStationsByLine(line) LTBusStation数组 在返回的类型为LTBusLinesResult结果集中,通过line对象获取此线路的站点列表
属性
属性名称 最后更新版本 返回值类型 说明
error Number 是否在查询过程之中出错,为0代表正常,其他值代表出错,这种情况下,就没有搜索结果,其他属性也就不存在
searchKey String 用户的查询关键词
count Number 结果的总条数,包括因为分页功能而没有返回的结果
lines LTBusLine数组 返回的线路数组
类 LTBusLine
代表一条公交线路对象
属性
属性名称 最后更新版本 返回值类型 说明
id Number 该线路的id
name String 该线路的名称,例如919支3(九龙游乐园-德胜门西)
stations LTBusStation数组 该站点的停靠站点列表
points LTPoint数组 该站点的运行轨迹点数组,用来在地图之中绘制线路
类 LTBusRoute
搜索结果中的一个换乘方案对象
属性
属性名称 最后更新版本 返回值类型 说明
distance Number 该换乘方案的总距离
routeLines LTBusRouteLine数组 该换乘方案的所有乘车线路的数组
sDis Number 从起点到首次上车车站的步行距离
eDis Number 从最后下车车站到终点的步行距离
sDir Number 从起点到首次上车车站的步行方向
eDis Number 从最后下车车站到终点的步行方向
detail Boolean 该对象是否已经包含了详细信息,经过LTBus的getRouteDetail方法查询过的方法才会有详细信息。
类 LTBusRouteLine
一个换乘方案之中的一个乘车线路对象,即一次上下车
属性
属性名称 最后更新版本 返回值类型 说明
line LTBusLine 线路对象
sStation LTBusStation 乘坐本线路的上车站点对象
eStation LTBusStation 乘坐本线路的下车站点对象
walk 乘坐本线路前需要步行的信息
{
distance:10; //步行的距离
direction:'西' //步行的方向
}
stations LTBusStation数组 本次乘车的所有经过站点,注意这是一个详细信息,必须经过LTBus的getRouteDetail方法查询并得到服务器返回之后,才会有本属性。
points LTPoint数组 本次乘车的路线轨迹,注意这是一个详细信息,必须经过LTBus的getRouteDetail方法查询并得到服务器返回之后,才会有本属性。
类 LTBusRoutesResult
两点之间计算换乘路线的返回结果类,其中包括换乘方案结果集(LTBusRoute),而换乘方案中又包括换乘线路信息(LTBusLine)、步行距离等信息等
属性
属性名称 最后更新版本 返回值类型 说明
error Number 是否在查询过程之中出错,为0代表正常,其他值代表出错,这种情况下,就没有搜索结果,其他属性也就不存在
routes LTBusRoute数组 一个数组,包含返回的多个换乘方案信息
sPoint LTPoint 起点坐标
ePoint LTPoint 终点坐标
类 LTBusStation
搜索结果中的一个公交站点对象
属性
属性名称 最后更新版本 返回值类型 说明
id Number 该站点的id
name String 该站点的名称
isStation Boolean 判断该对象是否是一个公交站点,总是返回true
point LTPoint 该站点的经纬度
lines LTBusLine数组 通过该站点的所有线路列表
类 LTBusStationsResult
通过站点名称或者坐标查询到的站点信息类,其中包含了目标点附近的站点集合(stations),以及经过站点的公交线路的简单信息(lines)
属性
属性名称 最后更新版本 返回值类型 说明
error Number 是否在查询过程之中出错,为0代表正常,其他值代表出错,这种情况下,就没有搜索结果,其他属性也就不存在
searchKey String 用户的查询关键词
count Number 结果的总条数,包括因为分页功能而没有返回的结果
stations LTBusStation数组 返回的站点数组