ST_MAKEPOLYGON |
Fabrique un polygone |
| BigQuery |
Syntaxe
|
ST_MAKEPOLYGON(geography_expression)
|
|
ST_MAKEPOLYGON(geography_expression, array_of_geography)
|
Paramètres
| Nom |
Description |
| geography_expression |
Ce paramètre permet de spécifier la ligne extérieure (anneau extérieur) du polygone. Il doit s'agir d'une expression de type GEOGRAPHY qui représente un LINESTRING fermé (c'est-à-dire que le point de début et le point de fin sont les mêmes). Si la ligne n'est pas fermée, la fonction peut renvoyer une erreur ou un polygone non valide. |
| array_of_geography |
Ce paramètre facultatif permet de spécifier un tableau (ARRAY) d'objets GEOGRAPHY, où chaque élément du tableau doit être une LINESTRING fermée. Ces lignes représentent les anneaux intérieurs (trous) du polygone. Chaque ligne de ce tableau doit être un anneau fermé entièrement contenu à l'intérieur de geography_expression (l'anneau extérieur). |
Description
Cette fonction permet de créer une valeur GEOGRAPHY afin de produire un polygone en utilisant plusieurs sommets géométriques.
Remarques
- Permet de construire des polygones à partir de lignes fermées : La fonction ST_MAKEPOLYGON convertit une ou plusieurs lignes (LINESTRING) fermées en une
surface géographique. Cela permet de représenter des zones délimitées comme des parcelles, des lacs ou des territoires administratifs.
- Nécessite impérativement une ligne fermée pour l'anneau extérieur : Le paramètre principal (le contour) doit être un LINESTRING dont le premier et le
dernier point sont identiques. Si ce n'est pas le cas, la fonction échoue ou retourne un polygone invalide. Il est donc essentiel de vérifier la fermeture de la ligne
avant l'appel.
- Peut inclure des trous via un tableau d'anneaux intérieurs : Le deuxième paramètre (facultatif) est un tableau de LINESTRING fermés représentant les trous
dans le polygone. Ces trous doivent être entièrement contenus dans l'anneau extérieur pour garantir la validité de la géométrie.
- Utile pour modéliser des objets géographiques complexes : Grâce à son support des trous, ST_MAKEPOLYGON permet de représenter des formes naturelles ou
humaines irrégulières, comme une île avec un lac intérieur, ou une propriété foncière trouée par des emprises.
- Respecte les règles topologiques de validité des polygones : Chaque anneau (extérieur ou intérieur) doit être simple, fermé et ne pas s'auto-intersecter.
Les trous ne doivent pas se chevaucher entre eux ni toucher le bord extérieur. Sinon, la géométrie retournée est incorrecte ou rejetée.
- Requiert une bonne organisation des sommets : Les points dans un anneau doivent être listés dans un ordre cohérent (souvent antihoraire pour l'extérieur,
horaire pour les trous selon convention). L'ordre peut affecter le comportement visuel ou logique de certains traitements spatiaux.
- Peut être utilisée avec d'autres fonctions de transformation : On peut précéder ST_MAKEPOLYGON d'un ST_CONVEXHULL, ST_BUFFER ou ST_MAKELINE pour
construire dynamiquement des contours, puis les transformer en polygones. Elle joue donc un rôle central dans les pipelines de construction spatiale.
- Permet une structuration précise des objets spatiaux : Grâce à cette fonction, on peut convertir des données géométriques simples en objets surfaciques
riches, intégrables dans des analyses SIG, des représentations cartographiques, ou des modèles de couverture du territoire.
Dernière mise à jour : Jeudi, le 18 Juin 2020