スキップして内容へ
HomeAPI大阪市Linked Open Data使用方法

大阪市Linked Open Data使用方法

APIについて

大阪市ではオープンデータのAPIとしてLinked Open Data(LOD)を採用しています。
LODとはウェブを基盤としたデータ流通の技術で、国際標準化された要素技術を組み合わせることで実現されます。
あらゆる事物(施設やイベントなど)に関する情報を構造化データとして提供しており、ウェブを経由して簡単に参照することができます。

ライセンス  

どなたでも、どんな目的でも自由にご利用いただけます。
大阪市のLODはオープンデータとして公開しています。
すべてのデータはクリエイティブ・コモンズ・ライセンス(CC BY 4.0)のもとご利用いただけます。
商用、非商用を問わずどなたでも自由に利用することができます。ただし、データを利用する際は原作者のクレジット(大阪市オープンデータ)を表示したうえで、可能であればデータへのリンクも含めるようにしてください。

aaaa

提供データ

大阪市が提供しているLODについての詳細情報です。

接頭辞

本文中では以下のとおり、接頭辞を用いてURIを省略して表記します。
また、以下のような既存の語彙についての用法や構造等の詳細についてはそれぞれのドキュメントを参照してください。

prefix name space
rdf http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs http://www.w3.org/2000/01/rdf-schema#
xsd http://www.w3.org/2001/XMLSchema#
dc http://purl.org/dc/elements/1.1/
dct http://purl.org/dc/terms/
dsv http://datashelf.jp/ns/dsv#
schema http://schema.org/
ic http://imi.ipa.go.jp/ns/core/rdf#

施設

Class base IRI
ic:施設型 http://data.city.osaka.lg.jp/rdf/resource/
属性
属性 定義
rdfs:label RDFリソースのラベル 文字列
ic:名称 施設の名称を表す ic:名称型
ic:表記 名称や住所等の表記 文字列
ic:カナ表記 名称のカナ表記 文字列
ic:種別 施設の種別を表す文字列 文字列
ic:種別コード 施設の種別を表すコード ic:コード型
ic:地理座標 地理空間座標 ic:座標型
ic:緯度 施設の地理空間上の緯度を示す値(WGS84) 文字列
ic:経度 施設の地理空間上の経度を示す値(WGS84) 文字列
ic:住所 所在地の住所 ic:住所型
ic:区 所在地のうち、区を記述 文字列
ic:連絡先 連絡先について 連絡先型
ic:電話番号 電話番号 文字列
ic:FAX FAX番号 文字列
ic:Webサイト WebサイトのURL 文字列
ic:バリアフリー バリアフリーに関する記述 文字列
ic:説明 施設に関する説明 文字列
施設クラスの主なインスタンス

ic:種別の値には次のような値が入っています。

  • 防火水槽
  • プール(指定水利)
  • 防災関連施設 - 防災スピーカー
  • 一時避難場所
  • 災害時避難所・一時避難場所
  • 防災関連施設 - 津波避難ビル
  • 官公庁/国の機関
例)ヘリポート
:50045 a ic:施設型 ;
  rdfs:label "鶴浜緑地(仮称)" ;
  ic:種別 "防災関連施設 - 災害時用へリポート" ;
  ic:名称 [
    ic:表記 "鶴浜緑地(仮称)"
  ] ;
  ic:住所 [
    ic:表記 "大正区鶴町3"
  ] ;
  ic:地理座標 [
    ic:緯度 "135.448339472222" ;
    ic:経度 "34.6408138055556"
  ] .
例)避難場所
:31252 a ic:施設型 ;
  rdfs:label "塩草小学校" ;
  ic:種別 "災害時避難所・一時避難場所" ;
  ic:名称 [
    ic:表記 "塩草小学校"
  ] ;
  ic:住所 [
    a ic:住所型 ;
    ic:区 "浪速区" ;
    ic:表記 "塩草1-4-31"
  ] ;
  ic:連絡先 [
    ic:電話番号 "6561-3095"
  ] ;
  ic:地理座標 [
    ic:緯度 "135.490601277778" ;
    ic:経度 "34.6613825277778"
  ] .

広報情報

現時点では都島区の広報情報のみ提供しています。
base IRIでは西暦YYYY、月MMを指定します。

Class base IRI
ic:イベント型 http://data.city.osaka.lg.jp/rdf/resource/都島区/広報情報/#{YYYY}/#{MM}
属性

