はじめに
HERE アカウントを取得します
フレキシブル HERE 基本プランから無料の HERE platform アカウントを使用し作成できます。 詳細については、 HERE 基本プランの価格表を参照してください。 または、会社がすでに HERE platform 組織を作成している場合は、組織管理者に連絡して、会社の組織に参加するよう招待してください。
プロジェクトを作成します
- HERE アカウントを使用して HERE platform にサインイン。
- ランチャーから[プロジェクトマネージャ]を開きます。
- [ 新しいプロジェクトを作成] をクリックする。
- プロジェクトの名前を入力する。プロジェクト名は一意である必要はありません。
- プロジェクト ID を入力します。 プロジェクト ID は組織内で一意である必要があり、組織の有効期間中は変更できません。プロジェクト ID の長さは 4 ~ 16 文字である必要があります。
- 任意 :任意の説明を入力します。
- [保存]をクリックする。
API キー を入手してください
- HERE アカウントを使用して HERE platform にサインイン。
- ランチャから [アクセスマネージャ] を選択します。
- [ アプリ] タブを選択し、[ 新しいアプリ を登録 ] をクリックします。
- アプリ の名前を入力します。
- オプション: アプリ の説明を入力します。
- オプション : 前の手順で作成したプロジェクトを、プロジェクト フィールドへの既定のアクセス権から選択します。
- [ 登録] をクリックします HERE platform によって、一意のアプリ ID を持つ新しいアプリ が作成されます。
- [資格情報]タブで 、[API Keys]を選択 し、[API キーを生成]をクリック して、アプリケーション認証資格情報用に 最大 2 つのAPI キーを生成します。API キー が作成され、表示されます。
リクエストを送信します
トラフィック情報を取得する前に、application/xml
の Content-Type
HTTP ヘッダーを含む HTTP POST リクエスト として次の XML 本文を initsession
リソースに送信します。
<?xml version="1.0" encoding="UTF-8"?>
<init-session>
<tpeg format="TPEGBinary" messagesize="50000" sessionsize="1000" >
<loc-ref id="TMC" version="1.3" />
<loc-ref id="ETL" version="1.0" />
<loc-ref id="OLR" version="1.0"/>
<app id="TEC" version="3.2" />
<app id="TFP" version="1.0" expiration="17" />
</tpeg>
<countries current="DE" destination="FR" />
<configuration>
<att name="radius" value="10" />
<att name="expiration" value="600" />
<att name="timeout" value="300" />
<att name="frequency" value="180" />
</configuration>
</init-session>
Authorization
Bearer
て、トークンまたはクエリーパラメータを含むヘッダーを追加する必要があります。 使用可能な認証オプションについては、『 Identity & Access Management 開発者ガイド』を参照してください。
https://tpeg.cit.cc.api.here.com/tpeg/1.0/initsession
XML 応答には、トラフィック情報要求の URL および暗号化キーが含まれています。 応答の例を次に示します。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<init-session-response
url="https://tpeg.traffic.hereapi.com/tpeg/1.0/initsession"
key="99a8cd635aa563acaf0c486992d297ad">
<config name="fcd" value="enabled"/>
</init-session-response>
交通情報を取得します
initsession
要求を送信した後、application/octet-stream
の HTTP ヘッダー Content-Type
を含む HTTP POST リクエスト を送信して、トラフィック情報を応答で URL に送信します。 次の例では、単一のポイントの周囲のトラフィック情報を要求します。
<?xml version="1.0" encoding="UTF-8" ?>
<get-messages>
<locations>
<loc lat="52.55121" lon="13.16565"/>
</locations>
</get-messages>
- gzip を使用して XML 本文を圧縮します。
- gzip ファイルの長さをバイト単位で計算します。
- gzip データの長さをリトルエンディアンの 32 ビット整数で圧縮本文に事前に追加します。
- gzip の内容と長さの組み合わせを 0 で埋めて、 16 バイト分均等に割り切れるようにします。
- AES 128 を使用して、結果として得られる内容と長さのパディングされた組み合わせを次のように暗号化します。
- 16 バイトのランダムな整数を作成します。
- AES
InitSession
は、手順 4. の結果を CBC モードで暗号化します。このとき、手順 5. a で生成された整数が初期化ベクターとして使用され、応答のキーが使用されます。 追加のパディングは適用しません。
- AES で暗号化されたデータの結果のブロックを HTTP POST リクエスト として送信 します。このブロックには、ステップ 5.a で
content type application/octet-stream
として生成された整数が事前に付加され、initsession
応答で URL に送信されます。

- 応答の最初の 16 バイトを抽出します。
- 手順 1 のセッションキーを使用して、 AES で残りの応答を復号化します。
- 復号化されたデータの最初の 4 バイトから gzip コンテンツの長さを抽出します。
- gzip コンテンツを TPEGBinary 形式に展開します。

次のステップ
HERE Traffic TPEG API リファレンス の実装方法の詳細については、 HERE Traffic TPEG API の他に、概念およびチュートリアルのセクションを参照することをお勧めします。