リスクマップ取得API - mapserv.riskmap

リスクマップ取得APIは、リスクマップのリスク等高線ポリゴンを取得します。
実行方式は JSON-RPC v2.0 を利用します。

リスクマップデータの共通仕様

リスクマップは、時間属性（開始日時と終了日時）と空間属性（ポリゴン）、その時間と空間に観測された（または予測される）リスク値からなるレコードの集合です。

リスクマップは以下のカラムで構成されています。

カラム名	データ型
start_datetime	timestamp with time zone
end_datetime	timestamp with time zone
geom	geometry
risk	integer

start_datetime / end_datetime: 時間属性

5分刻みで開始日時と終了日時が記録されています。
geom: 空間属性

標準地域メッシュ(第1次メッシュから第3次メッシュ)、分割地域メッシュ(2分の1地域メッシュおよび4分の1地域メッシュ)の何れかで該当するメッシュ形状が記録されています。リスクマップ取得の際にどの粒度のメッシュで取得するか指定します。
risk: リスク値

相関ルール抽出で得られたルールを実データに適用すると、ルールに基いてある時間・場所の何かの値が得られます。 EvWH では降水量から渋滞の発生しやすさを求めたり、気温と湿度から大気汚染物質の飛散量を求めるルールを抽出するため、得られた値を「リスク値」と呼んでいます。リスク値は0から10の11段階で定義されています。

エンドポイント

https://<api-server-endpoint>/api/v1/evwhapi/jsonrpc

リクエスト例

{
  "jsonrpc": "2.0",
  "method": "mapserv.riskmap",
  "params": {
    "type": "Feature",
    "geometry": {
      "type": "Polygon",
      "coordinates": [[
          [139.25, 35.25], [139.25, 35.5], [139.625, 35.5],
          [139.625, 35.25], [139.25, 35.25]
      ]]
    },
    "properties": {
      "start_datetime": "2018-09-15 00:00:00",
      "end_datetime": "2018-09-15 01:00:00",
      "themes": ["riskmap_fujisawa"]
    }
  },
  "id": "mapserv_riskmap"
}

パラメータ

リクエストパラメータは GeoJSON の Feature 形式です。
Geometry には検索したい空間的範囲を指定します。タイプは Polygon, Line, Point やこれらの Collection でも構いません。
Properties には以下のパラメータを指定します。

パラメータ名	データ型	内容	既定値
start_datetime	string	日時 ("YYYY-MM-DD hh:mm:ss+TZ")	必須
end_datetime	string	日時 ("YYYY-MM-DD hh:mm:ss+TZ")	start_datetime + 1秒
themes	[string, [string,...]	対象リスクマップ	必須
target_theme_mesh_degree	int	対象リスクマップのメッシュ粒度	オプション(1~5)

出力サンプル

出力例

戻り値

GeoJSON (FeatureCollection) 形式で返します。

各ポリゴンに対応する Feature.properties の theme には対象リスクマップ名， risk にはリスク値， datetime には日時がそれぞれ格納されます。

説明

リスクマップのリスク等高線ポリゴンデータを取得します。

start_datetime と end_datetime で指定した期間、 themes で指定したリスクマップ（複数可）に含まれるリスク等高線ポリゴンデータのうち、 GeoJSON の geometry パートで指定した領域と交差するものを返します。
対象期間，対象リスクマップ数， Geometry パートが大きい場合，非常に大きな GeoJSON が返ることがあります。
「リスクマップ取得API」は、時空間属性以外は risk カラムに含まれるリスク値だけを返します。それ以外の属性値を取得したい場合は「予測マップ取得API」を使用してください。
target_theme_mesh_degree を含めてリクエストする場合は、start_datetimeで指定した時間以降で直近の時間分のリスクマップが返却されます。