Name
ST_DWithin — Gibt TRUE zurück, wenn die Raster "rastA" und "rastB" innerhalb der angegebenen Entfernung voneinander liegen.
Synopsis
boolean ST_DWithin( raster rastA , integer nbandA , raster rastB , integer nbandB , double precision distance_of_srid );
boolean ST_DWithin( raster rastA , raster rastB , double precision distance_of_srid );
Beschreibung
Gibt TRUE zurück, wenn die Raster "rastA" und "rastB" innerhalb der angegebenen Distanz zueinander liegen. Wenn die Bandnummer nicht angegeben ist (oder auf NULL gesetzt), dann wird nur die konvexe Hülle des Rasters zur Überprüfung herangezogen. Wenn die Bandnummer angegeben ist, werden nur die Pixel mit einem Wert (nicht NODATA) bei der Überprüfung herangezogen.
Die Distanz wird in den Einheiten des Koordinatenreferenzsystems des Rasters angegeben. Damit diese Funktion Sinn hat, müssen die Quellraster dieselbe Projektion und die gleiche SRID haben.
![[Note]](../images/note.png)
|
|
|
Dieser Operand benützt jeden Index, der für den Raster zur Verfügung stellt. |
|
|
|
|
Um die räumliche Beziehung zwischen einem Raster und einer Geometrie zu untersuchen, wenden Sie bitte ST_Polygon auf den Raster an, z.B.: ST_DWithin(ST_Polygon(raster), geometry). |
Verfügbarkeit: 2.1.0
Beispiele
SELECT r1.rid, r2.rid, ST_DWithin(r1.rast, 1, r2.rast, 1, 3.14) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;
rid | rid | st_dwithin
-----+-----+------------
2 | 1 | f
2 | 2 | t