中国移动业务管理及Le接口技术规范.docx

中国移动通信有限公司 发布
中国移动通信企业标准

QB-╳╳-╳╳╳-╳╳╳╳

位置业务Le接口规范

Le Interface Specification For LBS Client Accessing LSP

版本号：2.0.0

╳╳╳╳-╳╳-╳╳发布
╳╳╳╳-╳╳-╳╳实施

目 录

1 范围 12
2 规范性引用文件 12
3 术语、定义和缩略语 12
3.1 符号 一三
3.2 语法说明 一三
4 位置业务接口协议组成 14
5 Le 协议 一五
5.1 Le协议概述 一五
5.2 Le结构 一五
5.3 Le扩展机制 一八
5.4 Le协议具体定义 19
5.4.1 传输层定义 19
5.4.2 元素层定义 19
5.4.2.1 Identity Element Definitions 19
5.4.2.2 Function Element Definitions 20
5.4.2.3 Location Element Definitions 21
5.4.2.4 Result Element Definitions 23
5.4.2.5 Shape Element Definitions 23
5.4.2.6 Quality Element Definitions 25
5.4.2.7 Network Element Definitions 26
5.4.2.8 Context Element Definitions 27
5.4.3 服务层定义 27
5.4.3.1 头信息结构(HDR) 27
5.4.3.1.1 Header DTD 29
5.4.3.2 立即定位服务SLIS(Standard Location Immediate Service) 30
5.4.3.2.1 立即定位请求(SLIR) 31
5.4.3.2.2 立即定位应答(SLIA) 32
5.4.3.2.3 立即定位报告(SLIREP) 34
5.4.3.3 立即紧急定位服务ELIS(Emergency Location Immediate Service) 35
5.4.3.3.1 紧急定位请求(EME_LIR) 36
5.4.3.3.2 紧急定位应答(EME_LIA) 37
5.4.3.3.3 立即紧急定位报告（EME_LIREP） 37
5.4.3.4 标准定位报告服务SLRS(Standard Location Reporting Service) 38
5.4.3.4.1 标准定位报告（SLR） 39
5.4.3.4.2 标准定位报告应答（SLRA） 39
5.4.3.5 紧急定位报告服务ELRS(Emergency Location Reporting Service) 40
5.4.3.5.1 紧急定位报告（ELR） 41
5.4.3.6 触发定位报告服务TLRS (Triggered Location Reporting Service) 41
5.4.3.6.1 触发定位报告请求(TLRR) 42
5.4.3.6.2 触发定位报告应答(TLRA) 48
5.4.3.6.3 触发定位报告(TLREP) 48
5.4.3.6.4 终止触发定位报告请求(TLRSR) 49
5.4.3.6.5 终止触发定位报告应答(TLRSA) 50
5.4.3.7 通用错误消息(GEM)定义 50
5.4.3.8 其他说明 51
5.4.3.8.1 多用户立即定位说明 51
5.4.3.8.2 GEM使用说明 51
5.4.3.8.3 net_param说明 51
5.4.3.8.4 QoP说明 51
5.5 元素和属性说明 53
5.5.1 add_info 53
5.5.2 alt 54
5.5.3 alt_acc 54
5.5.3.1 qos_class 54
5.5.4 alt_unc 55
5.5.5 angle 55
5.5.6 angularUnit 57
5.5.7 Box 57
5.5.7.1 gid 58
5.5.7.2 srsName 58
5.5.8 cc 59
5.5.9 cellid 59
5.5.10 tlrr_event 59
5.5.11 change_area 60
5.5.11.1 5.3.9.1 type 60
5.5.11.2 5.3.9.2. loc_estimates 61
5.5.12 CircularArcArea 62
5.5.12.1 gid 62
5.5.12.2 srsName 62
5.5.一三 CircularArea 63
5.5.一三.1 gid 63
5.5.一三.2 srsName 63
5.5.14 code 63
5.5.一五 codeSpace 64
5.5.16 codeword 64
5.5.17 distanceUnit 66
5.5.一八 direction 66
5.5.19 duration 66
5.5.20 edition 68
5.5.21 EllipticalArea 68
5.5.21.1 gid 69
5.5.21.2 srsName 69
5.5.22 eme_event 70
5.5.22.1 eme_trigger 70
5.5.23 eme_pos 70
5.5.23.1 pos_method 71
5.5.23.2 accout_ref 72
5.5.24 esrd 72
5.5.24.1 type 73
5.5.25 esrk 73
5.5.25.1 type 74
5.5.26 hor_acc 74
5.5.26.1 qos_class 75
5.5.27 id 75
5.5.28 imsi 75
5.5.29 inRadius 77
5.5.30 interval 77
5.5.31 lac 78
5.5.32 lcs_ref 78
5.5.33 lev_conf 79
5.5.34 LinearRing 79
5.5.34.1 gid 80
5.5.34.2 srsName 80
5.5.35 LineString 80
5.5.35.1 gid 81
5.5.35.2 srsName 81
5.5.36 ll_acc 82
5.5.36.1 5.3.34.1 qos_class 82
5.5.37 lmsi 83
5.5.38 loc_type 83
5.5.38.1 type 83
5.5.39 max_loc_age 84
5.5.40 mcc 85
5.5.41 mnc 85
5.5.42 ms_action 86
5.5.42.1 type 86
5.5.43 msid 86
5.5.43.1 type 87
5.5.43.2 enc 88
5.5.44 MultiLineString 89
5.5.44.1 gid 89
5.5.44.2 srsName 89
5.5.45 MultiPoint 89
5.5.45.1 gid 90
5.5.45.2 srsName 90
5.5.46 MultiPolygons 90
5.5.46.1 gid 91
5.5.46.2 srsName 91
5.5.47 name_area 91
5.5.48 ndc 91
5.5.49 nmr 92
5.5.50 no_of_reports 92
5.5.51 plmn 93
5.5.52 qos_not_met 93
5.5.53 radius 94
5.5.54 startAngle 94
5.5.55 stopAngle 95
5.5.56 Point 96
5.5.56.1 gid 96
5.5.56.2 srsName 96
5.5.57 Polygon 96
5.5.57.1 gid 97
5.5.57.2 srsName 97
5.5.58 prio 97
5.5.58.1 type 98
5.5.59 pwd 98
5.5.60 outRadius 100
5.5.61 pos 100
5.5.61.1 pos_method 101
5.5.61.2 account_ref 101
5.5.62 requestor 101
5.5.62.1 type 101
5.5.63 req_id 102
5.5.64 resp_req 103
5.5.64.1 type 103
5.5.65 resp_timer 104
5.5.66 result 104
5.5.66.1 resid 104
5.5.67 semiMajor 105
5.5.68 semiMinor 105
5.5.69 serviceid 107
5.5.70 requestmode 107
5.5.70.1 type 108
5.5.71 session 109
5.5.71.1 type 109
5.5.72 sessionid 110
5.5.73 speed 111
5.5.74 start_time 111
5.5.74.1 utc_off 112
5.5.75 stop_time 112
5.5.75.1 utc_off 1一三
5.5.76 subclient 1一三
5.5.76.1 last_client 114
5.5.77 net_param 114
5.5.78 cgi 1一五
5.5.79 sai 1一五
5.5.80 sac 116
5.5.81 ta 116
5.5.82 target_area 117
5.5.83 time 117
5.5.83.1 utc_off 1一八
5.5.84 time_remaining 1一八
5.5.85 trans_id 119
5.5.86 trl_pos 119
5.5.86.1 trl_trigger 120
5.5.86.2 pos_method 120
5.5.86.3 account_ref 120
5.5.87 url 120
5.5.88 vlrno 121
5.5.89 vmscno 122
5.5.90 X 122
5.5.91 Y 122
5.5.92 Z 124
5.5.93 Service attributes 124
5.5.93.1 res_type 124
5.5.93.2 ver 125
5.5.94 msids 125
5.5.95 msid_range 126
5.5.96 start_msid 126
5.5.97 stop_msid 127
5.5.98 req_result 127
5.5.98.1 type 128
5.5.99 area_code 128
5.5.99.1 type 128
5.6 错误码 129
5.7 HTTP映射 一三3
5.7.1 使用HTTP传输MLP消息 一三4
5.7.2 定位请求和应答封装 一三4
5.7.2.1 Service Initiation DTD 一三5
5.7.2.2 Service Result DTD 一三7
5.7.2.3 消息序列图 一三8
5.8 地理术语说明 140
6 编制历史 140
附录A说明与OMA-TS-MLP-V3_2-20051124-D的差别 141
附录B 一致性要求(规范性要求) 142
B.1.1 Service Initiation DTD 142
B.1.2 Service Result DTD 142
B.1.3 Header 143
B.1.4 Standard Location Immediate Request 143
B.1.5 Standard Location Immediate Answer 144
B.1.6 Standard Location Immediate Report 144
B.1.7 Emergency Location Immediate Request 144
B.1.8 Emergency Location Immediate Answer 145
B.1.9 Emergency Location Immediate Report 145
B.1.10 Standard Location Report 145
B.1.11 Standard Location Report Answer 146
B.1.12 Emergency Location Report 146
B.1.一三 Triggered Location Reporting Request 146
B.1.14 Triggered Location Reporting Answer 147
B.1.一五 Triggered Location Report 147
B.1.16 Triggered Location Reporting Stop Request 147
B.1.17 Triggered Location Reporting Stop Answer 147
B.1.一八 Support for Identity Elements 148
B.1.19 Support for Function Elements 148
B.1.20 Support for Location Elements 149
B.1.21 Support for Result Elements 一五0
B.1.22 Support for Shape Elements 一五0
B.1.23 Support for Quality of Position Elements 一五1
B.1.24 Support for Network Parameters Elements 一五1
B.1.25 Support for Context Elements 一五2
B.1.26 Service attributes 一五2
B.1.27 Transport mechanisms 一五2
B.1.28 Services 一五3
SCR for Server 一五3
B.2.1 Service Initiation DTD 一五3
B.2.2 Service Result DTD 一五4
B.2.3 Header 一五4
B.2.4 Standard Location Immediate Request 一五5
B.2.5 Standard Location Immediate Answer 一五5
B.2.6 Standard Location Immediate Report 一五5
B.2.7 Emergency Location Immediate Request 一五6
B.2.8 Emergency Location Immediate Answer 一五6
B.2.9 Emergency Location Immediate Report 一五6
B.2.10 Standard Location Report 一五7
B.2.11 Standard Location Report Answer 一五7
B.2.12 Emergency Location Report 一五7
B.2.一三 Triggered Location Reporting Request 一五7
B.2.14 Triggered Location Reporting Answer 一五8
B.2.一五 Triggered Location Report 一五8
B.2.16 Triggered Location Reporting Stop Request 一五9
B.2.17 Triggered Location Reporting Stop Answer 一五9
B.2.一八 Support for Identity Elements 一五9
B.2.19 Support for Function Elements 一五9
B.2.20 Support for Location Elements 160
B.2.21 Support for Result Elements 161
B.2.22 Support for Shape Elements 161
B.2.23 Support for Quality of Position Elements 162
B.2.24 Support for Network Parameters Elements 162
B.2.25 Support for Context Elements 163
B.2.26 Service attributes 163
B.2.27 Transport mechanisms 163
B.2.28 Services 164

