ST_DIMENSION |
Dimension |
| BigQuery |
Syntaxe
|
ST_DIMENSION(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 déterminer la dimension. La fonction renvoie la dimension de l'objet géographique, qui est généralement : 0 pour un point (ou une collection de points). 1 pour une ligne (ou une collection de lignes). 2 pour un polygone (ou une collection de polygones). NULL si l'entrée est NULL. |
Description
Cette fonction permet de demander la dimension la plus grande dans une valeur GEOGRAPHY.
Remarques
- Retourne un indicateur numérique de la complexité géométrique : La fonction ST_DIMENSION permet d'obtenir un entier représentant la dimension spatiale de
l'objet GEOGRAPHY. Ce nombre renseigne sur la nature de la géométrie : 0 pour un point, 1 pour une ligne, et 2 pour un polygone. Elle est particulièrement utile pour
classifier ou valider les objets géographiques dans une base.
- Permet de différencier automatiquement les types de géométrie : Plutôt que d'interroger le type via une fonction comme ST_GEOMETRYTYPE, ST_DIMENSION donne
un résultat numérique standardisé. Cela permet, par exemple, de traiter différemment les objets de dimension 0 (points) et ceux de dimension 2 (polygones), même s'ils
sont contenus dans des collections hétérogènes.
- Compatible avec les collections de géométries : Si l'entrée est une collection de types mixtes (par exemple, un GEOGRAPHY contenant à la fois des points
et des polygones), la fonction retourne la dimension la plus élevée rencontrée. Cela permet de capter la "richesse" spatiale d'un objet composite de façon synthétique.
- Fonction utile pour filtrer les objets dans des analyses spatiales : ST_DIMENSION permet de filtrer uniquement certaines géométries selon leur complexité.
Par exemple, on peut extraire uniquement les objets de dimension 1 pour effectuer des calculs de longueur, ou exclure les points (dimension 0) d'une analyse de surfaces.
- Résultat simple à interpréter mais puissant analytiquement : Les trois valeurs possibles (0, 1, 2) correspondent à des éléments géométriques
fondamentaux : points (objets discrets), lignes (trajets, frontières) et surfaces (zones fermées). Cette classification permet de bâtir des analyses spatiales adaptées
au type d'entité étudiée.
- Retourne NULL en cas d'entrée nulle : Si l'expression fournie est NULL, la fonction retourne également NULL, ce qui respecte la logique SQL standard. Cela
évite des erreurs ou des fausses valeurs dans des traitements où certaines géométries pourraient être absentes ou non définies.
- Fonction purement descriptive (pas de modification de géométrie) : Contrairement à des fonctions comme ST_UNION ou ST_DIFFERENCE, ST_DIMENSION ne modifie
pas les données spatiales. Elle fournit uniquement une information descriptive, ce qui permet de l'utiliser sans impact sur les géométries originales.
- Idéale pour les tests de cohérence et de validation de données spatiales : Lors de l'ingestion ou du nettoyage d'ensembles de données géographiques, cette
fonction permet de vérifier la consistance des objets. On peut, par exemple, s'assurer qu'une couche censée contenir uniquement des surfaces ne contient pas
accidentellement des lignes ou des points.
Dernière mise à jour : Jeudi, le 18 Juin 2020
