マップ取得API - mapserv.predictmap
予測マップ取得APIは、予測マップの時空間属性およびその他の属性を取得します。
実行方式は JSON-RPC v2.0
を利用します。
エンドポイント
https://<api-server-endpoint>/api/v1/evwhapi/jsonrpc
リクエスト例
{
"jsonrpc": "2.0",
"method": "mapserv.predictmap",
"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_predictmap"
}
パラメータ
リクエストパラメータは 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,...] | 対象予測マップ | 必須 |
出力サンプル
戻り値
GeoJSON (FeatureCollection) 形式で返します。
各 Feature の geometry には geom の GeoJSON 表現が、
properties には theme に予測マップ名が、あとはカラム名と値のセットが入ります。
説明
予測マップに含まれる時空間属性、およびその他のすべての属性データを取得します。
start_datetimeとend_datetimeで指定した期間、themesで指定した予測マップ(複数可)に含まれる等高線ポリゴンデータのうち、 GeoJSON の geometry パートで指定した領域と交差するものを返します。- 対象期間,対象予測マップ数, Geometry パートが大きい場合,非常に大きな GeoJSON が返ることがあります。
- 「予測マップ取得API」は、時空間属性に加え、それ以外のすべての属性データも返します。リスク値だけを取得したい場合は「リスクマップ取得API」を使用してください。