前 言

本协议定义了中国移动位置业务平台和业务平台或业务网关之间的通讯协议，目的是定义一种简单、安全的接入方法，使得无论使用哪种空中接口技术和定位方法，位置应用都能从无线网络访问终端位置信息。
本协议基于HTTP、SSL/TLS和XML等现有的Internet技术，有利于基于位置的应用程序的开发。
本文目标读者为省公司LBS业务技术人员和业务人员、LSP设备提供商技术人员、接入LSP网关设备提供商技术人员、LBS SP/CP技术人员、SI/集团客户产品提供商技术人员。
本标准由中移号文件印发。
本标准由中国移动通信集团公司技术部提出并归口。
本规范由规范归口部门负责解释。
本标准起草单位：中国移动通信有限公司研究院
本标准主要起草人：林智，于蓉蓉，陈心昕，陈莉华

1 范围
本规范规定业务平台和LSP平台之间的Le接口，Le接口是应用层协议，用于应用平台接入LSP平台获取移动终端位置、长途电话区号和所在CGI信息。
开通LBS业务的中国移动各省公司和LBS平台提供商和内容提供商（ICP）、应用服务提供商（SP）在向中国移动提供LBS业务时应遵循Le规范。

2 规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款,其最新版本适用于本标准。
[1] OMA-ERP-MLS-V1_1-20061020-C：OMA-TS-MLP-V3_2-20051124-C
[2] Hypertext Transfer Protocol –HTTP/1.1 RFC 2616, June 1999
[3] Extensible Markup Language (XML) 1.0 W3C Recommendation: REC-xml-20001006
[4] OMA Interoperability Policy and Process", Version 1.1, Open Mobile AllianceTM. OMA-IOP-Process-V1_1, URL: xxopenmobilealliance.org/

