ST_3DClosestPoint
Prev  7.12. Measurement Functions  Next

Name

ST_3DClosestPoint — Retorna o ponto 3 dimensional em g1 que é o mais próximo de g2. Este é o primeiro ponto da linha mais curta em três dimensões.

Synopsis

geometry ST_3DClosestPoint(geometry g1, geometry g2);

Descrição

Retorne o ponto 3-dimensional no g1 que é mais perto ao g2. Esse é o primeiro ponto da menor linha 3D. O comprimento 3D da menor linha 3D é a distância 3D.

This function supports 3d and will not drop the z-index.

This function supports Polyhedral surfaces.

Disponibilidade: 2.0.0

Alterações: 2.2.0 - se 2 geometrias 2D são entradas, um ponto 2D retorna (em vez do antigo comportamento assumindo 0 para Z perdido). Em caso de 2D e 3D, o Z não é mais 0 para Z perdido.

Exemplos

linestring e ponto -- pontos 3d e 2d mais próximos 

SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt,
                ST_AsEWKT(ST_ClosestPoint(line,pt)) As cp2d_line_pt
        FROM (SELECT 'POINT(100 100 30)'::geometry As pt,
                        'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 1000)'::geometry As line
                ) As foo;

cp3d_line_pt                                                |               cp2d_line_pt
-----------------------------------------------------------+------------------------------------------
POINT(54.69937988676193 128.93502291722837 11.547586950660556) | POINT(73.07692307692307 115.38461538461539)

linestring e multiponto -- pontos 3d e 2d mais próximos 

SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt,
                ST_AsEWKT(ST_ClosestPoint(line,pt)) As cp2d_line_pt
        FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt,
                        'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 900)'::geometry As line
                ) As foo;

cp3d_line_pt                        | cp2d_line_pt
-----------------------------------------------------------+--------------
POINT(54.69937988676193 128.93502291722837 11.547586950660556) | POINT(50 75)

Multilinestring e polígono pontos 3d e 2d mais próximos 

SELECT ST_AsEWKT(ST_3DClosestPoint(poly, mline)) As cp3d,
    ST_AsEWKT(ST_ClosestPoint(poly, mline)) As cp2d
        FROM (SELECT  ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, 50 60 5, 100 100 5, 175 150 5))') As poly,
                ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 -2, 125 100 1, 175 155 1),
                (1 10 2, 5 20 1))') As mline ) As foo;

cp3d                    |     cp2d
-------------------------------------------+--------------
POINT(40.45454545454545 53.63636363636364 5) | POINT(20 40)