Human-verifiable, agent-ready

データ利用・公開API

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

公開契約

契約バージョン
1.6.0
最終確認日
2026-09-14
更新頻度
施設・地域記録は出典確認後に随時更新。検証済み関連ニュースは公開データに紐づいた出典から生成され、JDC未確認のAIフィードは毎日11:12 JSTの同期後に更新されます。電力背景ニュースは週次のGoogle News収集後に更新されます。求人は日次の観測、週報は週次の保存を想定しています。求人基盤が未準備ならavailable:false、観測日時がない場合はupdated_at:nullとなり、未収集を0件と解釈しません。各ニュースAPIは最大50件を返します。各レコードの updated_at、last_verified_at、published_date、retrieved_at、first_seen_at 等で個別の鮮度を確認してください。
認証
認証不要・読み取り専用(GET)
キャッシュ
施設関連の検証済みエンドポイント(/api/v1/newsを含む)は Cache-Control: public, s-maxage=300(共有キャッシュ5分)、/api/v1/ai-feed、/api/v1/power-context-news、/api/v1/jobsとその配下は Cache-Control: no-store(キャッシュ無効・最新取得)です

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

形式状態内容取得
Markdown提供中施設詳細の出典付きMarkdown。/facilities/{slug}/markdown、英語は /en/facilities/{slug}/markdown。—
JSON提供中施設一覧・施設詳細・地域の動き・関連ニュース開く
GeoJSON提供中座標確認済みの公開施設をFeatureCollectionで提供開く
GeoJSON(送電網参考・関東周辺)提供中関東周辺の矩形範囲で抽出した154kV以上の送電線・変電所(OpenStreetMap由来、ODbL 1.0。供給区域(管内)とは一致しない)開く
GeoJSON(送電網参考・東北周辺)提供中東北周辺の矩形範囲で抽出した154kV以上の送電線・変電所(OpenStreetMap由来、ODbL 1.0。供給区域(管内)とは一致しない)開く
GeoJSON(送電網参考・関西周辺)提供中関西周辺の矩形範囲で抽出した154kV以上の送電線・変電所(OpenStreetMap由来、ODbL 1.0。供給区域(管内)とは一致しない)開く
GeoJSON(送電網参考・北海道周辺)提供中北海道周辺の矩形範囲で抽出した154kV以上の送電線・変電所(OpenStreetMap由来、ODbL 1.0。供給区域(管内)とは一致しない)開く
GeoJSON(送電網参考・九州周辺)提供中九州周辺の矩形範囲で抽出した154kV以上の送電線・変電所(OpenStreetMap由来、ODbL 1.0。供給区域(管内)とは一致しない)開く
GeoJSON(送電網参考・中国周辺)提供中中国周辺の矩形範囲で抽出した154kV以上の送電線・変電所(OpenStreetMap由来、ODbL 1.0。供給区域(管内)とは一致しない)開く
GeoJSON(送電網参考・四国周辺)提供中四国周辺の矩形範囲で抽出した154kV以上の送電線・変電所(OpenStreetMap由来、ODbL 1.0。供給区域(管内)とは一致しない)開く
CSV未提供現時点では未提供。JSONまたはGeoJSONを利用してください。—

エンドポイント

GET/api/v1/jobsJSON

データセンター関連の観測求人

国内の求人広告の概要・出典・最終観測日を返します。既定は直近7日。採用人数や全国の総求人数を示すものではありません。

パラメータ

prefecturequery都道府県名
rolequery主職種区分
employment_typequery雇用形態
ai_relatedquery1でAI関連と明記された求人に限定、0で解除
historyquery1で過去の観測を含める、0で直近7日に限定
pagequeryページ番号(既定1、最大1000000)
limitquery1ページの件数(既定20、最大100)

リクエスト例

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

レスポンス例

{
  "items": [],
  "total": 0,
  "page": 1,
  "limit": 20,
  "updated_at": null,
  "available": false
}

観測基盤が未準備の場合の例。available:falseを求人0件として解釈しないでください。

