返回兩個(gè)Geometry對象間的二維最短線段。
語法
geometry ST_ShortestLine(geometry g1 , geometry g2);
參數(shù)
參數(shù)名稱 | 描述 |
---|---|
g1 | 第一個(gè)Geometry對象。 |
g2 | 第二個(gè)Geometry對象。 |
描述
- 如果找到不止一條,該函數(shù)將僅返回第一條最短的Line對象。
- 如果g1和g2僅在一個(gè)點(diǎn)處相交,則該函數(shù)將返回一條在該相交點(diǎn)處具有起點(diǎn)和終點(diǎn)的Line對象。
- 如果g1和g2與一個(gè)以上的點(diǎn)相交,則該函數(shù)將返回一條以相同的點(diǎn)為起點(diǎn)和終點(diǎn)的Line,但是它可以是任何相交的點(diǎn)。
- 返回的Line將始終以g1開始,以g2結(jié)尾。
- 該函數(shù)返回的Line的長度將始終與g1和g2的ST_Distance返回值相同。
示例
默認(rèn)調(diào)用:
SELECT ST_AsText(ST_ShortestLine('POINT(0 0)'::geometry,'LINESTRING(0 2,1 1)'::geometry));
st_astext
---------------------
LINESTRING(0 0,1 1)
(1 row)