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> , [ <allow_invalid> ] )

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

TO_GEOMETRY( <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 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)');
Copy
+--------------------------------------+
| TO_GEOMETRY('POINT(1820.12 890.56)') |
|--------------------------------------|
| POINT(1820.12 890.56)                |
+--------------------------------------+
Copy