完全な項目定義: JobWatchListResponse
  • 給与・勤務地など確認できない値はnullです。
  • statusは観測上の確認状態です。見つからなくなっただけでは募集終了にしません。
  • 原文全文や個人の連絡先、内部の収集情報は返しません。

400: 絞り込み条件が不正です。ページ指定の不正はinvalid_pageまたはinvalid_limitです。 {"error":"invalid_filter"}

GET/api/v1/jobs/statisticsJSON

求人広告の観測動向

直近7日の観測と、同じ観測条件で直接確認できた前週の動向を返します。取得できなかった日は欠測として扱います。

リクエスト例

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

レスポンス例

{
  "available": false,
  "updated_at": null,
  "period_start": "2026-09-08",
  "period_end": "2026-09-14",
  "total_observed": 0,
  "newly_discovered": 0,
  "confirmed_count": 0,
  "comparison": {
    "comparable": false,
    "previous": null,
    "current": null,
    "percent_change": null,
    "reason": "unavailable"
  },
  "by_role": [],
  "by_prefecture": [],
  "by_employment_type": [],
  "salary": [],
  "daily": [
    {
      "date": "2026-09-08",
      "count": null
    },
    {
      "date": "2026-09-09",
      "count": null
    },
    {
      "date": "2026-09-10",
      "count": null
    },
    {
      "date": "2026-09-11",
      "count": null
    },
    {
      "date": "2026-09-12",
      "count": null
    },
    {
      "date": "2026-09-13",
      "count": null
    },
    {
      "date": "2026-09-14",
      "count": null
    }
  ],
  "coverage": {
    "partial": 0,
    "failed": 0,
    "blocked": 0
  },
  "methodology": "求人広告の観測。未収集を0件と解釈しない。"
}
完全な項目定義: JobWatchStatistics
  • 比較可能な2週間が揃うまでは前週比を出しません。
  • 給与は時給・月給・年収を分けて集計し、換算しません。5件未満の給与集計は非表示です。
  • 複数勤務地の広告は全国で1件、地域別では複数地域に含まれるため合計は一致しない場合があります。
GET/api/v1/jobs/reportsJSON

求人動向の週次レポート

月曜から日曜を対象とする保存済みの週次分析を返します。アクセス時のAI生成は行いません。

リクエスト例

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

レスポンス例

{
  "items": [],
  "available": false
}
完全な項目定義: JobWatchReportsResponse
  • 観測開始前やレポート未作成の場合はitemsが空です。
  • 求人広告の観測動向であり、採用実績や人手不足の推定ではありません。
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",
      "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"
    }
  ]
}
完全な項目定義: FacilityListResponse
  • 並び順は都道府県、施設名の昇順です。
  • canonical_name_en は英語名称(無い場合は null)。クライアントは null のとき canonical_name へフォールバックしてください。

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",
        "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"
      }
    }
  ]
}
完全な項目定義: 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件。未検証の収集候補は含みません。
GET/api/v1/ai-feedJSON

日本関連AIインフラ記事(JDC未確認)

ai.kokubu.pl のAIニュース収集からJDC側で機械的に抽出した、日本関連のAIインフラ記事を新しい順に返します。

リクエスト例

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

レスポンス例

{
  "count": 1,
  "items": [
    {
      "id": "3f9a4d0b5c1e7f8290a1b2c3d4e5f678",
      "url": "https://www.publickey1.jp/blog/26/example.html",
      "title": "さくらインターネット、石狩でGPUクラスタを増設",
      "excerpt": "日本国内のAI計算基盤と電力設備に関する記事の短い抜粋です。",
      "publisher": "Publickey",
      "published_date": "2026-08-05",
      "published_date_precision": "day",
      "topics": [
        "compute",
        "datacenter"
      ],
      "verified": false,
      "verification_note": "JDC未確認。ai.kokubu.pl のAIニュース収集から機械的に抽出した日本関連のAIインフラ記事であり、本サイトが検証した出典ではありません。施設・計画の裏付けとしては引用できません。",
      "scope": "japan_related",
      "classifier_version": "1.0.0",
      "first_seen_at": "2026-08-06 11:12:11"
    }
  ]
}
完全な項目定義: AiFeedListResponse
  • JDC未確認・日本関連のAIインフラ記事・最大50件・本サイトが検証した出典ではありません。
  • Evidence Levelは付与しません。原記事の見出し、160文字以下の抜粋、発行元、日付、トピック、リンクのみを提供します。
