Human-verifiable, agent-ready

データ利用・公開API

人が出典・定義・利用条件を検証でき、同じ公開契約をソフトウェアやAIエージェントがそのまま利用できるよう、 現行のJSON / GeoJSON APIをまとめています。

公開契約

契約バージョン
1.0.0
最終確認日
2026-07-19
更新頻度
施設・地域記録は出典確認後に随時更新。関連ニュースは公開データに紐づいた出典から生成され、最大50件を返します。各レコードの updated_at、last_verified_at、published_date、retrieved_at 等で個別の鮮度を確認してください。
認証
認証不要・読み取り専用(GET)
キャッシュ
成功レスポンスは Cache-Control: public, s-maxage=300(共有キャッシュ5分)

提供形式とダウンロード先

形式状態内容取得
JSON提供中施設一覧・施設詳細・地域の動き・関連ニュース開く
GeoJSON提供中座標確認済みの公開施設をFeatureCollectionで提供開く
GeoJSON(送電網参考・関東周辺)提供中関東周辺の矩形範囲で抽出した154kV以上の送電線・変電所(OpenStreetMap由来、ODbL 1.0。供給区域(管内)とは一致しない)開く
GeoJSON(送電網参考・関西周辺)提供中関西周辺の矩形範囲で抽出した154kV以上の送電線・変電所(187kV階級を含む・OpenStreetMap由来、ODbL 1.0。供給区域(管内)とは一致しない)開く
CSV未提供現時点では未提供。JSONまたはGeoJSONを利用してください。

エンドポイント

GET/api/v1/facilitiesJSON

公開施設一覧

公開済み施設を都道府県コードと状態で絞り込み、名称・所在地・状態・確度・電力容量等を返します。

パラメータ

prefqueryJIS都道府県コード2桁(例: 12=千葉県)
statusquery施設状態。許可値以外は400。

リクエスト例

curl -sS "https://japandatacenter.org/api/v1/facilities?pref=12&status=operational"

レスポンス例

{
  "count": 1,
  "items": [
    {
      "slug": "colt-inzai-1",
      "canonical_name": "Colt印西データセンター1",
      "prefecture": "千葉県",
      "pref_code": "12",
      "municipality": "印西市",
      "status": "operational",
      "status_as_of": null,
      "status_as_of_precision": "unknown",
      "coordinate_precision": "municipality",
      "evidence_level": "E3",
      "power_capacity_mw": 8,
      "power_capacity_type": "it_load",
      "detail_url": "/facilities/colt-inzai-1"
    }
  ]
}
完全な項目定義: FacilityListResponse
  • 並び順は都道府県、施設名の昇順です。

400: statusが許可値ではありません。 {"error":"invalid status"}

GET/api/v1/facilities/{slug}JSON

施設詳細

施設本体、事業者、状態イベント、施設・イベントの出典、周辺電源コンテキストを返します。

パラメータ

slugpath施設一覧のslug

リクエスト例

curl -sS "https://japandatacenter.org/api/v1/facilities/colt-inzai-1"

レスポンス例

{
  "facility": {
    "id": "78b7f12b8c38dd9e1fcb752b3486159a",
    "slug": "colt-inzai-1",
    "canonical_name": "Colt印西データセンター1",
    "prefecture": "千葉県",
    "municipality": "印西市",
    "status": "operational",
    "coordinate_precision": "municipality",
    "evidence_level": "E3",
    "power_capacity_mw": 8,
    "power_capacity_type": "it_load",
    "updated_at": "2026-07-15 17:44:34"
  },
  "operators": [],
  "events": [
    {
      "id": "178a32a9675f42b3a0c0df2e426673fe",
      "facility_id": "78b7f12b8c38dd9e1fcb752b3486159a",
      "event_date": null,
      "event_date_precision": "unknown",
      "event_type": "operation",
      "status_from": "unknown",
      "status_to": "operational",
      "title": "Colt印西データセンター1 稼働中",
      "summary": "公式サイトに稼働開始日の明記なし。",
      "created_at": "2026-07-15 17:43:45",
      "sources": []
    }
  ],
  "sources": [
    {
      "id": "2e256605ca1f05bddbf66976b8616e0d",
      "canonical_url": "https://www.coltdatacentres.net/ja-JP/our-locations/data-centre-locations-asia/inzai",
      "original_url": "https://www.coltdatacentres.net/ja-JP/our-locations/data-centre-locations-asia/inzai",
      "publisher": "Colt DCS",
      "title": "Colt 印西データセンター1",
      "published_date": null,
      "retrieved_at": "2026-07-15",
      "source_type": "official",
      "notes": null,
      "claim": "existence",
      "support": "supports"
    }
  ],
  "power_context": {
    "facility_id": "78b7f12b8c38dd9e1fcb752b3486159a",
    "nearby_power_mw_30km": 3929.8,
    "nearby_plant_count_30km": 5,
    "nearest_large_plant_name": "千葉火力発電所",
    "nearest_large_plant_type": "火力",
    "nearest_large_plant_mw": 1440,
    "nearest_large_plant_distance_km": 30,
    "data_source_version": "P03-13(2013年度版)",
    "computed_at": "2026-07-16 00:36:16"
  }
}

