Guide d'utilisation et de référence

ST_Transform

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.


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]