GET/api/v1/power-context-newsJSON

AIデータセンター向け電力・発電の背景記事

AIデータセンター向けの電力・発電投資など、背景として読む記事を新しい順に返します。日本以外の報道を含み、施設や計画への紐付けはありません。

リクエスト例

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

レスポンス例

{
  "count": 1,
  "items": [
    {
      "id": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "url": "https://news.google.com/rss/articles/example",
      "title": "韓国、米テキサス州ガス火力発電所に200億ドル超投資へ=報道",
      "excerpt": "人工知能(AI)データセンター向けの電力需要拡大に対応するため、テキサス州にガス火力発電所を建設することを目指している。",
      "publisher": "ロイター",
      "published_date": "2026-09-07",
      "topics": [
        "datacenter",
        "power"
      ],
      "verified": false,
      "verification_note": "AIデータセンター向けの電力・発電投資などの背景記事です。日本以外の報道も含みます。施設や計画への紐付けはしておらず、個別施設の裏付けとしては使えません。",
      "scope": "power_context",
      "classifier_version": "1.0.0",
      "first_seen_at": "2026-09-08 01:30:00"
    }
  ]
}
完全な項目定義: PowerContextNewsListResponse
  • 施設の検証済み出典ではありません。日本以外の報道を含みます。最大50件。
  • Evidence Levelは付与しません。/api/v1/news および /api/v1/ai-feed とは別フィードです。
GET/api/v1/planning-casesJSON

計画・手続き記録一覧

出典付きで公開済みの計画・許認可等の記録を返します。未確認情報、内部メモ、下書きは含みません。

パラメータ

prefecturequery都道府県名の完全一致。pref は同義の短縮名です。
prefqueryprefecture の短縮名。両方を指定する場合は同じ値にしてください。
municipalityquery市区町村名の完全一致。
stagequery現在の計画段階。
actor_typequery公開主体の種別。
evidence_levelquery確度。E0は受け付けません。
fromquery最終検証日の下限(YYYY-MM-DD)。
toquery最終検証日の上限(YYYY-MM-DD)。
limitquery返却上限(1〜100、既定100)。

リクエスト例

curl -sS "https://japandatacenter.org/api/v1/planning-cases?prefecture=%E5%8D%83%E8%91%89%E7%9C%8C&stage=under_review"

レスポンス例

{
  "count": 1,
  "items": [
    {
      "id": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "title": "印西市内のデータセンター計画",
      "facility_id": null,
      "facility_slug": null,
      "facility_name": null,
      "facility_name_en": null,
      "prefecture": "千葉県",
      "municipality": "印西市",
      "scope": "municipality",
      "current_stage": "under_review",
      "outcome": "ongoing",
      "start_date": "2026-08",
      "start_date_precision": "month",
      "last_verified_at": "2026-08-05",
      "evidence_level": "E3",
      "source_count": 2,
      "last_actor_type": "municipality",
      "last_actor_name": "印西市",
      "created_at": "2026-08-05 12:00:00",
      "updated_at": "2026-08-05 12:00:00"
    }
  ]
}
完全な項目定義: PlanningCaseListResponse
  • 最大100件。response count は公的資料に記載された集計値であり、世論推定・ランキングではありません。

400: フィルタ値、日付範囲、またはlimitが不正です。 {"error":"invalid stage"}

GET/api/v1/planning-cases/{id}JSON

計画・手続き記録詳細

公開済みの計画ケースと、既存イベントまたは地域記録、公開主体・手続き・出典を返します。

パラメータ

idpath計画ケースID

リクエスト例

