La fonction ST_BOUNDINGBOX renvoie la boîte englobante d'un objet GEOGRAPHY.
Syntaxe
STRUCT ST_BOUNDINGBOX(GEOGRAPHY <value>)Paramètres
value : Obligatoire. Valeur de type de données GEOGRAPHY. Utilisez des fonctions telles que ST_GEOGPOINT, ST_GEOGFROMWKB, ST_GEOGFROMTEXT, ST_MAKELINE et ST_MAKEPOLYGON pour créer des objets GEOGRAPHY.
Valeur de retour
Renvoie une valeur STRUCT<xmin DOUBLE, ymin DOUBLE, xmax DOUBLE, ymax DOUBLE> décrivant la plage de coordonnées de la boîte englobante. Les champs sont les suivants :
xmin : longitude minimale.
xmax : longitude maximale.
ymin : latitude minimale.
ymax : latitude maximale.
La fonction suit ces règles :
Si l'entrée est nulle ou correspond à un objet géographique vide, la fonction renvoie NULL.
MaxCompute effectue des calculs géospatiaux sur une sphère et non sur un plan. De plus, la bibliothèque S2 sous-jacente peut introduire de légères erreurs de précision. Par conséquent, les coordonnées renvoyées peuvent différer légèrement des coordonnées d'entrée.
Exemples
-
Exemple 1 : utilisez la fonction ST_GEOGFROMTEXT pour créer un polygone et renvoyer sa boîte englobante.
SELECT ST_BOUNDINGBOX(ST_GEOGFROMTEXT('POLYGON ((0 0, 0.1 0, 0.1 0.1, 0 0.1, 0 0))')); -- Returns: +------------------------------------------------------------------------------+ | _c0 | +------------------------------------------------------------------------------+ | {xmin:0.0, ymin:-3.8199962864073534e-14, xmax:0.1, ymax:0.10000003807717585} | +------------------------------------------------------------------------------+ -
Exemple 2 : gérez les valeurs nulles et les objets géographiques vides.
-- The input is an empty geography object. The function returns NULL. SELECT ST_BOUNDINGBOX(ST_GEOGFROMTEXT('point empty')); -- The input is null. The function returns NULL. SELECT ST_BOUNDINGBOX(ST_GEOGFROMTEXT(null));