Catégories :: Fonctions géospatiales, Fonctions de conversion

TO_GEOGRAPHY¶

Analyse une entrée et renvoie une valeur de type GEOGRAPHY.

Voir aussi :: TRY_TO_GEOGRAPHY , ST_GEOGRAPHYFROMWKB , ST_GEOGRAPHYFROMWKT

Syntaxe¶

Utilisez l’une des méthodes suivantes :

TO_GEOGRAPHY( <varchar_expression> , [ <allow_invalid> ] )

TO_GEOGRAPHY( <binary_expression> , [ <allow_invalid> ] )

TO_GEOGRAPHY( <variant_expression> , [ <allow_invalid> ] )

Copy

Arguments¶

varchar_expression

L’argument doit être une expression de chaîne qui représente un objet géométrique valide dans l’un des formats suivants :

WKT (texte bien connu).
WKB (binaire bien connu) au format hexadécimal (sans un 0x de début).
EWKT (texte bien connu étendu).
EWKB (binaire bien connu étendu) au format hexadécimal (sans un 0x de début).
GeoJSON.

binary_expression

L’argument doit être une expression binaire au format WKB ou EWKB.

variant_expression

L’argument doit être un OBJECT au format GeoJSON.

Facultatif :

allow_invalid: Si TRUE, spécifie que la fonction doit renvoyer un objet GEOGRAPHY ou GEOMETRY, même lorsque la forme d’entrée n’est pas valide et ne peut pas être réparée. Pour plus de détails, reportez-vous à Specifying How Invalid Geospatial Shapes Are Handled.

Renvoie¶

La fonction renvoie une valeur de type GEOGRAPHY.

Notes sur l’utilisation¶

Émet une erreur si l’entrée ne peut pas être analysée comme l’un des formats pris en charge (WKT, WKB, EWKT, EWKB, GeoJSON).
Émet une erreur si le format d’entrée est EWKT ou EWKB et que SRID n’est pas 4326. Consultez la note sur le traitement d” EWKT et d” EWKB.
Pour construire un objet GEOGRAPHY à partir d’une entrée WKT ou EWKT, vous pouvez également utiliser ST_GEOGRAPHYFROMWKT.
Pour construire un objet GEOGRAPHY à partir d’une entrée WKB ou EWKB, vous pouvez également utiliser ST_GEOGRAPHYFROMWKB.

Pour les coordonnées en WKT, EWKT et GeoJSON, la longitude apparaît avant la latitude (par exemple POINT(lon lat)).

Exemples¶

Cela montre une utilisation simple de la fonction TO_GEOGRAPHY avec des données VARCHAR :

select TO_GEOGRAPHY('POINT(-122.35 37.55)');
+--------------------------------------+
| TO_GEOGRAPHY('POINT(-122.35 37.55)') |
|--------------------------------------|
| POINT(-122.35 37.55)                 |
+--------------------------------------+

Copy