里資訊站
開放 API
這些資料本來就是政府開放資料，我們整理好後免金鑰、免申請提供。歡迎其他里、社區 App、LINE Bot、學生專題直接使用。
使用規則
- 全部 GET、回 JSON（行事曆為 text/calendar），CORS 允許任何來源。
- 合理使用：即時位置與公車到站請至少間隔 30 秒再查（上游本來就 30 秒～3 分鐘才更新）。
- 資料來源請標示「新北市政府環境保護局開放資料」「交通部 TDX」；本站非官方網站，時間僅供參考。
- 介面有變動會保留舊版至少三個月，並在這一頁公告。
GET
/api/v1/ntpc/districts/{區}/villages該區所有里，附本站對應網址
試試：/api/v1/ntpc/districts/%E6%96%B0%E5%BA%97%E5%8D%80/villages
GET
/api/v1/villages/{slug}/stops該里所有垃圾車停靠站與每週班表
slug 可以是已開通的里（renai），也可以是「新店區-仁愛里」這種探索格式（需 URL 編碼）
GET
/api/v1/villages/{slug}/live?stop={stopId}該里路線上的即時垃圾車位置；帶 stop 參數另回傳該站到站預估
環保局只在清運時段回報位置，非清運時段 vehicles 為空陣列是正常的
GET
/api/v1/villages/{slug}/stops/{stopId}/calendar.ics單一停靠站的每週重複行事曆（iCalendar）
回傳範例
GET /api/v1/villages/renai/live?stop=231004-18
{
"ok": true,
"vehicles": [
{ "lineId": "231004", "lineName": "路線4", "car": "KEA-1234",
"lat": 24.9721, "lng": 121.5419, "location": "新北市新店區中正路154巷",
"nearestStopName": "中正路154巷", "nearestStopTime": "14:20", "scheduleDeltaMin": 3 }
],
"eta": { "status": "approaching", "stopsAway": 2, "etaMinutes": 6, "position": { ... } },
"fetchedAt": "2026-09-10T06:18:02.000Z"
}