XYZ 値の追加プロセッサーは、ポイント ジオメトリーを含むイベント レコードから x、y、z 座標を取得するときに使用します。 座標値はイベント レコードにアペンドされます。イベント レコードの新しいスキーマを記述する新しいジオイベント定義が必要です。
例
XYZ 値の追加プロセッサーの使用例を次に示します。
- アプリケーションでは、イベント レコードの場所をフィーチャ JSON、GeoJSON、または汎用 JSON のジオメトリー表現ではなく、個別の座標として表現する必要があります。
- このプロセッサーを使用して、フィーチャ JSON から座標を抽出できます (例: フィーチャ サービスからフィーチャのポイント ジオメトリーを抽出)。
- このプロセッサーで抽出された x、y、z の値は、方位の計算プロセッサーの入力起点または終点として使用できます。
使用上の注意
XYZ 値の追加プロセッサーを使用する際には、以下の点を考慮してください。
- このプロセッサーは、ポイント ジオメトリーからの座標値の抽出のみをサポートしています。 このプロセッサーは、ArcGIS Server をポーリング (フィーチャ サービス) 入力コネクターまたは REST エンドポイントでフィーチャを受信入力コネクターからインポートされたイベント データとの組み合わせが最適です。
- プロセッサーに送信されるイベント レコードには、ポイント ジオメトリーを含むジオイベント定義が必要です。 ジオメトリー値は、各イベント レコードの x、y、z 座標値を取得するために使用されます。
- [X フィールド]、[Y フィールド]、[Z フィールド] のデフォルトの名前値はそれぞれ x、y、z ですが、これらの値は変更できます。 たとえば、[X フィールド] パラメーターに「longitude」、[Y フィールド] パラメーターに「latitude」、[Z フィールド] パラメーターに「altitude」または「height」として指定できます。
- [X フィールド]、[Y フィールド]、および [Z フィールド] パラメーターはすべて必須です。 このプロセッサーをフィールド マッパー プロセッサーまたはフィールド リデューサー プロセッサーと組み合わせて、プロセッサーが作成した出力ジオイベント定義のスキーマを変更します。
パラメーター
XYZ 値の追加プロセッサーのパラメーターについては、以下で説明します。
| パラメーター | 説明 |
|---|---|
|
Name |
GeoEvent Manager で参照用として使用されるプロセッサの記述名。 |
|
プロセッサ |
選択されたプロセッサを示します。 |
|
ジオメトリー フィールド |
プロセッサーが x、y、z 座標値の抽出に使用するイベント レコードのジオメトリー フィールドまたは [GEOMETRY] タグが付いたフィールドの名前。 指定したジオメトリー フィールドはポイント ジオメトリーである必要があります。 |
|
出力ジオイベント定義 |
プロセッサーによって作成される出力ジオイベント定義の名前を指定します。 作成されたジオイベント定義には、新しいスキーマの一部として x、y、z 座標フィールドがアペンドされます。 |
| X フィールド | x 座標値が格納されるフィールドの名前。 このフィールドは、プロセッサーによって作成される新しいジオイベント定義に追加されます。 デフォルトは x です。 |
| Y フィールド | y 座標値が格納されるフィールドの名前。 このフィールドは、プロセッサーによって作成される新しいジオイベント定義に追加されます。 デフォルトは y です。 |
| Z フィールド | z 座標値が格納されるフィールドの名前。 このフィールドは、プロセッサーによって作成される新しいジオイベント定義に追加されます。 デフォルトは z です。 注意:ポイント ジオメトリーに z 座標値が含まれていない場合、デフォルトの [0.0] が z 座標値として使用されます。 |
検討事項および制限事項
XYZ 値の追加プロセッサーを使用する際には、以下の点を考慮してください。
- このプロセッサーは、受信ジオイベント定義のジオメトリー フィールドまたはタグを使用してポイント ジオメトリーを識別し、x、y、z 座標値を取得します。 ジオメトリー フィールドまたはタグが存在しない場合、このプロセッサーを構成する前に、ジオメトリー フィールドを作成するか、[GEOMETRY] タグを既存のフィールドに適用する必要があります。 受信ジオメトリー フィールド名が [geometry] である場合、または [GEOMETRY] タグがすでに使用されている場合、この制限は適用されません。
- 新しいフィールドが追加されるため、プロセッサーでは新しいジオイベント定義が作成されます。 新しいフィールドを追加してイベント レコードのスキーマを変更するには、GeoEvent Server は常に新しいジオイベント定義を作成する必要があります。
- プロセッサーは、マルチポイント、エンベロープ、ポリライン、ポリゴンなど、他のジオメトリー タイプの座標値の配列を取得しません。 ポイント ジオメトリーの座標値の抽出のみがサポートされています。