Batch Geocoder API 開発者ガイド

はじめに

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

HERE アカウントを取得

フレキシブル HERE 基本プランから無料の HERE platform アカウントを使用してはじめに を作成できます。 詳細 については、「 HEREBase プラットフォーム の価格」を参照してください。 または、会社が すでに HERE platform 組織を作成している場合は、組織管理者に連絡して、会社の組織に参加するよう招待してください。

プロジェクトを作成します

プロジェクトを作成するには、次の手順に従います。
  1. HERE アカウントを使用して HERE platform にサインインします。
  2. ランチャーから[プロジェクトマネージャ]を開きます。
  3. [ 新しいプロジェクトを作成] をクリックする。
  4. プロジェクトの名前を入力する。プロジェクト名は一意である必要はありません。
  5. プロジェクト ID を入力します。 プロジェクト ID は組織内で一意である必要があり、組織の有効期間中は変更できません。プロジェクト ID の長さは 4 ~ 16 文字である必要があります。
  6. 任意の説明を入力する。
  7. [保存]をクリックする。

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

API キー を取得するには、次の手順を実行します。

  1. HERE アカウントを使用して HERE platform にサインインします。
  2. ランチャから [アクセスマネージャ] を選択します。
  3. [ アプリ] タブを選択し、[ 新しいアプリ を登録 ] をクリックします。
  4. アプリ の名前を入力します。
  5. オプション: アプリ の説明を入力します。
  6. オプション : 前の手順で作成したプロジェクトを 、プロジェクト フィールドへの既定のアクセス権から選択します。
  7. [ 登録] をクリックします HERE platform によって、一意のアプリ ID を持つ新しいアプリ が作成されます。
  8. [資格情報]タブで 、[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 の正常な使用方法については、次のトピックを参照してください