詳細天気検索

API名: 
pptenki/mesh
概要: 
ピンポイント天気5kmメッシュ毎の詳細天気情報を取得します。

※この機能を利用するには別途契約が必要です。

URI: 

http://core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/mesh

<API使用例>
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/mesh?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.6633583%2C139.7613555&timelater=3

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
latlon   - 緯度経度
llboundsとの同時指定はできません
llbounds   - 緯度経度矩形範囲
latlonとの同時指定はできません
datetime   現在日時 日時
天気を取得する日時をYYYYMMDDhhの形式で指定します。最大で指定できるのは現在時間から48時間後までです。現在日時より過去の日時は指定できません。
timelater   8 検索範囲時間
指定日時(datetime)から天気を取得する時間(n時間分)を指定します。1~49の範囲で指定可能です。ただし、最大で取得できるのは現在時間から49時間分です。
datum   TOKYO 測地系
入出力緯度経度の測地系を指定します。

出力データ
出力フォーマット
{"status":{"code":"0000",
           "text":"OK"},
 "item":[{"area":{"sw":{"lat":35.65,
                        "lon":139.75},
                  "ne":{"lat":35.7,
                        "lon":139.8125}},
          "center":{"lat":35.675,
                    "lon":139.78125},
          "weatherData":[{"time":"201302181200",
                          "weather":{"code":"2",
                                     "text":"雨"},
                          "detailWeather":{"code":"300",
                                           "text":"雨"},
                          "temperature":4.9,
                          "wind":{"code":"1",
                                  "text":"上"},
                          "windVelocity":2.5,
                          "rainfall":0.7,
                          "uv":{"code":"1",
                                "text":"弱い"},
                          "lightning":{"code":"0",
                                       "text":"なし"},
                          "fog":{"code":"3",
                                 "text":"雨"}},...]
         }...]
}

キー名 データ型 説明
status       object ステータス情報が入ります。
  code     string ステータスコードが入ります。
説明
0000 正常終了
0001 タイムアウト発生またはデータサイズが
制限値を超えたため処理が中断された
  text     string ステータス内容に関するテキスト情報が入ります。
item       array 検索結果天気データの配列となります。
検索結果が0件の場合は空の配列となります。
  area     object 天気取得矩形範囲
  center     object 天気取得中心の緯度経度
  weatherData     array 天気データオブジェクト。
1時間毎の天気データの配列となります。
    time   string 予報に該当する日時を返却します。
    weather   object 気象情報。
データが存在しない場合はNULLを返却します。
      code string 気象情報コード(1桁)が入ります。
気象情報
0
1 曇り
2
4
      text string 気象情報
    detailWeather   object 気象詳細情報。
データが存在しない場合はNULLを返却します。
      code string 気象詳細情報コード(3桁)
      text string 気象詳細情報
    temperature   number 気温。
データが存在しない場合はNULLを返却します。
    wind   object 風向き。
データが存在しない場合はNULLを返却します。
      code string 風向きコード
北を上とした風の方向を示します。
風向き
0 風なし
1
2 右上
3
4 右下
5
6 左下
7
8 左上
      text string 風向き
    windVelocity   number 風速。
データが存在しない場合はNULLを返却します。
    rainfall   number 降水量。
データが存在しない場合はNULLを返却します。
    uv   object UV情報。
データが存在しない場合はNULLを返却します。
      code string UV情報コード
情報
0 なし
1 弱い
2 中程度
3 強い
4 非常に強い
5 極端に強い
      text string UV情報
    lightning   object 落雷情報。
データが存在しない場合はNULLを返却します。
      code string 落雷情報コード
情報
0 なし
1 弱雷
2 中雷
3 強雷
      text string 落雷情報
    fog   object 霧情報。
データが存在しない場合はNULLを返却します。
      code string 霧情報コード
情報
0 無し
1 薄霧
2 濃霧
3
      text string 霧情報

出力例

[通常出力例]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/mesh?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.6633583%2C139.7613555&timelater=3

{"status":{"code":"0000",
           "text":"OK"},
 "item":[{"area":{"sw":{"lat":35.65,
                        "lon":139.75},
                  "ne":{"lat":35.7,
                        "lon":139.8125}},
          "center":{"lat":35.675,
                    "lon":139.78125},
          "weatherData":[{"time":"201302181200",
                          "weather":{"code":"2",
                                     "text":"雨"},
                          "detailWeather":{"code":"300",
                                           "text":"雨"},
                          "temperature":4.9,
                          "wind":{"code":"1",
                                  "text":"上"},
                          "windVelocity":2.5,
                          "rainfall":0.7,
                          "uv":{"code":"1",
                                "text":"弱い"},
                          "lightning":{"code":"0",
                                       "text":"なし"},
                          "fog":{"code":"3",
                                 "text":"雨"}},
                         {"time":"201302181300",
                          "weather":{"code":"2",
                                     "text":"雨"},
                          "detailWeather":{"code":"300",
                                           "text":"雨"},
                          "temperature":5.2,
                          "wind":{"code":"1",
                                  "text":"上"},
                          "windVelocity":1,
                          "rainfall":0.6,
                          "uv":{"code":"1",
                                "text":"弱い"},
                          "lightning":{"code":"0",
                                       "text":"なし"},
                          "fog":{"code":"3",
                                 "text":"雨"}},
                         {"time":"201302181400",
                          "weather":{"code":"2",
                                     "text":"雨"},
                          "detailWeather":{"code":"300",
                                           "text":"雨"},
                          "temperature":5.8,
                          "wind":{"code":"5",
                                  "text":"下"},
                          "windVelocity":2,
                          "rainfall":2.3,
                          "uv":{"code":"1",
                                "text":"弱い"},
                          "lightning":{"code":"0",
                                       "text":"なし"},
                          "fog":{"code":"3",
                                 "text":"雨"}}]}]}

[検索結果が0件の場合]
 

{"status":{"code":"0000",
           "text":"OK"},
 "item":[]}