データ出典台帳

サイトで使うデータの出典・ライセンス・確認日の一覧。新しいデータ源を使ったら追記する。

浜松市オープンデータ

• 提供：浜松市
• ライセンス：クリエイティブ・コモンズ 表示 2.1 日本（CC BY 2.1 JP）
• 利用規約：https://www.city.hamamatsu.shizuoka.jp/koho2/opendata/kiyaku.html
• カタログ：https://www.city.hamamatsu.shizuoka.jp/odpf/opendata/v1.html
• 出典表記：「浜松市オープンデータ（CC BY 2.1 JP）」（フッターと各データ表示箇所）
• 確認日：2026-10-07（小・中学校通学区域と町字・年齢別人口は 2026-10-13）

取得方法

• データセットページ（v1.html?x=<ID>）は JavaScript でカタログAPI https://www.city.hamamatsu.shizuoka.jp/api/odpf/opendata/v1?m=detail&x=<ID> を読み込んで表示している。応答JSONの odpf_body（HTML）に版・件数・更新日・ダウンロードリンクが含まれる。
• ダウンロードリンクは https://opendata.hamamatsu.odpf.net/redir/<ID>/<csv|excel|json>?r=<実ファイルURL> の形式。実ファイルは次の2系統に分かれている。
  • https://prd-hmpf-s3-odpf-01.s3.ap-northeast-1.amazonaws.com/opendata/v01/<ID>/<ID>.<拡張子>
  • https://static.hamamatsu.odpf.net/opendata/v01/<ID>/<ID>.<拡張子>
• npm run fetch（scripts/fetch/hamamatsu-opendata.ts）は、カタログAPIから最新のCSV URLを取得してダウンロードする。APIから取得できない場合は scripts/fetch/sources.ts に記録したURLを使う。
• 保存先：data/raw/<ID>/<YYYY-MM-DD>/（日付はJST）。CSVはバイト列のまま保存し、同じ場所の meta.json に取得URL・版・件数・更新日・SHA-256・Last-Modified を記録する。
• 取得のたびに data/update-log.csv に1データセット1行を追記する（列：fetched_at（UTC）・dataset・file・sha256・bytes・changed（直前の記録とハッシュが異なれば 1、同じなら 0、初回は空）・catalog_version・catalog_count・catalog_updated・last_modified）。
• GitHub Actions（.github/workflows/fetch-data.yml）が毎日 05:00 JST に npm run fetch を実行し、data/ 配下の差分だけを main に直接コミットする。手動実行（workflow_dispatch）も可能。
• CSVの文字コードは Shift_JIS（確認日時点で子育て支援ひろば一覧・児童館一覧・市営駐車場を確認）。変換は scripts/build/ 側で行う。

データセット一覧（CSV）

• 市営駐車場のIDは企画書に未記載だったため、カタログの施設カテゴリ（v1.html?m=category&v=7）から特定した（IDに 221309_ の接頭辞がない）。
• 市営駐車場は、駐車場が「無」のひろばのカード・詳細ページに「近くの駐車場」として表示する（npm run data で data/processed/parking.json を出力）。ひろばからの直線距離が2km以内のものを近い順に最大3か所。確認日（2026-10-14）時点では4か所すべて中央区の浜松駅周辺にある。
• 浜松市施設情報のデータセットページ（v1.html?x=221309_hamamatsu_institution）は分類メニューが表示されるため、ダウンロードリンクは m=detail を付けたページ（Excel・CSV タブ）にある。
• 一時預かり事業空き状況は集計日が古いため、実施施設一覧としてのみ使う（企画書 2.3・3.3）。
• 同じ形式でExcel（.xlsx）・JSON（.json）も公開されているが、取得はCSVのみとする。
• 町字・年齢別人口は時点（3月末・9月末）ごとに別IDのデータセットとして公開される（統計カテゴリ v1.html?m=category&v=5、確認日時点で 2023年3月〜2026年3月の7時点）。過去時点は内容が変わらないため、scripts/fetch/sources.ts で once: true とし、取得済みなら再取得しない。新しい時点が公開されたらIDを追加する。
• 町字・年齢別人口の項目：NO, 都道府県コード又は市区町村コード, 都道府県, 市区町村名, 対象年月, 区CD, 区, 地区, 大字CD, 大字, 年齢（0〜103、104歳以上は「104～」）, 合計, 男性, 女性, 備考（「早馬町に合算」など）。2023年は再編前の区名（中区・東区など）。
• 小・中学校通学区域は小学校×中学校の組み合わせ1行ごとに、町名を「・」区切りで並べた形式。町の一部だけが学区の場合は（）〔〕［］【】で条件が付く。学区×町名の対応表と表記ゆれの記録は school-areas.md。
• 子育て支援ひろば一覧はカタログ上の更新日（2026-10-05）とCSVの Last-Modified（2026-04-03）が一致しない。更新の実態は毎日の取得で SHA-256 を比べて判断する。