可読性のため入れ子配列とnullable項目を省略した抜粋例です。項目定義が完全な契約です。

完全な項目定義: FacilityDetailResponse
  • notes_internal は返しません。
  • 非公開または存在しないslugは404です。

404: 公開施設が見つかりません。 {"error":"not found"}

GET/api/v1/facilities/geojsonGeoJSON

公開施設GeoJSON

座標があり coordinate_precision が unknown ではない公開施設をGeoJSON FeatureCollectionで返します。

リクエスト例

curl -sS "https://japandatacenter.org/api/v1/facilities/geojson"

レスポンス例

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          140.14583,
          35.83222
        ]
      },
      "properties": {
        "slug": "colt-inzai-1",
        "name": "Colt印西データセンター1",
        "status": "operational",
        "status_as_of": null,
        "status_as_of_precision": "unknown",
        "coordinate_precision": "municipality",
        "evidence_level": "E3",
        "prefecture": "千葉県",
        "municipality": "印西市",
        "detail_url": "/facilities/colt-inzai-1"
      }
    }
  ]
}
完全な項目定義: FacilityGeoJsonCollection
  • Content-Typeはapplication/geo+json; charset=utf-8です。
  • 互換別名 /api/v1/facilities.geojson も同じレスポンスを返します。
  • 座標順は [longitude, latitude] です。coordinate_precision=municipality は施設の正確な位置ではありません。
GET/api/v1/community-actionsJSON

地域の動き

自治体の条例、議会・自治体対応、住民説明会等の公開記録を返します。

パラメータ

prefquery都道府県名の完全一致(例: 千葉県)。JISコードではありません。URLエンコードしてください。

リクエスト例

curl -sS "https://japandatacenter.org/api/v1/community-actions?pref=%E5%8D%83%E8%91%89%E7%9C%8C"

レスポンス例

{
  "count": 1,
  "items": [
    {
      "id": "2ed4130b73a649429df244798bdc17d1",
      "prefecture": "千葉県",
      "municipality": "印西市",
      "action_type": "district_plan_change",
      "title": "印西市、相次ぐデータセンター紛争を受け地区計画の変更を検討",
      "summary": "千葉ニュータウン中央駅近くの建築確認取消訴訟をはじめ、印西市内で住民とデータセンター事業者との紛争が相次いでいる。",
      "action_date": "2026-07",
      "action_date_precision": "month",
      "evidence_level": "E1",
      "facility_slug": null,
      "facility_name": null
    }
  ]
}
完全な項目定義: CommunityActionListResponse
  • 最大100件。日付の新しい順です。
GET/api/v1/newsJSON

関連ニュース

公開施設・イベント・地域の動きに実際に紐づいた検証済み出典を新しい順に返します。

リクエスト例

curl -sS "https://japandatacenter.org/api/v1/news"

レスポンス例

