桜島Webサービス Kago-Net



桜島Webサービス Kago-Net api案内

桜島webサービス Kago-Net Apiとは

桜島webサービス Kago-Net Apiとは、鹿児島県に位置する活火山、桜島に関連する情報を活用して新たなコンテンツを制作する開発者の方のためのサービスです。下位互換を保つよう努めますが、挙動や仕様に随時変更があり、予告なくサービスが停止することもありえます。

サービス内容

桜島webサービス Kago-Net Apiが提供する情報は桜島の爆発・噴火情報等の気象情報をはじめとして、それに関連する地域情報他のコンテンツを提供します。

【提供するデータ】
桜島爆発情報 桜島噴火情報
【提供方法】
apiアクセスによるxml形式出力

更新情報

最終更新日:2010/2/4
2010/2/4 ■api機能追加を行いました
  ・桜島の爆発、噴火情報apiにjson形式でのレスポンス機能追加を行いました
2010/1/11 ■api機能追加を行いました
  ・桜島の爆発、噴火情報apiにフリーワード検索の機能追加を行いました
2010/1/5 ■サービスの稼働開始を行いました
  ・桜島の爆発、噴火情報apiの稼働を開始しました

1.桜島api一覧

現在以下のapiが公開されています。
・桜島爆発噴火情報api    

2.api利用方法

2-1.基本仕様

各apiは指定されたurlに対して、リクエストパラメータを指定しgetにてhttpクエリを発行することで利用することができ、 各apiの呼び出し結果(レスポンス)はxml、jsonいずれかの形で取得できます。
各apiのリクエスト、レスポンス仕様の詳細は「2-2.各api仕様詳細」をご覧ください。


2-2.api仕様詳細


2-2-1.桜島爆発噴火情報api

url http://www.kago-net.com/api/sakurajima.php?

リクエストパラメータ
パラメータ名 必須 説明 備考
ymdh integer 発表日時 YYYYMMDDHHにて指定。日付指定の場合はYYMMDDHHにて指定。
例)2009123122(2009/12/31 22:00)
例)200912(2009/12)
eruption   integer 爆発噴火 レスポンスに含まれる爆発、噴火の別を指定
1:爆発・噴火、
2:爆発、
3:噴火(デフォルト:爆発・噴火)
order   integer ソート順 レスポンスデータの時刻ソート順
1:昇順、
2:降順
(デフォルト:昇順)
start   integer 検索開始位置 検索結果の何件目から出力するかを指定します。(デフォルト:1)
count   integer 1ページあたり取得数 検索結果の最大出力データ数を1〜100までの半角数字指定(デフォルト:10)
freeword   string フリーワード検索 検索ワードをutf-8でurlエンコードすること。「,」区切りで複数ワードが検索可能(10個まで)
freeword_condition   string フリーワード検索条件タイプ フリーワード検索の条件を指定
1:and検索、
2:or検索
(デフォルト:and検索)
res   string レスポンス形式 レスポンス形式を指定
res=jsonでjson形式でのレスポンス
(デフォルト:xml形式)

レスポンス
パラメータ名
(タグ名、@付きは属性名)
出現回数 説明 備考
response 1 complextype レスポンスルートノード  
total_hit_count 1 integer 該当件数  
display_per_page 1 integer 表示件数  
display_from 1 integer 表示開始位置  
info 複数回 complextype 爆発噴火情報  
update_time 1 string 発表日時  
eruption 1 string 爆発噴火種別  
details 1 string 爆発噴火情報詳細  


お問い合わせ

連絡先他

フォームやtwitter[@kago_net]にてお問い合わせいただければ幸いです。

謝辞:webで有益な情報を公開しているすべての開発者に感謝します。



このホームページのご意見ご質問はこちら