郡山市オープンデータ非公式 WebAPI

郡山市のオープンデータと RSS を扱う非公式 WebAPI です。

APIオープンデータ

概要

郡山市オープンデータ非公式 WebAPI は、郡山市が公開しているオープンデータと公式サイトの RSS を、JSON API や GeoJSON で扱いやすくするための非公式 API です。

公開先

項目	内容
公開 API	https://koriyama-open-data-hub.alflag.org/
API バージョン	`2.0`
API ベースパス	`/api/v2`

エンドポイント

メソッド	パス	用途
`GET`	`/`	サービス情報と主要エンドポイントを返す
`GET`	`/api/v2/health`	データ件数、RSS の取得状況、最近の更新状況を返す
`GET`	`/api/v2/datasets`	公開 dataset の一覧を返す
`GET`	`/api/v2/datasets/{dataset_id}`	dataset の詳細と出典情報を返す
`GET`	`/api/v2/datasets/{dataset_id}/records`	dataset の元データ行を返す
`GET`	`/api/v2/places`	正規化済み地点データを返す
`GET`	`/api/v2/places/{place_id}`	地点データを 1 件返す
`GET`	`/api/v2/places.geojson`	地点データを GeoJSON FeatureCollection で返す
`GET`	`/api/v2/search?q=`	地点データを検索する
`GET`	`/api/v2/changes`	取得・正規化時に検出した変更履歴を返す
`GET`	`/api/v2/rss/entries`	郡山市公式サイト RSS の項目を返す

一覧を返すエンドポイントでは、limit と offset を指定できます。places と places.geojson は dataset_id、category、q、bbox=minLng,minLat,maxLng,maxLat で絞り込めます。

レスポンス形式

JSON エンドポイントは、基本的に次の形で返します。

{
  "meta": {
    "api_version": "2.0",
    "generated_at": "2026-06-09T00:00:00.000Z",
    "source_name": "郡山市オープンデータ",
    "license": "CC BY 4.0",
    "attribution_required": true,
    "unofficial": true,
    "disclaimer": "This API is not affiliated with Koriyama City."
  },
  "data": []
}

配列を返すエンドポイントでは meta.result_count が付きます。ページング対象では meta.limit と meta.offset も返ります。

/api/v2/places.geojson は application/geo+json; charset=utf-8 で GeoJSON を返します。存在しない API やリソースは HTTP ステータスで区別されます。

公開データセット

dataset id	名称	category	備考
`public_facilities`	公共施設一覧	`facility`	公共施設等情報の CSV を正規化
`aed`	AED 設置個所一覧	`safety`	AED 設置施設の CSV を正規化
`public_wifi`	公衆無線 LAN アクセスポイント一覧	`facility`	Wi-Fi 設置施設の CSV を正規化
`public_toilets`	公衆トイレ一覧	`facility`	オストメイト対応トイレ設置施設の CSV を正規化
`childcare_facilities`	子育て施設一覧	`childcare`	子育て関連施設の CSV をまとめて正規化
`medical_institutions`	医療機関一覧	`medical`	保健所・病院の CSV を正規化
`schools`	学校一覧	`education`	小学校・中学校の CSV を正規化
`shelters`	指定緊急避難場所一覧	`disaster`	防災情報の出典メタデータを公開。公式ファイルが ZIP shapefile のため、地点正規化は未対応

データセット詳細には、出典ページ URL、出典ファイル、ファイル種別、文字コード、正規化対象かどうかが含まれます。

データ更新

データは定期的に取得・更新されます。

/api/v2/health では、公開中のデータ件数、RSS の取得状況、最近の更新状況を確認できます。

出典とライセンス

この API は、郡山市が公開するオープンデータと公式サイト RSS を利用しています。

レスポンスの meta.license は CC BY 4.0 です。データを利用する場合は、郡山市の公式ページと各データの条件を確認し、必要な出典表示を行ってください。

注意事項

この API は非公式です。郡山市公式サービスではありません。
データの正確性、完全性、最新性、可用性は保証しません。
正確な内容は必ず郡山市公式ウェブサイトで確認してください。
過度なリクエストや、短時間に集中する機械的な取得は避けてください。

補足

旧 v1 API は提供を終了しました。