Batch Geocoder API 開発者ガイド

はじめに - HERE Developer ポータル

このセクションで は、 HERE Developer ポータルのバッチ Geocoder API を使用してはじめにを迅速に作成する方法について説明します。
  1. HERE アカウントを取得
  2. プロジェクトを作成
  3. プロジェクトを構成します
  4. リクエストの送信
注 : このセクションでは、バッチ Geocoder API の使用を迅速に開始するために必要な最小セットアップについて説明します。HERE アカウントの設定、アプリの登録、および認証の詳細について は、『 Identity & Access Management 開発者ガイド』を参照してください。

HERE アカウントを取得

If you are an individual developer who has signed up for one of the plans listed on our Developer plans page on here-tech.skawa.fun, you received a HERE account ID when you signed up. You can use your HERE account to log in to here-tech.skawa.fun to create applications. Applications (uniquely identified by an app ID) enable development with HERE products and services.

アプリを登録します

アプリを登録するには、次の手順を実行します。
  1. Sign in to here-tech.skawa.fun.
  2. 名前をクリックし 、 [ プロジェクト] を選択して、一覧からプロジェクトを選択します。 プロジェクトの詳細と利用可能なアプリケーションの資格情報が表示されます。
  3. API キー を作成をクリック して、アプリケーションに最大 2 つの API キーを生成します。 API キー が作成され、表示されます。

API キー を入手してください

API キー を取得するには、次の手順を実行します。
  1. Sign in to here-tech.skawa.fun.
  2. 名前をクリックし 、 [ プロジェクト] を選択して、一覧からプロジェクトを選択します。 プロジェクトの詳細と利用可能なアプリケーションの資格情報が表示されます。
  3. 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>