Documentation
ドキュメントの検索
karat

+

K

APIリファレンス ↗
データ接続と統合Pipeline Builder TransformsGeometry knn left join

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

Geometry knn left join

対応バッチ

各有効なベースデータセットのジオメトリに対して、ネイバーズデータセットから最も近いk個のポイントを選択します。内部的には、入力データセットを指定された座標リファレンスシステムに変換し、WGS84に戻します。ネイバーズデータセット全体がドライバーおよびエグゼキューターのメモリに収まる必要があります。3GBのエグゼキューターは、ネイバーズデータセット内の最大100万ポイントを処理できるはずです。

トランスフォームカテゴリ: Geospatial, Join

引数

  • Base dataset - ジョインに使用するベースデータセット。
    Table
  • Condition for columns to select on the left - 左の入力スキーマ内のすべての列がこの条件に一致するかどうかをテストします。一致する場合、その列は出力に選択されます。
    ColumnPredicate
  • Condition for columns to select on the right - 右の入力スキーマ内のすべての列がこの条件に一致するかどうかをテストします。一致する場合、その列は出力に選択されます。
    ColumnPredicate
  • Join key - クエリデータセットのGeoJSON列とネイバーズデータセットのgeopoint列。
    Tuple<Column<Geometry>, Column<GeoPoint>>
  • K - 左のデータセット内の各有効なジオメトリに対して右のデータセットから選択するネイバーの数。
    Literal<Integer>
  • Neighbors dataset - ジョインに使用する潜在的なネイバーのデータセット。
    Table
  • Projected coordinate system - 入力ジオメトリはジョインの前にこの座標系に変換され、距離は指定された座標系の単位で測定されます。「authority」の形式で、たとえばUTMゾーン18NはEPSG:32618で識別できます。
    Literal<String>
  • optional Prefix for columns from right - 右側のすべての列名に追加するプレフィックス。
    Literal<String>

例

例 1: 基本ケース

引数の値:

  • Base dataset: ri.foundry.main.dataset.left
  • Condition for columns to select on the left:
    columnNameIsIn(
     columnNames: [geometryCol, lhsCol],
    )
  • Condition for columns to select on the right:
    columnNameIsIn(
     columnNames: [geometryCol, col],
    )
  • Join key: (geometryCol, geometryCol)
  • K: 2
  • Neighbors dataset: ri.foundry.main.dataset.right
  • Projected coordinate system: epsg:2868
  • Prefix for columns from right: rhs_

入力: ri.foundry.main.dataset.left

geometryCollhsCol
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0

ri.foundry.main.dataset.right

geometryColcol
{
 latitude: 33.440609443703586,
 longitude: -112.14843750000001,
}		rhsVal1
{
 latitude: 33.44082430962016,
 longitude: -112.14560508728029,
}		rhsVal2
{
 latitude: 33.440895931474124,
 longitude: -112.11796760559083,
}		rhsVal3

出力:

geometryCollhsColrhs_geometryColrhs_col
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0{
 latitude: 33.440609443703586,
 longitude: -112.14843750000001,
}		rhsVal1
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0{
 latitude: 33.44082430962016,
 longitude: -112.14560508728029,
}		rhsVal2

例 2: 基本ケース

引数の値:

  • Base dataset: ri.foundry.main.dataset.left
  • Condition for columns to select on the left:
    columnNameIsIn(
     columnNames: [geometryColLhs, lhs-1],
    )
  • Condition for columns to select on the right:
    columnNameIsIn(
     columnNames: [geometryColRhs, rhs-1],
    )
  • Join key: (geometryColLhs, geometryColRhs)
  • K: 1
  • Neighbors dataset: ri.foundry.main.dataset.right
  • Projected coordinate system: epsg:2868
  • Prefix for columns from right: null

入力: ri.foundry.main.dataset.left

geometryColLhslhs-1

ri.foundry.main.dataset.right

geometryColRhsrhs-1

出力:

geometryColLhslhs-1geometryColRhsrhs-1

例 3: 基本ケース

引数の値:

  • Base dataset: ri.foundry.main.dataset.left
  • Condition for columns to select on the left:
    columnNameIsIn(
     columnNames: [geometryCol, lhsCol],
    )
  • Condition for columns to select on the right:
    columnNameIsIn(
     columnNames: [geometryCol, col],
    )
  • Join key: (geometryCol, geometryCol)
  • K: 2
  • Neighbors dataset: ri.foundry.main.dataset.right
  • Projected coordinate system: epsg:2868
  • Prefix for columns from right: rhs_

入力: ri.foundry.main.dataset.left

geometryCollhsCol
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}43.0

ri.foundry.main.dataset.right

geometryColcol
{
 latitude: 33.440609443703586,
 longitude: -112.14843750000001,
}		rhsVal1
{
 latitude: 33.44082430962016,
 longitude: -112.14560508728029,
}		rhsVal2
{
 latitude: 33.440895931474124,
 longitude: -112.11796760559083,
}		rhsVal3

出力:

geometryCollhsColrhs_geometryColrhs_col
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0{
 latitude: 33.440609443703586,
 longitude: -112.14843750000001,
}		rhsVal1
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}43.0{
 latitude: 33.440609443703586,
 longitude: -112.14843750000001,
}		rhsVal1
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0{
 latitude: 33.44082430962016,
 longitude: -112.14560508728029,
}		rhsVal2
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}43.0{
 latitude: 33.44082430962016,
 longitude: -112.14560508728029,
}		rhsVal2

