ST_Transform associe une géométrie à un système de références spatiales différent de celui auquel elle est actuellement associée.
Syntaxe
db2gse.ST_Transform(g db2gse.ST_Geometry, SRID db2gse.coordref)
Type de retour
db2gse.ST_Geometry
Exemples
L'instruction CREATE TABLE ci-après crée la table TRANSFORM_TEST, qui comporte deux colonnes de type ligne, LN1 et LN2.
CREATE TABLE TRANSFORM_TEST (tid integer, l1 db2gse.ST_LineString, l2 db2gse.ST_LineString)
L'instruction INSERT ci-après insère une ligne dans la colonne l1 avec un SRID de 102.
INSERT INTO TRANSFORM_TEST VALUES (1, db2gse.ST_LineFromText('linestring (10.01 40.43, 92.32 29.89)', db2gse.coordref()..srid(102)),NULL)
La fonction ST_Transform convertit la ligne contenue dans la colonne L1 de la référence de coordonnée affectée au SRID 102 en la référence de coordonnée affectée au SRID 105. L'instruction UPDATE ci-après enregistre la ligne transformée dans la colonne l2.
UPDATE TRANSFORM_TEST SET l2 = db2gse.ST_Transform(l1, db2gse.coordref()..srid(105))
Si la géométrie ainsi associée est en dehors des limites du système de coordonnées sous-jacent au nouveau système de références spatiales, ST_Transform renvoie la géométrie sous forme d'une valeur nulle.
Par exemple, soit une géométrie ST_Point dotée d'une coordonnée X de
10.01 et d'une coordonnée Y de 20.02. Supposons que
cette géométrie soit associée à un système de références spatiales ayant les
paramètres suivants :
falsex | 0 |
falsey | 0 |
xyunits | 1 |
Supposons ensuite que vous appeliez la fonction ST_Transform pour remplacer
le système de références spatiales de la géométrie ST_Point par un autre
système possédant les paramètres suivants :
falsex | 100 |
falsey | 100 |
xyunits | 1 |
ST_Transform renverra la géométrie sous forme d'une valeur nulle car ses coordonnées (10.01, 20.02) sont en dehors des limites du système de coordonnées sous-jacent au nouveau système de références spatiales.