ST_ASGEOJSON |
A GeoJSON |
| BigQuery |
Syntaxe
|
ST_ASGEOJSON(geography_expression)
|
Paramètres
| Nom |
Description |
| geography_expression |
Ce paramètre permet de spécifier l'expression de type GEOGRAPHY (par exemple, un point, une ligne, un polygone, une collection de géométries) que vous souhaitez convertir en une chaîne de caractères au format GeoJSON. La fonction renvoie une chaîne de caractères (STRING) contenant la représentation GeoJSON de l'objet géographique. |
Description
Cette fonction permet de créer un objet GeoJSON en utilisant une expression de valeur GEOGRAPHY.
Remarques
- Conversion vers un format standard lisible : La fonction ST_ASGEOJSON transforme un objet GEOGRAPHY en une chaîne de caractères au format GeoJSON,
un format largement utilisé pour l'entreposage, l'échange et la visualisation de données géospatiales sur le web.
- Interopérabilité avec des outils web et SIG : Le GeoJSON est nativement pris en charge par de nombreux outils comme Leaflet,
Mapbox, Google Maps, QGIS,... En exposant les données GEOGRAPHY sous ce format, la fonction facilite leur intégration dans des applications
cartographiques web.
- Lisibilité et portabilité des données : Contrairement aux formats binaires (comme WKB), le GeoJSON est lisible par l'humain et facilement modifiable.
Cela en fait un excellent choix pour le débogage, le stockage ou la documentation de données spatiales.
- Prise en charge des types complexes : La fonction prend en charge des géométries simples (POINT, LINESTRING, POLYGON) ainsi que des géométries complexes
comme les MULTIPOLYGON ou les GEOMETRYCOLLECTION. Cela assure une compatibilité avec une large gamme d'objets spatiaux.
- Sortie conforme à la spécification RFC 7946 : Le format retourné est conforme au standard GeoJSON défini par la RFC 7946. Cela garantit
que les données générées pourront être directement utilisées dans des systèmes qui suivent ce standard, sans transformation supplémentaire.
- Idéal pour des API ou du JSON embarqué : Étant au format JSON, la sortie de ST_ASGEOJSON peut être facilement intégrée dans des réponses d'API RESTful ou
dans des objets JSON utilisés en JavaScript, ce qui est très pratique pour les applications web interactives.
- Complément de la fonction ST_GEOGFROMGEOJSON : ST_ASGEOJSON peut être vue comme la fonction inverse de ST_GEOGFROMGEOJSON. Cela permet des conversions
bidirectionnelles entre objets GEOGRAPHY et GeoJSON, assurant ainsi la réversibilité des traitements.
- Utilisation optimale pour exporter des données géographiques : Si vous souhaitez exporter vos résultats géospatiaux depuis BigQuery vers un outil externe,
ST_ASGEOJSON est la méthode recommandée, car elle préserve fidèlement la structure géométrique tout en garantissant une compatibilité maximale avec des environnements
variés.
Dernière mise à jour : Jeudi, le 18 Juin 2020
