開発者向け情報

本サイト(BODIK ODCS)は、九州・山口地域のオープンガバメントデータを提供するプラットフォームです。
BODIK ODCSの概要はこちらを参照下さい。

Web APIについて

BODIK ODCSではデータカタログサイトのプラットフォームとしてCKANを利用しています。

CKAN APIを利用してデータセットのメタデータへWeb API経由でアクセス可能です。
またCSVやXLSといった表形式のデータについては、ファイルの中身にアクセス可能になっています。

CKAN API
http://docs.ckan.org/en/latest/api/index.html
BODIK ODCSのCKAN Site URLはhttp://data.bodik.jp/となります。
上記CKAN APIのマニュアルでは、demo.ckan.orgの部分をdata.bodik.jpに置き換えてご利用ください。

例)
データセット一覧を取得します。
http://data.bodik.jp/api/3/action/package_list

自治体の一覧を取得します。
http://data.bodik.jp/api/3/action/organization_list

久留米市のデータセット一覧を取得します。
http://data.bodik.jp/api/3/action/package_search?q=organization:402036

「環境」というキーワード検索に引っかかるデータセットの一覧を取得します。
http://data.bodik.jp/api/3/action/package_search?q=環境

※CKANでは1つのデータセットに複数のリソース(ファイル)が登録できるようになっています。
例)http://data.bodik.jp/dataset/402036_0009900_00003/
データセットを検索する場合は「package_search」、リソースを検索する場合は「resource_search」を利用します。

「学校」というキーワード検索に引っかかるリソース(ファイル)の一覧を取得します。
http://data.bodik.jp/api/3/action/resource_search?query=name:学校

リソース「久留米市立学校一覧」(CSVファイル)の最初の5行を取得します。
http://data.bodik.jp/api/action/datastore_search?resource_id=7863c7b3-0e24-4776-b262-b91770ab787e&limit=5

リソース「久留米市立学校一覧」(CSVファイル)から「金丸小学校」を含む行を取得します。
http://data.bodik.jp/api/action/datastore_search?resource_id=7863c7b3-0e24-4776-b262-b91770ab787e&q=金丸小学校

Web APIで取得した日時について

CKANでは時刻はすべてUTC(協定世界時)で登録されています。
Web APIで取得した日時もUTCです。日本で利用する場合はJST(+9:00)に変換してご利用ください。
WebサイトではJSTで表示するようにしていますので、Webサイトの表示とAPIで取得した日時が異なりますのでご注意ください。

ビッグデータ&オープンデータ・イニシアティブ九州 ビッグデータ&オープンデータ・イニシアティブ九州
〒814-0001 福岡市早良区百道浜2-1-22-7F
TEL:092-852-3510 FAX:092-852-3455
ckan
wordpress