Partager via

geo_s2cell_to_polygon()

  • Article

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcule le polygone qui représente la zone rectangulaire d’une cellule S2.

En savoir plus sur les cellules S2.

Syntaxe

geo_s2cell_to_polygon(s2cell)

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
s2cell string ✔️ Valeur du jeton de cellule S2 telle qu’elle a été calculée par geo_point_to_s2cell(). La longueur maximale du jeton de cellule S2 est de 16 caractères.

Retours

Polygone au format GeoJSON et d’un type de données dynamique . Si la cellule s2cell n’est pas valide, la requête produit un résultat null.

Remarque

Les arêtes de cellule S2 sont des géodésiques sphériques.

Exemples

print s2cellPolygon = geo_s2cell_to_polygon("89c259")

Sortie

s2cellPolygon
{
« type » : « Polygon »,
« coordonnées » : [[[-74.030012249838478, 40.8012684339439], [-74.030012249838478, 40.7222262918358], [-73.935982114337421, 40.708880489804564], [-73.935982114337421, 40.787917134506841], [-74.030012249838478, 40.8012684339439]]
}

L’exemple suivant assemble la collection geometry GeoJSON des polygones de cellule S2.

datatable(lng:real, lat:real)
[
    -73.956683, 40.807907,
    -73.916869, 40.818314,
    -73.989148, 40.743273,
]
| project s2_hash = geo_point_to_s2cell(lng, lat, 10)
| project s2_hash_polygon = geo_s2cell_to_polygon(s2_hash)
| summarize s2_hash_polygon_lst = make_list(s2_hash_polygon)
| project bag_pack(
    "type", "Feature",
    "geometry", bag_pack("type", "GeometryCollection", "geometries", s2_hash_polygon_lst),
    "properties", bag_pack("name", "S2 Cell polygons collection"))

Sortie

Column1
{
« type » : « Feature »,
« geometry » : {"type » : « GeometryCollection », « geometries » : [
{"type » : « Polygon », « coordinates » : [[-74.030012249838478, 40.880202851376716], [-74.030012249838478, 40.8012684339439], [-73.935982114337421, 40.787917134506841], [-73.935982114337421, 40.86684616345771], [-74.030012249838478, 40.880202851376716]]},
{"type » : « Polygon », « coordinates » : [[-73.935982114337421, 40.866846163445771], [-73.935982114337421, 40.787917134506841], [-73.841906340776248, 40.774477568182071], [-73.841906340776248, 40.853401155678846], [-73.93598211437421, 40.8668461616345771]]},
{"type » : « Polygon », « coordinates » : [[-74.030012249838478, 40.8012684339439], [-74.030012249838478, 40.7222262918358], [-73.935982114337421, 40.708880489804564], [-73.935982114337421, 40.787917134506841], [-74.030012249838478, 40.8012684339439]]}]
},
« properties » : {"name » : « S2 Cell polygons collection"}
}

L’exemple suivant retourne un résultat null en raison de l’entrée de jeton s2cell non valide.

print s2cellPolygon = geo_s2cell_to_polygon("a")

Sortie

s2cellPolygon