Schedules — กติกา "จุดนี้ = เวลาจุดอ้างอิง ± n นาที"
- ฟิลด์ derive { from_station_id, offset_min } คำนวณที่ ui/partials/schedules.js (ท่อเดียว) รองรับอ้างจุดข้ามทิศ
- จุดย่อยของ "8 other_stop" ใช้ offsets_min จับคู่ตามลำดับ (เช่น ตลาดสามโก้ = ตลาดท่าช้าง +45 นาที)
- เครื่องมือ resource/tools/derive-times.py + ตาราง resource/data/derive-times.csv (--check / --audit ชี้จุดที่ควรตั้งกฎ)
- แยกตารางเป็นรายสาย: scheduleslist/schedules<route_id>.json และ schedules.json เป็นสารบัญ (โหลดแบบ lazy + cache)
- ตรวจจับวันทำงาน/วันหยุด + schema 3 (weekday/holiday → directions) · ไฟล์ข้อมูลเป็น CRLF ทั้งชุด
- ล้างค่าที่ไม่ใช่ HH:MM ที่ฝังใน times (ทำให้ KPI เพี้ยน) + กันค่าหลอกในตัวสรุปเวลา
UI
- หน้ารายละเอียดป้าย/ตารางเวลา ขับเคลื่อนด้วย JSON (stopDetail.init.js) · จุดขึ้นรถประจำทางอื่นๆ รองรับหลายจุดต่อสาย
- #/stops: แสดง 6 ป้ายแรก + ปุ่ม "แสดงป้ายทั้งหมด" (โหลดรูปเฉพาะที่แสดง) · ชิปสาย → #/routes/<route_id>
- หน้าแรก: ตัดตัวเลือก "ทุกสถานีในจังหวัดนี้" · ตัวกรองจังหวัด/สถานี + ปุ่มแชร์ (share URL)
- การ์ดติดต่อ: ไอคอน/ชื่อ/สีเปลี่ยนตามชนิด URL (Facebook / LINE / เว็บไซต์) + ปุ่มเปิดลิงก์จาก web_url
- รูปรองรับหลายนามสกุล (.jpg → .jpeg → .webp → .png) · ป้าย "ประมาณ" + หมายเหตุสำหรับตารางที่คำนวณ
- หน้าเครดิตเหลือ 3 หมวด · แก้ข้อความหมวดแผนที่ให้ตรงกับข้อมูลจริง
- แผนที่ Leaflet (vendor ในโปรเจกต์ ไม่ใช้ CDN): เส้นทาง + หมุด + ป๊อปอัป · แก้ CSS ที่ทำให้ SVG ยุบ 0x0
เครื่องมือและเอกสาร
- qgis-to-web.py อ่าน .shp ตรง → geojson-web (สร้างใหม่ 10 ไฟล์) + audit-geojson.py ตรวจ 3 ส่วน
- stop-km.py วัดระยะ กม. ตามเส้นจริง → stop-km.json · schedules-editor.html (แก้ทีละไฟล์ · มุมมองตารางแบบ Excel)
- AGENTS.md: กติกา derive · offsets_min · นามสกุลรูป · ชิปสาย · หน้ารายละเอียดป้ายมาจากไหน
8.4 KiB
GeoJSON-2 — โฟลเดอร์ส่งข้อมูลเส้นทางจาก QGIS → เว็บ
โฟลเดอร์นี้คือ ทางเดียว ที่ข้อมูลเส้นทางเดินรถเข้าสู่เว็บ mockup นี้
(QGIS export → ที่นี่ → สคริปต์แปลง → ../../geojson-web/ → แผนที่ Leaflet อ่าน)
QGIS (minibus map.qgz) เว็บใช้จริง
แก้เส้นทางในเลเยอร์ .shp ──Save──▶ <รหัส>.shp ──รันสคริปต์──▶ resource/data/geojson-web/<รหัส>.geojson
(CRS = EPSG:4326) python resource/tools/qgis-to-web.py
(ทางเลือกเดิม: --from geojson อ่านจาก GeoJSON-2/*.geojson)
ไม่ต้อง export GeoJSON อีกแล้ว — pipeline อ่าน
.shpตรง ๆ ผ่านตารางSHP_MAPในสคริปต์ (เวอร์ชัน 26/09/2026 เปลี่ยนมาใช้ทางนี้ เพราะวิธีทำงานจริงคือแก้ใน QGIS แล้วกด Save)
1. ก่อน export (ใน QGIS)
เปิดโปรเจกต์: resource/data/QGIS Project/minibus map.qgz
| เรื่อง | กติกา |
|---|---|
| CRS | EPSG:4326 – WGS84 เท่านั้น — ถ้า export เป็น UTM (EPSG:32647/32648) เว็บจะ ปฏิเสธไฟล์ (หมุดจะไปเกาะผิดที่) |
| ชื่อไฟล์ | <รหัสสาย>.geojson เช่น 101.geojson, 902.geojson (ชื่อไฟล์ = เลขสายที่เว็บใช้) |
| ปลายทาง | โฟลเดอร์นี้ (resource/data/QGIS Project/GeoJSON-2/) |
| ชนิดข้อมูล | LineString หรือ MultiLineString (หลายช่วงในไฟล์เดียวได้) |
ขั้นตอน export: คลิกขวาเลเยอร์ ▸ Export ▸ Save Features As…
Format : GeoJSON
File name : resource\data\QGIS Project\GeoJSON-2\101.geojson
CRS : EPSG:4326 - WGS84 ← สำคัญที่สุด
Layer Options / Geometry → เปิด Use RFC7946 ถ้ามี
2. เลเยอร์ไหนคือสายไหน (ในโปรเจกต์ QGIS มีหลายเวอร์ชันต่อสาย — เลือกให้ถูก)
| รหัสสาย | ไฟล์ .shp ที่ตรงกับที่เว็บใช้อยู่ | เวอร์ชันอื่นในโปรเจกต์ (ใช้ได้แต่ต้องเลือกโดยตั้งใจ) |
|---|---|---|
| 101 | 101-Angthong-pamok-Ayuthaya.shp (68 จุด) |
— |
| 902 | 902.shp (83 จุด) |
902 Ang Thong-Bangkok.shp (57 จุด, ไม่มี .prj) |
| 15 | 15 angthong-Bangkok-local.shp (120 จุด) |
15 Angthong-2.shp (11 จุด) |
| 951 | 951 Bangkok-wisead-suphanburi.shp (34 จุด) |
— |
| 952 | 952 กรุงเทพ-วิเศษชัยชาญ.shp (53 จุด) |
— |
| 954 | 954.shp (95 จุด) |
954 bangkok-singburi.shp (56 จุด) |
| 8 | 8 Bangkok-Chainat.shp (138 จุด) |
— |
| 464 | 464 -suphanburi-saraburi.shp (103 จุด, 2 ช่วง) |
— |
| 641 | 641-Angthong-lopburi1.shp (109 จุด) |
641-Angthong-lopburi.shp (97 จุด) |
| 2194 | 2194.shp (345 จุด) |
2194-Huaweanh-ayuthaya.shp (32 จุด) |
| 324 | 324-Angthong-watpikungthong1.shp (86 จุด) |
324-Angthong-watpikungthong.shp (54 จุด) |
| 1011 | 1011.shp (85 จุด) |
1011-Ang thong-Sribuathong.shp (59 จุด) |
| 2231 | 2231.shp (83 จุด) |
2231-Ang Thong-mahanam.shp (54 จุด) |
| 905 | 905 bangkok-singburi.shp (37 จุด) |
(ยังไม่มีใน routes.json) |
| 1012, XXX1, XXX2 | ไม่มีไฟล์ชื่อตรง (มีเฉพาะใน geojson-web/) |
— |
| 999 | ไม่มี geometry เลย — ต้องวาดใหม่ใน QGIS | — |
⚠️ ตัวเลข "จุด" = จำนวนจุดในเส้น ยิ่งมากยิ่งเกาะถนนละเอียด (จุดห่างกันน้อย) เส้นที่หยาบ (เช่น 902 = 48 จุด/100 กม.) จะเห็นเป็นเส้นตัดตรงข้ามโค้งถนนเมื่อซูมเข้า
3. แปลงเป็นไฟล์ที่เว็บใช้ (หลังกด Save ใน QGIS)
cd D:\Git\web-at-transit-mock
python resource/tools/qgis-to-web.py --check # ตรวจก่อน (ไม่เขียนไฟล์) — "เหมือนเดิม ✓" = QGIS ไม่มีการเปลี่ยน
python resource/tools/qgis-to-web.py --list # ดูตารางรหัสสาย ↔ ไฟล์ .shp + สถานะ
python resource/tools/qgis-to-web.py # เขียนจริง → resource/data/geojson-web/
สคริปต์จะ: อ่านไฟล์ .shp ตามตาราง SHP_MAP · ปฏิเสธไฟล์ที่ CRS เป็น UTM (เช็คจาก .prj + รูปแบบพิกัด) ·
ตัดจุดที่หลุดกรอบประเทศไทย (lng 97–103, lat 12–17.5) · ปัดพิกัด 5 ตำแหน่ง · เขียน 1 record = 1 feature (MultiLineString) ·
properties {"route_id": "<รหัส>"} · ไม่เขียนทับไฟล์ที่ไม่มีการเปลี่ยนแปลง
⚠️ ถ้าเปลี่ยนชื่อไฟล์
.shpใน QGIS ต้องแก้ตารางSHP_MAPในสคริปต์ด้วย (ไม่งั้นจะขึ้น "ไม่พบไฟล์")
3.1 ตรวจสุขภาพข้อมูล (แนะนำให้รันก่อน/หลังแก้เส้น)
python resource/tools/audit-geojson.py
ตรวจ 3 ส่วน: A) ไฟล์ส่งออกใน QGIS Project (CRS/ว่าง/ซ้ำ/หยาบ) · B) ข้อมูลที่เว็บใช้จริง geojson-web/
(รวม ปลายเส้นตรงกับจุดจอดจริงไหม เทียบ stations.json + 8 other_stop.json) · C) sync: shapefile ↔ geojson-web
(บอกว่า "ต้องรัน qgis-to-web.py" หรือไม่)
เกณฑ์: CRS ต้อง WGS84 · ตัดตรง > 1.5 กม. = หยาบเกินไป · ปลายเส้นห่างจุดจอด > 1.0 กม. = ไม่ตรง
4. ทดสอบ
เปิด http://localhost:8090/ui/index.html#/routes/101 (เปลี่ยนเลขสายตามที่แก้) แล้วกด Ctrl+Shift+R
- ไฟล์
.geojsonเป็น network-first ใน Service Worker → ไม่ต้อง bumpVERSIONเมื่อแก้แต่ข้อมูลเส้น - bump
VERSIONในui/sw.jsเฉพาะเมื่อแก้ไฟล์ในรายการ precache (HTML/CSS/JS)
5. ขอบเขตข้อมูล
| เรื่อง | รายละเอียด |
|---|---|
geojson-web/ มี 17 ไฟล์ |
แต่ routes.json ใช้ 14 สาย → 1012, 905, XXX1, XXX2 มีข้อมูลแต่ยังไม่ถูกเรียกใช้ |
| กี่สายที่แสดงบนแผนที่ได้ | 13/14 (ทุกสายใน routes.json ยกเว้น 999 ที่ไม่มี geometry) |
| ป้ายหยุดรถ | ไม่ได้อยู่ในโฟลเดอร์นี้ — มาจาก resource/data/busstop_list.json (154 ป้าย) |
| หมุดสถานี | มาจาก resource/data/stations.json (ต้องมีพิกัดเป็น number ไม่ใช่ string) |