バッチリクエストを送信しています
Batch Geocoder API は、リソースjobsを提供し、ジオ コーディングおよびリバースジオ コーディングのリクエストを一括して送信することができます。 最初の送信は、次の 入力データ のガイドラインに準拠している必要があります。 オプションの入力フィールドを使用して、ジョブの実行方法を制御するための追加情報を入力できます。 バッチ処理（ Batch Geocoder API ）は、ジオ コーディングを処理し、ジオ コーディングを非同期に反転します。 リクエストのライフサイクルの詳細について は、「リクエストのライフサイクルとジョブ」を参照してください。 ジョブの結果を要求する方法の例について は、「ジョブの結果を取得する」を参照してください。
成功したバッチ要求の出力を取得するには、次の手順を実行する必要があります。
- POSTリクエストを使用して、データを
jobsリソースにアップロードします。 - データアップロード要求のレスポンスに含まれる
RequestIdの値を使って、GETリクエストでジョブのステータスを確認します。ジョブステータスがcompletedの場合にのみ、結果をダウンロードすることができます。 - データのアップロードリクエストに対する応答に含まれている
RequestIdの値を使用して、 GET リクエストを送信し、結果をダウンロードします。
wgetまたはcURLを使用してリクエストを送信する場合は 、フィールド名 ( 例 &outCols=recId,…: ) および入力と出力両方のリクエストのフィールド区切り文字を確認してください。 問題がある場合、または区切り文字が入力ファイルの区切り文字と一致しない場合は、wget または cURLは、「 400 Bad Request 」を返します。 wget と cURL の両方で、ヘッダーにコンテンツタイプを指定する必要があります。 圧縮されたアドレスデータのアップロードは現在サポートされていません。
wget
wget ヘッダーを使用します Content-Type: text/plainジオ コーディングリクエストの例 :
wget --header="Content-Type: text/plain; charset=UTF-8" --post-file=addresses.txt
"https://batch.geocoder.ls.hereapi.com
/6.2/jobs?
&apiKey={YOUR_API_KEY}
&action=run
&header=true
&inDelim=;
&outDelim=,
&outCols=recId,latitude,longitude,locationLabel
&outputcombined=true
&language=de-DE" リバースジオコーディングのバッチリクエストを送信するには、入力ファイルに地理的座標について定義された一連の場所が含まれている必要があります。また、パラメータ mode を retrieveAddresses に設定する必要があります:
wget --header="Content-Type: text/plain; charset=UTF-8" --post-file=locations.txt
"https://batch.geocoder.ls.hereapi.com
/6.2/jobs?
&apiKey={YOUR_API_KEY}
&action=run
&header=true
&inDelim=;
&outDelim=,
&outCols=recId,latitude,longitude,locationLabel
&outputcombined=true
&language=de-DE
&mode=retrieveAddresses"cURL
cURLを使用する場合は、次のヘッダーContent-Type: text/plain--data-binaryパラメーターを使用してペイロードを送信してください。 ジオ コーディングリクエストの例 :
curl -X POST -H "Content-Type: text/plain" --data-binary @addresses.txt
"https://batch.geocoder.ls.hereapi.com
/6.2/jobs?
&apiKey={YOUR_API_KEY}
&action=run
&header=true
&inDelim=;
&outDelim=,
&outCols=recId,latitude,longitude,locationLabel
&outputcombined=true
&language=de-DE" リバースジオコーディングのバッチリクエストを送信するには、入力ファイルに地理的座標について定義された一連の場所が含まれている必要があります。また、パラメータ mode を retrieveAddresses に設定する必要があります。
curl -X POST -H "Content-Type: text/plain" --data-binary @locations.txt
"https://batch.geocoder.ls.hereapi.com
/6.2/jobs?
&apiKey={YOUR_API_KEY}
&action=run
&header=true
&inDelim=;
&outDelim=,
&outCols=recId,latitude,longitude,locationLabel
&outputcombined=true
&language=de-DE
&mode=retrieveAddresses"