ST_NUMPOINTS |
Nombre de points |
| BigQuery |
Syntaxe
|
ST_NUMPOINTS(geography_expression)
|
Paramètres
| Nom |
Description |
| geography_expression |
Ce paramètre permet de spécifier l'expression de type GEOGRAPHY (point, ligne, polygone ou une collection de géométries) dont vous souhaitez compter le nombre total de sommets (points définissant la géométrie). Pour un POINT, cela renvoie 1. Pour une LINESTRING ou un POLYGON, cela renvoie le nombre de points qui composent cette ligne ou ce polygone. Pour une collection, cela renvoie la somme des points de toutes les géométries qu'elle contient. |
Description
Cette fonction permet de demander le nombre de sommet que contient la valeur GEOGRAPHY.
Remarques
- Permet de compter les sommets constitutifs d'une géométrie : La fonction ST_NUMPOINTS retourne le nombre total de points définissant une géométrie, qu'il
s'agisse d'un point isolé, d'une ligne, d'un polygone ou d'une collection. Elle est utile pour analyser la complexité géométrique d'un objet GEOGRAPHY.
- Fournit un indicateur de précision géométrique : Un grand nombre de points dans une géométrie peut indiquer une haute précision spatiale ou une complexité
accrue (comme les contours détaillés d'un polygone côtier). Cette fonction aide donc à évaluer le niveau de détail d'une représentation géographique.
- Compatible avec tous les types de géographies : La fonction accepte des objets simples comme des POINT, mais aussi des géométries complexes comme
MULTILINESTRING, MULTIPOLYGON ou GEOMETRYCOLLECTION. Elle agrège tous les sommets dans les géométries contenues, ce qui la rend polyvalente.
- Renvoie toujours un entier supérieur ou égal à 0 : Même pour une géométrie vide, la fonction reste cohérente : elle renvoie 0 si la géographie ne contient
aucun point. Cela permet de filtrer facilement les entités inutiles ou corrompues dans des jeux de données spatiales.
- Différente de ST_NPOINTS dans d'autres SGBD : Certains systèmes de gestion comme PostGIS utilisent des fonctions similaires mais avec des noms différents
(comme ST_NPoints). En BigQuery, ST_NUMPOINTS est spécifiquement adaptée au type GEOGRAPHY, ce qui évite les ambiguïtés.
- Ne confond pas les points avec les objets géographiques : Un polygone n'est pas compté comme une seule entité, mais comme une séquence de sommets
définissant ses bords. Cette distinction est essentielle lorsqu'on veut analyser la forme plutôt que le nombre d'objets.
- Fonction idéale pour contrôler la charge spatiale : Lorsque l'on travaille avec des millions de géométries, ST_NUMPOINTS peut servir à détecter les
géométries surchargées (trop de points), et ainsi optimiser les traitements ou visualisations en simplifiant ou filtrant certaines d'entre elles.
- Particulièrement utile pour les traitements topologiques : Dans des analyses où l'on cherche à manipuler ou transformer les sommets (avec des fonctions
comme ST_POINTN ou ST_INTERPOLATEPOINT), connaître le nombre total de points permet de structurer des boucles ou des comparaisons logiques.
Dernière mise à jour : Jeudi, le 18 Juin 2020
