Partager via

geo_s2cell_to_polygon()

S’applique à : ✅Microsoft Fabric

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 Catégorie Requise Descriptif
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

L’exemple suivant calcule le polygone qui représente la zone rectangulaire de cellule S2.

Exécuter la requête

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.

Exécuter la requête

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

Colonne1
{
« 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.

Exécuter la requête

print s2cellPolygon = geo_s2cell_to_polygon("a")

Sortie

s2cellPolygon