参考：今後使う予定のデータセットID（カタログで確認済み、未取得）

地理院タイル（国土地理院）

• 提供：国土地理院
• 利用条件：https://maps.gsi.go.jp/development/ichiran.html（地理院タイル一覧）、https://www.gsi.go.jp/kikakuchousei/kikakuchousei40182.html（国土地理院コンテンツ利用規約）
• 利用内容：地図コンポーネント（src/components/MapView.astro）の背景地図。標準地図 https://cyberjapandata.gsi.go.jp/xyz/std/{z}/{x}/{y}.png（ズーム5〜18）をブラウザから直接読み込む。
• 出典表記：地図上のクレジット（「地理院タイル」へのリンク）と、地図の下の「地図：国土地理院（地理院タイル）」
• 確認日：2026-10-13

不動産情報ライブラリ（国土交通省）

• 提供：国土交通省
• 利用規約：https://www.reinfolib.mlit.go.jp/help/termsOfUse/（利用条件の整理は企画書 13.1）
• APIマニュアル：https://www.reinfolib.mlit.go.jp/help/apiManual/
• 利用内容：学区ページ用の市区町村一覧（XIT002）・取引価格（XIT001）・地価公示/地価調査（XPT002）・小中学校区（XKT004/005）・災害リスク（XKT026〜029）。取得対象・方法・アクセスログは reinfolib.md
• 取得：npm run fetch:reinfolib（GitHub Actions fetch-reinfolib.yml が毎週実行）。保存先 data/raw/reinfolib_<api>/<YYYY-MM-DD>/
• 加工：保存時に、タイルごとの応答を1つの GeoJSON にまとめ、同一の地物を1件にし、小中学校区は浜松市の行政区域コードの地物だけに絞る。属性値は変えない。サイトに表示するときは加工した旨を明記する
• 出典表記（必須）：
  • サイト内のクレジット「このサービスは、国土交通省の不動産情報ライブラリのAPI機能を使用していますが、提供情報の最新性、正確性、完全性等が保証されたものではありません」
  • 各表示箇所に「出典：国土交通省　不動産情報ライブラリ」と URL（https://www.reinfolib.mlit.go.jp/）
• 商用利用・再配布・保存の可否は規約に明記がないため、収益ページでの公開前に運営へ確認する（人間、企画書 13.1）
• 確認日：2026-10-14（サイトではまだ使っていない）

気象庁 天気予報（試作・取得元は未決定）

Issue #14 で利用条件を確認中。取得元の最終決定と利用条件の最終確認は人間が行う。サイトではまだ使っていない。

• 提供：気象庁（静岡地方気象台）
• 利用規約：気象庁ホームページ「ご利用にあたって」https://www.jma.go.jp/jma/kishou/info/coment.html
  • 権利表記がない限り「公共データ利用規約（第1.0版）」（PDL1.0、CC BY 4.0 互換）https://www.digital.go.jp/resources/open_data/public_data_license_v1.0 に準拠
  • 出典記載例：「出典：気象庁ホームページ（当該ページのURL）」。加工した場合は加工した旨と主体を別に記載する
  • 気象業務法による制約あり（第17条 予報業務の許可 https://www.jma.go.jp/jma/kishou/info/ml-17.html、第23条 警報の制限）
• 取得元（候補）：https://www.jma.go.jp/bosai/forecast/data/forecast/220000.json（気象庁ホームページの天気予報ページが読み込んでいるJSON。仕様が公開された API ではない）
  • 西部（浜松市を含む一次細分区域）：コード 220040。天気・6時間ごとの降水確率（翌日まで）
  • 気温地点：浜松 50456
  • 週間予報の降水確率は静岡県単位（220000）のみ
• 試作スクリプト：npx tsx scripts/fetch/jma-forecast.ts [--save]（--save で data/raw/jma-forecast/<YYYY-MM-DD>/ に保存）
• 確認日：2026-10-13