Tous les produits
Search
Centre de documentation

ApsaraDB RDS:ST_PointFromText

Dernière mise à jour :Sep 02, 2026

Construit un point à partir d’une chaîne Well-Known Text (WKT) et d’un identifiant de référence spatiale (SRID) facultatif.

Syntaxe

geometry ST_PointFromText(text wKT);
geometry ST_PointFromText(text wKT, integer srid);

Paramètres

Paramètre Type Description
wKT text Chaîne WKT représentant une géométrie de type point, par exemple POINT(119 40).
srid integer SRID à attribuer à la géométrie renvoyée. La valeur par défaut est 0 si ce paramètre est omis.

Remarques d'utilisation

  • Si la chaîne WKT ne représente pas un point, la fonction renvoie NULL.

  • Si la chaîne WKT n’est pas valide, la fonction renvoie une erreur.

  • Ordre des coordonnées : en WKT, X correspond à la longitude et Y à la latitude. Par exemple, POINT(119 40) signifie longitude 119, latitude 40. Inverser l’ordre est une erreur courante qui génère une géométrie incorrecte.

  • Les deux surcharges diffèrent par les métadonnées de l’objet renvoyé : la première retourne une géométrie sans système de référence spatiale défini (SRID = 0) ; la seconde intègre le SRID spécifié dans les métadonnées de la géométrie.

Quand utiliser une autre fonction

La fonction ST_PointFromText vérifie que l’entrée représente bien un point avant de le construire. Si votre entrée est déjà garantie comme étant un WKT de type point, utilisez plutôt ST_GeomFromText : cette fonction ignore l’étape de validation et offre de meilleures performances.

Si vous construisez des points à partir de coordonnées de longitude et de latitude et que vous privilégiez les performances et la précision plutôt que la conformité aux normes de l’Open Geospatial Consortium (OGC), optez pour ST_MakePoint ou ST_Point.

Exemples

Construire un point avec le SRID 4326 (WGS 84) :

SELECT ST_AsEWKT(ST_PointFromText('POINT(119 40)', 4326));

Résultat :

        st_asewkt
-------------------------
 SRID=4326;POINT(119 40)
(1 row)

Dans cet exemple, 119 correspond à la longitude (X) et 40 à la latitude (Y).

Fonctions associées

  • ST_GeomFromText — construit n’importe quel type de géométrie à partir d’une chaîne WKT ; plus rapide que ST_PointFromText lorsque l’entrée est garantie comme étant un point.

  • ST_MakePoint — construit un point 2D, 3DZ ou 4D à partir de coordonnées ; recommandé pour les cas d’utilisation sensibles aux performances.

  • ST_Point — construit un point à partir de coordonnées.