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.

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

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                                                      |
+-----------------------------------------------------------+