3 术语、定义和缩略语
在本规范中使用了“必须”、“推荐”/“建议”、和“可选”等词汇来描述对移动终端产品要求的强调程度。
“必选”/“必须”项是指终端产品所必须提供的功能或性能要求；对应于RFC2119 MUST，REQUIRED，SHALL。
“推荐”/“建议”项是指在标准中未作强制要求，若终端产品提供的功能或性能要求被认为更佳；对应于RFC2119 RECOMMENDED，SHOULD。
“可选”/“可”项指参考性要求，是终端产品在目前阶段可不提供的功能或性能要求；对应于RFC2119 MAY，OPTIONAL。
必不能，不能，不得：表示绝对的禁止；对应于RFC2119 MUST NOT，SHALL NOT。
不推荐，不建议：表示若产品按照所述内容制作，被认为略次；对应于RFC2119 SHOULD NOT，NOT RECOMMENDED。
规范中除了明确指明为 “推荐”/“建议”、“可选”外，均为必须要求。
表示时间阶段的词：:现阶段、下一阶段、目标网，现阶段表示试商用/商用的版本必须遵守该规定；下一阶段是商用之后升级的版本必须遵守该规定；目标网是更远的计划升级的版本需要遵守的规定。
A-GPS
Assisted GPS
CGI
Cell Global Identity
DTD
Document Type Definition
E-OTD
Enhanced Observed Time Difference
EPSG
European Petroleum Survey Group
GPS
Global Positioning System
HTTP
Hypertext Transfer Protocol
HTTPS
HTTP Secure
LBS
Location Based Service
LCS
Location Services
LDR
Location Deferred Request
LSP
Location Service Platform
MLP
Mobile Location Protocol
MS
Mobile Station
MSID
Mobile Station Identifier
MSISDN
Mobile Station ISDN
OTDOA
Observed Time Difference of Arrival
SSL
Secure Socket Layer
TLS
Transport Layer Security
URI
Uniform Resource Identifier
URL
Uniform Resource Locator
U-TDOA
Uplink Time Difference of Arrival
UTM
Universal Transverse Mercator
WAP
Wireless Application Protocol
WGS
World Geodetic System
XML
Extensible Markup Language