同じクラスに属するインスタンスでも、付随する属性は異なります。

属性 定義
rdfs:label RDFリソースのラベル 文字列
ic:名称 広報情報の名称 ic:名称型
ic:表記 広報情報、場所、住所等の表記 文字列
ic:種別 広報情報や名称、料金等の種別 文字列
ic:開催場所 催しやイベントの開催場所 ic:場所型
ic:住所 開催場所や連絡先の住所 ic:住所型
ic:説明 広報情報の内容、期間についての補足説明等 文字列
ic:対象者 広報情報、催し、イベント等の対象者 文字列
dsv:対象者属性 広報情報、催し、イベント等の対象者属性 dsv:対象者属性型
dsv:在住 対象エリアに在住すること 文字列
dsv:在勤 勤務地が対象エリアにあること 文字列
dsv:在学 就学先が対象エリアにあること 文字列
ic:人数 催しやイベント等の募集人数 文字列
ic:期間 催しやイベント等の開催期間 ic:期間スケジュール型
dsv:開始日 催しやイベント等の開始日 文字列
dsv:終了日 催しやイベント等の終了日 文字列
dsv:開始時間 催しやイベント等の開始時間 文字列
dsv:終了時間 催しやイベント等の終了時間 文字列
dsv:申込み方法   dsv:申込み方法型
ic:備考 申込み方法や連絡先についての備考 文字列
dsv:ハガキでの申し込み ハガキでの申込み方法について 文字列
dsv:往復ハガキでの申し込み 往復ハガキでの申込み方法について 文字列
dsv:窓口での申し込み 窓口での申込み方法について 文字列
dsv:ウェブでの申し込み ウェブでの申込み方法について 文字列
dsv:メールでの申し込み メールでの申込み方法について 文字列
dsv:FAXでの申し込み FAXでの申込み方法について 文字列
dsv:電話での申し込み 電話での申し込み方法について 文字列
ic:料金 催しやイベント等の会費や参加費 ic:価格型
ic:金額 会費や参加費の金額 ic:金額型
ic:通貨コード 通貨コード uncefactISO4217:ISO3AlphaCurrencyCodeContentType
ic:通貨 通貨 文字列
ic:数値 金額を表す数値 数値
ic:連絡先 連絡先に関する情報 ic:連絡先型
ic:電話番号 連絡先等の電話番号 文字列
ic:FAX 連絡先等のFAX番号 文字列
ic:Eメールアドレス 連絡先等のEメールアドレス 文字列
ic:Webサイト 催しやイベント、連絡先等のWebサイト 文字列
ic:組織 連絡先の組織に関する情報 ic:組織型
ic:要約 広報情報や催し、イベントの内容の要約 文字列
dct:created 情報の作成日時 文字列
dct:modified 情報の変更日時 文字列
dct:publisher 情報の発行者 文字列
ic:ID 区等のID ic:ID型
ic:識別子 IDの識別子 文字列
例)広報情報
:11 a ic:イベント型 ;
  dct:created "2016-01-25"^^<http://www.w3.org/2001/XMLSchema#date> ;
  dct:modified "2016-01-25"^^<http://www.w3.org/2001/XMLSchema#date> ;
  dct:publisher <http://data.city.osaka.lg.jp/rdf/resource/区/271021> ;
  rdfs:label "第13回 都島区生涯学習フェスティバル" ;
  ic:名称 [
    ic:表記 "所得税・復興特別所得税、個人市・府民税の申告受付" ;
    ic:種別 "主題"
  ] ;
  ic:名称 [
    ic:表記 "~いきいき わくわく チャレンジフェスタ~" ;
    ic:種別 "副題"
  ]
  ic:開催場所 [
    ic:名称 [
      ic:表記 "大阪市立都島小学校 講堂他"
    ] ;
    ic:住所 [
      ic:表記 "大阪市都島区都島本通3-10-3"
    ]
  ] ;
  ic:期間 [
    a ic:期間スケジュール型 ;
    dsv:開始日 "2016-02-28" ;
    dsv:終了日 "2016-02-28" ;
    dsv:開始時間 "10:00" ;
    dsv:終了時間 "15:00"
  ] ;
  ic:連絡先 [
    ic:名称 [
      ic:表記 "大阪市都島区役所まちづくり推進課22番窓口"
    ] ;
    ic:住所 [
      ic:表記 "大阪市都島区中野町2-16-20"
    ] ;
    ic:電話番号 "06-6882-9743" ;
    ic:FAX番号 "06-6352-4558"
  ] ;
  ic:説明 "[内容](1)舞台発表(ハワイアンフラダンス・ウクレレ・社交ダンス・ジャズなど)※手話通訳あり(2)作品展示(絵手紙・フラワーアレンジメント・ステンシル・書道など)(3)体験コーナー(要材料費、材料がなくなり次第終了)(4)生涯学習の取り組み紹介 など<br />[主催]大阪市都島区役所・生涯学習推進員都島区連絡会"
  ic:要約 "大阪市都島区内の生涯学習ルームで活動されている皆さんが、日頃の成果を発表します。体験コーナーもあり、大人も子どもも楽しめます。この機会に生涯学習にふれてみませんか。"
