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_PointFromTextlorsque 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.