3.1 符号
SP
Space
空格
CRLF
“\r\n”
回车换行
3.2 语法说明
[a-z]
任意小写字母
[A-Z]
任意大写字母
[0-9]
任意数字
{min,max}
重复次数大于等于min，小于等于max
[a-z,A-Z,0-9]
任意字母及数字
+
一次或多次出现
*
零次或多次出现
?
可选
()
多个表达式合成一个整体
|
多选一
,
严格的序列,与AND相同
4 位置业务接口协议组成
中国移动位置业务协议Le接口在网络结构中位置如图4-1所示：

图 41各接口协议示意图
5 Le 协议
5.1 Le协议概述

图 51Le接口示意图
LSP平台主要对SP的访问进行鉴权管理；对用户进行隐私管理，完成对终端的定位；Le接口用于（1）业务平台或业务网关（LCS Client，下文简称业务平台）接入LSP平台获取终端位置和（2）LSP接入LCS Client报告终端位置（可选），本文仅规定LSP Le接口内容，不包括LSP平台的其他功能。
Le接口基于OMA-TS-MLP-V3_2-20051124-C，两者的差别见附录A。
5.2 Le结构
在实际应用中，不同的终端设备有不同的通信方式，一个通用的位置服务的接口协议必须支持不同传输协议；在Le中对服务层和元素层进行了定义，作为内容（XML格式）它和传输协议是分开的。