{
  "count": 1,
  "items": [
    {
      "id": "cd30983919300329e27804218d6866bd",
      "canonical_url": "https://news.yahoo.co.jp/articles/e63981bc8769dd71ffe761ff37b5e5ceaaefd831",
      "publisher": "TOKYO MX",
      "title": "日野市のデータセンター計画、高さ・面積縮小へ 排熱の影響は「解析中」として示さず",
      "published_date": "2026-07-13",
      "retrieved_at": "2026-07-15",
      "source_type": "media",
      "context_label": "日野DC計画(三井不動産・日野自動車工場跡地)",
      "context_url": "/facilities/mitsuifudosan-hino-dc",
      "link_updated_at": "2026-07-15 17:32:23"
    }
  ]
}
完全な項目定義: NewsListResponse
  • 最大50件。未検証の収集候補は含みません。

項目定義・型・単位

未確認・非該当の値は原則 null です。部分日付は YYYY、YYYY-MM、YYYY-MM-DD のいずれかで、対応する *_precision が year、month、day、unknown を示します。0や月初日で欠損を代用しません。

施設一覧レスポンス FacilityListResponse

公開施設の件数と一覧。

項目単位説明
countintegeritemsの件数
itemsFacilitySummary[]公開施設一覧
施設一覧項目 FacilitySummary

施設一覧で返す要約レコード。

項目単位説明
slugstringURL・詳細APIで使う安定識別子
canonical_namestring施設の標準名称
prefecturestring都道府県名
pref_codestring | nullJIS都道府県コード2桁
municipalitystring | null市区町村
statusstring施設状態値: rumored / announced / pre_consultation / permitting / approved / under_construction / operational / expansion / paused / cancelled / closed / unknown
status_as_ofstring | null状態の基準日(部分日付)
status_as_of_precisionstringstatus_as_ofの精度値: day / month / year / unknown
coordinate_precisionstring公開座標の精度値: exact / block / district / municipality / unknown
evidence_levelstring公開情報の確度値: E1 / E2 / E3 / E4 / E5
power_capacity_mwnumber | nullMW公表された電力容量
power_capacity_typestring | null電力容量の意味区分値: it_load / utility_supply / facility_total / campus_total / planned_maximum / unknown
detail_urlstring本サイト内の施設詳細相対URL
施設詳細レスポンス FacilityDetailResponse

施設本体と関連情報。

項目単位説明
facilityFacility施設本体
operatorsOperator[]関連事業者
eventsFacilityEvent[]出典付き状態タイムライン
sourcesFacilityEvidenceSource[]施設レベルの出典
power_contextPowerContext | null周辺電源の集計値
施設本体 Facility

notes_internalを除いた公開施設レコード。

項目単位説明
idstring内部一意ID
slugstring公開識別子
canonical_namestring標準名称
canonical_name_enstring | null英語名称
prefecturestring都道府県名
pref_codestring | nullJIS都道府県コード2桁
municipalitystring | null市区町村
address_publicstring | null公開可能な住所
latitude_publicnumber | nulldecimal degrees公開緯度
longitude_publicnumber | nulldecimal degrees公開経度
coordinate_precisionstring座標精度値: exact / block / district / municipality / unknown
statusstring施設状態値: rumored / announced / pre_consultation / permitting / approved / under_construction / operational / expansion / paused / cancelled / closed / unknown
status_as_ofstring | null状態の基準日(部分日付)
status_as_of_precisionstring状態基準日の精度値: day / month / year / unknown
announced_datestring | null計画公表日(部分日付)
construction_start_datestring | null着工日(部分日付)
operational_datestring | null稼働日(部分日付)
site_area_m2number | null敷地面積
floor_area_m2number | null延床・床面積
power_capacity_mwnumber | nullMW電力容量
power_capacity_typestring | null電力容量の意味区分値: it_load / utility_supply / facility_total / campus_total / planned_maximum / unknown
power_capacity_notestring | null容量の補足
cooling_typestring | null冷却方式
water_sourcestring | null水源・水利用
ai_workload_claimstring | nullAI用途に関する公表内容
puenumber | nullPower Usage Effectiveness
pue_typestring | nullPUEが実績値か目標値か値: actual / target
pue_as_ofstring | nullPUEの基準日(部分日付)
pue_as_of_precisionstringPUE基準日の精度値: day / month / year / unknown
power_colocationstring | null発電所併設・専用電源の区分値: onsite_generation / dedicated_ppa / colocated_site / renewable_dedicated / planned
power_colocation_notestring | null電源併設の補足
evidence_levelstring確度値: E1 / E2 / E3 / E4 / E5
last_verified_atstring | null最終検証日時
review_statusstring公開状態(公開APIではpublished)
published_atstring | null公開日時
created_atstring作成日時
updated_atstring更新日時
deleted_atstring | null削除日時(公開APIではnull)
関連事業者 Operator

