: IpAppTriggeredUserLocation
: IpTriggeredUserLocation )
1: triggeredLocationReportingStartReq( 2: triggeredLocationReport( )
3: triggeredLocationReport( ) New reports are sent until the triggered reporting is stopped 4: triggeredLocationReportingStop( )
1 2 3 4 应用使用此消息向业务申请一个或多个用户触发式位置报告 当设置的触发条件满足时 业务使用此消息将相关用户的位置信息传递给它的回调对象 重复第 2 步 直到应用请求取消触发式位置报告(参见下一消息) 应用请求取消触发式位置报告
6.1.2
用户位置查询 – 定期请求
下面的流程图给出了一个应用如何向用户定位业务请求定期位置报告的例子
9 /9
无线定位业务应用编程接口
API
技术规范
: IpAppUserLocation 1: periodicLocationReportingStartReq(
: IpUserLocation )
2: periodicLocationReport( ) 3: periodicLocationReport( ) New reports are sent until the periodic reporting is stopped 4: periodicLocationReportingStop( )
１ ２ ３ ４ 应用使用此消息向业务请求一个或几个用户的定期位置报告 业务使用此消息将一个或几个用户的位置信息传递给它的回调对象 业务按规定的时间间隔重复第２步
直到应用请求取消定期位置报告（参见下一消息）
应用使用此消息请求取消定期位置报告
6.1.3
用户位置查询 – 参数错误 当应用向用户定位业务请求一个位
下面的流程图给出了用户位置查询中处理参数错误的例子 置报告时 业务在参数中至少检测到了一个错误 对于 ｅｘｔｅｎｄｅｄＬｏｃａｔｉｏｎＲｅｐｏｒｔＲｅｑ ｐｅｒｉｏｄｉｃＬｏｃａｔｉｏｎＲｅｐｏｒｔｉｎｇＳｔａｒｔＲｅｑ 消息的情况类似 因此并未一一列出
: IpAppUserLocation 1: locationReportReq( The scenarios for: · extendedLocationReport_Req · periodicLocationReportingStart_Req are similar and therefore not shown. )
: IpUserLocation
１ 应用使用此消息
向业务请求一个或几个用户的位置报告 但业务返回一个错误 请求被终止 执行
10 / 10
无线定位业务应用编程接口
API
技术规范
6.1.4
用户位置查询 – 网络错误
当应用向用户定位业务请求一个位
下面的流程图给出了用户位置查询中处理参数错误的例子 置报告时 发生了与网络有关的错误 对于 ｅｘｔｅｎｄｅｄＬｏｃａｔｉｏｎＲｅｐｏｒｔＲｅｑ ｐｅｒｉｏｄｉｃＬｏｃａｔｉｏｎＲｅｐｏｒｔｉｎｇＳｔａｒｔＲｅｑ 消息的情况类似 因此并未一一列出
: IpAppUserLocation 1: locationReportReq( )
: IpUserLocation
2: locationReportErr( )
The scenarios for: · extendedLocationReport_Req · periodicLocationReportingStart_Req are similar and therefore not shown. １ ２ 应用使用此消息向业务请求一个或几个用户的位置信息报告 在执行请求时 业务发现了与网络有关的错误
并将这些信息传递给它的回调对象
6.1.5
用户位置查询 – 交互式请求
下面的流程图给出了一个应用如何向用户定位业务请求一个位置报告的例子 : IpAppUserLocation 1: locationReportReq( 2: locationReportRes( ) )
: IpUserLocation
１ ２ 应用使用此消息向业务请求一个或几个用户的位置信息报告
业务使用此消息将一个或几个用户请求结果传递给它的回调对象
11 / 11
无线定位业务应用编程接口
API
技术规范
6.2 基于网络的用户定位业务流程图
6.2.1
基于网络的用户定位查询 – 触发请求
当
下面的流程图给出了一个应用如何向基于网络的用户定位业务请求触发式位置报告的例子 用户位置变化时 业务将其位置信息报告给应用
: IpAppUserLocationNetwork
: IpUserLocationNetwork
1: triggeredLocationReportingStartReq(
)
2: triggeredLocationReport( )
3: triggeredLocationReport( ) New reports are sent until the triggered reporting is stopped 4: triggeredLocationReportingStop( )
１ ２ ３ ４ 应用使用此消息向业务请求一个或几个用户的触发式位置报告 当触发条件满足时 重复第２步
业务使用此该消息将相关用户的位置信息传递给它的回调对象
直到应用请求取消触发式位置报告（参见下一个消息）
应用使用此消息向业务请求取消触发式位置报告
6.2.2
基于网络的用户定位查询 – 定期请求
下面的流程图给出了一个应用如何向基于网络的用户定位业务请求定期位置报告的例子
12 / 12
无线定位业务应用编程接口
: IpAppUserLocationlNetw
API
技术规范
: IpUserLocationNetwl
1: periodicLocationReportingStartReq(
)
2: periodicLocationReport( )
3: periodicLocationReport( ) New reports are sent until the periodic reporting is stopped 4: periodicLocationReport
ingStop( )
１ ２ ３ ４ 应用使用此消息向业务请求一个或几个用户的定期位置报告 业务使用此消息将一个或几个用户的位置信息传递给它的回调对象 业务按规定的时间间隔重复第２步
直到应用请求取消定期位置报告（参见下一个消息）
应用使用此消息向业务请求取消定期位置报告
6.2.3
基于网络的用户定位查询 – 参数错误
下面的流程图给出了基于网络的用户定位查询中处理参数错误的例子 当应用向基于网络的用 户定位业务请求一个位置报告时 业务在参数中至少检测到了一个错误 对于 ｐｅｒｉｏｄｉｃＬｏｃａｔｉｏｎＲｅｐｏｒｔｉｎｇＳｔａｒｔＲｅｑ 消息的情况类似 因此并未列出
: IpAppUserLocationNetwork
: IpUserLocationNetwork
1: locationReportReq(
)
The scenarios for: · periodicLocationReportingStart_Req are similar and therefore not shown.
误
１ 应用使用此消息向业务请求一个或几个用户的位置信息报告 但业务在参数中发现了一个错 请求执行被终止
6.2.4
基于网络的用户定位查询 – 网络错误
发生了与网
下面的流程图给出了当应用向基于网络的用户定位业务请求一个位置信息报告时 络相关错误的例子 对于
13 / 13
无线定位业务应用编程接口 ｐｅｒｉｏｄｉｃＬｏｃａｔｉｏｎＲｅｐｏｒｔｉｎｇＳｔａｒｔＲｅｑ 消息的情况类似 因此并未列出
API
技术规范
: IpAppUserLocationNetwor 1: locationReportReq( 2: locationReportErr( ) )
: IpUserLocationNetwor
The scenarios for: ·extendedLocationReport_Req ·periodicLocationReportingStart_Req are similar and therefore not shown.
１ 应用使用此消息向业务请求一个或几个用户的位置信息报告
２ 业务在执行请求时 发生了与网络有关的错误 业务使用此消息将错误信息传递给它的回调 对象
6.2.5
基于网络的用户定位查询 – 交互式请求
下面的流程图给出了一个应用如何向基于网络的用户定位业务请求一个位置报告的例子
: IpAppUserLocationNetwor 1: locationReportReq( )
: IpUserLocationNetwor
2: locationReportRes( )
１ ２ 应用使用此消息向业务请求一个或几个用户的位置信息报告
业务使用此消息将一个或几个用户请求结果传递给它的回调对象
6.3 用户状态业务流程图
6.3.1
触发式状态信息报告
当用户的
下面的流程图给出了一个应用如何向状态位置业务请求触发式状态信息报告的例子 状态改变时 业务将其状态信息报告给应用
14 / 14
无线定位业务应用编程接口
: IpAppUserStatus : IpUserStatus
API
技术规范
1: triggeredStatusReportingStartReq(
)
2: triggeredStatusReport( )
3: triggeredStatusRepo
rt( ) New reports are sent until the triggered reporting is stopped 4: triggeredStatusReportingStop( )
１ ２ ３ ４ 应用使用此消息向业务请求一个或几个用户的触发式状态信息报告 当一个指定用户的状态改变时 重复第２步
业务使用此消息将用户状态传递给它的回调对象
直到应用请求取消触发式状态信息报告（参见下一个消息）
应用使用此消息向业务请求取消触发式状态信息报告
6.3.2
交互式请求参数错误
下面的流程图给出了处理参数错误的例子 当应用向用户状态业务请求一个状态信息报告时 业务检测到了参数错误 并调用了一个处理错误的方法
: IpAppUserStatus 1: statusReportReq( The method is returning an error code. )
: IpUserStatus
6.3.3
交互式请求网络错误
发生了与网络相关错误的例子
下面的流程图给出了当应用向业务请求用户状态信息报告时
15 / 15
无线定位业务应用编程接口
API
技术规范
: IpAppUserStatus 1: statusReportReq( 2: statusReportErr( ) An error has occured while processing the request and an error method is called. )
: IpUserStatus
6.3.4
交互式请求
下面的流程图给出了一个应用如何向用户状态业务请求一个状态信息报告的例子
: IpAppUserStatus 1: statusReportReq( 2: statusReportRes( ) )
: IpUserStatus
１ ２ 应用使用此消息向业务请求一个或几个用户的状态信息报告 业务使用此消息将请求结果传递给业务的回调对象
16 / 16
无线定位业务应用编程接口
