h3-pg

PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.

1. Zainstaluj rozszerzenie w PostgreSQL poleceniem CREATE EXTENSION h3; — to aktywuje podstawowe funkcje H3 bez wymagania PostGIS. Jeśli chcesz pracować z geometrią i geografią, zainstaluj dodatkowo CREATE EXTENSION h3_postgis; (wymaga PostGIS).

2. Konwertuj współrzędne geograficzne na indeksy H3 za pomocą funkcji h3_latlng_to_cell(latitude, longitude, resolution), gdzie resolution to poziom szczegółowości siatki (0-15). Wynik to unikalny identyfikator komórki heksagonalnej.

3. Używaj operatora <-> do obliczania odległości między komórkami: SELECT h3index_a <-> h3index_b; zwraca liczbę komórek między dwoma punktami. Operator @ pozwala indeksować geometrię na danym poziomie rozdzielczości: SELECT geom @ resolution;.

4. Konwertuj komórki H3 na geometrię za pomocą rzutowania h3index::geometry, które zwraca centroid komórki jako punkt POINT z SRID 4326. Dla granic komórki użyj h3_cell_to_boundary_geometry(h3index), która zwraca wielokąt.

5. Wypełniaj wielokąty komórkami H3 funkcją h3_polygon_to_cells(geometry, resolution), która zwraca zbiór wszystkich indeksów H3 pokrywających dany wielokąt — przydatne do indeksowania obszarów.

6. Jeśli pracujesz z danymi rastrowymi, zastosuj h3_raster_summary(raster, resolution) do obliczenia statystyk (liczba, suma, średnia, odchylenie standardowe, min, max) dla każdej komórki H3 — funkcja automatycznie agreguje piksele raster do siatki.