Constructor
new BusQuery()
Members
networkName
网络名称。
transferScheme
换乘方案信息。
Methods
getCapabilities(successFn, failFn)
获取服务能力描述信息。
Parameters:
Name | Type | Description |
---|---|---|
successFn |
function | 请求成功的回调函数。 |
failFn |
function | 请求失败的回调函数。 |
initialize(name, url, options)
GeoGlobe.Query.BusQuery类的构造函数。
Example
(code)
var url = "http://map.geostar.com.cn:9001/bus_sdk_new/bus";
var busService = new GeoGlobe.Query.BusQuery("公交服务", url);
(end)
Parameters:
Name | Type | Description |
---|---|---|
name |
String | 服务名称。 |
url |
String | 服务地址。 |
options |
Object | 实例的选项设置,此参数可选。 |
isExist() → {Boolean}
将向服务发送"GetCapabilities"同步请求,以检测服务是否存在。
注意,本方法只能验证服务是否存在,并不能保证实际功能完全正常。
Returns:
- 服务是否存在。
- Type
- Boolean
queryBus(parameter1, parameter2, transferMode) → {Object}
根据parameter1、parameter2、transferMode查询公交换乘方案。
请求url,响应返回capabilities的XML文档信息,解析该XML文档,获得服务的networkName。
根据得到的参数请求_queryTransferScheme方法得到换乘方案信息
Parameters:
Name | Type | Description |
---|---|---|
parameter1 |
GeoGlobe.LngLat | String | 起点经纬度或者起点名称。 |
parameter2 |
GeoGlobe.LngLat | String | 终点经纬度或者终点名称。 |
transferMode |
String | 选择方式 0-较快捷 1-少换乘 2-少步行 |
Returns:
- 换乘方案信息
{flag:服务正常返回换乘信息为true,否则为false,featuresInfo:换乘方案信息}
- Type
- Object
queryBusTransferSchemeByIndex(sortIndex) → {Object}
根据sortIndex查询单条换乘方案几何信息。
Parameters:
Name | Type | Description |
---|---|---|
sortIndex |
String | 换乘方案索引值。 |
Returns:
- 换乘方案几何信息
{lineFeatures:方案线要素 ,stationFeatures:换乘方案的起始点要素}
- Type
- Object
queryChange(options, successFn, failFn, networkName, startStationId, endStationId, startCoordinate, endCoordinate, maxDepth, maxCost, maxSolutions, orderType)
公交换乘方案查询操作。
Example
(code)
busService.queryChange({
networkName: "BusChangeModule",
startStationId: "238",
endStationId: "25",
maxDepth:5,
maxCost:100.0,
maxSolutions:5,
//orderType表示换乘的类型。LeastCost表示较快捷,用户还可以选择LeastWalk或LeastChange,LeastWalk表示少步行,值为LeastChange时表示少换乘
orderType:"LeastCost"
})
(end)
Parameters:
Name | Type | Description |
---|---|---|
options |
Object | 请求参数。 |
successFn |
function | 请求成功的回调函数。 |
failFn |
function | 请求失败的回调函数。 options请求参数属性可为: |
networkName |
String | (必选) 网络模型名称。 |
startStationId |
Integer | (可选) 起始站点ID。 |
endStationId |
Integer | (可选) 终止站点ID。 |
startCoordinate |
String | (可选) 起始站点坐标。 |
endCoordinate |
String | (可选) 起始站点坐标。 |
maxDepth |
Integer | (可选) 最大边数范围,正整型参数,没有则默认值为5。 |
maxCost |
Float | (可选) 最大权值范围,正双精度符点型参数,没有则默认为100.0。 |
maxSolutions |
Integer | (可选) 最多解决方案数量,正整型参数,没有则默认为5。 |
orderType |
String | (可选) 值为LeastCost时表示较快捷,值为LeastWalk时表示少步行,值为LeastChange时表示少换乘。 |
queryKeyWord(options, networkName, keyWord, searchType, keyWordType) → {Array(GeoGlobe.Feature)}
根据关键字来获取线路信息或者站点信息或者出入口信息。(公交2.0)
Parameters:
Name | Type | Description |
---|---|---|
options |
Object | 请求参数。 options请求参数属性可为: |
networkName |
String | (必选) 网络模型名称。 |
keyWord |
String | (必选)查询关键字。 |
searchType |
Integer | (可选) 查询类型,默认值为 2,查询类型,其值为0|1|2:0-完全配匹,1-模糊查询,2-先完全后模糊默认值为2。 |
keyWordType |
Integer | (可选) 查询关键字类型,默认值为 -1,可供选择的值为-1|0|1|2:-1:先查线路,然后查车站,最后查出入口0-查线路,1-查车站,2-查出入口。 |
Returns:
- 返回的是出入口、站点、线路要素。
- Type
- Array(GeoGlobe.Feature)
queryLine(options, successFn, failFn, networkName, lineName, lineId, stationName, stationId, coordinate, bbox)
线路查询操作。
Example
(code)
//示例1 根据站点名称查询
busService.queryLine({
networkName: "BusChangeModule",
stationName: encodeURIComponent('口'),
}
//示例2 根据站点ID查询
busService.queryLine({
networkName: "BusChangeModule",
stationId : 2
}
//示例3 根据路线名称查询
busService.queryLine({
networkName: "BusChangeModule",
lineName : '4'
}
(end)
Parameters:
Name | Type | Description |
---|---|---|
options |
Object | 请求参数。 |
successFn |
function | 请求成功的回调函数。 |
failFn |
function | 请求失败的回调函数。 options请求参数属性可为: |
networkName |
String | (必选) 网络模型名称。 |
lineName |
String | (可选) 线路名称。 |
lineId |
Integer | (可选) 线路ID。 |
stationName |
String | (可选) 站点名称。 |
stationId |
Integer | (可选) 站点ID。 |
coordinate |
String | (可选) 站点位置。 |
bbox |
String | (可选) 矩形范围。 |
queryLineInfo(options, successFn, failFn, networkName, lineId, STARTNODENUMBER, ENDNODENUMBER)
线路查询操作。(公交2.0)
Example
(code)
busService.queryLineInfo({
networkName: "BusChangeModule",
stationId : 2
}
(end)
Parameters:
Name | Type | Description |
---|---|---|
options |
Object | 请求参数。 |
successFn |
function | 请求成功的回调函数。 |
failFn |
function | 请求失败的回调函数。 options请求参数属性可为: |
networkName |
String | (必选) 网络模型名称。 |
lineId |
Integer | (必选) 线路ID。 |
STARTNODENUMBER |
String | (可选) 线路中某一个站点的序号。多个序号采用逗号分割。 |
ENDNODENUMBER |
String | (可选) 线路中某一个站点的序号。多个序号采用逗号分割。 |
queryPassagewayInfo(options, successFn, failFn, networkName, passagewayId)
根据出入口ID获取与此出入口有关的站点信息,包括出入口所对应的车站信息。(公交2.0)
Example
(code)
busService.queryPassagewayInfo({
networkName: "BusChangeModule",
passagewayId : 2
}
(end)
Parameters:
Name | Type | Description |
---|---|---|
options |
Object | 请求参数。 |
successFn |
function | 请求成功的回调函数。 |
failFn |
function | 请求失败的回调函数。 options请求参数属性可为: |
networkName |
String | (必选) 网络模型名称。 |
passagewayId |
Integer | (必选) 出入口ID。 |
queryStation(options, successFn, failFn, networkName, stationName, stationId, lineId, lineName, coordinate, bbox)
站点查询操作。
Example
(code)
//示例1 根据站点名称查询:
busService.queryStation({
networkName: "BusChangeModule",
stationName: encodeURIComponent('口'),
}
//示例2 根据站点ID查询:
busService.queryStation({
networkName: "BusChangeModule",
stationId : 2
}
//示例3 根据矩形范围查询:
busService.queryStation({
networkName: "BusChangeModule",
bbox : '-1,-1,1,1'
}
(end)
Parameters:
Name | Type | Description |
---|---|---|
options |
Object | 请求参数。 |
successFn |
function | 请求成功的回调函数。 |
failFn |
function | 请求失败的回调函数。 options请求参数属性可为: |
networkName |
String | (必选) 网络模型名称。 |
stationName |
String | (可选) 站点名称。 |
stationId |
Integer | (可选) 站点ID 必须为正整型。 |
lineId |
Integer | (可选) 线路ID。 |
lineName |
String | (可选) 线路名称。 |
coordinate |
String | (可选) 站点位置 用逗号分隔XY轴坐标如(X,Y)。 |
bbox |
String | (可选) 矩形范围。 |
queryStationInfo(options, successFn, failFn, networkName, stationId)
站点查询操作。(公交2.0)
Example
(code)
busService.queryStationInfo({
networkName: "BusChangeModule",
stationId : 2
}
(end)
Parameters:
Name | Type | Description |
---|---|---|
options |
Object | 请求参数。 |
successFn |
function | 请求成功的回调函数。 |
failFn |
function | 请求失败的回调函数。 options请求参数属性可为: |
networkName |
String | (必选) 网络模型名称。 |
stationId |
Integer | (必选) 站点ID 必须为正整型。 |
queryTransferGeometry(options, networkName, parameterInfo, geometryTypeID, geometryInfoID, FromOrdinal, ToOrdinal)
根据线路ID或者步行ID来获取相应的线要素(公交2.0。注意:这些线要素不包含属性信息)。
Parameters:
Name | Type | Description |
---|---|---|
options |
Object | 请求参数。 options请求参数属性可为: |
networkName |
String | (必选) 网络模型名称。 |
parameterInfo |
Arrays | 取值格式:[[geometryTypeID,geometryInfoID,FromOrdinal,ToOrdinal]]例如[[0,10,22,24]]。 |
geometryTypeID |
Integer | (必选) 0-线路内部ID,1-步行路由内部ID。如果这个属性的值为1,那么FromOrdinal和ToOrdinal这两个属性的的值就都为0。 |
geometryInfoID |
Integer | 几何信息 的ID。 |
FromOrdinal |
Integer | (必选) 起点序号。 |
ToOrdinal |
Integer | (必选) 终点序号。 |