例 4: 基本ケース

引数の値:

  • Base dataset: ri.foundry.main.dataset.left
  • Condition for columns to select on the left:
    columnNameIsIn(
     columnNames: [geometryCol, lhsCol],
    )
  • Condition for columns to select on the right:
    columnNameIsIn(
     columnNames: [geometryCol, col],
    )
  • Join key: (geometryCol, geometryCol)
  • K: 3
  • Neighbors dataset: ri.foundry.main.dataset.right
  • Projected coordinate system: epsg:2868
  • Prefix for columns from right: rhs_

入力: ri.foundry.main.dataset.left

geometryCollhsCol
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0

ri.foundry.main.dataset.right

geometryColcol
{
 latitude: 33.440609443703586,
 longitude: -112.14843750000001,
}		rhsVal1
{
 latitude: 33.440609443703586,
 longitude: -112.14843750000001,
}		rhsVal1
{
 latitude: 33.44082430962016,
 longitude: -112.14560508728029,
}		rhsVal2
{
 latitude: 33.44082430962016,
 longitude: -112.14560508728029,
}		rhsVal2
{
 latitude: 33.440895931474124,
 longitude: -112.11796760559083,
}		rhsVal3

出力:

geometryCollhsColrhs_geometryColrhs_col
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0{
 latitude: 33.440609443703586,
 longitude: -112.14843750000001,
}		rhsVal1
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0{
 latitude: 33.440609443703586,
 longitude: -112.14843750000001,
}		rhsVal1
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0{
 latitude: 33.44082430962016,
 longitude: -112.14560508728029,
}		rhsVal2

例 5: 基本ケース

引数の値:

  • Base dataset: ri.foundry.main.dataset.left
  • Condition for columns to select on the left:
    columnNameIsIn(
     columnNames: [geometryColLhs, lhs-1],
    )
  • Condition for columns to select on the right:
    columnNameIsIn(
     columnNames: [geometryColRhs, rhs-1],
    )
  • Join key: (geometryColLhs, geometryColRhs)
  • K: 1
  • Neighbors dataset: ri.foundry.main.dataset.right
  • Projected coordinate system: epsg:2868
  • Prefix for columns from right: null

入力: ri.foundry.main.dataset.left

geometryColLhslhs-1

ri.foundry.main.dataset.right

geometryColRhsrhs-1
{
 latitude: 33.44082430962016,
 longitude: -112.14560508728029,
}		null
{
 latitude: 33.440895931474124,
 longitude: -112.11796760559083,
}		rhsVal2
nullrhsVal3

出力:

geometryColLhslhs-1geometryColRhsrhs-1

例 6: 基本ケース

引数の値:

  • Base dataset: ri.foundry.main.dataset.left
  • Condition for columns to select on the left:
    columnNameIsIn(
     columnNames: [geometryColLhs, lhs-1],
    )
  • Condition for columns to select on the right:
    columnNameIsIn(
     columnNames: [geometryColRhs, rhs-1],
    )
  • Join key: (geometryColLhs, geometryColRhs)
  • K: 1
  • Neighbors dataset: ri.foundry.main.dataset.right
  • Projected coordinate system: epsg:2868
  • Prefix for columns from right: null

入力: ri.foundry.main.dataset.left

geometryColLhslhs-1
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0
{"coordinates": [-112.14560508728029,33.44082430962016], "type":"Point"}43.0

ri.foundry.main.dataset.right

geometryColRhsrhs-1

出力:

geometryColLhslhs-1geometryColRhsrhs-1
{"coordinates": [-112.14843750000001,33.440609443703586], "type":"Point"}42.0nullnull
{"coordinates": [-112.14560508728029,33.44082430962016], "type":"Point"}43.0nullnull

例 7: 基本ケース

引数の値:

  • Base dataset: ri.foundry.main.dataset.left
  • Condition for columns to select on the left:
    columnNameIsIn(
     columnNames: [geometryCol, lhsCol],
    )
  • Condition for columns to select on the right:
    columnNameIsIn(
     columnNames: [geometryCol, col1, arrayCol],
    )
  • Join key: (geometryCol, geometryCol)
  • K: 5
  • Neighbors dataset: ri.foundry.main.dataset.right
  • Projected coordinate system: epsg:4326
  • Prefix for columns from right: rhs_

入力: ri.foundry.main.dataset.left

geometryCollhsCol
{"coordinates": [[[0.0, 0.0], [10.0, 0.0], [10.0, 10.0], [0.0, 10.0], [0.0, 0.0]]], "type": "Polygon"}42.0

ri.foundry.main.dataset.right

geometryColcol1arrayColtoDrop
{
 latitude: 33.440609443703586,
 longitude: -112.14843750000001,
}		rhsVal1[ 0.0, 1.1 ]1.0
{
 latitude: 33.44082430962016,
 longitude: -112.14560508728029,
}		rhsVal2[ 0.0, 1.1 ]1.0
{
 latitude: 33.440895931474124,
 longitude: -112.11796760559083,
}		rhs