ST_GEOGPOINTFROMGEOHASH |
Point géographique d'un GeoHash |
| BigQuery |
Syntaxe
|
ST_GEOGPOINTFROMGEOHASH(geohash)
|
Paramètres
| Nom |
Description |
| geohash |
Ce paramètre permet de spécifier la chaîne de caractères GeoHash (STRING) que vous souhaitez convertir en un point géographique. La fonction interprète la chaîne GeoHash et renvoie un nouvel objet GEOGRAPHY de type POINT qui correspond au centre (point milieu) de la boîte englobante représentée par ce GeoHash. Si la chaîne GeoHash est invalide, la fonction renvoie une erreur. |
Description
Cette fonction permet de créer une valeur GEOGRAPHY associé au point milieu de la limite d'un objet GeoHash.
Remarques
- Permet de convertir un GeoHash en point GEOGRAPHY : La fonction ST_GEOGPOINTFROMGEOHASH transforme une chaîne GeoHash en un objet GEOGRAPHY de type
POINT représentant le centre géographique de la zone couverte par ce GeoHash. Cela facilite l'utilisation de systèmes de géocodage compact dans les analyses spatiales.
- Utilise le centre de la boîte englobante du GeoHash : Le point retourné par la fonction correspond au point central (milieu) de la zone rectangulaire
délimitée par le GeoHash. Ce n'est pas une position précise mais une approximation utile pour de nombreux cas d'usage, comme le repérage ou la cartographie
simplifiée.
- Utile pour décoder des identifiants géospatiaux compacts : Le GeoHash est un format compact d'encodage de coordonnées géographiques. Cette fonction
permet de retrouver des points exploitables dans BigQuery à partir de chaînes GeoHash, souvent utilisées dans les bases de données massives ou les systèmes de cache
spatial.
- Indispensable pour l'interopérabilité avec des API ou bases tierces : De nombreux services utilisent le GeoHash pour identifier rapidement des zones
géographiques (par exemple Uber, OpenStreetMap, ou certaines bases NoSQL). Cette fonction permet d'intégrer facilement ces données dans un environnement SQL via BigQuery.
- Peut renvoyer une erreur en cas de GeoHash invalide : Si la chaîne fournie n'est pas un GeoHash valide, la fonction génère une erreur explicite. Cela
impose une validation des entrées ou l'utilisation de formats propres, notamment dans les pipelines automatisés.
- Le niveau de précision dépend de la longueur du GeoHash : Plus la chaîne GeoHash est longue, plus la zone représentée est petite et la précision du
point retourné est élevée. Une chaîne courte représente une grande zone, tandis qu'une chaîne longue localise un point très précisément (jusqu'à quelques mètres).
- Facilite les jointures spatiales approximatives : En convertissant les GeoHash en points centraux, il devient possible d'effectuer des jointures spatiales
rapides, par exemple en les combinant avec ST_DWITHIN ou ST_DISTANCE, pour retrouver des objets proches ou appartenant à une même zone.
- Complète les fonctions de génération de GeoHash : Cette fonction est souvent utilisée en tandem avec ST_GEOHASH, effectuant l'opération inverse : elle
encode un point en GeoHash. Ensemble, elles permettent de passer d'une représentation textuelle compressée à une géographie manipulable, et vice versa.
Dernière mise à jour : Jeudi, le 18 Juin 2020