施設と関係する事業者。

項目単位説明
idstring事業者ID
slugstring事業者識別子
namestring名称
name_enstring | null英語名称
website_urlstring | null公式サイト
rolestring施設との関係値: operator / owner / developer
施設イベント FacilityEvent

追記型の状態タイムライン。

項目単位説明
idstringイベントID
facility_idstring施設ID
event_datestring | nullイベント日(部分日付)
event_date_precisionstringイベント日の精度値: day / month / year / unknown
event_typestringイベント種別値: status_change / announcement / permit / construction / operation / expansion / pause / cancellation / correction / other
status_fromstring | null変更前状態値: rumored / announced / pre_consultation / permitting / approved / under_construction / operational / expansion / paused / cancelled / closed / unknown
status_tostring | null変更後状態値: rumored / announced / pre_consultation / permitting / approved / under_construction / operational / expansion / paused / cancelled / closed / unknown
titlestring見出し
summarystring | null要約
created_atstring記録作成日時
sourcesEvidenceSource[]イベントの出典
出典 EvidenceSource

正規化した公開出典。

項目単位説明
idstring出典ID
canonical_urlstring正規化URL
original_urlstring収集時URL
publisherstring発行元
titlestring資料・記事名
published_datestring | null公表日(部分日付の場合あり)
retrieved_atstring取得日
source_typestring出典種別値: official / media / gov_doc / filing / other
notesstring | null公開補足
施設出典 FacilityEvidenceSource

出典に主張種別と支持関係を加えたもの。

項目単位説明
idstring出典ID
canonical_urlstring正規化URL
original_urlstring収集時URL
publisherstring発行元
titlestring資料・記事名
published_datestring | null公表日
retrieved_atstring取得日
source_typestring出典種別値: official / media / gov_doc / filing / other
notesstring | null公開補足
claimstring裏づける主張値: existence / location / operator / status / power_capacity / site_area / cooling / water / ai_workload / schedule / efficiency / power_procurement / other
supportstring主張との関係値: supports / disputes / context
周辺電源コンテキスト PowerContext

国土数値情報から計算した集計値。個別発電所生データではありません。

項目単位説明
facility_idstring施設ID
nearby_power_mw_30kmnumber | nullMW半径30km内の発電容量合計
nearby_plant_count_30kminteger | null半径30km内の発電施設数
nearest_large_plant_namestring | null最寄り500MW以上発電所名
nearest_large_plant_typestring | null発電種別
nearest_large_plant_mwnumber | nullMW最寄り大規模発電所容量
nearest_large_plant_distance_kmnumber | nullkm最寄り大規模発電所までの距離
data_source_versionstring計算元データの版
computed_atstring計算日時
施設GeoJSON FacilityGeoJsonCollection

GeoJSON FeatureCollection。

項目単位説明
typestringGeoJSON種別
featuresFacilityGeoJsonFeature[]施設Feature
施設GeoJSON Feature FacilityGeoJsonFeature

施設1件のPoint Feature。

項目単位説明
typestringGeoJSON種別
geometryPointGeometry位置
propertiesFacilityGeoJsonProperties施設属性
Point geometry PointGeometry

GeoJSON Point。

項目単位説明
typestringgeometry種別
coordinatesnumber[][経度, 緯度]WGS84座標
GeoJSON施設属性 FacilityGeoJsonProperties

地図描画用の施設要約。

