Human-verifiable, agent-ready

Data access & public API

Human-verifiable definitions, sources, and terms — with the same public contract available to software and agents via JSON / GeoJSON APIs.

API field names and enum codes are language-neutral. UI copy on Japanese pages is separate; the same JSON is returned regardless of Accept-Language. canonical_name_en is included on the list and detail APIs (null when unknown — fall back to canonical_name).

Public contract

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

Formats & downloads

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

Format descriptions above are maintained in Japanese in the contract source; enum codes and field names are authoritative in OpenAPI.

Endpoints

GET/api/v1/facilitiesJSON

公開施設一覧

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

Parameters

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

Request example

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

Response example

{
  "count": 1,
  "items": [
    {
      "slug": "colt-inzai-1",
      "canonical_name": "Colt印西データセンター1",
      "canonical_name_en": "Colt Inzai Data Center 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"
    }
  ]
}
Full field schema: FacilityListResponse
  • 並び順は都道府県、施設名の昇順です。
  • canonical_name_en は英語名称(無い場合は null)。クライアントは null のとき canonical_name へフォールバックしてください。

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

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

施設詳細

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

Parameters

slugpath施設一覧のslug

Request example

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

Response example

{
  "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項目を省略した抜粋例です。項目定義が完全な契約です。

Full field schema: FacilityDetailResponse
  • notes_internal は返しません。
  • 非公開または存在しないslugは404です。

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

GET/api/v1/facilities/geojsonGeoJSON

公開施設GeoJSON

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

Request example

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

Response example

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          140.14583,
          35.83222
        ]
      },
      "properties": {
        "slug": "colt-inzai-1",
        "name": "Colt印西データセンター1",
        "name_en": "Colt Inzai Data Center 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"
      }
    }
  ]
}
Full field schema: FacilityGeoJsonCollection
  • Content-Typeはapplication/geo+json; charset=utf-8です。
  • 互換別名 /api/v1/facilities.geojson も同じレスポンスを返します。
  • 座標順は [longitude, latitude] です。coordinate_precision=municipality は施設の正確な位置ではありません。
GET/api/v1/community-actionsJSON

地域の動き

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

Parameters

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

Request example

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

Response example

{
  "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
    }
  ]
}
Full field schema: CommunityActionListResponse
  • 最大100件。日付の新しい順です。
GET/api/v1/newsJSON

関連ニュース

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

Request example

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

Response example

{
  "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"
    }
  ]
}
Full field schema: NewsListResponse
  • 最大50件。未検証の収集候補は含みません。

Field definitions, types, units

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

施設一覧レスポンス FacilityListResponse

公開施設の件数と一覧。

FieldTypeDescription
countintegeritemsの件数
itemsFacilitySummary[]公開施設一覧
施設一覧項目 FacilitySummary

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

FieldTypeDescription
slugstringURL・詳細APIで使う安定識別子
canonical_namestring施設の標準名称
canonical_name_enstring | null英語名称(無い場合は null)
prefecturestring都道府県名
pref_codestring | nullJIS都道府県コード2桁
municipalitystring | null市区町村
statusstring施設状態
status_as_ofstring | null状態の基準日(部分日付)
status_as_of_precisionstringstatus_as_ofの精度
coordinate_precisionstring公開座標の精度
evidence_levelstring公開情報の確度
power_capacity_mwnumber | null公表された電力容量
power_capacity_typestring | null電力容量の意味区分
detail_urlstring本サイト内の施設詳細相対URL
施設詳細レスポンス FacilityDetailResponse

施設本体と関連情報。

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

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