curl -sS "https://japandatacenter.org/api/v1/planning-cases/a1b2c3d4e5f60718293a4b5c6d7e8f90"

レスポンス例

{
  "case": {
    "id": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
    "title": "印西市内のデータセンター計画",
    "facility_id": null,
    "facility_slug": null,
    "facility_name": null,
    "facility_name_en": null,
    "prefecture": "千葉県",
    "municipality": "印西市",
    "scope": "municipality",
    "current_stage": "under_review",
    "outcome": "ongoing",
    "start_date": "2026-08",
    "start_date_precision": "month",
    "last_verified_at": "2026-08-05",
    "evidence_level": "E3",
    "source_count": 2,
    "last_actor_type": "municipality",
    "last_actor_name": "印西市",
    "created_at": "2026-08-05 12:00:00",
    "updated_at": "2026-08-05 12:00:00"
  },
  "items": []
}
完全な項目定義: PlanningCaseDetailResponse
  • 存在しないIDと非公開IDはいずれも404です。

404: 公開済みの記録が見つかりません。 {"error":"not found"}

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

施設別の計画・手続き記録

公開済み施設に紐づく公開済み計画ケースを返します。

パラメータ

slugpath施設一覧のslug
limitquery返却上限(1〜100、既定100)。

リクエスト例

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

レスポンス例

{
  "count": 0,
  "items": []
}
完全な項目定義: PlanningCaseListResponse
  • 非公開施設は404です。

400: limitが不正です。 {"error":"limit は1から100の整数です"}

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

項目定義・型・単位

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

観測求人の公開項目 JobWatchItem

出典へ遷移できる求人概要。個人情報や原文全文は含みません。

項目型単位説明
idstring—id
titlestring—title
urlstring—url
sourcestring—source
companystring | null—company
locationstring | null—location
prefecturestring | null—prefecture
employment_typestring | null—employment_type
salary_textstring | null—salary_text
rolestring—求人1件につき1つの主職種値: construction / electrical_mechanical / facility_operations / it_network / security_support / business / other
ai_relatedboolean—仕事内容にAI関連の明記がある
first_seen_atstring—first_seen_at
last_seen_atstring—last_seen_at
statusstring—掲載確認・未確認・明示された募集終了の区別値: observed / unconfirmed / closed
観測求人一覧 JobWatchListResponse

公開済み求人のページング結果。

項目型単位説明
itemsJobWatchItem[]—観測求人
totalinteger—total
pageinteger—page
limitinteger—limit
updated_atstring | null—updated_at
availableboolean—falseは観測基盤未準備であり求人ゼロを意味しない
求人広告の区分別集計 JobWatchCount

区分と広告件数。

項目型単位説明
keystring—key
countinteger—count
比較可能な前週との比較 JobWatchComparison

同じ条件で観測できる2週間に限定した比較。

項目型単位説明
comparableboolean—比較条件が揃っている
previousnumber | null—比較用の同条件における直接確認広告の件数
currentnumber | null—比較用の同条件における直接確認広告の件数
percent_changenumber | null—比較可能な直接確認広告の増減率(%)
reasonstring | null—比較できない理由の識別子
給与の観測 JobWatchSalary

5件以上の明記された給与を単位別に集計。推定換算はしない。

項目型単位説明
periodstring—記載給与の単位値: hourly / monthly / yearly
countinteger | null—対象件数。5件未満はnull
median_minnumber | null円median_min
median_maxnumber | null円median_max
日次の観測 JobWatchDay

欠測日はcount=nullで、求人ゼロとは区別する。

項目型単位説明
datestring—date
countinteger | null—その日の観測件数。欠測はnull
求人動向の集計 JobWatchStatistics

求人広告の動向。日本全体の求人数や採用人数の推計ではない。

