はじめに
このセクションでは、バッチ Geocoder API を使用して迅速にはじめにを作成する方法について説明します。
注 : このセクションでは、バッチ Geocoder API の使用を迅速に開始するために必要な最小セットアップについて説明します。HERE アカウントの設定、プロジェクトの作成、サービスのリンク、アプリ の登録、および認証の詳細については、 『 Identity & Access Management Guide』を参照してください。
HERE アカウントを取得
フレキシブル HERE 基本プランから無料の HERE platform アカウントを使用してはじめに を作成できます。 詳細 については、「 HEREBase プラットフォーム の価格」を参照してください。 または、会社が すでに HERE platform 組織を作成している場合は、組織管理者に連絡して、会社の組織に参加するよう招待してください。
プロジェクトを作成します
API キー を入手してください
API キー を取得するには、次の手順を実行します。
- HERE アカウントを使用して HERE platform にサインインします。
- ランチャから [アクセスマネージャ] を選択します。
- [ アプリ] タブを選択し、[ 新しいアプリ を登録 ] をクリックします。
- アプリ の名前を入力します。
- オプション: アプリ の説明を入力します。
- オプション : 前の手順で作成したプロジェクトを 、プロジェクト フィールドへの既定のアクセス権から選択します。
- [ 登録] をクリックします HERE platform によって、一意のアプリ ID を持つ新しいアプリ が作成されます。
- [資格情報]タブで 、[API Keys]を選択 し、[API キーを生成]をクリック して、アプリケーション認証資格情報用に 最大 2 つのAPI キーを生成します。API キー が作成され、表示されます。
リクエストを送信します
次の例では、リクエストの送信方法を示します。 完全な住所のリストに対応する地理座標を要求するには、次の手順を実行する必要があります。
- データをアップロードします。
- ジオ コーディングプロセスが完了するまで待つか、またはジョブステータスを確認してください。
- 結果をダウンロードします。
データをアップロードするには、次の POST リクエスト を送信します。
https://batch.geocoder.ls.hereapi.com/6.2/jobs
?apiKey={YOUR_API_KEY}
&indelim=%7C
&outdelim=%7C
&action=run
&outcols=displayLatitude,displayLongitude,locationLabel,
houseNumber,street,district,city,postalCode,county,
state,country
&outputcombined=false
POST ボディ
recId|searchText|country
0001|Invalidenstraße 116 10115 Berlin|DEU
0002|Am Kronberger Hang 8 65824 Schwalbach|DEU
0003|425 W Randolph St Chicago IL 60606|USA
0004|One Main Street Cambridge MA 02142|USA
0005|200 S Mathilda Ave Sunnyvale CA 94086|USA
上記のリクエストに対するレスポンスには、次のハイレベルな要素が含まれています。
-
RequestId
リクエストに作成されたジョブを示します。このジョブを使用して、ジョブの進行状況を追跡し、ジョブの完了時に結果を要求できます。 - このジョブのステータス。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:SearchBatch xmlns:ns2="http://www.navteq.com/lbsp/Search-Batch/1">
<Response>
<MetaInfo>
<RequestId>qr9jVjuoFe1mULUvBlXr7UK4dM8BpAkO</RequestId>
</MetaInfo>
<Status>accepted</Status>
<TotalCount>0</TotalCount>
<ValidCount>0</ValidCount>
<InvalidCount>0</InvalidCount>
<ProcessedCount>0</ProcessedCount>
<PendingCount>0</PendingCount>
<SuccessCount>0</SuccessCount>
<ErrorCount>0</ErrorCount>
</Response>
</ns2:SearchBatch>
次のステップ
Batch Geocoder API の正常な使用方法については、次のトピックを参照してください。