Repository navigation
Releases
Releases · uber/h3
Release v4.6.0
[4.6.0] - 2026-11-18
Added
- Added
edgeToVertexesfunction, returning the two vertexes at the ends of a directed edge (#1071, #421, #1272) - Added
reverseDirectedEdgeto H3 CLI. (#1252) - Added
isValidIndexto H3 CLI (#1251) - Added NDJSON-file based test suite (#1230)
Changed
clang-formatupgraded to version 23. The version is now pinned indev-requirements.txtand can be installed withpip 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
devDependenciesas 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
maxPolygonToCellsSizeExperimentaltaking 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,cellAreaKm2andcellAreaM2for 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
gridRingwhen passed a negativek(#1235) - Avoid signed integer overflow when accumulating vertex counts in
maxPolygonToCellsSize(#1204, #1231) - Fixed the
polygonToCellsfuzzer 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-tidywhen the user explicitly setENABLE_FORMAT=OFF/ENABLE_LINTING=OFF(#1158, #1191) - Fixed an out of bounds read in
_baseCellToCCWrot60when passed a face index equal toNUM_ICOSA_FACES(#978, #1224) - Fixed the
stringToIntCLI subcommand truncating 16 digit indexes, such as directed edges and vertexes (#1243) - Fixed the
gridDistanceCLI subcommand printing the distance in hexadecimal instead of decimal (#1244) - Fixed
cellToLatLngandcellToBoundarylosing precision in latitude near the poles; the worst error is now within a few units in the last place everywhere instead of growing as1/cos(latitude)(#1255) - Fixed
cellAreaM2CLI test not setting the C locale (#1176) - Clamp polygon bbox latitudes to the valid sphere range, fixing
polygonToCellsExperimentalspending a long time on tiny input (#1226) - Fixed
clang-tidydeprecated 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
dirFacesinvertexRotationsto silence a-Wmaybe-uninitializedwarning on some compilers/toolchains (#458, #582, #1273)
Release v4.5.0
[4.5.0] - 2026-05-21
Added
cellsToMultiPolygonfunction (#1104, #1113)reverseDirectedEdgefunction (#1098)- Bidirectional
gridPathCells(#1111) h3.pcpkg-config file (#1115)
Changed
cellsToLinkedMultiPolygonnow usescellsToMultiPolygoninternally (#1126, #1133, #1136)cellsToLinkedMultiPolygon(andcellsToMultiPolygon) now return errors for invalid cells (E_CELL_INVALID), mixed resolutions (E_RES_MISMATCH), and duplicate cells (E_DOMAIN) instead of producing undefined output
cellAreaRads2usesgeoLoopArea(#1101)- Refactor of indexing code to use Vec3d (#1145, #1155)
- Refactor of CoordIJK code to be inlineable (#1154)
Fixed
Release v4.4.1
Release v4.4.0
[4.4.0] - 2025-11-06
Added
getIndexDigitfunction for inspecting specific index digits of an H3 index. (#1024, #1042)isValidIndexfunction (#1056, #1079)constructCellfunction (#1063, #1074, #1078)- New
H3_INDEX_INVALID,E_BASE_CELL_DOMAIN,E_DIGIT_DOMAIN,E_DELETED_DIGITerror codes andH3_ERROR_END(#1063, #1064, #1065)
Changed
- Updated minimum version of macOS in CI. (#1069)
Release v4.3.0
Release v4.2.1
Release v4.2.0
[4.2.0] - 2024-12-04
Added
- Added experimental new algorithm for
polygonToCells, calledpolygonToCellsExperimental, that supports more containment flags and is more memory-efficient (#785, #800, #947) h3binary for shell scripts ready for use (#818, #826, #846, #923, #924, #931, #933)
Fixed
- Fixed compacting all or many resolution 1 cells (#919)
Changed
compactCellsinternally 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-formatupgraded to version 14. (#834)- Fixed tests that incorrectly did not test resolution 15. (#820)
- Use
CMAKE_INSTALL_LIBDIRwhen choosing where to install library files. (#819)
Release v4.1.0
Release v4.0.1
[4.0.1] - 2022-09-15
Fixed
- Changing an internal
floattodoubleimproves 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
Release v4.0.0
[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
H3Errorreturn value. (#617, #586, #581, #551, #550, #509, #505, #507, #508, #503, #478, #468, #436, #359) - Cell count parameters use
int64_tinstead ofint. polygonToCells(previouslypolyfill) accepts a flags argument for future expansion. (#570)cellToLocalIjandlocalIjToCellaccept a mode argument for future expansion. (#586)exactEdgeLengthfunctions renamed toedgeLength(#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)
polygonToCellsreturns an error if Infinity is passed in. (#636)
Changed
- The file
CMakeTests.cmakeis no longer included ifENABLE_TESTINGis off. (#609)
Added
- Vertex mode and associated functions: (#422, #420, #417)
cellToVertex(cell, vertexNum)cellToVertexes(cell, out)vertexToLatLng(vertex, out)isValidVertex(vertex)
h3CLI application. (#556, #497)