項目型単位説明
availableboolean—観測基盤が利用可能
updated_atstring | null—updated_at
period_startstring | null—period_start
period_endstring | null—period_end
total_observedinteger—total_observed
newly_discoveredinteger—newly_discovered
confirmed_countinteger—confirmed_count
comparisonJobWatchComparison—前週比較
by_roleJobWatchCount[]—by_role
by_prefectureJobWatchCount[]—by_prefecture
by_employment_typeJobWatchCount[]—by_employment_type
salaryJobWatchSalary[]—単位別給与集計
dailyJobWatchDay[]—日次観測。欠測は空白として描画する
coverageobject—部分取得・欠測の概況。内部の取得経路は含まない
methodologystring—集計方法と解釈上の説明
週次分析 JobWatchReport

保存済みの日英分析と集計。

項目型単位説明
week_startstring—week_start
week_endstring—week_end
generated_atstring—generated_at
summary_jastring—summary_ja
summary_enstring—summary_en
metricsobject—週報生成時点の公開用集計
週報一覧 JobWatchReportsResponse

保存済み週報。

項目型単位説明
itemsJobWatchReport[]—週報
availableboolean—観測基盤が利用可能
施設一覧レスポンス FacilityListResponse

公開施設の件数と一覧。

項目型単位説明
countinteger—itemsの件数
itemsFacilitySummary[]—公開施設一覧
施設一覧項目 FacilitySummary

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

項目型単位説明
slugstring—URL・詳細APIで使う安定識別子
canonical_namestring—施設の標準名称
canonical_name_enstring | null—英語名称(無い場合は null)
prefecturestring—都道府県名
pref_codestring | null—JIS都道府県コード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_precisionstring—status_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 | null—JIS都道府県コード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 | nullm²敷地面積
floor_area_m2number | nullm²延床・床面積
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 | null—AI用途に関する公表内容
puenumber | null—Power Usage Effectiveness
pue_typestring | null—PUEが実績値か目標値か値: actual / target
pue_as_ofstring | null—PUEの基準日(部分日付)
pue_as_of_precisionstring—PUE基準日の精度値: 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。

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

施設1件のPoint Feature。

項目型単位説明
typestring—GeoJSON種別
geometryPointGeometry—位置
propertiesFacilityGeoJsonProperties—施設属性
Point geometry PointGeometry

GeoJSON Point。

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

地図描画用の施設要約。

項目型単位説明
slugstring—施設識別子
namestring—施設名称(日本語)
name_enstring | null—英語名称(無い場合は null)
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

地域記録の件数と一覧。

項目型単位説明
countinteger—itemsの件数
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

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

項目型単位説明
countinteger—itemsの件数
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—出典リンクの最終更新日時
JDC未確認AIフィードレスポンス AiFeedListResponse

JDC未確認の日本関連AIインフラ記事の件数と一覧。

項目型単位説明
countinteger—itemsの件数
itemsAiFeedItem[]—JDC未確認の記事
JDC未確認AIフィード項目 AiFeedItem

発行元由来の見出し・短い抜粋と分類メタデータ。施設・計画の検証済み出典ではありません。

項目型単位説明
idstring—安定した記事ID
urlstring—原記事URL
titlestring—発行元由来の記事見出し
excerptstring | null—発行元由来の160文字以下の抜粋
publisherstring—発行元
published_datestring | null—公開日
published_date_precisionstring—公開日の精度値: day / unknown
topicsstring[]—JDC側の決定論的分類トピック
verifiedboolean—JDCによる検証済みか(常にfalse)
verification_notestring—JDC未確認であることと引用上の注意
scopestring—固定の地理スコープ
classifier_versionstring—決定論的分類器の版
first_seen_atstring—JDCが最初に取り込んだ日時
電力背景ニュースレスポンス PowerContextNewsListResponse

AIデータセンター向け電力・発電の背景記事の件数と一覧。

項目型単位説明
countinteger—itemsの件数
itemsPowerContextNewsItem[]—背景記事
電力背景ニュース項目 PowerContextNewsItem

電力・発電投資の背景記事。施設・計画の検証済み出典ではありません。

