sprintars WebAPI





結果

結果

sprintarsは、竹村俊彦教授(九州大学応用力学研究所)が開発責任者となり、 大気中の浮遊粒子状物質(エアロゾル)による地球規模の気候変動および大気汚染の状況を コンピュータにより再現・予測するために開発された数値モデル(ソフトウェア)です。 次のURLにて計算結果が公開されています。

https://sprintars.riam.kyushu-u.ac.jp/

上公開ページからデータを取得できるAPIを公開しており、全部で2種、提供しています。
PHP・Goutteを用いてスクレイピングを行っています。
本サービス使用にあたっては、どなた様も自由にご使用いただけます。
ただし本サービスをご使用する場合、自己責任においてお願いいたします。弊社として如何なる被害においても責任を負いかねます。
またレンタルサーバで運用していますので、予告なくサービス停止することがありますことご了承ください。
不具合ありましたらこちらまでメールをお願いします。可能な範囲で対応いたします。

竹村俊彦教授、およびsprinters開発に携わった方々に対しまして、有用なデータをご提供いただき感謝申し上げます。
① 指定都道府県
 次のように指定します。

 www.mm-s.biz/sprintars/sprintars_pref.php?Pref=<都道府県コード>

 都道府県コードは全国地方公共団体コードに従い、北海道を01として沖縄県が47として割り振られています。
 また00を指定すると、北海道における四地区(道央・道南・道東・道北)でのテータが得られます。
 成功するとJSON形式でデータが得られます。

 例:北海道詳細(00)の例
 https://www.mm-s.biz/sprintars/sprintars_pref.php?Pref=00


② 全国のデータ
 次のように指定します。

 www.mm-s.biz/sprintars/sprintars_all.php

 渡すパラメータはありません。
 成功するとJSON形式でデータが得られます。
 例:
 https://www.mm-s.biz/sprintars/sprintars_all.php


エラーについて
 戻ってくるJSONデータのstatusがtrueである場合が成功で、falseはエラーです。
 エラーは3種類で、errorとして次の文字列がセットされます。なお成功した場合は、errorは空白です。
 ① sprintarsのサーバから応答がないとき [SERVER no response.]
 ② 都道府県情報が内部で正しく処理できなかった場合 [PrefCode convert error.]
   ※ API内部のエラーです。
 ③ パラメータが間違っている場合 [parameter error.]
   ※ 指定都道府県のみで、スクレイピングを行う前に文字長さと数字確認を行っています。






本APIはJSONPに対応しておりajaxからのクロスドメインによる呼び出しが可能です。

読み出し方の例(北海道の詳細を読み出し)

<script src="https://code.jquery.com/jquery-1.11.1.min.js"></script>
<script>
    $.ajax({
        url: 'https://www.mm-s.biz/sprintars/sprintars_pref.php',
        type: 'GET',
        data: {
            format: "json",
            'Pref': "00"
        },
        dataType: 'jsonp',
        jsonpCallback: 'callback',
        success: function (d) {
            if (d.status) {
                //成功の場合...データカウントと1番目の1つめ(地域名)
                var cnt = d.count;
                var pref = d.data[0][0];
            } else {
                //エラーの場合
                var err = d.error;
            }
        },
        error: function (XMLHttpRequest, textStatus, errorThrown) {
            //AJAXに失敗した場合...
            document.getElementById("result").innerHTML = (XMLHttpRequest + "" + textStatus);
        }
    });
</script>
                        
                    

  2017年4月6日 新規作成
  2018年12月7日 HTTP対応
  2020年2月23日 Goutte(PHP)バージョンアップ対応