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

フロー

このリソースは、地理空間エリアのトラフィックフローデータに対する要求を処理する役割を果たします。応答には、速度と輻輳 ( 「紙詰まり係数」 ) の情報が含まれています。配信形式は、 XML または JSON のいずれかです。リクエストでは、道路の形状および機能クラス情報を任意で指定できます。この情報を使用すると、交通量情報を取得できます。

レスポンス

有効な例 :

<TRAFFICML_REALTIME xmlns="http://traffic.nokia.com/trafficml-flow-3.1" CREATED_TIMESTAMP="2023-06-09T07:22:11Z" MAP_VERSION="" UNITS="metric" VERSION="3.1">
  <RWS TY="TMC" MAP_VERSION="202302" EBU_COUNTRY_CODE="D" EXTENDED_COUNTRY_CODE="E0" TABLE_ID="1" UNITS="metric">
    <RW mid="04d02108-a3c6-43eb-bf75-dbd5ba6b5361" LI="D01-50187" DE="B1" PBT="2023-06-09T07:22:11Z">
      <FIS>
        <FI>
          <TMC PC="20256" DE="Stralauer Straße" QD="+" LE="0.69024"/>
          <SHP>52.52091,13.41504 52.52055,13.41458 52.52029,13.41421 52.52007,13.41377 52.51998,13.41356 52.51982,13.41319 52.51944,13.41234 52.51932,13.41216 52.51921,13.41193 52.51892,13.41132 52.51871,13.41088 52.51851,13.41046 52.5182,13.40982 52.51803,13.40947 52.51774,13.40889 52.51762,13.40867</SHP>
          <SHP>52.51762,13.40867 52.51747,13.40844 52.51733,13.40852 52.51723,13.4087 52.51719,13.40878 52.51714,13.4089 52.51707,13.409 52.51699,13.40903 52.51695,13.40901 52.51687,13.40892 52.51677,13.4088</SHP>
          <CF CN="0.99" FF="37.7" JF="3.14159" SP="20.37" SU="20.37" TY="TR">
            <SSS>
              <SS FF="39.09" JF="1.13277" LE="0.17592" SP="34.33" SU="34.33"/>
              <SS FF="42.14" JF="6.65113" LE="0.19989" SP="18.43" SU="18.43"/>
              <SS FF="33.68" JF="2.2034" LE="0.12201" SP="25.7" SU="25.7"/>
              <SS FF="35.32" JF="3.14159" LE="0.19241" SP="14.61" SU="14.61"/>
            </SSS>
          </CF>
        </FI>
      </FIS>
    </RW>
  </RWS>
</TRAFFICML_REALTIME>

一般的な使用例のパラメータの組み合わせ

表 1. フローデータを要求するためのパラメータ
必須です	オプションです
`quadkey`、 `prox`、 `bbox`、または `corridor` (Z / X / Y アドレスを除く )	`maxfunctionalclass` `minjamfactor` `maxjamfactor`

応答データの形式

このリソースは、アドレス指定方式に応じて、 JSON の XML で応答データを配信できます。

[Z]/[X]/[Y] アドレス指定 - URL 変数を使用するか xmljson、またはなどのリソース名の直後にある変数を使用します .../flow/xml/... .../incidents/json/...
それ以外の場合は、リソース拡張子 .xml を使用するか .json.../flow.json/...、またはなどを使用します。 .../incidents.xml/...

作業 URL の詳細については、例も参照してください。

リソースパラメーター