項目型単位説明
idstring—安定した記事ID
urlstring—記事URL(Google News配信URLの場合あり)
titlestring—記事見出し
excerptstring | null—抜粋
publisherstring | null—発行元
published_datestring | null—公開日
topicsstring[]—決定論的分類トピック
verifiedboolean—JDCによる検証済みか(常にfalse)
verification_notestring—背景記事であり施設の裏付けではないこと
scopestring—固定スコープ
classifier_versionstring—決定論的分類器の版
first_seen_atstring—JDCが最初に取り込んだ日時
エラーレスポンス ErrorResponse

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

項目型単位説明
errorstring—機械可読な短いエラー文字列
計画ケース一覧レスポンス PlanningCaseListResponse

公開済み計画ケースの件数と一覧。

項目型単位説明
countinteger—itemsの件数
itemsPlanningCase[]—計画ケース一覧
計画ケース詳細レスポンス PlanningCaseDetailResponse

公開済み計画ケースと時系列の構成記録。

項目型単位説明
casePlanningCase—計画ケース
itemsPlanningItem[]—紐づく公開記録
grid_factsPlanningGridFact[]—出典付きの系統連系・受電事実。待ち時間は推計しません
計画ケース PlanningCase

計画・許認可・手続きの公開記録。review_status、published_at、notes_internalは公開しません。

項目型単位説明
idstring—計画ケースID
titlestring—見出し
facility_idstring | null—関連施設ID
facility_slugstring | null—関連施設slug
facility_namestring | null—関連施設名
facility_name_enstring | null—関連施設英語名
prefecturestring—都道府県
municipalitystring | null—市区町村
scopestring—記録範囲値: facility / campus / municipality / utility_area / national_policy
current_stagestring—現在段階値: announced / pre_consultation / environmental_review / planning_application / under_review / approved / conditional_approval / deferred / withdrawn / under_construction / operational / unknown
outcomestring—結果値: ongoing / approved / conditional / deferred / rejected / withdrawn / unknown
start_datestring | null—開始時期(部分日付)
start_date_precisionstring—開始時期の精度値: day / month / year / unknown
last_verified_atstring | null—最終検証日
evidence_levelstring—確度値: E1 / E2 / E3 / E4 / E5
source_countinteger—重複を除く関連出典数
last_actor_typestring | null—最新の公開主体種別値: operator / developer / municipality / prefecture / national_government / regulator / utility / council / court / resident_group / ngo / media / other
last_actor_namestring | null—最新の公開組織・自治体等の名称
created_atstring—作成日時
updated_atstring—更新日時
計画ケース構成記録 PlanningItem

既存の施設イベントまたは地域記録と、その公開文脈・出典。recordの形はrecord_typeに従います。

項目型単位説明
idstring—紐づきID
sort_orderinteger—表示順
record_typestring—既存記録の種別値: facility_event / community_action
recordobject—既存の公開イベントまたは地域記録
contextPlanningContext | null—公開主体・手続き文脈
sourcesPlanningEvidence[]—既存記録の出典
計画・手続き文脈 PlanningContext

公開資料に基づく主体・手続き・判断・集計応答数。個人の連絡先や自由投稿は含みません。

項目型単位説明
idstring—文脈ID
facility_event_idstring | null—関連施設イベントID
community_action_idstring | null—関連地域記録ID
actor_typestring—公開主体種別値: operator / developer / municipality / prefecture / national_government / regulator / utility / council / court / resident_group / ngo / media / other
actor_namestring | null—公開組織・自治体等の名称
procedure_typestring—手続き種別値: announcement / pre_consultation / environmental_review / planning_application / public_comment / council_action / regulatory_decision / permit / appeal / court_filing / construction / operation / expansion / pause / withdrawal / correction / other
decisionstring—判断値: pending / approved / conditional_approval / rejected / deferred / withdrawn / noted / unknown
reason_tagsstring[]—公開資料に明記された理由分類
public_response_totalinteger | null—公式資料に明記された応答件数
public_response_forinteger | null—公式資料に明記された内訳
public_response_againstinteger | null—公式資料に明記された内訳
public_response_unknowninteger | null—公式資料に明記された内訳
as_ofstring | null—基準時点(部分日付)
as_of_precisionstring—基準時点の精度値: day / month / year / unknown
created_atstring—作成日時
updated_atstring—更新日時
sourcesPlanningEvidence[]—文脈の出典
計画・手続き出典 PlanningEvidence

