APIの利用について
横浜市オープンデータポータル掲載データの中には、APIを使用してデータの取得を行うことができるものがあります。
更新情報
日付 | 更新内容 |
---|---|
2020/11/30 |
保育所等に関するデータを更新しました。(①9月時点のデータに更新/②施設情報と入所状況の突合を停止/③幼稚園のデータ公開を停止/④BaseURLの規則を変更) ※②施設情報と入所状況の突合を停止‥入所状況等を表すIDと施設情報を表すIDが別のものとなりましたので、ご注意ください。 |
APIの利用方法
SPARQLエンドポイントでデータを取得する
URLに対してSPARQLクエリを実行し、データを取得できます。
SPARQL 1.1, SELECT, CONSTRUCT, ASKが利用可能です。HTTP/GETかHTTP/POSTでリクエストしてください。
URL:
https://data.city.yokohama.lg.jp/sparql
エンティティのURIからHTTP/GETでデータを取得する
エンティティのURIに対してGETリクエストすることでデータを取得できます。レスポンスはJSONです。
※ 現在は、保育所等データでのみ使用可能です。
提供しているデータ
- 人口データ
- 保育所等に関するデータ
1. 人口データ
人口動態データをData Cube Vocabularyが定める仕様に基づきRDF化して提供しています。詳しくは、W3Cが公開している仕様をご参照ください。
なお、次元や速度などは独立行政法人統計センターによる統計LODとの互換性に配慮してできる限り共通化しています。詳しくは独立行政法人統計センターが公開している仕様をご参照ください。
データセット(qb:Dataset)
原則、統計表の単位でデータセットとしています。
登録されているデータセットは、次のSPARQLクエリで一覧を確認できます。
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>
prefix xsd: <http://www.w3.org/2001/XMLSchema#>
prefix dsv: <http://datashelf.jp/ns/dsv#>
prefix dct: <http://purl.org/dc/terms/>
prefix dimension: <http://data.city.yokohama.lg.jp/namespace/dimension#>
prefix observation: <http://data.city.yokohama.lg.jp/lod/v2/qb/dataset/population/doutai/202002#obs_>
prefix qb: <http://purl.org/linked-data/cube#>
prefix base: <http://data.city.yokohama.lg.jp/lod/v2/qb/dataset/population/doutai/202002#>
prefix g00200502_dimension: <http://data.e-stat.go.jp/lod/ontology/g00200502/dimension/>
prefix g00200521_dimension_2010: <http://data.e-stat.go.jp/lod/ontology/g00200521/dimension/2010/>
prefix g00200521_dimension_2015: <http://data.e-stat.go.jp/lod/ontology/g00200521/dimension/2015/>
prefix g00200521_code_2010: <http://data.e-stat.go.jp/lod/ontology/g00200521/code/2010/>
prefix g00200502_code: <http://data.e-stat.go.jp/lod/ontology/g00200502/code/>
prefix cd_code: <http://data.e-stat.go.jp/lod/ontology/crossDomain/code/>
prefix cd_dimension: <http://data.e-stat.go.jp/lod/ontology/crossDomain/dimension/>
prefix estat_measure: <http://data.e-stat.go.jp/lod/ontology/measure/>
prefix estat_attribute: <http://data.e-stat.go.jp/lod/ontology/attribute/>
prefix estat_attribute_code: <http://data.e-stat.go.jp/lod/ontology/attribute/code/>
prefix sac: <http://data.e-stat.go.jp/lod/sac/>
prefix sdmxConcept: <http://purl.org/linked-data/sdmx/2009/concept#>
prefix sdmxDimension: <http://purl.org/linked-data/sdmx/2009/dimension#>
prefix sdmxAttribute: <http://purl.org/linked-data/sdmx/2009/attribute#>
prefix sdmxMeasure: <http://purl.org/linked-data/sdmx/2009/measure#>
prefix sdmxMetadata: <http://purl.org/linked-data/sdmx/2009/metadata#>
prefix sdmxCode: <http://purl.org/linked-data/sdmx/2009/code#>
prefix sdmxSubject: <http://purl.org/linked-data/sdmx/2009/subject#>
select * where {
?s a qb:DataSet
}
クエリ例
SPARQL
- データセットの構造情報を取得する
データセット
<http://data.city.yokohama.lg.jp/dataset/population/doutai/202002#pupulation_doutai_2020020 >の持つ構造情報を取得します。
prefix qb: <http://purl.org/linked-data/cube#>
SELECT *
where {
<http://data.city.yokohama.lg.jp/dataset/population/doutai/202002#pupulation_doutai_2020020> qb:structure ?structure.
?structure qb:component ?component .
}
- 18区の面積を取得する
prefix qb: <http://purl.org/linked-data/cube#>
prefix sdmxMeasure: <http://purl.org/linked-data/sdmx/2009/measure#>
prefix sdmxDimension: <http://purl.org/linked-data/sdmx/2009/dimension#>
SELECT ?area ?value
where {
?slice qb:sliceStructure <http://data.city.yokohama.lg.jp/dataset/population/doutai/202002#slicekey_面積> .
?slice qb:observation ?obs .
?obs sdmxMeasure:obsValue ?value .
?obs sdmxDimension:refArea ?area .
} ORDER BY ?value
2. 保育所等に関するデータ
保育所等に関するデータを、次のとおりLODとして提供しています。
すべて同じクラスのインスタンスとしており、事業の分類はプロパティを用いて区別しています。
データセット
データセット名 | 更新頻度 | 所管課 | クラス |
---|---|---|---|
認可保育所 | 随時 | こども青少年局 | dsv:保育所型 |
認定こども園 | 随時 | こども青少年局 | dsv:保育所型 |
小規模保育事業 | 随時 | こども青少年局 | dsv:保育所型 |
家庭的保育事業 | 随時 | こども青少年局 | dsv:保育所型 |
事業所内保育事業 | 随時 | こども青少年局 | dsv:保育所型 |
横浜保育室 | 随時 | こども青少年局 | dsv:保育所型 |
届出済認可外保育施設 | 随時 | こども青少年局 | dsv:保育所型 |
幼稚園 | 随時 | こども青少年局 | dsv:幼稚園型 |
なお、prefixとして以下のとおり定義して使用しています。
prefix
prefix | URI | 説明 |
---|---|---|
rdfs | http://www.w3.org/2000/01/rdf-schema# | |
rdf | http://www.w3.org/1999/02/22-rdf-syntax-ns# | |
ic | https://imi.go.jp/ns/core/rdf# | 共通語彙基盤 |
dsv | http://datashelf.jp/ns/dsv# | 独自に設定した語彙 |
クエリ例
SPARQL
- 0歳児の空きのある保育所を探す
select distinct * where {
?s a dsv:保育所型;
rdfs:label ?label;
dsv:入所可能人数 [
ic:種別 "0歳児";
ic:数値 ?num;
ic:メタデータ [
ic:日付 [
ic:標準型日付 ?date
]
]
]
FILTER (xsd:decimal(?num) > 0 )
}
- 保育所等の設置数を区ごとに集計
select distinct ?ward ?cat COUNT(?s) AS ?num where {
?s a dsv:保育所型;
rdfs:label ?label;
ic:種別コード [
ic:種別 "事業種別";
ic:識別値 ?cat
];
ic:住所 [
ic:区 ?ward;
ic:市区町村コード [
ic:種別 "市区町村コード";
ic:識別値 ?code
]
]
}
ORDER by ?ward ?cat
HTTP/GET
APIパスに対してGETリクエストすることでデータを取得できます。
-
保育所型クラスのエンティティ一覧を取得する
-
エンティティの情報を取得する
エンティティは全て固有のIRIを持っています。
例) http://data.city.yokohama.lg.jp/lod/v2/保育所型/402050001
独自に設定した語彙
クラス
- dsv:保育所型
- dsv:評価型
プロパティ
- dsv:受入可否
- dsv:認可年月日
- dsv:入所児童数
- dsv:入所可能人数
- dsv:入所待ち人数
- dsv:評価
- dsv:評価ステータス
- dsv:結果
- dsv:結果公表日時
- dsv:調査日時
dsv:保育所型
Canonical IRI | http://datashelf.jp/ns/dsv#保育所型 |
---|---|
Inherited | ic:施設型 |
Definition | 保育所等の事業 |
dsv:受入可能
Canonical IRI: http://datashelf.jp/ns/dsv#受入可能
Type | rdf:Property |
---|---|
Domain | ic:施設型 |
Range | rdfs:Literal |
Definition | 保育所等で児童の受入が可能な状態にあるか |
dsv:認可年月日
Canonical IRI: http://datashelf.jp/ns/dsv#認可年月日
Type | rdf:Property |
---|---|
Domain | ic:施設型 |
Range | rdfs:Literal(xsd:dateTimeを推奨) |
Definition | 保育所等が行政機関から認可を受けた日 |
dsv:入所児童数
Canonical IRI: http://datashelf.jp/ns/dsv#入所児童数
Type | rdf:Property |
---|---|
Domain | ic:施設型 |
Range | ic:数量型 |
Definition | 保育所等の入所児童数 |
dsv:入所可能人数
Canonical IRI: http://datashelf.jp/ns/dsv#入所可能人数
Type | rdf:Property |
---|---|
Domain | ic:施設型 |
Range | ic:数量型 |
Definition | 保育所等で入所可能な児童数 |
dsv:入所待ち人数
Canonical IRI: http://datashelf.jp/ns/dsv#入所待ち人数
Type | rdf:Property |
---|---|
Domain | ic:施設型 |
Range | ic:数量型 |
Definition | 保育所等で入所待ち人数 |
dsv:評価型
Canonical IRI: http://datashelf.jp/ns/dsv#評価型
Type | rdfs:Class |
---|---|
Inherited | ic:事物型 |
Definition | 事業や設備に対する評価 |
dsv:評価
Canonical IRI: http://datashelf.jp/ns/dsv#評価
Type | rdf:Property |
---|---|
Domain | ic:施設型 |
Range | dsv:評価型 |
Definition | 事業や設備に対する評価 |
dsv:評価ステータス
Canonical IRI: http://datashelf.jp/ns/dsv#評価ステータス
Type | rdf:Property |
---|---|
Domain | ic:施設型 |
Range | rdfs:Literal |
Definition | 評価が実施済みか否か等 |
dsv:結果
Canonical IRI: http://datashelf.jp/ns/dsv#結果
Type | rdf:Property |
---|---|
Domain | ic:施設型 |
Range | rdfs:Literal |
Definition | 評価結果 |
dsv:結果公表日時
Canonical IRI: http://datashelf.jp/ns/dsv#結果公表日時
Type | rdf:Property |
---|---|
Domain | ic:施設型 |
Range | rdfs:Literal(xsd:dateTimeを推奨) |
Definition | 評価結果が公表された日時 |
dsv:調査日時
Canonical IRI: http://datashelf.jp/ns/dsv#調査日時
Type | rdf:Property |
---|---|
Domain | ic:施設型 |
Range | rdfs:Literal(xsd:dateTimeを推奨) |
Definition | 調査が実施された日時 |
データモデル
dsv:保育所型
ic:施設型を継承しています。
エンティティごとにプロパティの構成が異なる場合があります。必ずしも全てのプロパティを持つわけではないためご注意ください。
メタデータ
エンティティの更新日時を記述しています。
例)
:横浜保育園 ic:メタデータ [
a ic:メタデータ型 [
a ic:日付 [
ic:種別 "更新日";
ic:標準型日付 "2018-10-10"^^<xsd:date> .
]
]
].
施設名
例)
:横浜保育園 ic:名称 [
a ic:名称型;
ic:表記 "横浜保育園"
].
:横浜保育園 rdfs:label "横浜保育園".
ID
各施設のIDは、入所状況のものとは異なります。
例)
:横浜保育園 ic:ID [
a ic:ID型;
ic:識別値 "12345678"
].
種別
横浜市の保育所は次の事業種別があります。
- 認可保育所
- 認定こども園
- 小規模保育事業
- 家庭的保育事業
- 事業所内保育事業
- 横浜保育室
- 届出済認可外保育施設
例)
:横浜保育園 ic:種別コード [
a ic:コード型;
ic:種別 "事業種別";
ic:識別値 "認可保育所"
].
また、認可保育所には私立か公立かの区分があります。
例)
:横浜保育園 ic:種別コード [
a ic:コード型;
ic:種別 "私立・公立";
ic:識別値 "公立"
].
さらに、エコ保育所の指定の区分がある場合があります。
例)
:横浜保育園 ic:種別コード [
a ic:コード型;
ic:種別 "エコ保育所";
ic:識別値 "認定外"
].
住所
統計LODが公開している市区町村コードにリンクしています。
http://data.e-stat.go.jp/lodw/provdata/lodRegion/
例)
:横浜保育園 ic:住所 [
a ic:住所型;
ic:表記 "横浜市中区港町1-1-1";
ic:区 "中区";
ic:郵便番号 "245-6789";
ic:市区町村コード [
a ic:コード型;
ic:種別 "市区町村コード";
ic:識別値 "14104"
];
ic:市区町村コード [
a ic:コード型;
ic:種別 "統計LOD市区町村コード";
ic:識別値 <http://data.e-stat.go.jp/lod/page/sac/C14104>
]
].
連絡先
例)
:横浜保育園 ic:連絡先 [
a ic:連絡先型;
ic:電話番号 "045-012-3456";
ic:FAX番号 "045-012-3457";
ic:Webサイト "http://example.com"
].
行き方
例)
:横浜保育園 ic:アクセス [
a ic:アクセス型;
ic:備考 "関内駅から徒歩5分"
].
最寄りの交通機関
事業形態ごとに種別が異なりますため、ご注意ください。
- 最寄りの交通機関
- 最寄駅(私鉄JR)
- 最寄駅(市営地下鉄)
例)
:横浜保育園 ic:記述 [
a ic:記述型;
ic:種別 "最寄駅(市営地下鉄)"
ic:説明 "関内駅"
].
建物および敷地の面積
例)
:横浜保育園 ic:建物 [
a ic:建物型;
ic:敷地面積 [
a ic:面積型;
ic:種別 "敷地面積";
ic:数値 "1,479.79";
ic:単位表記 "㎡"
]
ic:建物面積 [
a ic:面積型;
ic:種別 "建物面積";
ic:数値 "714.04";
ic:単位表記 "㎡"
]
].
設置者
例)
:横浜保育園 ic:関与 [
a ic:関与型;
ic:関与者 [
a ic:組織型 [
ic:名称 [
a ic:名称型
ic:表記 "横浜市"
]
];
rdfs:label "横浜市"
];
ic:役割 "設置者"
].
定員
次の種別を用いて記述されています。
- 定員0歳児
- 定員1歳児
- 定員2歳児
- 定員3歳児
- 定員4歳児
- 定員5歳児
例)
:横浜保育園 ic:収容人数 [
a ic:数量型;
ic:種別 "定員1歳児";
ic:数値 "20"^^<xsd:decimal>
].
開所時間
開所時間は次の区分を用いて記述されています。
- 開所時間(平日)
- 開所時間(土曜日)
- 開所時間(日・祝日)
- 保育標準時間平日
- 保育標準時間土曜日
- 保育短時間平日
- 保育短時間土曜日
- 休園日
例)
:横浜保育園 ic:利用可能時間 [
a ic:定期スケジュール型;
ic:種別 "開所時間(平日)";
ic:説明 "7:30から18:30"
].
第三者評価
種別として、第三者評価と立入調査があります。
事業形態ごとに記述方法が異なるため、ご注意ください。
例)
:横浜保育園 dsv:評価 [
a dsv:評価型;
ic:種別 "第三者評価";
dsv:結果 "認可外保育施設指導監督基準に係る文書指導:なし(基準を満たす旨の証明書交付日:平成17年4月1日)";
ic:参照 [
a ic:参照型;
ic:参照先 "http:example.com"
];
dsv:評価ステータス "受審済";
dsv:調査日時 "2018-11-01T10:19"^^<xsd:date>
dsv:結果公表日時 "2018-11-01T10:19"^^<xsd:date>
].
その他属性
事業形態ごとに異なる属性が定義されています。
ic:記述を用いて統一的に記述しており、ic:種別を用いて区別しています。
- 3歳以上の主食
- 3歳以上の主食内容
- 一次保育
- 一次保育内容
- 夜間保育(20時以降)
- 24時間保育
- 預かり保育内容
- 預かり保育(1号)
- 一次保育(非在園児)
- 休日保育
- 保護者との約束事
- 独自の保育サービスと保育料以外の保護者負担
- 年間の主な行事
- 教育・保育方針
- 受入年齢
- 受入年齢(月極)
- 受入年齢(一時)
- 施設紹介
- 給食
- 給食内容
- 1号給食詳細
- 2号給食詳細
- 3号給食詳細
- 園バス内容
- 月極契約
- 証明書交付
- その他特徴
- タグ
例)
:横浜保育園 ic:記述 [
a ic:記述型:
ic:種別 "受入年齢";
ic:説明 "0歳から"
].
入所状況
入所可能人数、入所待ち人数、入所児童数を随時更新しています。
年齢はic:種別で区別しています。
各施設のIDは、施設情報のものとは異なります。
- 0歳児
- 1歳児
- 2歳児
- 3歳児
- 4歳児
- 5歳児
例)
:横浜保育園 dsv:入所可能人数 [
a ic:数量型:
ic:種別 "0歳児";
ic:数値 "0"^^<xsd:decimal>;
ic:メタデータ [
a ic:文書型;
ic:日付 [
a ic:日付型;
ic:種別 "更新日";
ic:標準型日付 "2018-10-10"^^<xsd:date> .
]
]
];
dsv:入所待ち人数 [
a ic:数量型:
ic:種別 "0歳児";
ic:数値 "0"^^<xsd:decimal>;
ic:メタデータ [
a ic:文書型;
ic:日付 [
a ic:日付型;
ic:種別 "更新日";
ic:標準型日付 "2018-10-10"^^<xsd:date> .
]
]
];
dsv:入所児童数 [
a ic:数量型:
ic:種別 "0歳児";
ic:数値 "10"^^<xsd:decimal>;
ic:メタデータ [
a ic:文書型;
ic:日付 [
a ic:日付型;
ic:種別 "更新日";
ic:標準型日付 "2018-10-10"^^<xsd:date> .
]
]
]
].
備考
例)
:横浜保育園 ic:備考 "詳細については直接園にお問合せください"