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> )

TO_GEOGRAPHY( <binary_expression> )

TO_GEOGRAPHY( <variant_expression> )

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.

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)                 |
+--------------------------------------+