インシデント
このリソースは、または地理空間エリアの交通事故情報に対するリクエストを処理する役割を果たします。 配信形式は、 XML または JSON のいずれかです。 以下のリクエストパラメータは、両方のインシデントエンドポイント (6.0 および 6.1)* で有効です。
( * パラメータは例外 type
です。 詳細については、このパラメータの説明を参照してください)。
一般的な使用例のパラメータの組み合わせ
必須です | オプションです |
---|---|
|
|
必須です | オプションです |
---|---|
|
|
応答データの形式
このリソースは、アドレス指定方式に応じて、 JSON の XML で応答データを配信できます。
- [Z]/[X]/[Y] アドレス指定 - URL 変数を使用するか
xml
json
、またはなどのリソース名の直後にある 変数を使用します.../flow/xml/...
.../incidents/json/...
- それ以外の場合は 、リソース拡張子
.xml
を使用するか.json
.../flow.json/...
、またはなどを使用します。.../incidents.xml/...
作業 URL の詳細については、例も参照してください。
リソースパラメーター
パラメーター | 説明 |
---|---|
app_code | クライアント アプリケーションの認証に使用される 20 バイトの Base64 URL セーフエンコード文字列。 |
app_id | クライアント アプリケーションの認証に使用される 20 バイトの Base64 URL セーフエンコード文字列。 |
apiKey | 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. |
bbox | 空間フィルタのタイプ。 空間フィルタは、要求の対象となる領域 ( データまたはマップ タイルを取得する領域 ) を定義します。 バウンディング ボックスは、 2 つの緯度と経度のペアで指定された長方形の領域を表します。 1 つ目のペアは、バウンディング ボックスの左上隅、 2 つ目の右下隅を定義します。 注 : バウンディング ボックスの最大許容サイズ ( 幅および高さ ) は 10 度に制限されています。 |
c | 国のインジケータ ( インシデント対応のロケール ) 。 使用できる値は、特定の ISO 国コード (2 バイト、 ISO 3166-1-alpha-2) です。 パラメータ |
corridor | 空間フィルタのタイプ。 空間フィルタは、要求の対象となる領域 ( データまたはマップ タイルを取得する領域 ) を定義します。 廊下からのリクエストに対する応答には、廊下のエリア内にある結果が含まれます。 経路と幅によって経路が定義されます。 経路は、一連の緯度と経度のペアで表される、回廊の中央に沿った線です。 廊下の幅はメートル単位で指定します。 |
criticality | 重要度に応じてインシデントレポートを選択するフィルタ。大文字と小文字は区別されません。 このパラメータには、次のリストから選択した複数のカンマ区切り値を含めることができます。
このパラメータが指定されていない場合、重要度に関係なく、すべてのインシデントレポートが応答に含まれます ( デフォルトの動作 ) 。 |
endTime | 時間値をフィルタリングするときに使用する形式については、 xs:dateTime を参照してください。 |
i18n | インシデントメッセージを このパラメータで使用できる値は次のとおりです。
|
inc22 | 応答をバージョンと一致するように書式設定するかどうかを示すフラグ。 インシデントのうち 2.2 つの XSD () 使用できる値は次のとおりです。
|
jsoncallback | JSON 応答のラップに使用するユーザー定義関数の名前を指定するパラメータ。 |
lg | インシデント応答のロケール言語の指定子。 パラメータ 使用できる値については、「サポートされている翻訳言語」を参照 |
localtime | 交通事故データのリクエストに対する応答のすべての時間値が
|
maxresults | 回答に含める最大インシデント数のインジケータ。 正の数の値は 0 以外にすることができます。 |
profile | プロファイルでは、地理的カバレッジ (TMC テーブルを使用可能 ) やタイルオーバーレイのカスタムカラーマッピングなどの属性を定義します。 |
prox | 空間フィルタのタイプ。 空間フィルタは、要求の対象となる領域 ( データまたはマップ タイルを取得する領域 ) を定義します。 近傍を使用した要求に対する応答には、 A 緯度とその中心および半径の経度によって定義された円の範囲内にある結果が含まれます(メートル単位で指定)。 |
quadkey | 地球全体に及ぶタイルのグリッド内のマップ タイルの識別子。 quadkey は、 0 ~ 21 桁の 1 つの数値文字列です。 quadkey が参照するグリッドのマップズーム レベルは、 quadkey 文字列の桁数と同じです。 quadkey アドレッシング方式のエンドポイントでのみ使用します。 Quadkeys も参照してください。 |
sort | 重要度に基づいて、交通事故リクエストに対する応答データを並べ替える方法を指定するインジケータ。 使用できる値は次のとおりです。
|
startTime | 結果に含まれるインシデントと一致する最小開始時間( GMT 形式)。 時間値をフィルタリングするときに使用する形式については、 xs:dateTime を参照してください。 |
status | ステータスに応じてインシデントの選択をトリガーするステータスインジケータ。大文字と小文字は区別されません。 パラメータ値は、複数の値をコンマで区切って指定できます。 受け入れられるステータス値は、 |
tables | プロファイル内の TMC テーブルを指定して、応答に含めるか、または応答から除外するかを指定するパラメータ。 値に複数のテーブルが指定されている場合、テーブル ID はカンマで区切ります。 正の値が含まれ、負の値は除外されます。 注 : 正の値と負の値の組み合わせはサポートされていません。その結果、エラー応答が発生します。 デフォルトでは ( パラメータがリクエストで使用されていない場合 ) 、応答にはプロファイル内のすべてのテーブルが含まれます。 利用可能なテーブルの一覧については、 TMCCodeType の TMC テーブルまたは顧客プロファイルの一覧を参照してください。 |
type | 応答に含めるアイテムのタイプを指定するインジケータ。大文字と小文字は区別されません。 値には、複数のタイプ識別子をコンマで区切って含めることができます。 この値で使用できるトラフィック項目タイプの識別子は次のとおりです。
デフォルトでは(リクエストでパラメータが指定されていない場合)、タイプに関係なく、すべてのインシデントレポートが応答に含まれます。 *- このタイプは、インシデントバージョン 2.2 (traffic/6.1/incidents.endpoint) をリクエストする場合にのみサポートされます<format> |
verified | 確認済みのインシデントレポートを応答に含めるか、または除外するかを示すフラグ。 使用できる値は次のとおりです。
デフォルトでは、リクエストでこのパラメータが指定されていない場合、タイプに関係なく、すべてのインシデントレポートが応答に含まれます。 |
units | このパラメータは、応答のすべての値が必要な単位系に変換されることを保証するために使用されます。 次の値を受け入れます。
既定では、このパラメータを指定しない場合、値はコンテンツフィードから受信したものと同じ単位系で返されます。 |