Regional Data

1市区町村、1条件軸・1値、Top Nで町丁を比較するRegional Data v1の正本契約です。

契約と上限

schemaVersion: 1.0
methodology.version: single-axis-relative-share-v1
topN: 1–50（既定 10）

requestはschemaVersion、idempotencyKey、region、condition、topNを持ちます。resultはrequestId、analysisId、region、condition、dataVersion、methodology、quality、topAreasを返します。

Regional Data v1の合成例

合成例 — 契約を読むための固定例であり、実データや現在の提供状態を示しません。

request

{
  "schemaVersion": "1.0",
  "idempotencyKey": "synthetic-home-preview-001",
  "region": {
    "prefectureCode": "13",
    "municipalityCode": "13110"
  },
  "condition": {
    "axis": "age_group",
    "value": "35-44"
  },
  "topN": 10
}

result

{
  "schemaVersion": "1.0",
  "requestId": "req_synthetic",
  "analysisId": "ana_synthetic",
  "status": "SUCCEEDED",
  "region": {
    "prefectureCode": "13",
    "municipalityCode": "13110",
    "granularity": "town"
  },
  "condition": {
    "axis": "age_group",
    "value": "35-44"
  },
  "dataVersion": {
    "datasetId": "synthetic-regional-town-2020",
    "surveyVintage": "2020",
    "sourcePublishedAt": null,
    "sourceRevisedAt": null,
    "sourceRetrievedAt": "2026-01-01T00:00:00.000Z",
    "syncedAt": "2026-01-02T00:00:00.000Z",
    "transformVersion": "synthetic-town-transform-v1"
  },
  "methodology": {
    "version": "single-axis-relative-share-v1",
    "kind": "single_axis_relative_share",
    "isRelative": true,
    "comparisonScope": "municipality:13110",
    "limitations": [
      "Synthetic fixture for contract verification; not production availability evidence."
    ]
  },
  "quality": {
    "matched": 3,
    "total": 3,
    "ratio": 1,
    "missing": 0,
    "warnings": [
      "source_date_warning:published_missing",
      "source_date_warning:revised_missing"
    ]
  },
  "topAreas": [
    {
      "rank": 1,
      "areaCode": "13110000001",
      "name": "例示町一丁目",
      "axisShare": 0.6,
      "relativeScore": 100
    },
    {
      "rank": 2,
      "areaCode": "13110000002",
      "name": "例示町二丁目",
      "axisShare": 0.4,
      "relativeScore": 50
    },
    {
      "rank": 3,
      "areaCode": "13110000003",
      "name": "例示町三丁目",
      "axisShare": 0.2,
      "relativeScore": 0
    }
  ]
}

順位は市区町村内の相対比較です。複数条件を同時に満たす世帯数の実数、絶対確率、事業成果の予測は示しません。

結果の読み方

topAreasのaxisShareは選択条件の構成比、relativeScoreとrankはmunicipalityの比較集合内の順位です。dataVersionは取得・変換時点を、qualityはmatched / total / ratio / missing / warningsを示します。

結果は比較集合内の相対比較に限ります。複数条件を同時に満たす世帯数や絶対確率を表すものではありません。