FieldTypeDescription
idstring内部一意ID
slugstring公開識別子
canonical_namestring標準名称
canonical_name_enstring | null英語名称
prefecturestring都道府県名
pref_codestring | nullJIS都道府県コード2桁
municipalitystring | null市区町村
address_publicstring | null公開可能な住所
latitude_publicnumber | null公開緯度
longitude_publicnumber | null公開経度
coordinate_precisionstring座標精度
statusstring施設状態
status_as_ofstring | null状態の基準日(部分日付)
status_as_of_precisionstring状態基準日の精度
announced_datestring | null計画公表日(部分日付)
construction_start_datestring | null着工日(部分日付)
operational_datestring | null稼働日(部分日付)
site_area_m2number | null敷地面積
floor_area_m2number | null延床・床面積
power_capacity_mwnumber | null電力容量
power_capacity_typestring | null電力容量の意味区分
power_capacity_notestring | null容量の補足
cooling_typestring | null冷却方式
water_sourcestring | null水源・水利用
ai_workload_claimstring | nullAI用途に関する公表内容
puenumber | nullPower Usage Effectiveness
pue_typestring | nullPUEが実績値か目標値か
pue_as_ofstring | nullPUEの基準日(部分日付)
pue_as_of_precisionstringPUE基準日の精度
power_colocationstring | null発電所併設・専用電源の区分
power_colocation_notestring | null電源併設の補足
evidence_levelstring確度
last_verified_atstring | null最終検証日時
review_statusstring公開状態(公開APIではpublished)
published_atstring | null公開日時
created_atstring作成日時
updated_atstring更新日時
deleted_atstring | null削除日時(公開APIではnull)
関連事業者 Operator

施設と関係する事業者。

FieldTypeDescription
idstring事業者ID
slugstring事業者識別子
namestring名称
name_enstring | null英語名称
website_urlstring | null公式サイト
rolestring施設との関係
施設イベント FacilityEvent

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

FieldTypeDescription
idstringイベントID
facility_idstring施設ID
event_datestring | nullイベント日(部分日付)
event_date_precisionstringイベント日の精度
event_typestringイベント種別
status_fromstring | null変更前状態
status_tostring | null変更後状態
titlestring見出し
summarystring | null要約
created_atstring記録作成日時
sourcesEvidenceSource[]イベントの出典
出典 EvidenceSource

正規化した公開出典。

FieldTypeDescription
idstring出典ID
canonical_urlstring正規化URL
original_urlstring収集時URL
publisherstring発行元
titlestring資料・記事名
published_datestring | null公表日(部分日付の場合あり)
retrieved_atstring取得日
source_typestring出典種別
notesstring | null公開補足
施設出典 FacilityEvidenceSource

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

FieldTypeDescription
idstring出典ID
canonical_urlstring正規化URL
original_urlstring収集時URL
publisherstring発行元
titlestring資料・記事名
published_datestring | null公表日
retrieved_atstring取得日
source_typestring出典種別
notesstring | null公開補足
claimstring裏づける主張
supportstring主張との関係
周辺電源コンテキスト PowerContext

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

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

GeoJSON FeatureCollection。

FieldTypeDescription
typestringGeoJSON種別
featuresFacilityGeoJsonFeature[]施設Feature
施設GeoJSON Feature FacilityGeoJsonFeature

施設1件のPoint Feature。

FieldTypeDescription
typestringGeoJSON種別
geometryPointGeometry位置
propertiesFacilityGeoJsonProperties施設属性
Point geometry PointGeometry

GeoJSON Point。

FieldTypeDescription
typestringgeometry種別
coordinatesnumber[]WGS84座標
GeoJSON施設属性 FacilityGeoJsonProperties

地図描画用の施設要約。

FieldTypeDescription
slugstring施設識別子
namestring施設名称(日本語)
name_enstring | null英語名称(無い場合は null)
statusstring施設状態
status_as_ofstring | null状態の基準日
status_as_of_precisionstring状態基準日の精度
coordinate_precisionstring座標精度
evidence_levelstring確度
prefecturestring都道府県
municipalitystring | null市区町村
detail_urlstring施設詳細相対URL
地域の動きレスポンス CommunityActionListResponse

地域記録の件数と一覧。

FieldTypeDescription
countintegeritemsの件数
itemsCommunityAction[]地域記録
地域の動き項目 CommunityAction

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

FieldTypeDescription
idstring記録ID
prefecturestring都道府県
municipalitystring | null市区町村
action_typestring記録種別
titlestring見出し
summarystring | null要約
action_datestring | null日付(部分日付)
action_date_precisionstring日付精度
evidence_levelstring確度
facility_slugstring | null関連施設slug
facility_namestring | null関連施設名
関連ニュースレスポンス NewsListResponse

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

FieldTypeDescription
countintegeritemsの件数
itemsNewsItem[]ニュース項目
関連ニュース項目 NewsItem

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

FieldTypeDescription
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で明示的に返すエラー。

FieldTypeDescription
errorstring機械可読な短いエラー文字列