設定

返されるレコード数や検索距離の上限を設定し、端までの距離、カウント、インデックスの各フィールドを出力に含めることができます。

表 1. Find Nearest の設定
出力オプション 説明
制限 任意の検索ジオメトリに対して返されるレコード数を制限するための設定です。フローとシステムで最大限の性能が得られるように、これらの制限を少なくとも 1 つ設定することを強くお勧めします。
返されるレコードの数を制限します

デフォルトでこのオプションは選択されており、デフォルト値として 1 が設定されています。これを選択しない場合、指定された距離の範囲内にあるすべての最も近い候補が返されます。その場合はパフォーマンスに影響が生じる可能性があります。

MaxCandidates 入力フィールドで指定した値はこの設定よりも優先されます。

検索距離を制限します

デフォルトでこのオプションは選択されており、1 マイルという値が設定されています。0 以上の値が有効ですが、検索距離を 0 にすると、入力ジオメトリと交差する結果のみが返されることになります。使用可能な単位は、マイル、センチメートル、フィート、インチ、キロメートル、メートル、ヤードです。

MaxDistance および MaxDistanceUnit 入力フィールドで指定した値はこの設定よりも優先されます。

Distance

Include distance

このオプション (デフォルトで選択されています) は、入力ジオメトリから返されたレコードまでの最短距離を知りたい場合に便利です。

距離フィールド - 入力ジオメトリから返されたレコードまでの最短距離を含みます。返されたレコードが入力を包含するか、入力と交差する場合、返される距離は 0 となります。

距離単位フィールド - 距離単位を含む出力フィールドの名前。

距離単位 - 返される距離の単位 (マイル、センチメートル、フィート、インチ、キロメートル、メートル、またはヤード)。

辺までの距離を含める

このオプションは、ポイントがジオメトリの境界線にどれだけ近いかを知る必要がある場合に便利です。デフォルトでは選択されていません。

[端までの距離] フィールド - 境界線までの距離を含む出力フィールドの名前。境界線までの最短距離、つまり入力ジオメトリと返されたレコードのジオメトリの最も近い 2 つのポイントの間の距離が常に含まれます。返される距離の単位は、上の [距離単位] ドロップダウン リストで選択したものと同じです。

交差した境界線を含むジオメトリは 0 (ゼロ) を返します。一方のジオメトリがもう一方のジオメトリを完全に含んでいる場合、フィールドは距離の値を返します。

Include count and index

このオプションは、多数のレコードが返され、それぞれを互いに識別する必要がある場合に便利です。

カウント フィールド - 各入力に対して返されたレコードの総数を含む出力フィールドの名前。

インデックス フィールド - 出力レコード コレクションにおける現在のレコードの順序を表します。

例えば "5 件のうちの 1 件目" である場合、カウントは 5、インデックスは 1 になります。