Skip to content

Releases

Release v4.6.0

Choose a tag to compare

@isaacbrodsky isaacbrodsky released this 18 Nov 22:26
33ec628

[4.6.0] - 2026-11-18

Added

  • Added edgeToVertexes function, returning the two vertexes at the ends of a directed edge (#1071, #421, #1272)
  • Added reverseDirectedEdge to H3 CLI. (#1252)
  • Added isValidIndex to H3 CLI (#1251)
  • Added NDJSON-file based test suite (#1230)

Changed

  • clang-format upgraded to version 23. The version is now pinned in dev-requirements.txt and can be installed with pip install -r dev-requirements.txt. (#1319)
  • Added internal Gosper island iterator (#1098, #1215)
  • Test coverage improvements (#1183, #1184, #1185, #1186, #1192, #1193, #1194, #1195, #1196, #1207, #1210, #1214)
  • All website dependencies are marked as devDependencies as they are not part of the C build process (#1206)
  • Added 32 bit Linux builds to CI (#1237)
  • Replace the retired macos-14 CI runner with macos-15-intel (#1292)

Fixed

  • Fixed maxPolygonToCellsSizeExperimental taking unbounded time on very thin or degenerate polygons (for example, all vertices on the same latitude): the size estimate now also coarsens its working resolution based on the longest side of the bounding box, not only its area
  • Fixed precision loss in cellAreaRads2, cellAreaKm2 and cellAreaM2 for cells crossing the antimeridian: the longitude difference of an edge across ±180° was close to 2π, so the tiny true step was lost to rounding and cells at resolution 12 and finer came out up to several percent too small. Both longitudes are now shifted to the same side of the antimeridian before subtracting
  • Fixed an out of bounds write in gridRing when passed a negative k (#1235)
  • Avoid signed integer overflow when accumulating vertex counts in maxPolygonToCellsSize (#1204, #1231)
  • Fixed the polygonToCells fuzzer regression test to use explicit double literals instead of reinterpreting raw bytes, so it is portable across endianness (#964, #1182)
  • No longer emit a CMake warning about a missing clang-format/clang-tidy when the user explicitly set ENABLE_FORMAT=OFF/ENABLE_LINTING=OFF (#1158, #1191)
  • Fixed an out of bounds read in _baseCellToCCWrot60 when passed a face index equal to NUM_ICOSA_FACES (#978, #1224)
  • Fixed the stringToInt CLI subcommand truncating 16 digit indexes, such as directed edges and vertexes (#1243)
  • Fixed the gridDistance CLI subcommand printing the distance in hexadecimal instead of decimal (#1244)
  • Fixed cellToLatLng and cellToBoundary losing precision in latitude near the poles; the worst error is now within a few units in the last place everywhere instead of growing as 1/cos(latitude) (#1255)
  • Fixed cellAreaM2 CLI test not setting the C locale (#1176)
  • Clamp polygon bbox latitudes to the valid sphere range, fixing polygonToCellsExperimental spending a long time on tiny input (#1226)
  • Fixed clang-tidy deprecated setting error (#1216)
  • Fixed possible signed integer overflow in uncompactCellsSize (#1205)
  • Fixed incorrect test suite names (#1294)
  • Fixed CLI exiting with status 0 when an arguments could not be parsed (unknown argument, missing required argument, missing or unparseable value). (#1300, #1312)
  • Initialized dirFaces in vertexRotations to silence a -Wmaybe-uninitialized warning on some compilers/toolchains (#458, #582, #1273)

Release v4.5.0

Choose a tag to compare

@isaacbrodsky isaacbrodsky released this 21 May 22:59
1b536c3

[4.5.0] - 2026-05-21

Added

  • cellsToMultiPolygon function (#1104, #1113)
    • Internal for now, will be added to the public API in a future release
    • destroyGeoMultiPolygon function (#1104)
    • (internal) geoLoopArea function (#1101)
  • reverseDirectedEdge function (#1098)
  • Bidirectional gridPathCells (#1111)
  • h3.pc pkg-config file (#1115)

Changed

  • cellsToLinkedMultiPolygon now uses cellsToMultiPolygon internally (#1126, #1133, #1136)
    • cellsToLinkedMultiPolygon (and cellsToMultiPolygon) now return errors for invalid cells (E_CELL_INVALID), mixed resolutions (E_RES_MISMATCH), and duplicate cells (E_DOMAIN) instead of producing undefined output
  • cellAreaRads2 uses geoLoopArea (#1101)
  • Refactor of indexing code to use Vec3d (#1145, #1155)
  • Refactor of CoordIJK code to be inlineable (#1154)

Fixed

  • CLI handling of invalid cell input (#1125, #1124)
  • destroyLinkedMultiPolygon is now idempotent (safe to call twice) (#1136)

Release v4.4.1

Choose a tag to compare

@ajfriend ajfriend released this 12 Nov 23:40
70d4c9e

[4.4.1] - 2025-11-11

Fixed

  • Proper version set in VERSION file (#1091)

Release v4.4.0

Choose a tag to compare

@isaacbrodsky isaacbrodsky released this 07 Nov 00:13
f8e4cda

[4.4.0] - 2025-11-06

Added

  • getIndexDigit function for inspecting specific index digits of an H3 index. (#1024, #1042)
  • isValidIndex function (#1056, #1079)
  • constructCell function (#1063, #1074, #1078)
  • New H3_INDEX_INVALID, E_BASE_CELL_DOMAIN, E_DIGIT_DOMAIN, E_DELETED_DIGIT error codes and H3_ERROR_END (#1063, #1064, #1065)

Changed

  • Updated minimum version of macOS in CI. (#1069)

Release v4.3.0

Choose a tag to compare

@isaacbrodsky isaacbrodsky released this 17 Jun 20:48
f6d1b0b

[4.3.0] - 2025-06-17

Added

  • Added gridRing function, that works even if encountering pentagon distortion. (#1011, #1013, #1015)

Release v4.2.1

Choose a tag to compare

@isaacbrodsky isaacbrodsky released this 10 Mar 16:04
067d9c7

[4.2.1] - 2025-03-10

Fixed

  • Fixed MSVC/WIN32 checks in CMake. (#981)
  • Fixed potential memory leak in polygonStringToGeoPolygon (#976)

Changed

  • Added arm64 tests in CI. (#975, #974)
  • Faster isValidCell (#968)
  • Moved ContainmentMode enum for polygonToCellsExperimental to h3api.h. (#958)

Release v4.2.0

Choose a tag to compare

@isaacbrodsky isaacbrodsky released this 05 Dec 04:59
2d8a62d

[4.2.0] - 2024-12-04

Added

  • Added experimental new algorithm for polygonToCells, called polygonToCellsExperimental, that supports more containment flags and is more memory-efficient (#785, #800, #947)
  • h3 binary for shell scripts ready for use (#818, #826, #846, #923, #924, #931, #933)

Fixed

  • Fixed compacting all or many resolution 1 cells (#919)

Changed

  • compactCells internally uses int64 for array indexing. (#920)
  • Reorganize tests into public / internal. (#762)
  • Performance enhancement for aarch64, may improve other platforms (#790, #792, #852, #905, #913)
  • clang-format upgraded to version 14. (#834)
  • Fixed tests that incorrectly did not test resolution 15. (#820)
  • Use CMAKE_INSTALL_LIBDIR when choosing where to install library files. (#819)

Release v4.1.0

Choose a tag to compare

@isaacbrodsky isaacbrodsky released this 18 Jan 15:10
5c91149

[4.1.0] - 2023-01-18

Added

  • Functions for cellToChildPos and childPosToCell (#719)

Fixed

  • Fixed possible signed integer overflow in h3NeighborRotations (#707)
  • Fixed possible signed integer overflow in localIjToCell (#706, #735)

Changed

  • assert on defensive code blocks that are not already covered. (#720)
  • clang-format upgraded to version 11. (#734)

Release v4.0.1

Choose a tag to compare

@isaacbrodsky isaacbrodsky released this 15 Sep 19:22
5035cd1

[4.0.1] - 2022-09-15

Fixed

  • Changing an internal float to double improves the precision of geographic coordinate output (#652)
  • Fixed compacting all children of a resolution 0 cell (#679)
  • Fixed possible signed integer overflow in maxGridDiskSize (#686)
  • Fixed possible use of uninitialized values in cellToVertex (#683, #690)
  • Fixed possible out of bounds read in localIjToCell (#684)
  • Fixed possible memory leak in compactCells (#685)
  • Fixed possible out of bounds read in areNeighborCells (#677)
  • Fixed possible memory leak in cellsToLinkedMultiPolygon (#673)

Changed

  • Build script does not use toolchain file (#641)
  • Removed a duplicated include preprocessor directive (#682)
  • Improvements to the fuzzer suite and their automatic runs in CI (#671, #674, #687)
  • Increased test coverage (#642)
  • Added a fuzzer targetting internal algos.c functions (#675)

Release v4.0.0

Choose a tag to compare

@isaacbrodsky isaacbrodsky released this 23 Aug 16:07
90748a4

[4.0.0] - 2022-08-23

Breaking changes

  • Rename functions according to the terminology RFC (#622, #586, #571, #403, #466, #495, #466)
  • Functions that can experience errors now have an H3Error return value. (#617, #586, #581, #551, #550, #509, #505, #507, #508, #503, #478, #468, #436, #359)
  • Cell count parameters use int64_t instead of int.
  • polygonToCells (previously polyfill) accepts a flags argument for future expansion. (#570)
  • cellToLocalIj and localIjToCell accept a mode argument for future expansion. (#586)
  • exactEdgeLength functions renamed to edgeLength (#639)

Fixed

  • Fix polyfill bug when vertex latitude exactly matches cell center. (#603)
  • A number of issues detected via unit tests and fuzzers were fixed. (#568, #562, #558, #559, #560, #430)
  • polygonToCells returns an error if Infinity is passed in. (#636)

Changed

  • The file CMakeTests.cmake is no longer included if ENABLE_TESTING is off. (#609)

Added

  • Vertex mode and associated functions: (#422, #420, #417)
    • cellToVertex(cell, vertexNum)
    • cellToVertexes(cell, out)
    • vertexToLatLng(vertex, out)
    • isValidVertex(vertex)
  • h3 CLI application. (#556, #497)

Other changes

  • Generally use lng instead of lon
  • Closed-form implementation of numHexagons
  • A number of fuzzer harnesses are now included in the H3 core library. (#557, #553, #545, #433)
  • Additional benchmarks are added and benchmarks are regularly run in CI. (#524, #518)