geo_point_to_h3cell()

Coğrafi konumun H3 Hücre belirteci dize değerini hesaplar.

H3 Hücre hakkında daha fazla bilgi edinin.

Sözdizimi

geo_point_to_h3cell(boylam, enlemi, [ çözünürlük ])

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

Ad	Tür	Zorunlu	Açıklama
boylam	real	✔️	Jeo-uzamsal koordinat, derece olarak boylam değeri. Geçerli değer gerçek bir sayıdır ve [-180, +180] aralığındadır.
enlem	real	✔️	Jeo-uzamsal koordinat, derece olarak enlem değeri. Geçerli değer gerçek bir sayıdır ve [-90, +90] aralığındadır.
çözünürlük	int		İstenen hücre çözünürlüğünü tanımlar. Desteklenen değerler [0, 15] aralığındadır. Belirtilmezse, varsayılan değer 6 kullanılır.

Döndürülenler

Belirli bir coğrafi konumun H3 Hücre belirteci dize değeri. Koordinatlar veya düzeyler geçersizse sorgu boş bir sonuç üretir.

Not

• H3 Hücre kullanışlı bir jeo-uzamsal kümeleme aracı olabilir.
• H3 Hücre, alan kapsamı en yüksek düzey 0 ile 0,9m² arasında en düşük düzey 15 olan 4.250.547km² arasında 16 hiyerarşi düzeyine sahiptir.
• H3 Hücresinin benzersiz bir altıgen şekli vardır ve bu da bazı benzersiz özelliklere yol açar:
• Altıgenlerin 6 komşuları vardır
• Altıgenler kolayca yaklaşık yarıçaplar oluşturmamıza olanak sağlar ve tüm komşular eşit olur
• Altıgenler görsel olarak hoş
• Bazı nadir durumlarda şekil beşgen şeklindedir.
• H3 Hücre, düzlem yüzeyinde dikdörtgen bir alana sahiptir.
• x ve enlem y boylamında hesaplanan bir H3 Hücre belirteci dizesinde geo_h3cell_to_central_point() işlevini çağırmak mutlaka x ve y döndürmez.
• İki coğrafi konumun birbirine çok yakın olması ancak farklı H3 Hücre belirteçlerine sahip olması mümkündür.

H3 Çözünürlük değeri başına yaklaşık alan kapsamı hücresi

Level	Ortalama Altıgen Kenar Uzunluğu
0	1108 km
1	419 km
2	158 km
3	60 km
4	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

Tablo kaynağı bu H3 Hücre istatistiksel kaynağında bulunabilir.

Ayrıca bkz. geo_point_to_s2cell(), geo_point_to_geohash().

Diğer kullanılabilir kılavuz sistemleriyle karşılaştırma için. bkz. Kusto Sorgu Dili ile jeo-uzamsal kümeleme.

Örnekler

Sorguyu çalıştırma

print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)

Çıktı

h3cell
862a1072fffffffff

Aşağıdaki örnek koordinat gruplarını bulur. Gruptaki her koordinat çifti, ortalama altıgen alanı 253 km² olan H3 Hücresinde bulunur.

Sorguyu çalıştırma

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

Çıktı

h3cell	count	konumlar
852a100bfffffff	2	[ "A", "B" ]
852a1073fffffff	1	[ "C" ]

Aşağıdaki örnek, geçersiz koordinat girişi nedeniyle boş bir sonuç üretir.

Sorguyu çalıştırma

print h3cell = geo_point_to_h3cell(300,1,8)

Çıktı

h3cell

Aşağıdaki örnek, geçersiz düzey girişi nedeniyle boş bir sonuç üretir.

Sorguyu çalıştırma

print h3cell = geo_point_to_h3cell(1,1,16)

Çıktı

h3cell

Aşağıdaki örnek, geçersiz düzey girişi nedeniyle boş bir sonuç üretir.

Sorguyu çalıştırma

print h3cell = geo_point_to_h3cell(1,1,int(null))

Çıktı

h3cell