こんにちは。CData Software Japan、API担当の杉本です！
今朝いつものようにAPI関連ニュースをチェックしていたら、熱いトピックがありましたね！
内閣官房のIT総合戦略室が地方公共団体が保有するオープンデータを横断的に活用することができる、APIプラットフォームを公開したみたいです！
www.atmarkit.co.jp
以下のページが公式です。
https://portal.opendata.go.jp/
以前までであれば、こういったオープンデータはCSVであったりExcelであったり、はたまはPDFで公開されている、みたいなこともありましたが、今回はREST ベースのAPIとして公開されていて、実にデベロッパーフレンドリーなオープンデータになっています！
しかも驚くべきことに、API仕様書は OpenAPI Specification 3.0で書かれていて、そのSpecも自由にダウンロードして利用できます。
対象データは現在第1段ということで、札幌市、会津若松市、群馬県、東京都、神奈川県、横浜市、福井県、三重県、神戸市、福岡市の10団体がCSV形式で公開している新型コロナウイルス感染症（COVID-19）関連のデータをWeb APIとして提供しているとのことでした。
ちになみにこのAPIプラットフォームサイトはGoogle の Apigeeを用いて作られているようです。
https://portal.opendata.go.jp/about-us
問い合わせフォームもGoogle フォームが使われてますね。
APIの使い方
API の使い方も簡単です。
公式のQuick Startでも十分ですが、実際に試してみたので、その模様をお伝えします。
https://portal.opendata.go.jp/quickstart
アカウントの作成
APIにアクセスするためには、アカウントから生成できるAPIKeyが必要になります。
まずSign In画面に移動してアカウントを作成します。
First Name・Last Name・Email・Passwordを入力するだけで作成できます。その後対象のメールアドレスに確認メールが送られてくるので、それを認証すればOKです。
アプリの作成
次にAPIアクセス用のアプリを作成します。
ログイン後のメニューから「Apps」に移動して
「＋New APP」をクリックして、アプリを作成します。
任意の名称とアクセスしたい対象のAPIを「Enable」にすればOKです。
作成後、APP ID・API Key・Secretが表示されます。ちなみに、APP IDやSecretは今の所特に使う必要は無いみたい？ です。OAuth 2.0なのかな？ と思いきやクエリパラメータにAPI Keyを付与するだけでした。
ポータルからAPIにアクセスしてみる
あとは任意のAPIにアクセスするだけです。今回は札幌のCOVID 19データにアクセスしてみました。（本当は私が住んでいる宮城県にしたかったんですが、まだ公開されていないみたいです・・・残念・・・。）
https://portal.opendata.go.jp/docs/sapporo-shi-product/1/overview
API仕様書の画面にアクセスしたら、右上の「AUTHORIZE」をクリックして
先程登録したアプリを選択します。
あとは対象のPATHSを選択して「Execute」をクリックすればAPIのレスポンスが確認できます。お手軽で素晴らしい。
PostmanからAPIにアクセスしてみる
せっかくなのでPostmanからもAPIにアクセスしてみましょう。まず、Open API SpecのURLを以下のリンクから採取します。
札幌のデータは「https://portal.opendata.go.jp/portals/api/sites/cas-jp-opendataapiportal/liveportal/apis/sapporo-shi-product/download_spec」になります。
このURLをPostmanの「Import」→「Link」のところに貼り付けます。
これでAPI SpecからPostman Collectionが自動生成されます。
次にインポートしたCollectionの設定に移動して「Authorization」タブで、API Keyを設定します。
デフォルトで以下のような設定になっているので、値：Valueのところに生成したAPI Keyを入力すればOKです。
これで任意のAPIにアクセスできるようになります。
CData REST Driver で繋いでみた
せっかくなので、私の会社の製品「CData REST Driver」でも繋いでみました。
ExcelからこのAPIに接続してみたいと思います。
www.cdata.com
トライアルをダウンロードして、セットアップすると、ExcelにCDataタブが追加されるので、「データの取得」から「取得元：REST」を選択します。
「URI」に対象のAPIとAPIkeyが付いたURL「例）https://api.opendata.go.jp/sapporo-shi/quarantine-center-cases?apikey=XXXXX」を入力し、「OK」をクリックします。
テーブルが一つ定義されるので、それを選択することで
データ取得のためのクエリ画面が表示されます。今回はそのままとりあえずデータをロードしてしまいます。
以下のようにAPIのレスポンスを一覧形式でロードすることができました。
あとはピボットグラフなどにしてしまえば、手軽にオープンデータが分析できますね。
おわりに
こういった動きは素晴らしいですね。
もちろん、まだまだ対象データが少なかったり、認証周りがAPIKeyクエリパラメータでいいのか？ レスポンスの型が全部Stringなんだけど、みたいな気になるところはいくつか見受けられますが、こういった展開はどんどん進んでほしいなと思います。
関連コンテンツ