图 52 Le协议结构
Le是应用层的协议，上图所示Le结构分为三层：传输层、元素层和服务层。最底层是传输层（Transport Layer），定义了XML内容的传输承载协议，常见的应用传输协议有：超文本传输协议(HTTP)、无线对话协议(WSP)、简单对象访问协议(SOAP)等。中国移动建议采用HTTP(V1.1)作为传输协议。
传输层之上是元素层（Element Layer），定义了服务层中共用的元素，Le定义了以下的DTD来描述元素层的所有元素。
MLP_ID.DTD
Identify Element Definitions
MLP_FUNC.DTD
Function Element Definitions
MLP_LOC.DTD
Location Element Definitions
MLP_RES.DTD
Result Element Definitions
MLP_SHAPE.DTD
Shape Element Definitions
MLP_QOP.DTD
Quality of Position Element Definitions
MLP_NET.DTD
Network Parameters Element Definitions
MLP_CTXT.DTD
Context Element Definitions
服务层（Service Layer）定义了MLP支持的基本位置服务类型，目前支持：立即定位服务(SLIS)、紧急立即定位服务(ELIS)、标准定位报告服务（SLRS）、紧急定位报告服务（ELRS）及触发定位报告服务(TLRS)，至于高级位置服务不在本协议讨论范围。每个基本的位置服务都包含多个消息(请求消息和应答消息等)。

立即定位服务（SLIS）
LSP必须立即（在一定时间内）对定位请求进行响应，返回终端的位置信息或长途区号或CGI；请求和响应可以是同步的，也可以是异步的。在同步模式下，LSP通过SLIA返回定位结果；在异步模式下， LSP设备先通过SLIA确认定位请求已经收到，再通过SLIREP返回定位结果。
n立即定位请求(SLIR)
n立即定位应答(SLIA)
n立即定位报告(SLIREP)
立即紧急定位服务
（ELIS）
在紧急情况下，LSP通过同步方式对定位请求进行立即响应。与SLIS唯一的区别是ELIS无须对定位请求进行鉴权，请求和应答也在同一连接中完成；ELIS有请求消息和应答消息：
n立即紧急定位请求(ELIR)
n立即紧急定位应答(ELIA)
n立即紧急定位报告（ELIREP）
标准定位报告服务
（SLRS）
当移动用户向第三方报告其位置时使用该服务。由LSP平台将位置信息发送给业务平台。应用和发送地址由终端或者LSP定义。SLRS包含以下消息：
n标准定位报告（SLR）
n标准定位报告应答（SLRA）
紧急定位报告服务
（ELRS）
该服务用于在紧急呼叫时，无线网络自动发起定位。LSP平台将位置信息和相关数据发送给紧急应用平台。紧急应用和发送地址定义在LSP中。ELRS包含以下消息：
n紧急定位报告（ELR）
触发定位报告服务
(TLRS)
定位请求设置定位条件，在条件满足时LSP对终端进行定位并把定位结果回传到定位请求者，定位过程需要鉴权，定位请求和定位报告是异步进行，一般在不同的连接中完成。TLRS有下列消息，TLRA请求一般不进行定位结果的传递，而只是LSP设备用于确认定位请求已经收到，而定位结果则在TLREP中进行传递：
n触发定位请求(TLRR)
n触发定位应答(TLRA)
n触发定位报告(TLREP)
n取消触发定位请求(TLRSR)
n取消触发定位应答(TLRSA)

5.3 Le扩展机制
Le协议具有扩展性，实现原则如下：
1）一般性的信息以分离式的DTD来定义，以便这些基本元素（element）的重用，如Client address，shape。
2）信息扩展机制允许增加新的元素，这种机制以特定的实体参数（%extension;）来实现；这个实体参数指的是一个扩展的DTD文件，这个DTD文件必须包含另一个实体参数（%extension.message），其中包含了要扩展的信息元素的定义。
3）元素扩展机制允许在已有的定义中增加新的元素。这种机制同上，不过实体参数为%extension.param。
4） 已定义元素不可被赋予新的定义而再次使用。扩展的DTD必须在XML文件中引用。LSP必须忽略不能解析的扩展元素，尽力而为的解析各元素并正常响应（如同未有扩展元素）。
例1：消息扩展
<!-truckco_MLP_extension -->
<!ENTITY % extension.message "| truckco_message">
<!ELEMENT truckco_message (truckco_data)>
<!ATTLIST truckco_message ver CDATA #FIXED "x.y.z">