表 2. トラフィックフロー要求パラメータ
パラメーター	説明
認証パラメータ
`app_code`	`xs:string` クライアントアプリケーションの認証に使用される 20 バイトの Base64 URL セーフエンコード文字列。 `app_id` すべて `app_code` のリクエストに AND を含める必要があります。認証の詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。
`app_id`	`xs:string` クライアントアプリケーションの認証に使用される 20 バイトの Base64 URL セーフエンコード文字列。 `app_id` すべて `app_code` のリクエストに AND を含める必要があります。認証の詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。
`apiKey`	`xs:string` A 43-byte Base64 URL-safe encoded string used for the authentication of the client application. As a logged in user, you can generate it at https://here-tech.skawa.fun/projects. API Keys never expire but you can invalidate your API Keys at any time. You cannot have more than two API Keys for one app at the same time. `apiKey` すべてのリクエストにを含める必要があります。認証の詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。
メイン（地理空間）フィルタ
`bbox`	`GeoBoundingBoxType`: lat 、 lon ; lat 、 lon 空間フィルタのタイプ。空間フィルタは、要求の対象となる領域 ( データまたはマップタイルを取得する領域 ) を定義します。バウンディングボックスは、 2 つの緯度と経度のペアで指定された長方形の領域を表します。 1 つ目のペアは、バウンディングボックスの左上隅、 2 つ目の右下隅を定義します。注 : バウンディングボックスの最大の幅と高さは 10 度です。
`prox`	`GeoProximityType`: lat 、 long 、 distance 空間フィルタのタイプ。空間フィルタは、要求の対象となる領域 ( データまたはマップタイルを取得する領域 ) を定義します。近傍を使用した要求に対する応答には、 A 緯度とその中心および半径の経度によって定義された円の範囲内にある結果が含まれます（メートル単位で指定）。
`corridor`	`GeoCorridorType`: lat 、 lon 、 lat 、 lon 、 lat 、 lon 、 lat 、 lon 、 [etc.]; width 空間フィルタのタイプ。空間フィルタは、要求の対象となる領域 ( データまたはマップタイルを取得する領域 ) を定義します。廊下からのリクエストに対する応答には、廊下のエリア内にある結果が含まれます。経路と幅によって経路が定義されます。経路は、一連の緯度と経度のペアで表される、回廊の中央に沿った線です。廊下の幅はメートル単位で指定します。
`quadkey`	`QuadkeyType` 地球全体に及ぶタイルのグリッド内のマップタイルの識別子。 quadkey は、 0 ～ 21 桁の 1 つの数値文字列です。 quadkey が参照するグリッドのマップズームレベルは、 quadkey 文字列の桁数と同じです。 quadkey アドレッシング方式のエンドポイントでのみ使用します。 Quadkeys も参照してください。
追加のフィルタ
`profile`	`xs:string` プロファイルでは、地理的カバレッジ (TMC テーブルを使用可能 ) やタイルオーバーレイのカスタムカラーマッピングなどの属性を定義します。
`responseattributes`	`xs:list` トラフィックフローのデータ応答に含めるオプション情報を示すリストのコンテナ。デフォルトでは、このパラメータで指定されていない限り、応答にはシェイプまたは機能クラスの情報は含まれません。受け入れられる値は、次の指定子のリストです。 `sh` または `shape` `fc` `responseattributes`パラメーターを使用したリクエストの例については、「バウンディングボックスフィルター」を参照してください。
`locationreferences`	`xs:list` トラフィックフローのデータ応答に含めるオプション情報を示すリストのコンテナ。デフォルトでは、応答には DLR 情報は含まれず、 TMCS のみが返されます。受け入れられる値は、次の指定子のリストです。 `shp` `tmc` `locationreferences`パラメータを使用したリクエストの例については、「 DLR を使用したトラフィックフローデータ」を参照してください。
`minjamfactor`	`xs:double` 応答に含めるトラフィックフローアイテムの最小ジャムファクター値のインジケータ。 `minjamfactor` パラメータで指定された値よりもジャム係数が小さいすべてのフローイベントが省略されます。このパラメータは、混雑した道路でのみフローデータを必要とするクライアントが使用できます。値の範囲は `0.0` ～ `10.0` ( 両端を含む ) にする必要があります。
`maxjamfactor`	`xs:double` 応答に含めるトラフィックフローアイテムの最大ジャムファクター値のインジケータ。 `maxjamfactor` パラメータで指定された値よりも higherjam のフローイベントはすべて省略されます。このパラメータは、渋滞のない道路でのみフローデータを必要とするクライアントで使用できます。値の範囲は `0.0` ～ `10.0` ( 両端を含む ) にする必要があります。
`jsoncallback`	`xs:string` JSON 応答のラップに使用するユーザー定義関数の名前を指定するパラメータ。
`maxfunctionalclass`	`xs:int` トラフィックフロー項目を応答に含めるために照合する必要がある最大機能クラスのインジケータ。このパラメータの値よりも小さいか、または同じ機能クラスを持つすべての項目が応答に含まれます。機能クラスの詳細については、 FunctionalClassType を参照してください。
`units`	`xs:string` このパラメータは、応答のすべての値が必要な単位系に変換されることを保証するために使用されます。次の値を受け入れます。メートル法英単位系既定では、このパラメータを指定しない場合、値はコンテンツフィードから受信したものと同じ単位系で返されます。
`ts`	`xs:boolean` このパラメータは、通過可能なステータス情報をフロー応答に提供するために使用されます。このステータスは、指定されたトラフィック項目の状態を示します。ここで、 TS が「 C 」に設定されている場合、これは標準的な道路閉鎖であり、他の属性は次のとおりである。 sp="-1" 、 su="-1" 、 jf="10.0" のように入力します。これは、 TML 2.0 以降、 TML Flow がクロージャーをどのように示してきたかと整合性があります。 TS が「 O 」に設定されている場合、道路は交通のために開放されている。これには、舗装されている正逆転可能道路が含まれます TS が「 RNR 」に設定されている場合、可逆道路はルーティングできず、他の属性は次のようになります。 sp="-1" 、 su="-1" 、 jf="-1" 。次の値を受け入れます。正しい誤りデフォルトでは、値は false に設定されています。