Catégories :

Fonctions géospatiales, Fonctions de conversion

ST_GEOGRAPHYFROMWKT

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

Alias :

ST_GEOGFROMWKT , ST_GEOGRAPHYFROMEWKT , ST_GEOGFROMEWKT , ST_GEOGRAPHYFROMTEXT , ST_GEOGFROMTEXT

Voir aussi :

TO_GEOGRAPHY

Syntaxe

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

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

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

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

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

ST_GEOGFROMTEXT( <varchar_expression> [ , <allow_invalid> ] )
Copy

Arguments

Obligatoire :

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 à Spécification du mode de traitement des formes géospatiales non valides.

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 WKT ou EWKT.

  • Émet une erreur si le format d’entrée est EWKT et que SRID n’est pas 4326. Consultez la note sur le traitement d” EWKT et d” EWKB.

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

Exemples

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

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';
Copy
select ST_GEOGRAPHYFROMWKT('POINT(-122.35 37.55)');
Copy
+---------------------------------------------+
| ST_GEOGRAPHYFROMWKT('POINT(-122.35 37.55)') |
|---------------------------------------------|
| POINT(-122.35 37.55)                        |
+---------------------------------------------+

L’exemple suivant renvoie l’objet GEOGRAPHY pour un objet géospatial avec une coordonnée Z décrit au format WKT :

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';
Copy
select ST_GEOGRAPHYFROMWKT('POINTZ(-122.35 37.55 30)');
Copy
+-------------------------------------------------+
| ST_GEOGRAPHYFROMWKT('POINTZ(-122.35 37.55 30)') |
|-------------------------------------------------|
| POINTZ(-122.35 37.55 30)                        |
+-------------------------------------------------+

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

-- Set the output format to EWKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='EWKT';
Copy
select ST_GEOGRAPHYFROMEWKT('SRID=4326;POINT(-122.35 37.55)');
Copy
+--------------------------------------------------------+
| ST_GEOGRAPHYFROMEWKT('SRID=4326;POINT(-122.35 37.55)') |
|--------------------------------------------------------|
| SRID=4326;POINT(-122.35 37.55)                         |
+--------------------------------------------------------+