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

ST_GEOMETRYFROMWKT¶

Analyse une entrée WKT (texte bien connu) ou EWKT (texte bien connu étendu) et renvoie une valeur de type GEOMETRY.

Alias :

ST_GEOMFROMWKT , ST_GEOMETRYFROMEWKT , ST_GEOMFROMEWKT , ST_GEOMETRYFROMTEXT , ST_GEOMFROMTEXT

Voir aussi :: TO_GEOMETRY

Syntaxe¶

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

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

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

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

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

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

Copy

Arguments¶

varchar_expression: L’argument doit être une expression de chaîne au format WKT ou EWKT qui représente un objet géospatial valide.

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 WKT ou EWKT.
Pour une entrée WKT, l’objet GEOMETRY résultant a SRID fixé à 0.

Pour modifier le SRID d’un objet GEOMETRY, passez l’objet GEOMETRY à ST_SETSRID, en spécifiant le SRID que vous voulez définir. ST_SETSRID renvoie l’objet GEOMETRY qui possède le SRID spécifié.

Exemples¶

L’exemple suivant renvoie l’objet GEOMETRY pour un objet géospatial décrit au format EWKT :

-- Set the output format to EWKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)');

Copy

+---------------------------------------------------------------+
| ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)') |
|---------------------------------------------------------------|
| SRID=32633;POINT(389866.35 5819003.03)                        |
+---------------------------------------------------------------+

Copy

Dans l’exemple suivant, l’entrée est au format WKT, qui ne spécifie pas le SRID :

-- Set the output format to WKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)');

Copy

+----------------------------------------------------+
| ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)')  |
|----------------------------------------------------|
| SRID=0;POINT(389866.35 5819003.03)                 |
+----------------------------------------------------+

Copy