街道经纬度位置转换
API文档全球IP区县级API
全球IP街道级API
全球IP网络风险API
离线API
街道经纬度位置转换
社区版IP库版本
纯真社区版IP库
常见问题
数据隐私说明纯真用户协议纯真隐私政策SDK合规指南街道经纬度转换
纯真街道级API的经纬度信息，通过3种主流的地理空间索引（S2、GeoHash、H3）来进行表示。本文档介绍如何将这3种字符串值转换成实际的经纬度位置。
1 地理空间索引（S2、GeoHash、H3）介绍
1.1 什么是S2？
S2 Geometry Library是 Google 开发的一个非常强大的用于处理球面几何（比如地球）的库，非常适合进行高效的空间索引和地理计算。
S2 的核心概念包括S2 Cell 和 Cell ID等级：
（1）S2 Cell：S2 将地球表面投影到一个立方体上，然后将每个面递归地划分为四个子单元格（四叉树），最终形成一个层次化的网格系统。每个单元格都有一个唯一的 Cell ID（64位整数）作为其编码。
（2）Cell ID 等级 (Level)：S2 的等级（Level，范围 0-30）决定了单元格的大小。等级越高，单元格面积越小，精度越高。比如：
- Level 30：面积约 1 cm²，用于超高精度。
- Level 20：面积约 1.0 km²（常用于街道、小区级别）。
- Level 12：面积约 3.31 km²（常用于城镇、区域级别）。
- Level 0：是 6 个最大的立方体面。
1.2 什么是 GeoHash？
GeoHash 是一种将二维的经纬度编码成一个字符串的公共算法。这个字符串有以下几个特点：
- （1）表示一个矩形区域：字符串越长，表示的精度越高，区域越小。
- （2）前缀匹配：拥有相同前缀的 GeoHash 码，表示它们在空间上是接近的。利用这个特性，可以非常高效地做附近地点搜索。
- （3）简单易用：算法本身不依赖任何本地库。
- （4）集成 GeoHash 库：Java 中有几个成熟的 GeoHash 实现库。最常用的是 java-geohash。你只需要像添加其他 Maven 依赖一样引入它即可。
1.3 什么是H3？
H3-Java 是 Uber 开源的一个 分层六边形地理空间索引系统（H3）的 Java 绑定库。它用于将地球表面划分为六边形的网格，并对地理空间数据进行高效的索引、查询和分析。以下是对 H3-Java 的简要介绍，包括其功能、应用场景、安装使用和常见问题。
H3的核心功能包括：
- （1）地理坐标转换：将经纬度坐标转换为六边形网格地址（H3索引），支持多种分辨率（从0到15级，分辨率逐级提高）。
- （2）网格操作：提供六边形邻居查找、网格路径计算、多边形填充六边形等功能。
- （3）空间分析：支持空间关系判断（如是否包含、相交）、距离计算等。
- （4）跨平台支持，兼容 Linux、Windows、macOS、FreeBSD 和 Android 等多种操作系统和架构。
2 怎么使用S2？
2.1 依赖引入
以JAVA编程为例，首先需要在项目中添加S2 Geometry Library Pom依赖。
<dependency>
<groupId>io.sgr</groupId>
<artifactId>s2-geometry-library-java</artifactId>
<version>1.0.0</version>
</dependency>2.2 S2 Cell ID 解析与坐标转换
/**
* 将 S2 Cell ID 字符串解析为经纬度坐标
* @param s2CellId S2 Cell ID 字符串（如 "89c25a31"）
* @return 经纬度坐标
*/
public class S2GeometryExample {
public static S2LatLng parseS2CellId(String s2CellId) {
try {
S2CellId cellId1 = S2CellId.fromToken(s2CellId);
// 获取区域中心点的经纬度
S2LatLng centerLatLng = cellId1.toLatLng();
System.out.println("Cell 中心点: " + centerLatLng.latDegrees() + ", " + centerLatLng.lngDegrees());
return centerLatLng;
} catch (Exception e) {
throw new IllegalArgumentException("无效的 S2 Cell ID:" + s2CellId);
}
}
}3 怎么使用GeoHash？
3.1 依赖的引入
以JAVA编程为例，首先需要在项目中添加GeoHash Pom依赖。
<dependency>
<groupId>ch.hsr</groupId>
<artifactId>geohash</artifactId>
<version>1.4.0</version>
</dependency>3.2 GeoHash 解析与坐标转换
/**
* 解析 GeoHash 字符串获取中心点坐标
* @param geoHashString GeoHash 字符串
* @return 中心点坐标 [纬度, 经度]
*/
public class GeoHashExample {
public static double[] parseGeoHash(String geoHashString) {
try {
GeoHash geoHash = GeoHash.fromGeohashString(geoHashString);
WGS84Point point = geoHash.getPoint();
return new double[]{point.getLatitude(), point.getLongitude()};
} catch (Exception e) {
throw new IllegalArgumentException("无效的 GeoHash 字符串: " + geoHashString, e);
}
}
}4 怎么使用H3？
4.1 依赖的引入
以JAVA编程为例，首先需要在项目中添加H3-Java Pom依赖。
<dependency>
<groupId>com.uber</groupId>
<artifactId>h3</artifactId>
<version>4.3.1</version>
</dependency>4.2 H3 索引解析与坐标转换
/**
* 解析 H3 索引获取中心点坐标
* @param h3Index H3 索引字符串（十六进制）
* @return 经纬度坐标
*/
public class H3Example {
public static LatLng parseH3Index(String h3Index) {
try {
H3Core h3 = H3Core.newInstance();
return h3.cellToLatLng(h3Address);
} catch (IOException e) {
throw new RuntimeException("初始化 H3Core 失败", e);
}
}
}
