# tGoogleGeocoder

人間が判読できるアドレスを地理座標に変換します。

tGoogleGeocoderはHTTPリクエスト経由でGoogle Places APIにアクセスして、ユーザーが提供するアドレス座標に従って詳細な地理座標を取得します。

Google Places APIの詳細は、[Google Places API](https://developers.google.com/places/documentation/)をご覧ください。

各データ行には、Places APIへの1つ以上の呼び出しが必要です。クオータは、Googleが提供するライセンスによります。クオータを超過するデータセットに対してコンポーネントを実行しないようにご注意ください。実行するとエラーメッセージが表示され、アドレスが修正されません。

Google Places APIの使用制限については、[Usage Limits and Billing](https://developers.google.com/maps/documentation/places/web-service/usage-and-billing)をご覧ください。

Google Places APIの利用規約については、[Terms of Service](https://developers.google.com/maps/terms?hl=en)をご覧ください。

デフォルトで、このコンポーネントはTalend Studioと共には出荷されていません。機能マネージャーを使ってインストールする必要があります。 詳細は、[機能マネージャーを使って機能をインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/install-features-to-talend-studio)をご覧ください。

## tGoogleGeocoderの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtGoogleGeocoderを設定するために使われます。

標準のtGoogleGeocoderコンポーネントは、データクオリティファミリーに属しています。

このコンポーネントは、Talend Data Management Platform、Talend Big Data Platform、Talend Real-Time Big Data Platform、Talend Data Services Platform、Talend Data Fabricで利用できます。

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| Pause(in 1/10 seconds) (一時停止(1/10秒単位)) | 地理情報レコードへのhttpリクエスト間のタイムブレーク。このフィールドのデフォルト値は1です。 |
| [Schema] (スキーマ)と[Edit Schema] (スキーマを編集) | スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは[Built-in] (組み込み)か、[Repository] (リポジトリー)にリモートで保存されます。 |
| Address column (アドレスカラム) | Google Places APIへのリクエスト送信に使用するパラメーターをこのリストから選択します。このリストのパラメーターは入力データのスキーマで事前定義されています。 |
| API key (APIキー) | Google Developer Console (https://developers.google.com/console/help/new/)からAPIキーを生成する必要があります。<br><br>キーを入力し、フィールドの横にある[…]ボタンをクリックします。<br><br>情報メモ注: 5.6以前の旧リリースから移行したジョブには、実行するキーが必要です。ジョブを実行する前にキーを生成し、tGoogleGeocoderの基本設定で設定を行ってください。<br><br>これらのジョブから入手する地理情報は、Google Geocoding APIに問い合わせた時に以前取得した情報とは異なる場合があります。 |
| [Sync columns] (カラムを同期) | このボタンをクリックすると、ジョブで接続されている前のコンポーネントからスキーマが取得されます。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| Import (インポート) | このフィールドをカスタマイズして、tGoogleGeocoderのJavaクラスをインポートします。デフォルトでは、この部分を変更する必要はありません。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、コンポーネントレベルでログデータを収集できます。 |
| [Enable parallel execution] (並列実行を有効化) | このチェックボックスを選択すると、複数のデータフローを同時に処理することにより、高速データ処理を実行できます。このフィーチャーは、データベースまたは複数の挿入を並行して処理するアプリケーションの機能と、関係するCPUの数に依存していることにご注意ください。[Number of parallel executions] (並列実行の数)フィールドで次のいずれかの操作を行います。<br><br><ul> <li>実行する並列実行の数を入力します。</li> <li><span>Ctrl + スペース</span>を押し、リストから適切なコンテキスト変数を選択します。コンテキスト変数の詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables" target="_blank">コンテキストと変数を使用</a>をご覧ください。 </li> </ul><br><br>並列実行を有効にすると、グローバル変数を使ってサブジョブで戻り値を取得することはできないことにご注意ください。<br><br><ul><li> <span>[Action on table] (テーブルでのアクション)</span>フィールドは、並列化ファンクションでは利用できません。したがって、テーブルを作成する場合は、<span>tCreateTable</span>のコンポーネントを使用する必要があります。 </li><li> 						            並列実行を有効にすると、グローバル変数を使ってサブジョブで戻り値を取得できません。 </li> </ul> |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | NB\_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。<br><br>ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。<br><br>変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、中間コンポーネントとして使用されます。このコンポーネントには入力コンポーネント、出力コンポーネント、および[Main] (メイン)リンク行が必要です。 |

**関連概念**

[アドレス情報を使った地理座標の取得](https://help.qlik.com/talend/ja-JP/components/8.0/google-address-standardization/tgooglegeocoder-tfixedflowinput-tlogrow-tlogrow-obtaining-geographic-coordinates-using-address-information-standard-component-enterprise-this)