例)料金
:00 a ic:イベント型 ;
  ic:料金 [
    a ic:価格型 ;
    ic:種別 "一般料金" ;
    ic:金額 [
      a ic:金額型 ;
      ic:通貨コード "JPY" ;
      ic:通貨 "円" ;
      ic:数値 "1000"xsd:decimal
    ]
  ]

各種イベント情報

Class base IRI
ic:イベント型 http://data.city.osaka.lg.jp/rdf/resource/イベント情報/
属性
属性 定義
ic:名称 イベント情報 ic:名称型
ic:要約 イベントの要約情報 文字列
ic:Webサイト イベント案内WEBサイト 文字列
ic:種別 イベントの種別を表す文字列 文字列
dsv:対象地域 イベントの開催地域 文字列
ic:期間 イベント開催期間 ic:期間スケジュール型
dsv:開始日 催しやイベント等の開始日 文字列
dsv:終了日 催しやイベント等の終了日 文字列

SPARQLエンドポイント

SPARQL(RDF専用のクエリ言語)を用いて、欲しいデータを問い合わせて取得することができます。
Endpoint URIにGETリクエストするとレスポンスが得られます。(SPARQL 1.1)
許可している操作は、select, construct, ask, describeです。

  Endpoint URI:https://data.city.osaka.lg.jp/sparql

Getでのデータ取得

クエリ例

select distinct * where {
  ?s ?p ?o .
} LIMIT 100

GETリクエスト例

$ curl -H 'Accept: text/turtle' data.yafjp.org/sparql?query=select%20distinct%20%2a%20where%20%7b%0d%0a%3fs%20%3fp%20%3fo%20%2e%0d%0a%7d%20LIMIT%20100?format=json

クエリパラメーターで"format"を指定することができます。
指定できる主なフォーマットには以下があります。
- json
- CSV
- TSV
- XML

クエリ例

以下、基本的なクエリ例を示します。
SPARQLのドキュメント等を参考にぜひ、応用してみてください。

例)施設(ヘリポート)情報を取得

PREFIX ic: <http://imi.ipa.go.jp/ns/core/rdf#>
PREFIX dsv: <http://datashelf.jp/ns/dsv#>

select distinct ?s ?label ?address ?lat ?long where {
  ?s a ic:施設型 ;
  rdfs:label ?label ;
  ic:住所 / ic:表記 ?address ;
  ic:種別 "防災関連施設 - 災害時用へリポート" ;
  ic:地理座標 / ic:緯度 ?lat ;
  ic:地理座標 / ic:経度 ?long .
} LIMIT 100

 

例)都島区のイベント情報を取得

PREFIX ic: <http://imi.ipa.go.jp/ns/core/rdf#>
PREFIX dsv: <http://datashelf.jp/ns/dsv#>

select distinct ?s ?label ?startDate ?endDate ?at where {
  ?s a ic:イベント型 ;
  rdfs:label ?label ;
  ic:開催場所 / ic:名称 / ic:表記 ?at .
  ?s ic:期間 ?dateTime .
  ?dateTime dsv:開始日 ?startDate .
  OPTIONAL {
    ?dateTime dsv:終了日 ?endDate .
  }
} LIMIT 100

 

例)各種イベント情報を取得

PREFIX ic: <http://imi.ipa.go.jp/ns/core/rdf#>
PREFIX dsv: <http://datashelf.jp/ns/dsv#>

select * where {
  ?s a ic:イベント型 ;
  ic:名称 / ic:表記 ?name ;
  dsv:対象地域 ?area ;
  ic:Webサイト ?web ;
  ic:要約 ?summary ;
  ic:期間 [ dsv:開始日 ?start; dsv:終了日 ?end ] .
} LIMIT 1000