geo_point_to_s2cell()

Coğrafi konumun S2 hücre belirteci dize değerini hesaplar.

S2 hücresi yararlı bir jeo-uzamsal kümeleme aracı olabilir. S2 hücresi küresel bir yüzey üzerindeki hücredir ve jeodezik kenarları vardır. S2 hücreleri, dünya yüzeyini bölen bir hiyerarşinin parçasıdır. En fazla 31 düzeye sahiptir ve bu düzey sıfırdan 30'a kadardır ve bu da bir hücrenin alt bölünme sayısını tanımlar. Seviyeler, 85.011.012.19km² alan kapsamı ile sıfır seviyesindeki en büyük kapsama alanından 30. düzeyde en düşük 0,44 cm² kapsama alanına kadar değişmektedir. S2 hücreleri daha yüksek düzeylerde alt bölümlere ayrılmış olduğundan, hücre merkezi iyi korunur. İki coğrafi konum birbirine çok yakın olabilir, ancak farklı S2 hücre belirteçleri vardır.

Not

x ve enlem y boylamlarında hesaplanan bir S2 hücre belirteci dizesinde geo_s2cell_to_central_point() işlevini çağırırsanız, işlevin mutlaka x ve y döndürmesi gerekmez.

Syntax

geo_point_to_s2cell(Boylam,Enlem, [ düzey ])

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

Parametreler

Ad	Tür	Gerekli	Açıklama
Boylam	real	✔️	Jeo-uzamsal koordinat, boylam değeri derece olarak. Geçerli değer gerçek bir sayıdır ve [-180, +180] aralığındadır.
latitude	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.
Düzey	int		İstenen hücre düzeyini tanımlar. Desteklenen değerler [0, 30] aralığındadır. Belirtilmemişse, varsayılan değer 11 kullanılır.

Döndürülenler

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

Düzey değeri başına S2 hücre yaklaşık alan kapsamı

Her düzey için S2 hücresinin boyutu benzerdir ancak tam olarak eşit değildir. Yakındaki hücre boyutları daha eşit olma eğilimindedir.

Level	En düşük rastgele hücre kenar uzunluğu (Birleşik Krallık)	Maksimum rastgele hücre kenar uzunluğu (ABD)
0	7842 km	7842 km
1	3921 km	5004 km
2	1825 km	2489 km
3	840 km	1310 km
4	432 km	636 km
5	210 km	315 km
6	108 km	156 km
7	54 km	78 km
8	27 km	39 km
9	14 km	20 km
10	7 km	10 km
11	3 km	5 km
12	1699 m	2 km
13	850 m	1225 m
14	425 m	613 m
15	212 m	306 m
16	106 m	153 m
17	53 m	77 m
18	27 m	38 m
19	13 m	19 m
20	7 m	10 m
21	3 m	5 m
22	166 cm	2 m
23	83 cm	120 cm
24	41 cm	60 cm
25	21 cm	30 cm
26	10 cm	15 cm
27	5 cm	7 cm
28	2 cm	4 cm
29	12 mm	18 mm
30	6 mm	9 mm

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

Örnekler

S2 hücresi tarafından toplanan ABD fırtına olayları

Aşağıdaki örnek, S2 hücreleri tarafından toplanan ABD fırtına olaylarını bulur.

Sorguyu çalıştır

StormEvents
| project BeginLon, BeginLat
| summarize by hash=geo_point_to_s2cell(BeginLon, BeginLat, 5)
| project geo_s2cell_to_central_point(hash)
| render scatterchart with (kind=map)

Çıkış

Aşağıdaki örnekte S2 hücre kimliği hesaplanır.

Sorguyu çalıştır

print s2cell = geo_point_to_s2cell(-80.195829, 25.802215, 8)

Çıkış

s2cell
88d9b

Koordinat grubu bulma

Aşağıdaki örnek koordinat gruplarını bulur. Gruptaki her koordinat çifti en fazla 1632,45 km² alanla S2 hücresinde bulunur.

Sorguyu çalıştır

datatable(location_id:string, longitude:real, latitude:real)
[
  "A", 10.1234, 53,
  "B", 10.3579, 53,
  "C", 10.6842, 53,
]
| summarize count = count(),                                        // items per group count
            locations = make_list(location_id)                      // items in the group
            by s2cell = geo_point_to_s2cell(longitude, latitude, 8) // s2 cell of the group

Çıkış

s2cell	count	Konum
47b1d	2	["A","B"]
47ae3	1	["C"]

Boş sonuçlar

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

Sorguyu çalıştır

print s2cell = geo_point_to_s2cell(300,1,8)

Çıkış

s2cell

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

Sorguyu çalıştır

print s2cell = geo_point_to_s2cell(1,1,35)

Çıkış

s2cell

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

Sorguyu çalıştır

print s2cell = geo_point_to_s2cell(1,1,int(null))

Çıkış

s2cell

İlgili içerik

• geo_point_to_geohash()
• geo_point_to_h3cell()