geo_point_to_h3cell()
Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Oblicza wartość ciągu tokenu komórki H3 lokalizacji geograficznej.
Przeczytaj więcej na temat komórki H3.
Składnia
geo_point_to_h3cell(długość geograficzna,, [ rozdzielczość ])
Dowiedz się więcej na temat konwencji składni.
Parametry
| Nazwisko | Type | Wymagania | opis |
|---|---|---|---|
| długość | real |
✔️ | Współrzędna geoprzestrzenna, wartość długości geograficznej w stopniach. Prawidłowa wartość to liczba rzeczywista i w zakresie [-180, +180]. |
| szerokość geograficzna | real |
✔️ | Współrzędna geoprzestrzenna, wartość szerokości geograficznej w stopniach. Prawidłowa wartość to liczba rzeczywista i w zakresie [-90, +90]. |
| rezolucja | int |
Definiuje żądaną rozdzielczość komórki. Obsługiwane wartości znajdują się w zakresie [0, 15]. Jeśli nie określono, zostanie użyta wartość 6 domyślna. |
Zwraca
Wartość ciągu tokenu komórki H3 dla danej lokalizacji geograficznej. Jeśli współrzędne lub poziomy są nieprawidłowe, zapytanie spowoduje wygenerowanie pustego wyniku.
Uwaga
- Komórka H3 może być przydatnym narzędziem do klastrowania geoprzestrzennego.
- Komórka H3 ma 16 poziomów hierarchii z pokryciem obszaru od 4250 547 km² na najwyższym poziomie od 0 do 0,9 m² na najniższym poziomie 15.
- Komórka H3 ma unikatowy kształt sześciokąta i prowadzi do pewnych unikatowych właściwości:
- Sześciokąty mają 6 sąsiadów
- Sześciokąty pozwalają nam łatwo przybliżyć promień, a wszyscy sąsiedzi są równoważni
- Sześciokąty są wizualnie przyjemne
- W niektórych rzadkich przypadkach kształt jest pentagonem.
- Komórka H3 ma prostokątny obszar na powierzchni płaszczyzny.
- Wywołanie funkcji geo_h3cell_to_central_point() w ciągu tokenu komórki H3 obliczonego na długości geograficznej x i szerokości geograficznej y nie musi zwracać wartości x i y.
- Możliwe, że dwie lokalizacje geograficzne są bardzo blisko siebie, ale mają różne tokeny komórki H3.
Przybliżone pokrycie obszaru komórki H3 na wartość rozdzielczości
| Poziom | Średnia długość krawędzi sześciokątnych |
|---|---|
| 0 | 1108 km |
| 1 | 419 km |
| 2 | 158 km |
| 3 | 60 km |
| 100 | 23 km |
| 5 | 8 km |
| 6 | 3 km |
| 7 | 1 km |
| 8 | 460 m |
| 9 | 174 m |
| 10 | 66 m |
| 11 | 25 m |
| 12 | 9 m |
| 13 | 3 m |
| 14 | 1 m |
| 15 | 0,5 m |
Źródło tabeli można znaleźć w tym zasobie statystycznym komórki H3.
Zobacz również geo_point_to_s2cell(), geo_point_to_geohash().
Porównanie z innymi dostępnymi systemami siatki. zobacz klastrowanie geoprzestrzenne za pomocą język zapytań Kusto.
Przykłady
print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)
Wyjście
| h3cell |
|---|
| 862a1072fff |
Poniższy przykład znajduje grupy współrzędnych. Każda para współrzędnych w grupie znajduje się w komórce H3 ze średnim sześciokątnym obszarem 253 km².
datatable(location_id:string, longitude:real, latitude:real)
[
"A", -73.956683, 40.807907,
"B", -73.916869, 40.818314,
"C", -73.989148, 40.743273,
]
| summarize count = count(), // Items per group count
locations = make_list(location_id) // Items in the group
by h3cell = geo_point_to_h3cell(longitude, latitude, 5) // H3 Cell of the group
Wyjście
| h3cell | count | locations |
|---|---|---|
| 852a100bfffffff | 2 | [ "A", "B" ] |
| 852a1073fffff | 1 | [ "C" ] |
Poniższy przykład generuje pusty wynik z powodu nieprawidłowych danych wejściowych współrzędnych.
print h3cell = geo_point_to_h3cell(300,1,8)
Wyjście
| h3cell |
|---|
Poniższy przykład generuje pusty wynik z powodu nieprawidłowych danych wejściowych na poziomie.
print h3cell = geo_point_to_h3cell(1,1,16)
Wyjście
| h3cell |
|---|
Poniższy przykład generuje pusty wynik z powodu nieprawidłowych danych wejściowych na poziomie.
print h3cell = geo_point_to_h3cell(1,1,int(null))
Wyjście
| h3cell |
|---|