Catégories :

Fonctions géospatiales, Fonctions de conversion

TO_GEOMETRY

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

Voir aussi :

TRY_TO_GEOMETRY , ST_GEOMETRYFROMWKB , ST_GEOMETRYFROMWKT

Syntaxe

Utilisez l’une des méthodes suivantes :

TO_GEOMETRY( <varchar_expression> )

TO_GEOMETRY( <binary_expression> )

TO_GEOMETRY( <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 GEOMETRY.

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

  • Pour les entrées GeoJSON, WKT et WKB, l’objet GEOMETRY résultant a pour valeur SRID 0. Pour modifier les SRID, passez l’objet GEOMETRY à ST_SETSRID, en spécifiant le SRID que vous souhaitez définir. ST_SETSRID renvoie l’objet GEOMETRY avec cet ensemble SRID.

  • Pour construire un objet GEOMETRY à partir d’une entrée WKT ou EWKT, vous pouvez également utiliser ST_GEOMETRYFROMWKT.

  • Pour construire un objet GEOMETRY à partir d’une entrée WKB ou EWKB, vous pouvez également utiliser ST_GEOMETRYFROMWKB.

Exemples

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

alter session set geometry_output_format='WKT';

select to_geometry('POINT(1820.12 890.56)');
+--------------------------------------+
| TO_GEOMETRY('POINT(1820.12 890.56)') |
|--------------------------------------|
| POINT(1820.12 890.56)                |
+--------------------------------------+