ST_GEOGPOINT |
Point géographique |
| BigQuery |
Syntaxe
|
ST_GEOGPOINT(longitude, latitude)
|
Paramètres
| Nom |
Description |
| longitude |
Ce paramètre permet de spécifier la valeur numérique de la longitude du point géographique. La longitude doit être comprise entre -180 et 180 degrés (inclus). |
| latitude |
Ce paramètre permet de spécifier la valeur numérique de la latitude du point géographique. La latitude doit être comprise entre -90 et 90 degrés (inclus). La fonction renvoie un nouvel objet GEOGRAPHY de type POINT basé sur les coordonnées de longitude et latitude fournies. |
Description
Cette fonction permet de créer une valeur GEOGRAPHY à partir d'un point de longitude et latitude.
Remarques
- Crée un point géographique simple à partir de coordonnées : La fonction ST_GEOGPOINT permet de générer un objet GEOGRAPHY de type POINT en utilisant deux
coordonnées numériques : une longitude et une latitude. C'est le moyen le plus direct pour créer un emplacement géographique ponctuel dans BigQuery.
- Respecte les plages valides de coordonnées terrestres : Les valeurs acceptées sont -180 à 180 pour la longitude, et -90 à 90 pour la latitude. Toute
valeur en dehors de ces bornes génère une erreur. Cela garantit que les points créés sont toujours situés sur la surface terrestre réelle.
- Idéal pour représenter des entités ponctuelles : Cette fonction est très utile pour modéliser des emplacements précis comme des adresses, des capteurs,
des clients, des antennes ou tout autre objet localisé par des coordonnées GPS. Elle constitue la base de nombreuses analyses spatiales ponctuelles.
- Peut être utilisée dans des colonnes calculées : ST_GEOGPOINT peut être utilisée pour convertir automatiquement des paires de colonnes numériques
(longitude, latitude) en objets GEOGRAPHY, ce qui est utile lors de l'import de jeux de données contenant des coordonnées au format tabulaire.
- Compatible avec toutes les fonctions spatiales GEOGRAPHY : Une fois le point créé, il devient un objet GEOGRAPHY pleinement exploitable dans BigQuery.
On peut l'utiliser avec des fonctions comme ST_DISTANCE, ST_WITHIN, ST_DWITHIN, ou encore pour des jointures spatiales.
- Ne nécessite aucun formatage complexe : Contrairement à d'autres fonctions comme ST_GEOGFROMTEXT ou ST_GEOGFROMGEOJSON, ST_GEOGPOINT n'exige pas de
format particulier ou de texte structuré. Il suffit de deux nombres pour générer une géographie valide.
- Peut être utilisée dans des sous-requêtes ou des conditions : Elle est fréquemment utilisée directement dans des clauses WHERE, SELECT ou JOIN, par exemple
pour chercher tous les objets dans un rayon donné autour d'un point (ST_DWITHIN(mon_objet, ST_GEOGPOINT(...), 1000)).
- Fonction simple mais essentielle pour la cartographie dynamique : ST_GEOGPOINT est souvent le point d'entrée des traitements SIG dans BigQuery,
notamment pour visualiser des données sur des cartes, créer des clusters, ou effectuer des analyses de proximité. Elle est donc incontournable dans tout projet
géospatial.
Dernière mise à jour : Jeudi, le 18 Juin 2020
