geoprimsField-grade geospatial math

H3 grid distance

The number of grid steps between two cells of the same resolution.

10

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?

Your values

Showing an example. Change anything.
Run many at once from a CSV

Loading…

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

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

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