Page Comparison

概要

こちらのデータトランスフォーメーションステップは、OpenCage forward GeoCiding APIを活用することで、単一のテキストアドレスカラム（列）や、複数のアドレスパートフィールドの組み合わせから、緯度/経度を取得し、ジオポイント値へ変換します。

OpenCage APIについて、より詳細な情報は、こちらを参照してください。https://geocoder.opencagedata.com/ 

セットアップ

こちらのステップを使用するためには、Yellowfinの環境に、OpenCage GeoCodeのプラグインをインストールしなくてはいけません。

1. Yellowfinのマーケットプレイスからプラグインをダウンロードします。（トランスフォーメーション項目から検索することができます）
2. Yellowfinのインスタンスへこれをインストールします。プラグインのインストール方法については、こちらを参照してください。

設定概要

ステップの設定詳細について、簡単に概説します。

インプットオプション

...

...

ステップの出力

APIは、アドレスに提供された詳細のレベルに基づき、可能な緯度/経度の一覧を返します。このステップは、この一覧から最初に一致したものを選択します。APIが何の一致も返さない場合は（不十分なアドレス詳細が提供された場合に発生する可能性があります）、null値が表示されます。

返されるポイントは、APIが作成した一致レベルの中心になります。例えば、住所が提供され、APIがこれを実際の住所と一致することができた場合、ジオポイントは実際のアドレスに配置されます。しかし、市町村区だけが一致した場合は、返されるジオポイントは市の中心地になります。

多くのデータベースはジオメトリーフィールド型を保存することができないため、一致したジオポイントは「POINT（緯度, 経度）」のテキスト文字列として返されます。例：POINT(-112.1234, 45.123)。この値は、データベース機能（SQLサーバ、など）や、Yellowfinのビューレベルのよく知られたテキスト、またはWKTコンバーターを使用したマップ表示のために、ジオメトリーオブジェクトに変換することができます。

ステップ設定手順

...

トラブルシューティング

手順が失敗した場合は、様々な原因が考えられます。

• • API Keyが使用制限を超過している（無料評価版を使用している場合）。このステップの使用を継続するためには、新しいKeyが必要です。
  • 提供されたAPI Keyが不正確であった。
  • 提供されたインプットアドレスフィールドが不正確である（または、カラム（列）のデータ型に一致しない）。

...