uber h3地图网格，点，区域获得六边形网格，java客户端

最新推荐文章于 2025-07-16 21:19:18 发布

原创最新推荐文章于 2025-07-16 21:19:18 发布 · 3k 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言

uber h3 专栏收录该内容

1 篇文章

订阅专栏

文章介绍了Uber的H3六边形空间索引系统，用于将经纬度转换为可聚合的H3索引。H3有16个层级，层级越高，网格划分越精细。文章提供了一个Java示例，展示如何使用H3Core库进行坐标转换和区域网格化，并提到了faceIJK编码方式。此外，还讨论了如何获取特定层级的全量网格索引。

因为工作需要用到六边形地图网格，所以接触到了uber h3

网上资料并不是太多，在这里记录一下

首先介绍一下

H3 是 uber 设计的六边形空间索引，可以通过经纬度获取所在的 h3 六边形边界，每个经纬度对应的六边形都是确定的，每个六边形唯一对应了一个 h3index。在业务开发中，我们可以通过 h3index 来对地理空间中的对象做聚合，本质还是将经纬度查询转换成了 h3index 的查询。

h3的层级，h3一共0-15有16个层级，从低到高，划分的粒度逐渐越来越细致,网格数也越来越多，注意它是由六边形和五边形共同组成的；

具体为什么，可以看看设计根源和官方资料，先跑起来，出现效果才有兴趣！

可以看看这个：https://blog.csdn.net/whynottrythis/article/details/129765463?spm=1001.2014.3001.5506

再说说uber在进行网格编码时，如何做的，对于如此庞大数量的网格索引，官方也是采用一种faceIJK坐标系的编码方式，可以看看：http://it.taocms.org/04/25109.htm （我以为会是树形结构存储呢）

下面看看案例

我使用的是JAVA版

<!--h3地图网格,如果和区域相关，建议使用此版本-->
<dependency>
    <groupId>com.uber</groupId>
    <artifactId>h3</artifactId>
    <version>4.1.1</version>
</dependency>

案例，根据提到的写相应接口就可以了

package com.lipengg.controller;

import com.uber.h3core.H3Core;
import com.uber.h3core.util.LatLng;

import java.io.IOException;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;

/**
 * @author lipengg
 * @date 2023/4/17
 */
public class Test {
    public static void main(String[] args) throws IOException {

        H3Core h3Core = H3Core.newInstance();

        // 将一个经纬度坐标和层级转换为h3区域
        // 获得的meshIndex时long类型网格索引
        long meshIndex = h3Core.latLngToCell(30.0, 30.0, 2);
        System.out.println("meshIndex:"+meshIndex);
        // 将网格索引变为六边形区域
        List<LatLng> latLngs = h3Core.cellToBoundary(meshIndex);
        System.out.println("六边形区域："+latLngs);

        // 在4.1.1中有获取区域的索引，相信用到这个的人挺多
        List<LatLng> areas = new ArrayList<>();
        areas.add(new LatLng(66.66,55.55));
        areas.add(new LatLng(33.33,55.55));
        areas.add(new LatLng(33.33,77.77));
        areas.add(new LatLng(66.66,77.77));
        // 区域内的网格索引
        List<Long> longs = h3Core.polygonToCells(areas, null, 2);
        // 转换为六边形
        for (Long aLong : longs) {
            // 将网格索引变为六边形区域
            List<LatLng> latLngList = h3Core.cellToBoundary(aLong);
//            System.out.println(latLngList);
        }

        // 如何获取某一层级下的全量网格呢？api中只提供了0层级的全量网格，往下看
        // 0层级下的全量网格
        Collection<Long> res0Cells = h3Core.getRes0Cells();
        // 0层级下的网格个数
        long numCells = h3Core.getNumCells(0);
        System.out.println("层级0下的网格索引数："+numCells);
        // 重点来了，以层级2为例
        int res2IndexNum = 0;
        for (Long res0Cell : res0Cells) {
            // 此时用res0Cell网格索引和子层级2就获取到了子层级下的索引
            // 这里就要注意到h3在存储网格索引时使用的编码结构了，官方叫
            // FaceIJK坐标系，可以参考我帖的链接了解一下
            List<Long> longs1 = h3Core.cellToChildren(res0Cell, 2);
            res2IndexNum = res2IndexNum + longs1.size();
        }
        System.out.println("层级2下的网格索引数："+res2IndexNum);

    }
    
}

官方api文档
其余的可以参考api文档，我当初也是看了文档才知道
https://h3geo.org/docs/api/indexing