中国电信综合业务接入网关(ISAG)开放.pdf
《中国电信综合业务接入网关(ISAG)开放.pdf》由会员分享,可在线阅读,更多相关《中国电信综合业务接入网关(ISAG)开放.pdf(24页珍藏版)》请在咨信网上搜索。
1、 黄 中国电信集团公司技术标准 Q/CT XXXX.1-2008 中国电信综合业务接入网关(ISAG)开放接口技术规范 LCS RC 1.0.1 200-发布 200-实施 中国电信集团公司 发布 保 密 等 级:公 开 发 放 Q/CT XXXX.1-2008 2 中国电信综合业务接入网关(ISAG)开放接口技术规范 目录 1 范围.4 2 规范性引用文件.错误!未定义书签。错误!未定义书签。3 定义和缩略语.6 4 服务概述.7 5 序列图.8 5.1 位置信息同步查询.8 5.2 位置信息异步查询(事件触发).8 5.3 位置信息异步查询(周期性触发).9 6 数据类型.10 6.1 经
2、纬度值.10 6.2 精度值.10 6.3EnteringLeavingCriteria.10 6.4LocationInfo.11 6.5LocationData.11 6.6RetrievalStatus.11 7 接口定义.12 7.1 接口:TerminalLocation.12 7.1.1 操作:getLocation.12 7.1.2 操作:getTerminalDistance.13 7.1.3 操作:GetLocationForGroup.14 7.2 接口:TerminalLocationNotificationManager.15 7.2.1 操作:StartGeograp
3、hicalNotification.15 7.2.2 操作:StartPeriodicNotification.17 7.2.3 操作:EndNotification.18 7.3 接口:TerminalLocationNotification.19 7.3.1 操作:LocationNotification.19 7.3.2 操作:LocationError.20 7.3.3 操作:LocationEnd.21 8 差错定义.22 8.1ServiceException.22 8.1.1SVC0200:超出系统精度范围.22 8.2Fault:PolicyException.22 8.2.1
4、POL0230:要求的精度不支持.22 8.2.2POL0231:区域性通知不可用.22 8.2.3POL0232:周期性通知不可用.22 8.2.4POL0901:Duration 值超过限度.23 9 服务策略.24 Q/CT XXXX.1-2008 中国电信综合业务接入网关(ISAG)开放接口技术规范 3 前言 本系列规范由八项规范组成,名称如下:中国电信综合业务接入网关 ISAG 总体技术规范 中国电信综合业务接入网关 ISAG 设备技术规范 中国电信 ISAG Router 设备技术规范 中国电信综合业务接入网关 ISAG 开放接口技术规范 中国电信综合业务接入网关 ISAG 协议映
5、射南向接口技术规范 中国电信综合业务接入网关 ISAG 路由接口技术规范 中国电信综合业务接入网关 ISAG 业务流程技术规范 中国电信综合业务接入网关 ISAG 业务测试规范 本系统规范主要依据 3GPP 和 OMA 的有关规范和信息产业部颁布的相关行业技术标准编制。本规范解释权属于中国电信集团公司。本规范起草单位:中国电信股份有限公司上海研究院。Q/CT XXXX.1-2008 4 中国电信综合业务接入网关(ISAG)开放接口技术规范 1 范围范围 IT 领域的第三方业务提供商可以通过综合业务接入网关访问和使用电信网络的业务能力。本规范规定了中国电信综合业务接入网关向第三方提供的电信网络业
6、务能力,描述了这些业务能力的应用开发接口(API),用于指导综合业务接入网关的设计开发及 CP/SP 接口应用。本规范适用于中国电信移动业务网络综合业务接入网关(ISAG)的设备提供商及与此相关的内容提供商、服务提供商。为综合业务接入网关设备制造、工程设计和网络运行、管理和维护等方面提供技术依据。Q/CT XXXX.1-2008 中国电信综合业务接入网关(ISAG)开放接口技术规范 5 2 规范引用性文件规范引用性文件 下列文件中的条款通过本企业技术标准的引用而成为本企业技术标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修改版均不适用于本标准,然而,鼓励根据本标准达
7、成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。1 中国电信综合业务接入网关 ISAG 总体技术规范 2 3GPP,TS 29.198 Open Service Access(OSA);Application Programming Interface(API)3 ETSI ES 202 391-2 4 Parlay Group,Parlay 4.0 Parlay X Web Services Specification Q/CT XXXX.1-2008 6 中国电信综合业务接入网关(ISAG)开放接口技术规范 3 缩略语缩略语 缩略语缩略语 英文
8、全名英文全名 中文全名中文全名 AOMT ApplicationOriginated MobileTerminated 应用发起,终端终止 CP Content Provider 内容提供商 GMLC GateWay Mobile Location Center 网关移动位置中心 GMSC GateWay Mobile Location Center 网关移动交换中心 HLR Home Location Register 归属位置寄存器 IDE Integrated Development Environment 集成开发环境 IN Intelligent Network 智能网 IP Int
9、elligent Peripheral 智能外设 ISAG Integrated Service Access Gateway 综合业务接入网关 ISMP Integrated Service Management Platform 综合业务管理平台 MOAT MobileOriginated ApplicationTerminated 终端发起,应用终止 MSC Mobile Switch Center 移动交换中心 MSISDN Mobile Station International Subscriber Directory Number 移动用户 ISDN 号 NAG Network
10、Access Gateway 网络接入网关 OME Open Messaging Enabler 开放消息使能器 OSA Open Service Access 开放业务访问 OSS Operation Support System 运营支撑系统 PS Presence Server 呈现服务器 PHS Personal Handset System 个人手持电话系统 PSWAP Presence ServerWireless Application Protocol 呈现服务器无线应用协议 SCP Service Control Point 业务控制点 SCS Service Capabil
11、ity Server 业务能力服务器 SE Service Enabler 业务引擎 SLA Service Level Agreement 业务层协议 SMSGW Short Message Gateway 彩信网关(PHS)SP Services Provider 业务提供商 VLR Visit Location Register 拜访位置寄存器 VMSC Visit Mobile Switch Center 拜访地移动交换中心 MPSS Mobile Payment Service System 移动支付服务系统 Watcher Watcher 观察者 Q/CT XXXX.1-2008
12、中国电信综合业务接入网关(ISAG)开放接口技术规范 7 4 服务服务概述概述 Parlay X 终端位置 Web Service 用于获取用户的位置信息。本 Web Service 的使用不要求开发者有任何特殊的电信技能,但要具备位置坐标的知识。Q/CT XXXX.1-2008 8 中国电信综合业务接入网关(ISAG)开放接口技术规范 5 序列图序列图 5.1 位置信息同步查询位置信息同步查询 应用向 GW 查询一个或一组用户位置信息,网关同步返回位置信息告知应用。图 5.1 位置信息查询示例 5.2 位置信息异步查询(事件触发)位置信息异步查询(事件触发)应用调用一次位置请求,指定范围区域
13、。在查询周期内,用户进入指定区域或离开指定区域,网络将上报用户位置信息。Q/CT XXXX.1-2008 中国电信综合业务接入网关(ISAG)开放接口技术规范 9 图 5.2 位置事件触发查询示例 5.3 位置信息异步查询(周期性触发)位置信息异步查询(周期性触发)应用可以调用一个 API 请求,网络按一定频率周期性上报用户位置信息。图 5.3 位置周期性查询示例 Q/CT XXXX.1-2008 10 中国电信综合业务接入网关(ISAG)开放接口技术规范 6 数据类型数据类型 6.1 经纬度值经纬度值 由于 ISO 6709 7规范中的经纬度采用了十进制的度,所以本文档中的经纬度值遵循其约定
14、。纬度值以浮点数(-90.0000-+90.0000)形式表示,单位为十进度的度(方向与分钟和秒钟相返),正值表示赤道以北,负值表示赤道以南。经度值以浮点数(-180.0000-+180.0000)形式表示,单位为十进度的度(方向与分钟和秒钟相返),正值表示本初子午线(格林威治)以东,负值表示本初子午线(格林威治)以西,直到第 180 条子午线。6.2 精度精度值值 在有些操作中会使用两种精度值,该值表示了 Web Service 所提供的位置应用要求。对该值的选择将会影响 SP 对业务的计费。参数”requested accuracy”表示应用期望获取位置信息的范围,该参数与采用位置技术相关
15、。(例如,在请求精度为 1000 米是,可采用 CELL 扇区定位,而对于低于 100 米请求精度时,则需要采用 GPS 定位技术)参数”acceptable accuracy”表示应用认为的可用位置范围,超出该范围,应用则不希望返回相应的位置信息。如,在一个出租车定位业务中,如果定位距离用户最近的出租车结果不在 1000 米范围内,则不予考虑。该方法可减少用户满意度问题,因为对于无用数据可进行适当计费处理。(如 SP 对于该结果可不计费)6.3 EnteringLeavingCriteria 数据类型:枚举型 名称名称 描述描述 Entering 进入服务区 Leaving 离开服务区 Q/
16、CT XXXX.1-2008 中国电信综合业务接入网关(ISAG)开放接口技术规范 11 6.4 LocationInfo 数据类型:结构型 名称名称 类型类型 描述描述 address xsd:anyURI 终端地址 latitude xsd:float 纬度 longitude xsd:float 经度 altitude xsd:float 高度(可选)accuracy xsd:int 精度,以米为单位(可选)timestamp xsd:dateTime 用户位置报告的时间 6.5 LocationData 数据类型:结构 名称名称 类型类型 描述描述 reportStatus Retri
17、evalStatus 位置报告状态 currentLocation LocationInfo 终端位置信息 errorInformation common:ServiceError 当 ReportStatus 为“Error”时,错误原因值。6.6 RetrievalStatus 数据类型:枚举型 值值 描述描述 Retrieved 重新获得位置信息 NotRetrieved 位置信息无法获得 Error 查询位置时,异常出错 Q/CT XXXX.1-2008 12 中国电信综合业务接入网关(ISAG)开放接口技术规范 7 接口定义接口定义 7.1 接口接口:TerminalLocation
18、 该接口适用于 APP 侧触发,发起呼叫请求。包括四个 API:GetLocation:查询位置信息。GetTerminalDistance:查询终端与特定点间的距离。7.1.1 操作操作:getLocation 查询一个终端用户的位置信息。7.1.1.1 输入输入:getLocationRequest 参数名参数名 类型类型 描述描述 addresses xsd:anyURI 终端地址组 requestedAccuracy xsd:int 要求精度,以米为单位 acceptableAccuracy xsd:int 可接受的精度,以米为单位 7.1.1.2 输出输出:getLocationRe
19、sponse 参数名参数名 类型类型 描述描述 result LocationInfo 位置查询结果 7.1.1.3 差错差错 ServiceException from 3GPP TS 29.199-1 6:SVC0001:Service error.SVC0002:Invalid input value.SVC0200:Accuracy out of limit.Q/CT XXXX.1-2008 中国电信综合业务接入网关(ISAG)开放接口技术规范 13 PolicyException from 3GPP TS 29.199-1 6:POL0001:Policy error.POL0002
20、:Privacy error.POL0006:Groups not allowed.POL0230:Requested accuracy not supported.7.1.2 操作操作:getTerminalDistance 查询一个与某个特定位置间的距离,该特定的位置以经度和纬度来表示。7.1.2.1 输入输入:getTerminalDistanceRequest 参数名参数名 类型类型 描述描述 address xsd:anyURI 终端地址 latitude xsd:float 指定位置的纬度 longitude xsd:float 指定位置的经度 7.1.2.2 输出输出:getTe
21、rminalDistanceResponse 参数名参数名 类型类型 描述描述 result xsd:int 终端与指定点间的距离,以米为单位 7.1.2.3 差错差错 ServiceException from 3GPP TS 29.199-1 6:SVC0001:Service error.SVC0002:Invalid input value.PolicyException from 3GPP TS 29.199-1 6:POL0001:Policy error.Q/CT XXXX.1-2008 14 中国电信综合业务接入网关(ISAG)开放接口技术规范 POL0002:Privacy
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中国电信 综合 业务 接入 网关 ISAG 开放
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【w****g】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【w****g】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。