Traffic TPEG API 開発者ガイド（交通情報）

initsession リクエストを送信します

initsession 要求のパラメータは、 POST リクエスト XML 本文と URL の一部の両方で渡さ initsession れます。これらのパラメータは、要求 XSD に準拠している必要があります。次の表に、共通のパラメータを示します。

表 1. パラメーターをリクエストしてください
パラメーター	説明
`profile`	クライアントアプリケーションのプロファイルを定義する文字列値パラメータ。
承認	`app_id` およびを使用 `app_code`: `app_id={YOUR_APP_ID}&app_code={YOUR_APP_CODE}` 使用 : `apiKey` `apiKey={apiKey}` `token`承認の使用方法については、 https://developer.here.com/documentation/authentication/dev_guide/topics/token.html を参照してください。注 : トークン認証の基本 URL は https://tpeg.traffic.ls.hereapi.comです。

表 2. リクエストパラメータ POST
パラメーター	説明
`tpeg`	の子として 1 回だけ発生 `init-session`します。 @format: TPEGBinary 。 @messagesize: 整数。 @sessionsize: 整数。
`loc-ref`	の子として少なくとも 1 回発生 `tpeg`します。 @id: トラフィックメッセージチャネルを要求 ()`TMC` @version: 各規格のバージョン。現在 1.3 件です @id: 拡張 TMC 位置情報を要求 ()`ETL`。 @version: 各規格のバージョン。現在 1.0 です @id: 未完了の場所の参照をリクエスト ()`OLR`。 @version: 各規格のバージョン。現在 1.0 です。
`app`	の子として少なくとも 1 回発生 `tpeg`します。 @id: Traffic Event Compact ()`TECTFP`または Traffic Flow and Prediction() 1.0 アプリケーションを要求します。 @version: 各規格のバージョン。現在は 3.0 および 1.0 です。
`configuration`	の子として 1 回のみ発生 `init-session`できます。
`att name="radius"`	km 単位の任意の整数。 100 km 未満にする必要がありますデフォルト値は 10 km です
`att name="timeout"`	分単位の任意の整数。これは、デルタ機能をサポートするためのサービスの通知者です。値が 0 の場合、デルタ外機能を使用してすべての更新を受信します。つまり `getmessages` 、この時間枠内にリクエストが受信されなかっ `initsession` た場合、最初のセッションは引き続き有効で、すべての更新を処理します。デフォルト値は 100 分です。
`att name="expiration"`	分単位の任意の整数。この時間が経過すると、新しい `initsession` アカウントが必要になります。デフォルト値は 999 分です。
`att name="frequency"`	分単位の任意の整数。更新リクエストの頻度を示します。

リクエスト本文の例


<?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>

initsession 応答

initsession すべての応答は XML 形式 initsession で、応答 XSD に準拠しています。

応答の例


<?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>