Catégories :

Fonctions géospatiales, Fonctions de conversion

TRY_TO_GEOGRAPHY

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

Cette fonction est essentiellement identique à TO_GEOGRAPHY sauf qu’elle renvoie NULL lorsque TO_GEOGRAPHY émettrait une erreur.

Voir aussi :

TO_GEOGRAPHY

Syntaxe

Utilisez l’une des méthodes suivantes :

TRY_TO_GEOGRAPHY( <varchar_expression> )

TRY_TO_GEOGRAPHY( <binary_expression> )

TRY_TO_GEOGRAPHY( <variant_expression> )

Arguments

expression_varchar

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.

expression_binaire

L’argument doit être une expression binaire au format WKB ou EWKB.

expression_variante

L’argument doit être un OBJECT au format GeoJSON.

Renvoie

La fonction renvoie une valeur de type GEOGRAPHY.

Notes sur l’utilisation

  • Renvoie NULL si l’entrée ne peut pas être analysée comme le format pris en charge approprié (WKT, WKB, EWKT, EWKB, GeoJSON).

  • Renvoie NULL 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.

Exemples

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

select TRY_TO_GEOGRAPHY('Not a valid input for this data type.');
+-----------------------------------------------------------+
| TRY_TO_GEOGRAPHY('NOT A VALID INPUT FOR THIS DATA TYPE.') |
|-----------------------------------------------------------|
| NULL                                                      |
+-----------------------------------------------------------+