H3 grid distance
The number of grid steps between two cells of the same resolution.
The cells are 10 grid steps apart.
Provenance
- Computed by
- indexing.h3.grid-distance 1.0.0, core 0.1.0
- Model
- H3 v4 (h3o 0.11)
- Accuracy
- Identical to H3 C; coordinates within 1e-12° below 88° latitude, 5e-11° nearer the poles; areas within 6e-15 relative at resolution 0 and 2e-8 at resolution 15, where the 1 m² cell's spherical excess runs out of digits
- Notes
- None
- Cites
- Uber Technologies and the H3 contributors, H3: A Hexagonal Hierarchical Geospatial Indexing System (API reference v4); Hydronium Labs, h3o: a Rust implementation of H3
Something look off?
How we got thisFormula, worked example, sources, and proof
Model: H3 v4 (h3o 0.11)
Accuracy: Identical to H3 C; coordinates within 1e-12° below 88° latitude, 5e-11° nearer the poles; areas within 6e-15 relative at resolution 0 and 2e-8 at resolution 15, where the 1 m² cell's spherical excess runs out of digits
When to use this: Use this to measure how far apart two H3 cells are in the grid itself, for neighborhood queries, smoothing radii, or checking a k-ring size. Enter two cells of the same resolution. The tool returns the number of steps between them, the k of the smallest ring around one that reaches the other.
Limitations: Grid steps are not ground distance: a step is about one cell's width, which changes across the globe, so use a geodesic tool for meters. The cells must share a resolution, and H3 cannot measure across pentagon distortion or between cells very far apart, where it says so instead of guessing.
Worked example: Two resolution 9 cells in Pittsburgh. Source: H3 v4 API, computed by h3o and checked against H3 C. It is golden test vector v001, and every build checks the tool still gives its answer within its tolerance.
You enter
- From cell
- 892a8471487ffff
- To cell
- 892a84710cbffff
You get
- Grid distance
- 10
Review: Not yet independently reviewed by a GIS professional.
Last verified: 2026-09-18, when a maintainer last confirmed this tool's sources at the issuer. See the sources ledger.
Status: version 1.0.0, core 0.1.0. See this tool in the verification report.
Changes
- 2026-10-14, changed: The fourteen focused H3 operations, from cell-to-latlng through edge-length, are now stable. Each is held to H3 C 4.5.0 through h3-py on 20 or more cases, and a new invariants test checks them together on hexagons and pentagons at five resolutions: centers, edges, vertexes, children, classes, distances, and areas. Results are unchanged. Changelog
Checked against: 21 golden test vectors (download the test vectors, each with its source and tolerance). See how results are checked and every source.
Sources
- H3: A Hexagonal Hierarchical Geospatial Indexing System (API reference v4), Uber Technologies and the H3 contributors, H3 4.x documentation. Indexing, inspection, traversal, hierarchy, directed edges, vertexes, and resolution tables. Read free.
- h3o: a Rust implementation of H3, Hydronium Labs, 0.11.0 (tested against H3 C). CellIndex, LatLng, Resolution. Read free.
Terms
- H3: H3 hexagonal hierarchical index
- A global grid of hexagons (and 12 pentagons) at 16 resolutions, each cell about one-seventh the area of its parent, named by a 15-character index. Source: H3 hexagonal index
H3 — H3 hexagonal hierarchical index
A global grid of hexagons (and 12 pentagons) at 16 resolutions, each cell about one-seventh the area of its parent, named by a 15-character index.
Source: H3 hexagonal index