| Anchor | ||||
|---|---|---|---|---|
|
| Table of Contents | ||
|---|---|---|
|
| Info |
|---|
これまでマーケットプレイス (サポートサイト) に掲載されていたPitneyBowes Forward Geocodingのプラグインは、今後サポートされません (2023年11月1日をもって終了)。詳細はこちらの記事をご確認ください。これらのコードのレガシーバージョンへのアクセスをご希望の場合は、Yellowfin サポートチームまでお問い合わせください。 |
概要
ユーザーは、PitneyBowes forward geocoding APIを活用することで、インプットしたアドレスから緯度/経度を取得し、ジオポイント値へ変換することができます。これは、顧客のアドレスを拡張する際に有効です。
...
こちらのステップを使用するためには、Yellowfinの環境に、PitneyBowes Geocodeのプラグインをインストールしなくてはいけません。
- Yellowfinのマーケットプレイスからプラグインをダウンロードします。（トランスフォーメーションステップ項目から検索することができます）※日本国内のユーザーは、Yellowfin サポートサイトからダウンロードしてください。プラグインをダウンロードします。
- Yellowfinのインスタンスへこれをインストールします。プラグインのインストール方法については、こちらを参照してください。
...
- 基礎的な設定：アドレス全体が単一行のインプットとして提供される場合は、こちらの設定を使用します。
Advanced configuration（高度な設定）：アドレスの個々の要素が個別に指定されている場合は、こちらの設定を使用します。左側が空白のフィールド、またはnull値のフィールドは無視されます。こちらはより具体的な設定のため、Full Address（フルアドレス）バージョンよりも優れた結果を生成する傾向があります。
Tip 計算フィールドステップを使用し、各フィールドにプラス（+）演算子を用いることで、分割アドレスを連結することもできます。
- API KeyとAPI Secret：これは、PitneyBowes APIへ接続するための詳細情報です。これらの値は、geocodingステップを実行するために必要です。API Keyを取得するためには、こちらを参照してください。：https://www.pitneybowes.com/us/developer/geocoding-apis.html
- Preview Mode Row Limit（プレビューモードでのロウ（行）制限）：PitneyBowes APIは、トランスフォーメーションフローを構成、またはテストする際に、迅速に消費されるクレジットのシステムを使用します。こちらのフィールドを使用して、プレビュー実行でこのステップに消費されるクレジット量の上限を設定することができます。こちらの値を0に設定すると、制限は適用されません。各データロウ（行）がクレジットを使用するため、こちらで指定した数字は、データプレビューパネルに表示されるロウ（行）数に影響します。注意：クレジットは、フローがすでに発行され、実行されている場合には適用されません。
...
多くのデータベースはジオメトリーフィールド型を保存することができないため、一致したジオポイントは「POINT（緯度, 経度）」のテキスト文字列として返されます。例：POINT(-112.1234, 45.123)。この値は、データベース機能（SQLサーバ、など）や、Yellowfinのビューレベルのよく知られたテキスト、またはWKTコンバーターを使用したマップ表示のために、ジオメトリーオブジェクトに変換することができます。
ステップ設定手順
...
- Advanced configuration（高度な設定）トグルを有効にします。追加のオプション設定が表示されます。
- 異なるアドレスの詳細を選択します。
...
トラブルシューティング
手順が失敗した場合は、様々な原因が考えられます。
...