ST_ GeomFromGeoSquare

ST_ GeomFromGeoSquare renvoie une géométrie qui couvre la zone représentée par une valeur géosquare en entrée. La géométrie renvoyée est toujours bidimensionnelle. Pour calculer une valeur de geosquare, consultez ST_ GeoSquare.

Syntaxe

ST_GeomFromGeoSquare(geosquare)

ST_GeomFromGeoSquare(geosquare, max_depth)

Arguments

geosquare

Valeur de type de données BIGINT ou expression ayant pour résultat un type BIGINT qui est une valeur de geosquare qui décrit la séquence de subdivisions effectuées sur le domaine initial pour atteindre le carré souhaité. Cette valeur est calculée par ST_ GeoSquare.

max_depth

Valeur du type de données INTEGER qui représente le nombre maximal de subdivisions de domaine effectuées sur le domaine initial. Cette valeur doit être supérieure ou égale à 1.

Type de retour

GEOMETRY

Si geosquare n’est pas valide, la fonction renvoie une erreur.

Si l’entrée max_depth n’est pas comprise dans la plage, la fonction renvoie une erreur.

Exemples

Le code SQL suivant renvoie une géométrie à partir d’une valeur de geosquare.

SELECT ST_AsText(ST_GeomFromGeoSquare(797852));

 st_astext       
--------------------------------------------------------------------------------------------------------------------
 POLYGON((13.359375 52.3828125,13.359375 52.734375,13.7109375 52.734375,13.7109375 52.3828125,13.359375 52.3828125))
 

Le code SQL suivant renvoie une géométrie à partir d’une valeur de geosquare et d’une profondeur maximale de 3.

SELECT ST_AsText(ST_GeomFromGeoSquare(797852, 3));

 st_astext       
--------------------------------------
 POLYGON((0 45,0 90,45 90,45 45,0 45))
 

Le code SQL suivant calcule d’abord la valeur de geosquare pour Seattle en spécifiant la coordonnée X comme longitude et la coordonnée Y comme latitude (-122,3, 47,6). Il renvoie ensuite le polygone du geosquare. Bien que la sortie soit une géométrie bidimensionnelle, elle peut être utilisée pour calculer des données spatiales en termes de longitude et de latitude.

SELECT ST_AsText(ST_GeomFromGeoSquare(ST_GeoSquare(ST_Point(-122.3, 47.6))));

 st_astext
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
POLYGON((-122.335167014971 47.6080129947513,-122.335167014971 47.6080130785704,-122.335166931152 47.6080130785704,-122.335166931152 47.6080129947513,-122.335167014971 47.6080129947513))