st_closestpoint

備考

プレビュー

この機能はパブリック プレビュー段階です。プレビュー登録は プレビュー ページで確認できます。「Databricks プレビューの管理」を参照してください。

ユークリッド距離に関して 2 番目のジオメトリに最も近い最初のジオメトリ上の点の 2D 投影を返します。

対応する Databricks SQL 関数については、 st_closestpoint関数を参照してください。

構文

Python

from pyspark.databricks.sql import functions as dbf

dbf.st_closestpoint(col1=<col1>, col2=<col2>)

パラメーター

パラメーター	Type	説明
col1	pyspark.sql.Column または str	最初のジオメトリ値。
col2	pyspark.sql.Column または str	2 番目のジオメトリ値。

注意

2 つのジオメトリは同じ SRID 値を持つと予想されます。そうでない場合はエラーが返されます。返されるポイントの SRID 値は、入力ジオメトリの共通 SRID 値と同じです。2 つの入力ジオメトリのいずれかが空の場合、2D の空のポイントを返します。

例

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('MULTIPOINT ZM (-10 10 -1 -10,2 10 -2 -20,20 10 -3 -30)','POINT Z (0 0 300)',)], ['wkt1', 'wkt2'])
df.select(dbf.st_asewkt(dbf.st_closestpoint(dbf.st_geomfromtext('wkt1', 3857), dbf.st_geomfromtext('wkt2', 3857)).alias('result'))).collect()

Output

[Row(result='SRID=3857;POINT(2 10)')]