リスクマップ配信 mapserv.riskmap

リスクマップ配信APIは、リスクマップのリスク等高線ポリゴンを取得します。

実行方式は JSON-RPC v2.0 を利用します。

リクエスト例

{
  "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で指定した時間以降で直近の時間分のリスクマップが返却されます。