# tokeilab

> 日本の公開データを集めて計算した統計を、人向けの HTML と AI エージェント向けの JSON で公開するサイト（日本語）。すべての HTML ページ /path/ に同じ内容の /path/index.json がある。 (Japanese-language site of statistics derived from Japanese open data; every page has a JSON twin at /path/index.json.)

## コンテンツ
- [東京23区 建物ごとの日当たり](https://tokeilab.org/sunlight/): 約196万棟の建物ごとに、周りの建物と地形の影を考えた直射日照時間（各月15日、面ごと・階ごと）。区・町丁目の分布は無料のページ、建物ごとの値は API。JSON: https://tokeilab.org/sunlight/index.json
- [町丁目の一覧（名前・読み・コード・代表地点）](https://tokeilab.org/sunlight/towns.json): 住所の町名から町丁目コードを探すのに使う
- [計算方法と限界](https://tokeilab.org/sunlight/methodology/)、[データ仕様](https://tokeilab.org/schema/sunlight/)

## 住所の日当たりを調べる手順
1. 緯度経度があれば https://api.tokeilab.org/api/v1/sunlight/near?lat=<緯度>&lon=<経度>&r=50 で周りの建物（用途・高さ・12/15 の日照）を取る
2. 町名だけなら https://tokeilab.org/sunlight/towns.json で town_code を探し、町丁目ページ https://tokeilab.org/sunlight/<区コード>/<town_code>/ または https://api.tokeilab.org/api/v1/sunlight/town/<town_code>/buildings を使う
3. 建物 ID で https://api.tokeilab.org/api/v1/sunlight/building/<building_id>/full（面・階・月ごとの日照と時間帯）
注意: シミュレーション（実測ではない）。樹木・バルコニー・天気・データ作成後の建物は反映しない。

## API
- [API の使い方](https://tokeilab.org/sunlight/api/)、エンドポイント一覧 https://tokeilab.org/openapi.json、料金 https://tokeilab.org/pricing/（課金は未有効化、コスト単位で計測）

## Status
- https://tokeilab.org/status.json