項目単位説明
slugstring施設識別子
namestring施設名称
statusstring施設状態値: rumored / announced / pre_consultation / permitting / approved / under_construction / operational / expansion / paused / cancelled / closed / unknown
status_as_ofstring | null状態の基準日
status_as_of_precisionstring状態基準日の精度値: day / month / year / unknown
coordinate_precisionstring座標精度値: exact / block / district / municipality / unknown
evidence_levelstring確度値: E1 / E2 / E3 / E4 / E5
prefecturestring都道府県
municipalitystring | null市区町村
detail_urlstring施設詳細相対URL
地域の動きレスポンス CommunityActionListResponse

地域記録の件数と一覧。

項目単位説明
countintegeritemsの件数
itemsCommunityAction[]地域記録
地域の動き項目 CommunityAction

自治体・住民等の公開記録。

項目単位説明
idstring記録ID
prefecturestring都道府県
municipalitystring | null市区町村
action_typestring記録種別値: ordinance / lawsuit / council_response / public_hearing / protest / district_plan_change / other
titlestring見出し
summarystring | null要約
action_datestring | null日付(部分日付)
action_date_precisionstring日付精度値: day / month / year / unknown
evidence_levelstring確度値: E1 / E2 / E3 / E4 / E5
facility_slugstring | null関連施設slug
facility_namestring | null関連施設名
関連ニュースレスポンス NewsListResponse

検証済み出典の件数と一覧。

項目単位説明
countintegeritemsの件数
itemsNewsItem[]ニュース項目
関連ニュース項目 NewsItem

公開データに紐づいた出典。

項目単位説明
idstring出典ID
canonical_urlstring記事URL
publisherstring発行元
titlestring記事名
published_datestring | null公開日
retrieved_atstring取得日
source_typestring出典種別
context_labelstring関連施設・地域記録の表示名
context_urlstring | null関連する本サイト内相対URL
link_updated_atstring出典リンクの最終更新日時
エラーレスポンス ErrorResponse

現在のv1で明示的に返すエラー。

項目単位説明
errorstring機械可読な短いエラー文字列

出典と加工

主な出典

  • 企業・事業者の公式発表
  • 自治体・政府の行政資料、議事録、許認可等
  • 報道機関の記事
  • OpenStreetMap(関東・関西周辺の主要送電線・変電所の参考レイヤー)

加工内容

  • URLを正規化し、同一出典の重複を抑制します。
  • 施設は最低1件の出典を必須とし、E1〜E5の確度を付与します。未確認のE0は公開しません。
  • 状態変更は出典付きイベントとして追記し、誤りは correction イベントで訂正します。
  • 座標精度を別項目で保持し、市区町村代表点を正確な施設位置として扱いません。
  • 電力容量はMW、面積はm²、距離はkmで提供し、容量の意味区分を power_capacity_type で併記します。
  • 送電網参考レイヤーはOpenStreetMapのvoltageタグを数値分解し、最大値が154kV以上の設備をエリアごとの矩形範囲で抽出してGeoJSON化します(電圧階級の列挙に依存しないため、エリア固有の187kV・220kV等も漏れなく含む)。矩形範囲は供給区域(管内)と一致しません。物理的な位置関係のみを示し、供給余力・接続可否には使用しません。

利用条件

本サイトのURLを出典として明示することで、公開APIの施設情報・集計データを報道・研究・分析等に利用できます。出典を示さないデータベース複製・自社サービスとしての再配布は許諾対象外です。

個別の公式発表・行政資料・報道記事そのものの著作権・利用条件は各権利者に帰属し、本サイトの利用許諾はそれらには及びません。送電網参考GeoJSONは© OpenStreetMap contributors、ODbL 1.0に従います。

掲載基準の利用条件を確認

バージョン・互換性・エラー

URLの /api/v1 をメジャーバージョンとします。v1内では項目追加など後方互換の変更を行う場合があります。既存項目の削除・型変更など破壊的変更は /api/v2 など新しいメジャーパスで提供します。

明示的な400 / 404は {"error":"..."} 形式です。予期しない障害時の5xxレスポンス本文は互換性契約の対象外です。

CORSについて

成功レスポンスは Access-Control-Allow-Origin: *CORSはブラウザからの取得可否を決める配信設定であり、agent-readyの判定要件ではありません。現行の400/404エラーレスポンスではCORSヘッダーを保証しません。