北斗位置服务平台数据接口规范

XXXX发布DataInterfaceSpecificationofBeidouLocationService2024-XX-XX发布IDB1X/TXXXX-2024 9DB1X/TXXXX-2024前言本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。起草单位：本文件主要起草人：DB1X/TXXXX-2024北斗卫星导航系统作为我国自主建设、独立运行且极具影响力的时空信息基础设施，已深度融入众多行业领域，其中北斗三号更是凭借其卓越性能，让北斗应用迎来新的发展契机。北斗位置服务平台在整个北斗应用生态中扮演着核心枢纽角色，其数据接口的规范与否直接关系到北斗服务的质量与拓展。在测绘基准方面，确保其合法性与唯一性至关重要，如今面对北斗数据的接入与管控时，因数据质量也参差不齐、缺乏统一且完善的数据接口规范，导致数据来源繁杂、格式各异，使得测绘基准的合法性与唯一性难以有效保障，。同时，各行业间迫切需要进行数据共享以实现协同发展，但数据接入环节的不规范，使得不同系统之间的数据交互困难重重，跨行业的数据融合应用受到极大阻碍。本地方标准的制定能够保障数据准确传输与共享，推动北斗位置服务在各行业的标准化应用，促进跨行业数据融合与创新发展，进而提升北斗系统服务经济社会发展的综合能力。河北省自然资源档案馆作为起草单位，将该标准向省内推荐参考，并面向省内北斗高精度应用使用。1DB1X/TXXXX-2024北斗位置服务平台数据接口规范本标准规定了北斗位置服务平台数据接口规范，包括平台组成、接口功能及关系、接口数据格式及调用方式、错误处理机制、测试与验证和示例代码。本标准适用于河北省内使用河北北斗位置服务平台进行分米级、厘米级及毫米级的定位服务的用户。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T11457信息技术软件工程术语GB/T39267北斗卫星导航术语GB/T39607卫星导航定位基准站数据传输和接口协议BD410003A北斗/全球卫星导航系统（GNSS）接收机差分数据格式（二）NMEA-0183美国国家海洋电子协会制定的通讯协议3术语和定义GB/T11457和GB/T39267界定的以及下列术语和定义适用于本文件。3.1数据接口数据对外应用开发接口服务标准化，满足个性化数据需求。3.2北斗位置服务平台提供北斗基准站数据接入、数据管理、数据解算，具备分米级、厘米级实时定位和毫米级事后定位能力。3.3行业应用系统接收北斗位置服务平台的原始观测数据和各类数据产品，并针对行业应用特点进行北斗地基增强数据处理，形成支持行业深度应用的数据产品的系统。2DB1X/TXXXX-20243.4原始观测数据接收机接收到导航卫星的信号后输出的伪距、载波相位、多普勒频移、载噪比等数据。[来源：GB/T39607卫星导航定位基准站数据传输和接口协议]3.5差分一种改进无线电导航系统定位精度的技术。通过确定已知位置的定位误差，随后将该误差或校正因子发送给在相同地理区域内使用同一个无线电导航系统信号源的用户。[来源：GB/T39267北斗卫星导航术语]4缩略语下列缩略语适用于本文件。API：应用程序编程接口（ApplicationProgrammingInterface）ID：身份标识号缩写，具有唯一性（Identitydocument）IMEI：国际移动设备识别码，即设备序列号，具有唯一性（InternationalMobileEquipmentIdentity）JSON：JS键值对数据（JavaScript0bjectNotation）NTRIP：通过互联网进行RTCM网络传输的协议（NetworkedTransportofRTCMviaInternetProtocol）RTCM：国际海运事业无线电技术委员会标准协议（RadioTechnicalCommissionforMaritimeServices）RINEX：与接收机无关的数据交换格式（ReceiverIndependentExchangeFormat）TCP/IP：传输控制/网络通信协议（TransmissionControlProtocol/InternetProtocol）5平台组成北斗位置服务平台实现从数据接入到用户对外服务的一体化服务流程，具备北斗数据汇集与分析系统、北斗数据解算系统、北斗高精度服务监测评估系统、北斗高精度产品共享服务系统、北斗高精度服务运行管理系统等基本功能，实现业务线上化、数据安全化、位置服务高精度海量化等。6接口功能及关系6.1接口功能6.1.1北斗位置服务平台与基准站/共享基准站之间的接口主要用于接收原始观测数据，为北斗位置服务平台数据处理提供数据基础。6.1.2北斗位置服务平台与行业应用系统的接口，用于向各行业提供高精度的格网差分改正数，各行业应用系统可以通过标准化接口从北斗位置服务平台获取相关产品数据（轨道产品、电离层产品和误差修正产品等）。6.1.3北斗位置服务平台与用户的接口，用户通过用账号和密码登陆后，可以从北斗位置服务平台获取差分改正数及其他增值服务。3DB1X/TXXXX-20246.2接口连接关系北斗位置服务平台接口包括与基准站/共享基准站接口、与行业应用系统之间的接口、与用户之间的接口。具体接口关系见图1，图中箭头方向为数据流方向。图1北斗位置服务平台的接口关系6.3输入及输出接口北斗位置服务平台输入输出的接口类型、发送方、接收方及信息内容情况见表1。表1北斗位置服务平台的接口情况序号接口类型发送方接收方协议123457接口数据格式及调用方式7.1数据交换格式北斗位置服务平台接口采用以下标准数据格式:a)RTCM：用于观测数据传输，适用于NTRIP协议；b)格网差分改正数：用于北斗位置服务平台向行业系统发送格网差分改正数，适用于TCP协议；c)数据产品文件：数据产品（如轨道、电离层、误差修正产品）采用CSV或RTCM格式文件，通过FTP下载。4DB1X/TXXXX-20247.2接口调用协议北斗位置服务平台接口采用以下接口调用协议:a)TCP/NTRIP协议：用于基准站、行业应用系统、用户和平台之间的数据传输；b)FTP：用于平台产品的数据下载。7.3基准站输入接口7.3.1输入内容输入内容主要为：BDS（B1/B2/B3）系统的原始观测数据、站点信息。这些数据分别包括：a)原始观测数据：包括码伪距、信噪比、载波相位值、多普勒频移、卫星广播星历等；b)基准站物理信息：电池电量、环境温度、CPU温度等；c)站点信息：包括站名、精确坐标、天线信息等。7.3.2输入频度基准站输入到北斗位置服务平台的数据输入频度和类型见表2。表2数据输入频度和类型数据类型输入频度7.3.3输入格式基准站数据输入格式采用RTCM3.3、RTCM3.4格式，RTCM电文按照BD410003A执行。7.4用户获取差分数据接口7.4.1输入内容用户发送GGA数据给北斗位置服务平台，获取相应的差分改正数。7.4.2输入格式用户定位数据输入格式采用GGA格式，GGA数据格式遵循NMEA-0183标准。7.4.3输出内容用户从平台获取差分数据时，北斗位置服务平台提供的输出内容主要包括当前定位的差分改正数。7.4.4输出参数平台输出格式采用RTCM3.3、RTCM3.4格式，RTCM电文按照BD410003A执行。7.4.5获取方式用户使用NTRIP协议获取差分数据。7.5行业应用系统获取接口7.5.1输出内容行业应用系统从平台获取数据包括:a)格网数据包括特定区域的格网节点及其对应的误差修正值或电离层延迟数据；5DB1X/TXXXX-2024b)数据产品包括轨道产品文件、电离层产品文件和误差修正产品文件。7.5.2输出参数平台输出格式采用RTCM3.3、RTCM3.4格式，RTCM电文按照BD410003A执行。7.5.3获取方式行业应用系统使用TCP协议获取格网数据，使用FTP协议下载轨道产品文件、电离层产品文件和误差修正产品文件。8错误处理机制北斗位置平台错误状态码说明见表3。表3平台错误状态码错误码描述解决方法检查请求的格式和参数，确保符合NTRIP协议的提供正确的用户名和密码进行身份验证/检查身份FTP接口的响应是FTP服务器返回的状态码，表示文件下载的结果。FTP文件下载状态码及其含义如表4所示。表4FTP文件下载状态码状态码描述FTP文件下载可能的错误码以及对应的处理方式如表5所示。表5FTP文件下载错误码错误码码描述解决方法操作失败（文件不存在或权限不6DB1X/TXXXX-2024错误码码描述解决方法9测试及验证9.1基准站数据输入测试：基准站能够通过TCP或者NTRIP协议发送RTCM数据至平台，且平台能正确接收和处理数据，测试流程如下：a)使用NTRIP/TCP协议模拟基准站连接，上传符合RTCM格式的样本数据，观察平台的数据接收情况；b)断开连接后重新连接，验证平台是否能够正常恢复接收数据；c)在上传过程中断开连接，然后重新连接，验证平台是否能够正常恢复接收数据，并检查是否有数据丢失或重复处理的情况；d)上传不符合RTCM格式的数据，验证平台的错误处理机制，确认平台能否识别并拒绝错误数据，同时记录错误日志。9.2用户获取校验：验证用户认证接口是否能成功实现用户身份验证，测试流程如下：a)输入有效和无效的用户名/密码组合，确认接口返回正确的授权或错误信息；b)测试用户名、密码的边界条件（例如最大长度），确保接口能正确处理极端输入。9.3产品下载测试：验证产品是否可以通过FTP下载，测试流程如下：a)用户登录请求FTP服务器，FTP服务器可以正常登陆；b)用户获取产品文件列表，用户可以获取产品文件列表；c)用户下载产品文件，产品文件可以正常下载；d)用户未登录、下载权限不足、URL过期等，平台能否返回正确的错误信息。7DB1X/TXXXX-2024附录A示例代码A.1获取源列表表1获取源列表GET获取源列表User-Agent:NTRIP<product