既存のevidence_sourcesから明示射影した公開出典。

項目型単位説明
idstring—出典ID
canonical_urlstring—正規化URL
original_urlstring—収集時URL
publisherstring—発行元
titlestring—資料名
published_datestring | null—公表日
retrieved_atstring—取得日
source_typestring—出典種別値: official / media / gov_doc / filing / other
系統連系・受電事実 PlanningGridFact

個別の公開資料に明記された申込、回答、受電予定・実績、申込容量。日付間の待ち時間はAPIで導出しません。

項目型単位説明
idstring—事実ID
case_idstring—計画ケースID
fact_typestring—事実種別値: connection_application / utility_response / expected_energization / actual_energization / requested_capacity_mw
date_valuestring | null—部分日付。容量事実ではnull
date_precisionstring—日付精度。容量事実ではunknown値: day / month / year / unknown
capacity_mwnumber | nullMW申込受電容量。日付事実ではnull
notesstring | null—出典記載範囲内の注記
created_atstring—作成日時
updated_atstring—更新日時
sourcePlanningEvidence—当該値を裏付ける出典

出典と加工

主な出典

  • 企業・事業者の公式発表
  • 自治体・政府の行政資料、議事録、許認可等
  • 報道機関の記事
  • 求人媒体・企業の公式採用ページに掲載された国内の求人広告
  • ai.kokubu.pl のAIニュース収集に掲載された発行元由来の見出し・短い抜粋・メタデータ
  • OpenStreetMap(関東周辺・東北周辺・関西周辺・北海道周辺・九州周辺・中国周辺・四国周辺の主要送電線・変電所の参考レイヤー)

加工内容

  • URLを正規化し、同一出典の重複を抑制します。
  • 施設は最低1件の出典を必須とし、E1〜E5の確度を付与します。未確認のE0は公開しません。
  • 状態変更は出典付きイベントとして追記し、誤りは correction イベントで訂正します。
  • 求人は広告単位で記録し、観測日時・確認状態を保持します。取得失敗を募集終了にせず、観測件数を採用人数や人手不足の推計に使いません。前週比較は同じ観測条件の2週間が揃う場合に限ります。
  • 座標精度を別項目で保持し、市区町村代表点を正確な施設位置として扱いません。
  • 電力容量はMW、面積はm²、距離はkmで提供し、容量の意味区分を power_capacity_type で併記します。
  • 送電網参考レイヤーはOpenStreetMapのvoltageタグを数値分解し、最大値が154kV以上の設備をエリアごとの矩形範囲で抽出してGeoJSON化します(電圧階級の列挙に依存しないため、エリア固有の187kV・220kV等も漏れなく含む)。矩形範囲は供給区域(管内)と一致しません。物理的な位置関係のみを示し、供給余力・接続可否には使用しません。
  • ai.kokubu.pl の公開済み記事をJDC側の決定論的分類器で日本関連のAIインフラ記事に絞り込みます。公開APIではさらに信頼媒体ホストの許可リスト(application側)で絞り、施設紐付けはしません。これらのレコードにはEvidence Levelを付与しません。
  • AIデータセンター向けの電力・発電投資ニュースは、施設トリアージ用のニュース候補および日本関連AIフィードとは別テーブルに取り込みます。日本シグナルは必須にせず、電力・発電とデータセンターまたはAI文脈の両方がある記事だけを公開します。Evidence Levelは付与しません。

利用条件

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

個別の公式発表・行政資料・報道記事・求人広告そのものの著作権・利用条件は各権利者に帰属し、本サイトの利用許諾はそれらには及びません。AIフィードに取り込まれた見出し・抜粋も各発行元の権利に帰属し、原記事へのリンクを伴うメタデータとして提供します。求人は概要と出典リンクを提供し、原文全文は公開しません。送電網参考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ヘッダーを保証しません。