ST_COVEREDBY |
Couverture |
| BigQuery |
Syntaxe
|
ST_COVEREDBY(geography_1, geography_2)
|
Paramètres
| Nom |
Description |
| geography_1 |
Ce paramètre permet de spécifier la première expression de type GEOGRAPHY, qui est la géométrie dont on vérifie si elle est couverte. |
| geography_2 |
Ce paramètre permet de spécifier la deuxième expression de type GEOGRAPHY, qui est la géométrie "couvrante". La fonction renvoie TRUE si geography_1 est complètement couverte par geography_2 (c'est-à-dire que tous les points de geography_1 sont dans geography_2, y compris les limites), et FALSE sinon. Cette relation est symétrique à ST_COVERS si les géométries sont solides et sans trous, mais ST_COVEREDBY(A, B) est équivalent à ST_COVERS(B, A). |
Description
Cette fonction permet de vérifier si aucun point géographique n'est à l'extérieur d'un autre point géographique en inverse l'ordre des paramètres.
Remarques
- Relation spatiale de type inclusion étendue : La fonction ST_COVEREDBY permet de vérifier si une géographie est entièrement couverte par une autre,
c'est-à-dire que tous les points, y compris ceux situés sur la frontière, sont inclus dans la géométrie "couvrante". Contrairement à ST_WITHIN ou ST_CONTAINS, les bords
sont ici acceptés, ce qui rend la condition légèrement plus souple.
- Inverse logique de ST_COVERS : Cette fonction est l'équivalent inversé de ST_COVERS. En d'autres termes, ST_COVEREDBY(A, B) est identique à
ST_COVERS(B, A). Cela permet de garder une logique cohérente selon qu'on exprime une relation du point de vue de la géométrie "couverte" ou "couvrante", facilitant
la lecture du code selon le contexte spatial.
- Inclut les limites dans l'évaluation : Contrairement à certaines fonctions comme ST_CONTAINS, exigeant que la géométrie soit strictement à l'intérieur,
ST_COVEREDBY accepte que les points de geography_1 soient sur les bords de geography_2. Cela la rend plus permissive et adaptée à des cas pratiques comme la
vérification d'une zone administrative.
- Utilisable pour valider des emplacements dans une zone : On peut utiliser cette fonction pour vérifier si une route, un bâtiment, ou tout autre objet
spatial est entièrement inclus ou bordé par une zone réglementée (commune, réserve naturelle, secteur cadastral, etc.). Elle permet donc de garantir que rien ne
dépasse sans être trop restrictive.
- Fonction logique à retourner un booléen : ST_COVEREDBY retourne une valeur booléenne (TRUE ou FALSE) pouvant être directement utilisée dans des clauses
conditionnelles, comme WHERE, CASE, ou pour du filtrage spatial dans une interface cartographique. Cela facilite son intégration dans les requêtes SQL géospatiales.
- Pertinente pour la conformité géographique : Dans des contextes réglementaires ou de gestion territoriale, cette fonction permet de vérifier que des
objets ne sortent pas des limites autorisées, même partiellement. Par exemple, on peut vérifier que toutes les parcelles d'un permis de construction sont
intégralement couvertes par une zone urbaine définie.
- Applicable à tous types de géographies : Elle fonctionne avec des points, lignes, polygones, ou collections complexes. Que ce soit un ensemble de
segments routiers ou un polygone composite, la fonction évaluera si l'ensemble est contenu (bord inclus) dans la géographie de référence, sans distinction de forme.
- Sensible à la précision et à la validité des géométries : Comme pour d'autres fonctions géospatiales, un résultat fiable dépend de la qualité des
géométries. Si les polygones sont invalides (auto-intersections, trous non fermés,...), ST_COVEREDBY peut retourner des résultats erronés. Il est donc conseillé de
valider les données en amont avec ST_ISVALID.
Dernière mise à jour : Jeudi, le 18 Juin 2020
