h3-pg
Rozszerz PostgreSQL o heksagonalną siatkę H3 do analiz przestrzennych i indeksowania
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
h3-pg to rozszerzenie PostgreSQL, które integruje system heksagonalnej siatki H3 bezpośrednio w bazie danych. Umożliwia pracę z komórkami H3 poprzez operatory przestrzenne, indeksowanie, konwersję geometrii i analizę rastrów. Dostępne są dwa moduły: podstawowy h3 (bez zależności PostGIS) oraz h3_postgis (z pełną integracją PostGIS). Narzędzie oferuje operatory odległości między komórkami, rzutowanie geometrii na punkty, wypełnianie wielokątów komórkami H3 oraz zaawansowaną analizę danych rastrowych z obliczeniami statystycznymi per komórka.
Jak używać
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).
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.
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;.
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.
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.
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.