<?xml version = "1.0" ?>
<!DOCTYPE svc_init SYSTEM "MLP_SVC_INIT_200.DTD " [
<!ENTITY % extension SYSTEM
"xxtruckcox/truckco_MLP_extension.dtd">
%extension;
]>
<svc_init ver=“2.0.0”>
<hdr ver=“2.0.0”>
...
</hdr>
<truckco_message ver="x.y.z">
<truckco_data>
...
</truckco_data>
</truckco_message>
</svc_init>
例2：元素扩展
<!-- truckco_MLP_extension -->
<!ENTITY % extension.param ", truckco_extension">
<!ELEMENT trucko_extension (truck_no, trucko_codeword)>
<!ELEMENT truck_no (#PCDATA)>
<!ELEMENT trucko_codeword (#PCDATA)>
<!ATTLIST trucko_codeword
type ( long | short) #REQUIRED>

<?xml version = "1.0" ?>
<!DOCTYPE svc_init SYSTEM "MLP_SVC_INIT_200.DTD" [
<!ENTITY % extension SYSTEM
"xxtruckcox/truckco_MLP_extension.dtd">
%extension;
]>
<svc_init ver=“2.0.0”>
<hdr ver=“2.0.0”>
...
</hdr>
<slir ver=“2.0.0”>
...
<truckco_extension>
<truck_no>KLM4583</truck_no>
<trucko_codeword type=”short”>6547</trucko_codeword>
</truckco_extension>
</slir>
</svc_init>
5.4 Le协议具体定义
5.4.1 传输层定义
MLP的传输层可使用多种传输协议（如5.2所述），其中同HTTP的对应见5.7 HTTP Mapping。
5.4.2 元素层定义
5.4.2.1 Identity Element Definitions
<!-- MLP_ID -->

<!ELEMENT
msid
(#PCDATA)>
<!ATTLIST
msid

type (MSISDN | IMSI | IMEI | MIN | MDN |
EME_MSID | ASID | OPE_ID | IPV4 | IPV6 | SESSID | SIP_URI | TEL_URL | CSid | IM_ID | Browser_ID)
"MSISDN"

enc (ASC | CRP)
"ASC">
<!ELEMENT
msid_range
(start_msid, stop_msid)>
<!ELEMENT
msids
(((msid, codeword?, session?, trans_id?) | (msid_range, codeword*))+)>
<!ELEMENT
codeword
(#PCDATA)>
<!ELEMENT
esrd
(#PCDATA)>
<!ATTLIST
esrd

type (NA)
"NA">
<!ELEMENT
esrk
(#PCDATA)>
<!ATTLIST
esrk

type (NA)
"NA">
<!ELEMENT
session
(#PCDATA)>
<!ATTLIST
session

type (APN | DIAL)
#REQUIRED>
<!ELEMENT
start_msid
(msid)>
<!ELEMENT
stop_msid
(msid)>
<!ELEMENT
trans_id
(#PCDATA)>

注：msid_range中start_msid和stop_msid的type必须相同。
5.4.2.2 Function Element Definitions
<!-- MLP_FUNC -->

<!ELEMENT
eme_event
(eme_pos+)>
<!ATTLIST
eme_event

eme_trigger (EME_ORG | EME_REL)
#REQUIRED>
<!ELEMENT
tlrr_event
(ms_action | change_area)>
<!ELEMENT
ms_action
EMPTY>
<!ATTLIST
ms_action

type (MS_AVAIL)
#REQUIRED>
<!ELEMENT
change_area
(target_area, no_of_reports?)>
<!ATTLIST
change_area

type (MS_ENTERING | MS_LEAVING | MS_WITHIN_AREA)
#REQUIRED

loc_estimates (TRUE | FALSE)
#REQUIRED>
<!ELEMENT
target_area