# 简介
918博天堂官网封装了高精度实时定位服务相关 API(Ntrip 协议) 的 Java SDK,降低开发者集成难度,能方便快速调试和接入高精度实时定位服务。
# 开发环境
环境:JDK 7 版本及以上。
# 配置安装
1.准备918博天堂官网提供的最新版本的 SDK jar 包。例如:"starlocation-ntrip-java.jar";
2.项目根目录下新建 libs 目录将 jar 包放入其中;
3.配置依赖库,在 pom.xml 中引入 jar 包,并加入 netty 依赖,如下所示:
<dependencies>
<dependency>
<groupId>io.netty</groupId>
<artifactId>netty-all</artifactId>
<version>4.1.10.Final</version>
</dependency>
<dependency>
<groupId>cn.starcart</groupId>
<artifactId>sdk</artifactId>
<version>1.0</version>
<scope>system</scope>
<systemPath>${project.basedir}/libs/starlocation-ntrip-java.jar</systemPath>
</dependency>
</dependencies>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
4.在 pom.xml 中将 java 版本配置为 1.7 及以上,如下:
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.7</source>
<target>1.7</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
</plugins>
</build>
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
# 示例
//TODO 请填写申请下来的信息,demo示例给出的值不可用,详见SDK文档说明
String userName = "***";
String userPassword = "***";
StarLocationService starLocationProService = StarLocationFactory.getStarLocationProService(userName, userPassword);
// gga位置信息,设置为用户当前位置
// 比较合适的做法是使用设备定位出来的位置,以下为广州地区的一个位置,demo示例仅供参考
String gga = "$GPGGA,031323,2306.00,N,11320.00,E,4,31,0.5,69.3891,M,-6.6544,M,01,0001*62";
// 发起服务请求,本示例以厘米级定位服务为例
starLocationProService.requestLocRtcmUpdate(new StarLocationListener() {
public void onRtcmDataChanged(LocRtcmData locRtcmData) {
//获取RTCM数据
byte[] vrsRtcm = locRtcmData.getRtcmMessage();
// TODO 根据自身需求处理rtcm数据,这里进行长度的打印
System.out.println("locRtcmData:" + vrsRtcm.length);
}
public void onState(Status wzRtcmStatus) {
//获取状态码信息
System.out.println("onState:" + wzRtcmStatus);
}
}, gga);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
更多示例,请下载工程示例 (opens new window)。
# 接口说明
← openAPI接入 androidSdk →