geo_point_to_s2cell()geo_point_to_s2cell()

Calcola il valore della stringa del token della cella S2 per una posizione geografica.Calculates the S2 cell token string value for a geographic location.

Scopri di più sulla gerarchia di celle S2.Read more about S2 cell hierarchy.

SintassiSyntax

geo_point_to_s2cell(Longitudine , Latitudine , livello di)geo_point_to_s2cell(longitude, latitude, level)

ArgomentiArguments

  • Longitudine: valore Longitudine di una posizione geografica.longitude: Longitude value of a geographic location. La longitudine x sarà considerata valida se x è un numero reale e x è compreso nell'intervallo [-180, + 180].Longitude x will be considered valid if x is a real number and x is in the range [-180, +180].
  • Latitudine: valore di latitudine di una posizione geografica.latitude: Latitude value of a geographic location. La latitudine y sarà considerata valida se y è un numero reale e y nell'intervallo [-90, + 90].Latitude y will be considered valid if y is a real number and y in the range [-90, +90].
  • Level: valore facoltativo int che definisce il livello di cella richiesto.level: An optional int that defines the requested cell level. I valori supportati sono compresi nell'intervallo [0, 30].Supported values are in the range [0, 30]. Se non è specificato, viene usato il valore predefinito 11 .If unspecified, the default value 11 is used.

RestituisceReturns

Valore stringa del token della cella S2 di una determinata posizione geografica.The S2 cell token string value of a given geographic location. Se le coordinate o i livelli non sono validi, la query produrrà un risultato vuoto.If the coordinates or levels are invalid, the query will produce an empty result.

Nota

  • La cella S2 può essere un utile strumento di clustering geospaziale.S2 cell can be a useful geospatial clustering tool.
  • La cella S2 presenta 31 livelli di gerarchia con copertura dell'area, da 85011, 012.19 km ² al livello più alto compreso tra 0 e 00.44 cm ² al livello più basso 30.S2 cell has 31 levels of hierarchy with area coverage ranging from 85,011,012.19km² at the highest level 0 to 00.44cm² at the lowest level 30.
  • La cella S2 conserva la buona parte del centro celle durante l'incremento del livello da 0 a 30.S2 cell preserves the cell center well during level increase from 0 to 30.
  • La cella S2 è una cella in una superficie sferica e i relativi bordi sono geodetiche.S2 cell is a cell on a spherical surface and its edges are geodesics.
  • Richiamando la funzione geo_s2cell_to_central_point () su una stringa di token della cella S2 calcolata sulla longitudine x e la latitudine y non verranno necessariamente restituiti x e y.Invoking the geo_s2cell_to_central_point() function on an S2 cell token string that was calculated on longitude x and latitude y won't necessarily return x and y.
  • È possibile che due posizioni geografiche siano molto vicine tra loro, ma che abbiano token di cella S2 diversi.It's possible that two geographic locations are very close to each other but have different S2 cell tokens.

Valore di copertura area approssimativa cella S2 per livelloS2 cell approximate area coverage per level value

Per ogni livello, le dimensioni della cella S2 sono simili ma non esattamente uguali.For every level, the size of the S2 cell is similar but not exactly equal. Le dimensioni delle celle vicine tendono a essere più uguali.Nearby cell sizes tend to be more equal.

LivelloLevel Lunghezza minima del bordo della cella casuale (Regno Unito)Minimum random cell edge length (UK) Lunghezza massima del bordo della cella casuale (US)Maximum random cell edge length (US)
00 7842 km7842 km 7842 km7842 km
11 3921 km3921 km 5004 km5004 km
22 1825 km1825 km 2489 km2489 km
33 840 km840 km 1310 km1310 km
44 432 km432 km 636 km636 km
55 210 km210 km 315 km315 km
66 108 km108 km 156 km156 km
77 54 km54 km 78 km78 km
88 27 km27 km 39 km39 km
99 14 km14 km 20 km20 km
1010 7 km7 km 10 km10 km
1111 3 km3 km 5 km5 km
1212 1699 m1699 m 2 km2 km
1313 850 m850 m 1225 m1225 m
1414 425 m425 m 613 m613 m
1515 212 m212 m 306 m306 m
1616 106 m106 m 153 m153 m
1717 53 m53 m 77 m77 m
1818 27 m27 m 38 m38 m
1919 13 m13 m 19 m19 m
2020 7 m7 m 10 m10 m
2121 3 m3 m 5 m5 m
2222 166 cm166 cm 2 m2 m
2323 83 cm83 cm 120 cm120 cm
2424 41 cm41 cm 60 cm60 cm
2525 21 cm21 cm 30 cm30 cm
2626 10 cm10 cm 15 cm15 cm
2727 5 cm5 cm 7 cm7 cm
2828 2 cm2 cm 4 cm4 cm
2929 12 mm12 mm 18 mm18 mm
3030 6 mm6 mm 9 mm9 mm

L'origine della tabella si trova in questa risorsa statistica della cella S2.The table source can be found in this S2 cell statistical resource.

Vedere anche geo_point_to_geohash ().See also geo_point_to_geohash().

EsempioExamples

Eventi Storm Uniti aggregati da s2cell.US storm events aggregated by s2cell.

S2cell US

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) // map rendering available in Kusto Explorer desktop
print s2cell = geo_point_to_s2cell(-80.195829, 25.802215, 8)
s2cells2cell
88d9b88d9b

Nell'esempio seguente vengono trovati gruppi di coordinate.The following example finds groups of coordinates. Ogni coppia di coordinate del gruppo risiede nella cella S2 con un'area massima di 1632,45 km2.Every pair of coordinates in the group resides in the S2 cell with a maximum area of 1632.45 km².

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
s2cells2cell countcount locationslocations
47b1d47b1d 22 ["A", "B"]["A","B"]
47ae347ae3 11 ["C"]["C"]

Nell'esempio seguente viene generato un risultato vuoto a causa dell'input della coordinata non valido.The following example produces an empty result because of the invalid coordinate input.

print s2cell = geo_point_to_s2cell(300,1,8)
s2cells2cell

Nell'esempio seguente viene generato un risultato vuoto a causa dell'input di livello non valido.The following example produces an empty result because of the invalid level input.

print s2cell = geo_point_to_s2cell(1,1,35)
s2cells2cell

Nell'esempio seguente viene generato un risultato vuoto a causa dell'input di livello non valido.The following example produces an empty result because of the invalid level input.

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