ST_GEOGFROMTEXT |
Géographique de texte |
| BigQuery |
Syntaxe
|
ST_GEOGFROMTEXT(wkt_string)
|
|
ST_GEOGFROMTEXT(wkt_string, oriented)
|
Paramètres
| Nom |
Description |
| wkt_string |
Ce paramètre permet de spécifier la chaîne de caractères (STRING) au format Well-Known Text (WKT) que vous souhaitez convertir en un objet géographique (GEOGRAPHY). Cette fonction interprète la chaîne WKT et crée l'objet GEOGRAPHY correspondant. Si la chaîne WKT est invalide ou représente une géométrie qui ne peut pas être représentée comme un type GEOGRAPHY valide, la fonction renverra une erreur. |
| oriented |
Ce paramètre facultatif de type BOOL permet de contrôler la règle d'orientation appliquée lors de la création d'un polygone à partir de la chaîne WKT. Si TRUE, ce paramètre permet à la fonction d'appliquer la règle d'orientation de BigQuery (généralement la règle de la main droite) pour les polygones.Si FALSE ou omis, la fonction utilise l'orientation des anneaux intérieurs et extérieurs telle qu'elle est définie dans la chaîne WKT sans la modifier. Ce paramètre est particulièrement pertinent pour les polygones avec des trous, où l'orientation des anneaux intérieurs est cruciale. |
Description
Cette fonction permet de créer une valeur GEOGRAPHY en utilisant une chaîne de caractères d'objet WKT.
Remarques
- Conversion du format WKT en objet GEOGRAPHY : La fonction ST_GEOGFROMTEXT permet de convertir une chaîne de texte au format Well-Known Text (WKT) en
un objet géographique GEOGRAPHY. Ce format est standard dans le monde SIG et permet de décrire des points, lignes, polygones ou collections de manière textuelle.
- Compatible avec tous les types géométriques WKT valides : Elle accepte des objets WKT comme POINT, LINESTRING, POLYGON, MULTIPOLYGON, ou encore
GEOMETRYCOLLECTION. Cela permet de charger et de manipuler une grande variété de formes géographiques directement à partir de texte.
- Idéale pour intégrer des données issues d'outils SIG : De nombreux outils SIG (comme QGIS, ArcGIS, PostGIS) exportent des géométries au format WKT.
Cette fonction est donc essentielle pour intégrer ces données dans BigQuery sans conversion intermédiaire complexe.
- Renvoie une erreur si la chaîne est invalide : Si le texte WKT est mal formé ou contient des coordonnées non valides, la fonction renvoie une erreur
explicite. Cela garantit une certaine robustesse des données, mais suppose que la chaîne soit bien structurée au préalable.
- Le paramètre oriented permet de contrôler le sens des polygones : Le second paramètre optionnel, oriented, permet de gérer l'orientation
des anneaux dans les polygones, ce qui est crucial lorsqu'il y a des trous. En activant cette option, BigQuery applique une règle d'orientation standard (comme la
règle de la main droite) pour garantir une interprétation correcte des faces et des creux.
- Utile pour le traitement de géométries complexes : Grâce à cette fonction, il est possible d'importer et d'analyser des géométries complexes à plusieurs
niveaux, comme des polygones imbriqués ou des collections de formes, ce qui élargit le champ des analyses géospatiales possibles dans BigQuery.
- Peut être combinée avec toutes les fonctions spatiales GEOGRAPHY : Une fois la conversion effectuée, la géométrie peut être utilisée avec toutes les
fonctions géographiques BigQuery, comme ST_AREA, ST_DISTANCE, ST_INTERSECTS, etc. Cela permet une intégration fluide dans les flux de travaux d'analyse spatiale.
- Particulièrement adaptée aux données statiques ou intégrées manuellement : Cette fonction est utile lorsque des géométries sont insérées manuellement
dans une requête ou une table sous forme de texte. Cela permet aux analystes ou développeurs de travailler directement avec des géométries sans recourir à des formats
de fichiers comme GeoJSON ou Shapefile.
Dernière mise à jour : Jeudi, le 18 Juin 2020
