h3-pg
将Uber的H3六边形地理空间索引系统集成到PostgreSQL中。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：h3-pg。 它的用途是：将Uber的H3六边形地理空间索引系统集成到PostgreSQL中。 完整的 Skill 内容见：https://321skill.com/skills/h3-pg/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在 PostgreSQL 中写一个查询，找出坐标点 (37.3615593, -122.0553238) 在分辨率 5 下的 H3 单元格，并获取其所有相邻单元格。” 它会提供使用 h3_latlng_to_cell 和 h3_grid_disk 等函数的 SQL 示例，帮助你直接在数据库内完成地理空间邻居分析。
介绍
h3-pg 是一个 PostgreSQL 扩展，它将 Uber 开源的 H3 六边形层次化地理空间索引系统的核心功能引入到数据库中。它解决了在数据库层面高效处理地理空间数据（如地理位置聚合、邻近搜索、区域分析）的难题，无需将数据导出到外部系统。
用户可以通过简单的 SQL 函数直接调用 H3 库的强大功能，例如将经纬度坐标转换为 H3 单元格索引、计算单元格间的距离、进行区域填充或 k 环邻居查找等。安装后，这些函数就像内置的 PostgreSQL 函数一样使用。
这个扩展特别适合需要在数据库内进行复杂地理空间计算的后端开发、数据分析师和运维开发人员。无论是处理海量的出行轨迹、用户地理位置，还是进行区域性的商业分析，都能从中受益。
使用前请确保你的 PostgreSQL 版本与扩展兼容。建议在生产环境使用前，在测试环境充分验证其性能和对现有业务逻辑的影响。由于它深度绑定 H3 库的 API，主要适用于已决定采用 H3 索引方案的项目。
核心特点
这是官方认可的、将 H3 C 库核心 API 直接以 PostgreSQL 原生扩展形式提供的方案，与数据库集成度最高，性能损耗小，且支持从 PostgreSQL 14 到 18 的多个版本。不同于一些外部包装库，它允许在 SQL 查询中无缝进行复杂的地理空间运算。
注意事项
主要功能是暴露 H3 核心库的 API，不适合需要超出 H3 原生功能之外的、高度定制化地理空间处理场景。
常见问题
如何在 Ubuntu 上安装 h3-pg？
使用 apt 安装对应 PostgreSQL 版本的包，例如 sudo apt install postgresql-16-h3。
h3-pg 支持哪些 PostgreSQL 版本？
目前 CI 测试支持 PostgreSQL 14 到 18，具体请查看官方仓库的构建状态。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/h3-pg/raw/index.md 读取 h3-pg 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/h3-pg/raw/index.md（查看排版版本）