データ仕様 — 建物ごとの日当たり
ページの JSON（/path/index.json）
すべてのページに generated_at、data_through（PLATEAU 元ファイルの最終更新日）、source[]、
license、schema_url、canonical_url、language、data があります。
分布の項目（区・町丁目・23区全体）
値の単位は分（12月15日の直射時間）。割合は 0〜1。residential に同じ項目の住宅だけの値が入ります。
buildings | 建物数 |
|---|---|
buildings_with_exterior_face | 外気に面する面がある建物の数 |
buildings_with_south_face | 南向きの面がある建物の数 |
dec15_south_1f_q1 / _median / _q3 | 12/15 南面・1階の直射時間の四分位 |
dec15_best_top_q1 / _median / _q3 | 12/15 最良面・最上階の直射時間の四分位 |
share_dec15_best_top_2h | 12/15 最良面・最上階が 120 分以上の建物の割合 |
share_dec15_south_1f_2h | 12/15 南面・1階が 120 分以上の建物の割合 |
annual_mean_best_top_mean | 年間平均（最良面・最上階、分/日）の建物平均 |
mean_floors | 平均階数（階高 3 m） |
highrise_share | 高さ 31 m 超の建物の割合 |
edge_uncertain / height_uncertain | 23区の境界から 1 km 以内 / 高さ未計測の建物数 |
hist_dec15_best_top[11] / hist_dec15_south_1f[11] | 60 分ごとの建物数（最後は 600 分以上） |
usage_counts | 建物用途コードごとの建物数 |
top10_dec15_best_top / bottom10_dec15_best_top | 町丁目で 12/15 最良面・最上階が長い / 短い建物の ID |
API の応答
ベース URL https://api.tokeilab.org。{"data": ..., "meta": {generated_at, data_through, source, license, schema_url, api_version, cost_units}}。
ヘッダ X-Cost-Units・X-Api-Version。エラーは RFC 9457（application/problem+json）。使い方は API の使い方。
建物オブジェクト（/building/{building_id}、/near、/town/…/buildings）
building_id | PLATEAU の建物 ID（uro:buildingID、例 13112-bldg-202748） |
|---|---|
ward_code / town_code | 区コード（13101〜13123）/ 町丁目コード（2020 年国勢調査の小地域、9 桁または 11 桁） |
lat / lon | 建物の底面の重心（世界測地系） |
height_m / floors | 箱型モデルの高さ（m）/ 推定階数（階高 3 m） |
usage_code / usage / is_residential | PLATEAU の建物用途コードと名前（例 412 共同住宅）、住宅かどうか（用途不明は null） |
edge_uncertain / height_uncertain | 23区の境界から 1 km 以内 / 高さ未計測 |
summary.winter_solstice_best_face_top_floor_min | 12/15（冬至の代表日）最良面・最上階の直射時間（分） |
summary.winter_solstice_south_face_ground_floor_min | 12/15 南面・1階の直射時間（分）。南向きの面がなければ null |
summary.annual_mean_best_face_top_floor_min | 最良面・最上階の 12 か月平均（分/日） |
全結果（/building/{building_id}/full）
footprint: { unit: "m", origin: "footprint_centroid", axes: ["east", "north"], rings: [[[east, north], ...], ...] }
faces[]: { face_index, azimuth_deg, face_type: "exterior" | "shared_wall", length_m, midpoint_m: {east, north},
levels[]: { floor, z_m, days[12]: { date: "MM-15", represents?, direct_min, blocked_min,
backface_min, sunlit_intervals[]: {start, end} } } }
blockers[≤5]: { building_id, azimuth_deg, blocked_min }
terrain_blocked_min, self_blocked_min, model_version
face_index | 面の番号（外周の辺の長い順、0 から） |
|---|---|
azimuth_deg | 面の外向きの方位（北 0°、東 90°、南 180°、西 270°） |
length_m / midpoint_m | 壁（外周の辺）の長さと、その中点の位置（建物の底面の重心から東・北へ何 m か）。同じ向きの壁を見分けるのに使う |
footprint | 建物の底面の形（重心を原点に、東・北方向の m。外周のみ、0.1 m 単位） |
floor | 計算した階（1階・中間階・最上階の 3 つ） |
z_m | 観測点の標高（m、地盤の標高を含む。地面からの高さではありません） |
represents | winter_solstice など。その日を冬至・春分・夏至・秋分の代表日として使うことを示す（実際の日付は date） |
direct_min / blocked_min / backface_min | 日が当たった / 建物か地形の影になった / 太陽が面の裏側にあった時間（分、10 分刻み） |
sunlit_intervals | 日が当たった時間帯（日本標準時、end は含まない、10 分単位） |
blockers[].blocked_min | その建物の影になった時間の合計（全ての面・計算した階・12 日分の合計、分）。影が長い順に 5 件 |
terrain_blocked_min / self_blocked_min | 地形 / 建物自身の形による影の時間の合計（同じく全ての面・階・日の合計） |