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 · นามสกุลรูป · ชิปสาย · หน้ารายละเอียดป้ายมาจากไหน
94 lines
12 KiB
Markdown
94 lines
12 KiB
Markdown
# `8 other_stop.json` — บันทึกเตือนความจำ (ห้ามเพิ่ม/ห้ามลบมั่ว)
|
|
|
|
> 📌 **ไฟล์นี้เป็นบันทึกของเจ้าของข้อมูล ไม่ใช่ข้อมูลสำหรับเว็บ** — เว็บอ่านเฉพาะ `8 other_stop.json`
|
|
> ไฟล์นี้มีไว้กันการ "ช่วยเติมข้อมูล" ที่ไม่ได้รับอนุญาต (เช่น AI หรือผู้พัฒนาที่เข้ามาทีหลัง)
|
|
|
|
อัปเดตล่าสุด: **2026-09-26** · ผู้ตัดสินใจ: เจ้าของข้อมูล (ทีม Atroute)
|
|
|
|
---
|
|
|
|
## 1. ไฟล์นี้คืออะไร
|
|
|
|
`stations.json` มีจุดจอดกลางชื่อ **"จุดขึ้นรถประจำทางอื่นๆ"** (`station_id: 8`, `station_code: other_stop`)
|
|
ซึ่งเป็น**ชื่อรวม**ของทุกสายที่ไม่ได้ขึ้นที่สถานีหลัก — ของจริงของแต่ละสายอยู่ใน `8 other_stop.json` เช่น
|
|
|
|
```json
|
|
{ "route_id": "1101", "station_name_th": "วัดสีบัวทอง", "city_th": "แสวงหา", "province_th": "อ่างทอง",
|
|
"station_type": "local_stop", "latitude": 14.787802367428677, "longitude": 100.23218786664407 }
|
|
```
|
|
|
|
หน้าเว็บ (`#/stops/other_stop?route=1011`) จะขึ้น **"จุดขึ้นรถประจำทางอื่นๆ · วัดสีบัวทอง"** โดยจับคู่จากไฟล์นี้
|
|
ตัวจับคู่อยู่ที่ `ui/partials/otherStop.js` (ใช้ทั้งหน้า `#/stops/...` และ `#/routes/...`) — **อ่านไฟล์นี้เท่านั้น ไม่ต้องแก้โค้ดเมื่อเพิ่ม/ลบรายการ**
|
|
|
|
---
|
|
|
|
## 2. ⛔ ห้ามเพิ่ม 7 สายนี้ (เจ้าของข้อมูลกำหนด)
|
|
|
|
| สาย | ชื่อสาย | มี`station_id 8` ในเส้นทางไหม | สถานะข้อมูลของจุดนั้น | คำสั่ง |
|
|
| ------------- | ------------------------------------------------ | --------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
|
|
| | | | | |
|
|
| **952** | กรุงเทพ-วิเศษชัยชาญ | มี (จุดที่ 3/3) | มีเวลา 3 เที่ยว แต่ยังไม่ระบุชื่อจุดจริง | ⛔ ห้ามเพิ่ม entry (อย่าเพิ่มเพราะเห็นว่ามีเวลา) |
|
|
| **641** | อ่างทอง-บ้านแพรก-ลพบุรี | มี (จุดที่ 3/3) | ยังไม่มีข้อมูลเวลาที่จุดนี้ | ⛔ ห้ามเพิ่ม entry |
|
|
| **15** | กรุงเทพ-อ่างทอง สายใน | ไม่มี | — | ⛔ ห้ามเพิ่ม — เพิ่มไปก็ไม่แสดงผล |
|
|
| **902** | กรุงเทพ-อ่างทอง สายเอเซีย | ไม่มี | — | ⛔ ห้ามเพิ่ม — เพิ่มไปก็ไม่แสดงผล |
|
|
| **464** | สุพรรณ-อ่างทอง-สระบุรี | ไม่มี | — | ⛔ ห้ามเพิ่ม — เพิ่มไปก็ไม่แสดงผล |
|
|
| **101** | อ่างทอง-ป่าโมก-อยุธยา | ไม่มี | — | ⛔ ห้ามเพิ่ม — เพิ่มไปก็ไม่แสดงผล |
|
|
|
|
**ผลเมื่อไม่มี entry:** หน้าเว็บยังทำงานปกติ — แถวของสายนั้นจะแสดงตำแหน่งในเส้นทางแทน
|
|
(เช่น `จุดจอดที่ 3/3` หรือ `Passing · 4/5`) **ไม่ใช่ข้อผิดพลาด** และไม่ต้องไปเติมให้ครบ
|
|
|
|
---
|
|
|
|
## 3. ✅ 6 รายการที่มีอยู่แล้ว — ห้ามลบ
|
|
|
|
| `route_id` ในไฟล์ | ใช้กับสาย | ชื่อจุดจริง | อำเภอ/จังหวัด |
|
|
| ------------------------- | ------------------ | ------------------------ | -------------------------------------------------- |
|
|
| `2231` | 2231 | วัดมหานาม | ไชโย · อ่างทอง |
|
|
| `324` | 324 | วัดไชโย | ไชโย · อ่างทอง |
|
|
| `954` | 954 | ตลาดท่าช้าง | เดิมบางนางบวช · สุพรรณบุรี |
|
|
| `8` | 8 | ตลาดสรรคบุรี | สรรคบุรี · ชัยนาท |
|
|
| `2194` | 2194 | วัดหัวเวียง | เสนา · อยุธยา |
|
|
| **`1101`** | **1011** | วัดสีบัวทอง | แสวงหา · อ่างทอง |
|
|
|
|
> ⚠️ `1101` **ไม่ใช่รหัสสายจริง** — เป็นรหัสที่ระบบเดิมใช้แทนสาย **1011**
|
|
> โค้ดรองรับไว้แล้ว (เทียบแบบ "ตัวเลขชุดเดียวกัน สลับตำแหน่ง" เฉพาะรหัส ≥3 หลัก และหาคู่ได้ไม่กำกวม)
|
|
> จะแก้เป็น `"1011"` ก็ได้ (โค้ดรองรับทั้งสองแบบ) แต่ **ห้ามลบ** เพราะจุดนี้เป็นของสาย 1011
|
|
|
|
---
|
|
|
|
## 4. กติกาที่โค้ดใช้จับคู่ (`ui/partials/otherStop.js`)
|
|
|
|
1. **ตรงตัวก่อน** — `route_id` ในไฟล์ตรงกับรหัสสายจริง → ใช้เลย
|
|
2. **ไม่ตรง → เทียบแบบสลับตำแหน่งตัวเลข** เฉพาะรหัส **≥3 หลัก** และต้องหาคู่ได้ **ตัวเดียว** → `1101 → 1011` ✅
|
|
3. **ไม่รู้จัก / กำกวม → ไม่เดา** (คืนค่าว่าง แล้ว UI ถอยไปแสดงตำแหน่งในเส้นทาง) — เช่น `51` จะไม่ถูกจับเป็น `15`
|
|
|
|
## 5. ถ้าอนาคตจะเพิ่มรายการใหม่ (ต้องได้รับการยืนยันจากเจ้าของข้อมูลก่อน)
|
|
|
|
คีย์ที่ต้องมี: `route_id`, `station_name_th`, `city_th`, `province_th`, `station_type` (`local_stop`), `latitude`, `longitude` (+ `note` ถ้ามี)
|
|
หลังเพิ่ม: หน้า `#/stops/other_stop?route=<รหัสสาย>` ต้องขึ้นชื่อจุดนั้นทันที · และ `#/routes/<รหัสสาย>` จะแสดงจุดนั้นพร้อม กม. ตามเส้นทาง
|
|
|
|
**ข้อห้าม:** อย่าเพิ่มรายการเพราะ "เห็นว่ายังไม่มี" — ถ้าไม่มีในตาราง §3 แปลว่ายังไม่ได้รับข้อมูลจากเจ้าของ
|
|
|
|
## 6. กติกา "หลายจุดต่อสาย" (สำคัญ — เจ้าของข้อมูลกำหนด)
|
|
|
|
สายเดียวผ่านได้หลายจุด (เช่น **954** = ตลาดท่าช้าง · ตลาดสามโก้ · ตลาดวิเศษชัยชาญ · ตลาดอ่างทอง)
|
|
|
|
```json
|
|
"station_name_th": ["ตลาดท่าช้าง", "ตลาดสามโก้", "ตลาดวิเศษชัยชาญ", "ตลาดอ่างทอง"],
|
|
"latitude": 14.651061064977933, ← พิกัด "ของชื่อแรก" (ตลาดท่าช้าง)
|
|
"longitude": 100.14903762295052
|
|
```
|
|
|
|
- `station_name_th` เป็นได้ทั้ง **ข้อความเดียว** หรือ **array หลายชื่อ**
|
|
- `latitude`/`longitude` เป็นได้ทั้ง **ตัวเลขเดียว** (ของชื่อแรก) หรือ **array** จับคู่ **ตามลำดับ**
|
|
- ตัวอย่าง array: สาย 8 → `latitude: [15.0474, 14.7497, 14.6603]` + 4 ชื่อ → ชื่อที่ 4 (ตลาดอ่างทอง) ยังไม่มีพิกัด
|
|
- **ชื่อที่เกินจำนวนพิกัด = ยังไม่มีพิกัด** → เว็บแสดงชื่อพร้อมป้าย "ยังไม่มีพิกัด" (ไม่ซ่อน ไม่เดา)
|
|
- `city_th`/`province_th` ในไฟล์อธิบาย **จุดแรก** เท่านั้น (จุดอื่นไม่ทราบ)
|
|
|
|
**การแสดงผล:** `#/stops/other_stop?route=954` → แสดง "จุดขึ้นรถประจำทางอื่นๆ · ตลาดท่าช้าง" (ชื่อย่อ = จุดแรก)
|
|
+ รายการ **ทุกจุด** ของสายนั้น (แถวที่ไม่มีพิกัดขึ้นป้ายเตือน) · แผนที่ปักหมุดเฉพาะจุดที่มีพิกัด
|
|
|
|
**ข้อสังเกตของเจ้าของข้อมูล (ยังไม่แก้ ต้องยืนยัน):**
|
|
- สาย **951** และ **954** มีค่า `latitude/longitude` **เท่ากันเป๊ะ** (14.651061064977933, 100.14903762295052)
|
|
ทั้งที่จุดแรกของ 951 คือ "ตลาดวิเศษชัยชาญ" คนละที่กับ "ตลาดท่าช้าง" ของ 954 — น่าจะคัดลอกวางผิด
|