การเข้าถึงได้
คุณสมบัติที่ทำให้สถานที่หรือบริการใช้ได้ตามความต้องการ ข้อมูลไม่รู้ไม่เท่ากับเข้าถึงได้หรือไม่เข้าถึงได้
ตัวอย่าง
ข้อมูลการใช้รถเข็นอาจมีหรือไม่ก็ได้
พจนานุกรม ROOTE
พจนานุกรมคำศัพท์ด้านการเคลื่อนที่และข้อมูล
คำนิยามง่ายเพื่อเข้าใจการขนส่ง, บริการใกล้ตัว และเครื่องมือที่เชื่อมโยงกับแอปของคุณ
79 คำนิยามที่แสดง
ก
การคืนยานพาหนะ
การสิ้นสุดการใช้ตามกฎบริการ ทางคืนอาจต่างกับทางยืม
ตัวอย่าง
สถานีอนุญาตให้เริ่มใช้แต่ไม่มีที่คืนแล้ว
การเคลื่อนที่แบบแชร์
บริการที่ให้คนหลายคนใช้ยานพาหนะต่อเนื่องกัน แทนการมีเจ้าของรายเดียว
ตัวอย่าง
จักรยานและสกู๊ตเตอร์ให้เช่าในเมืองหนึ่งแห่ง
การเดินทางแบบสหรูปแบบ
ใช้หลายโหมดเดินทางต่อเนื่องในทริปเดียว แต่ละช่วงรักษาตารางและเงื่อนไขของตน
ตัวอย่าง
ปั่นจักรยานไปขึ้นรถราง แล้วเดินต่อ
การแทรกคำสั่ง
พยายามใช้เนื้อหาภายนอกเปลี่ยนคำสั่งผู้ช่วย คำบรรยายซัพพลายเออร์ต้องเป็นข้อมูล ไม่ใช่คำสั่ง
ตัวอย่าง
คำสั่งที่ซ่อนในชื่อสถานที่ไม่ควรถูกใช้
การแปลงรหัสที่ตั้ง
การค้นหาที่แปลงที่อยู่หรือคำบอกตำแหน่งเป็นเป้าหมายพร้อมพิกัด หลายสถานที่อาจตรงกับคำเดียวกัน
ตัวอย่าง
สองเมืองมีถนนชื่อเดียวกัน
การแปลงรหัสที่ตั้งย้อนกลับ
ค้นหาสถานที่หรือชื่อจากพิกัด ผลลัพธ์อาจหมายถึงสถานที่ใกล้เคียง ไม่ใช่ที่อยู่ที่แน่นอน
ตัวอย่าง
จุด GPS แปลงเป็นชื่อที่อ่านได้
การยืมยานพาหนะ
การเริ่มใช้ยานพาหนะ แม้จำนวนบวก แต่บริการอาจปิดไม่ให้ยืมได้
ตัวอย่าง
มีจักรยานแต่สถานีอาจไม่อนุญาตให้เช่า
การสังเกต
สถานะหรือเหตุการณ์ที่บันทึก ณ เวลาหนึ่ง ต้องแยกจากเหตุการณ์ที่วางแผนหรือประมาณไว้
ตัวอย่าง
รถเมล์ผ่านจริงอาจต่างจากเวลาที่แจ้ง
การให้เครดิต
การระบุผู้ให้ข้อมูลหรือแหล่งที่มาของข้อมูล เมื่อขอให้ใช้ต้องแสดงบนอินเทอร์เฟซ
ตัวอย่าง
การให้เครดิตที่ต้องใช้ต้องเก็บไว้ในอินเทอร์เฟซ
ข
ข้อมูลเรียลไทม์
ข้อมูลที่อัปเดตแสดงสถานการณ์ล่าสุดหรือใช้ในการประมาณ ความสดใหม่ต้องประเมิน; เรียลไทม์ไม่หมายถึงทันทีหรือรับประกัน
ตัวอย่าง
การประมาณเวลาขึ้นรถคำนวณใหม่จากข้อมูลล่าสุด
ข้อมูลหมดอายุ — stale
ข้อมูลที่ถือว่าเกินเวลาที่กำหนดตามสัญญาหรือมาตรการ อาจเก็บเป็นประวัติล่าสุดโดยไม่แสดงว่าเป็นของใหม่
ตัวอย่าง
ส่วนต่อประสานแสดงว่าต้องอัปเดตความพร้อมใช้งาน
ค
ความครอบคลุม
ขอบเขตและความสมบูรณ์ของข้อมูลสำหรับการค้นหาหรือแหล่งข้อมูล การครอบคลุมไม่เต็มจะจำกัดผลสรุปได้
ตัวอย่าง
รายการอาจช่วยได้แต่ไม่ครอบคลุมบริการทั้งหมด
ความผิดปกติ
เหตุการณ์กระทบบริการขนส่ง เช่น หยุดชั่วคราวหรือเปลี่ยนเส้นทาง ผลกระทบขึ้นกับช่วงเวลาและสถานที่ที่ระบุ
ตัวอย่าง
เตือนเฉพาะสายหนึ่งในช่วงเวลาเฉพาะ
ความพร้อมใช้งาน
สถานะหรือจำนวนที่บ่งบอกสิ่งที่ใช้ได้ทันตามข้อมูลปัจจุบัน การสังเกตอาจเปลี่ยนแปลงได้และไม่เท่ากับการสำรอง
ตัวอย่าง
จักรยาน 3 คันที่สังเกตได้ในสถานี ไม่ใช่การจอง 3 คัน
ความเพ้อฝันของผู้ช่วย AI
สร้างข้อมูลที่ไม่มีหลักฐาน แสดงเหมือนรู้จริง ในการเคลื่อนที่อาจเป็นเวลาหรือความพร้อมเทียม
ตัวอย่าง
ผู้ช่วยบอกเวลารถ ทั้งที่ได้รับแค่ข้อมูลป้าย
ความสดใหม่ของข้อมูล
การประเมินความทันสมัยของข้อมูลตามวันที่และกฎสัญญา เวลาเรียกดูไม่ชี้ชัดความสดของต้นทาง
ตัวอย่าง
ค่าที่ได้ขณะนี้อาจมาจากสังเกตการณ์เก่า
ค่าที่ไม่ทราบ — null
ไม่มีค่าที่รู้ในสัญญา ใช้ null เพื่อระบุ ห้ามแทนที่ด้วยศูนย์ ปลอม หรือหลักฐานไม่พบ
ตัวอย่าง
นับจำนวนจักรยาน null ไม่แปลว่าสถานีว่าง
เ
เครื่องมือ MCP
ความสามารถที่อธิบายด้วยชื่อ, ฟังก์ชัน และแผนผังอาร์กิวเมนต์ ผู้ช่วยต้องใช้ข้อมูลที่แผนผังกรองรับ
ตัวอย่าง
geocode รับที่อยู่ transit_nearby รับพิกัด
เซิร์ฟเวอร์ MCP
โปรแกรมที่ให้บริการตามโปรโตคอล MCP เครื่องมือที่ประกาศคือสิ่งที่ลูกค้าเรียกได้
ตัวอย่าง
tools/list ดูรายการเครื่องมือที่มี
เที่ยวรถ
การให้บริการขนส่งหนึ่งเที่ยวในเส้นทางและเวลาที่กำหนด ใน GTFS เที่ยวรถสัมพันธ์กับสายและบริการปฏิทิน
ตัวอย่าง
รถสองเที่ยวที่ออกติดต่อกันในสายเดียวกัน
เปลี่ยนสาย
เปลี่ยนไปบริการหรือลักษณะเดินทางอื่นระหว่างทริป ใกล้สองป้ายไม่แปลว่าเดินเปลี่ยนได้สะดวก
ตัวอย่าง
ต้องเผื่อเวลาเดินระหว่างชานชาลาและรอรถ
เวลาตารางกำหนด
เวลาที่กำหนดในแผนบริการสำหรับวันที่และเที่ยวรถนั้น ไม่บ่งชี้สถานะปัจจุบัน
ตัวอย่าง
รถออก 8:10 ตามตารางเวลาบนปฏิทิน
เวลาทำการ
ช่วงเวลาที่สถานที่แจ้งว่าจะเปิด ไม่ใช่การยืนยันเปิดจริงแบบเรียลไทม์
ตัวอย่าง
ปิดชั่วคราวอาจไม่แสดงในเวลาทำการปกติ
เวลาประเมิน
คาดการณ์เวลาขึ้นรถที่คำนวณจากข้อมูลปัจจุบัน ปรับตามข้อมูลใหม่ได้
ตัวอย่าง
ขึ้นรถ 8:10 ถูกอัปเดตเป็น 8:14
แ
แคช
เก็บผลลัพธ์ชั่วคราวเพื่อหลีกเลี่ยงค้นซ้ำ ค่าในแคชยังคงแสดงต้นทางและบริบทเวลา
ตัวอย่าง
ขอสองครั้งเดียวกันอาจใช้ตอบกลับเดิมถ้ายังใช้ได้
แท่นจอด
อุปกรณ์ในสถานีที่ใช้ล็อกจักรยาน การมีแท่นไม่รับประกันว่าจอดคืนได้ทันที
ตัวอย่าง
ต้องมีที่จอดว่างและใช้งานได้
แท่นชาร์จ
อุปกรณ์สำหรับชาร์จยานพาหนะที่รองรับ การหาตำแหน่งไม่รับประกันว่าว่างหรือเข้ากันได้
ตัวอย่าง
ข้อมูลตำแหน่งและสถานะการใช้แตกต่างกัน
แอปโฮสต์ MCP
แอปที่เป็นจุดติดต่อผู้ใช้และจัดการไคลเอนต์ MCP เป็นผู้รับผิดชอบใช้ผลลัพธ์ในประสบการณ์
ตัวอย่าง
แอปแชตของคุณเชื่อมกับเซิร์ฟเวอร์ ROOTE
ไ
ไคลเอนต์ MCP
ส่วนของแอป AI รับส่งข้อมูลกับเซิร์ฟเวอร์ MCP จัดการโปรโตคอลนี้
ตัวอย่าง
ไคลเอนต์ส่งคำค้นหาไปยัง ROOTE
ไร้สถานี — free-floating
รูปแบบที่ยานพาหนะไม่จำเป็นต้องยืมหรือคืนติดแท่นจอด กฎและเขตที่จอดตามบริการ
ตัวอย่าง
สกู๊ตเตอร์ต้องคืนในพื้นที่ที่อนุญาต
จ
จักรยานไฟฟ้า
จักรยานที่มีมอเตอร์ช่วยปั่น รายงานแยกประเภทมอเตอร์และแบตเตอรี่ในข้อมูลการเคลื่อนที่
ตัวอย่าง
สถานีอาจแยกจักรยานธรรมดาและจักรยานไฟฟ้า
จักรยานสาธารณะ
บริการให้ยืมจักรยานชั่วคราวตามเงื่อนไขของผู้ให้บริการ อาจมีสถานีหรือจักรยานไร้สถานี
ตัวอย่าง
คุณพบจักรยานแล้วใช้บริการให้เช่านั้น
จำกัดความถี่ — rate limit
จำกัดจำนวนคำขอที่บริการยอมรับ กฎและการรอขึ้นกับสัญญา
ตัวอย่าง
รหัส 429 ขอให้เคารพเวลารอ
จุดเริ่มต้นค้นหา
ตำแหน่งตั้งต้นใช้คำนวณระยะทางและขอบเขตการค้นหา อาจไม่ตรงกับศูนย์กลางที่แสดงบนแผนที่
ตัวอย่าง
กล้องเคลื่อนไหว แต่การค้นหายังคงใช้จุดกึ่งกลางบอร์โดซ์
จุดสนใจ — POI
สถานที่ที่เป็นประโยชน์สำหรับการค้นหา เช่น ธุรกิจหรืออุปกรณ์ POI แตกต่างจากที่อยู่ไปรษณีย์ทั่วไป
ตัวอย่าง
ชื่อโรงแรมอาจค้นหาเป็นสถานประกอบการ
จุดสิ้นสุด — เส้นทาง API
ที่อยู่และการทำงานผ่าน API สำหรับความสามารถเฉพาะ เส้นทางต่างกันอาจส่งชุดผลลัพธ์ต่างกัน
ตัวอย่าง
/v1/transit/nearby ค้นหาสถานที่เดินทาง
ช
ชานชาลา
พื้นที่หรือตำแหน่งสำหรับขึ้นรถ ข้างกันอาจมีหลายชานชาลารองรับเส้นทางทิศทางต่างกัน
ตัวอย่าง
ชานชาลาต่างกันสำหรับทิศทางของเส้นทางเดียวกัน
ซ
ซูมแผนที่
ระดับการขยายภาพในแผนที่ ควบคุมความเห็น ไม่แทนรัศมีคำขอ API
ตัวอย่าง
zoom=15 ซูมเข้าแผนที่
ต
ตอบโดยยึดข้อมูล — grounding
สร้างคำตอบจากข้อมูลที่ได้จริง ช่องว่างและข้อจำกัดต้องชัดเจน
ตัวอย่าง
ผู้ช่วยใช้ข้อมูลสถานที่โดยไม่แต่งเติมเวลาเปิด
ตำแหน่งทางภูมิศาสตร์
การได้ตำแหน่งทางภูมิศาสตร์โดยอุปกรณ์หรือแอป ขึ้นกับสิทธิ์และความแม่นยำที่มี
ตัวอย่าง
ปุ่มหาตำแหน่งขอความยินยอมจากเบราว์เซอร์
ท
โ
โทเค็น Bearer
ตัวระบุสิทธิ์ในหัวข้อ Authorization ตามกลไก ต้องเก็บอย่างปลอดภัย
ตัวอย่าง
Authorization: Bearer ใช้โดยไม่เผยโทเค็นใน URL
น
น้ำดื่มได้
น้ำที่ระบุว่าปลอดภัยสำหรับดื่ม ต้องมีข้อมูลชัดเจนก่อนบอกว่าเป็นน้ำดื่มได้
ตัวอย่าง
ต้องแยกประเภทอุปกรณ์กับคุณสมบัติของมัน
บ
บริการในเมือง
อุปกรณ์หรือบริการใกล้สถานที่ เช่น ห้องน้ำ น้ำดื่ม หรือแท่นชาร์จ ข้อมูลอาจไม่ครบถ้วน
ตัวอย่าง
ผลลัพธ์ตอบบริการและข้อมูลที่ทราบ
ป
ปฏิทินบริการ
ข้อมูลวันที่ให้บริการและข้อยกเว้น ตารางเวลาต้องตีความร่วมกับปฏิทินนี้
ตัวอย่าง
เที่ยวบริการวันจันทร์-ศุกร์อาจไม่มีในวันอาทิตย์
ประเภทบริการ
หมวดหมู่ที่ใช้เลือกหรืออธิบายบริการในเมือง ค่าใช้ได้ขึ้นกับ API และสกีมาของมัน
ตัวอย่าง
API บริการ ROOTE ใช้ types=toilets สำหรับห้องน้ำ
ปลายทางสุดท้าย
จุดสุดท้ายของเส้นทาง สายอาจมีรูปแบบที่ปลายทางแตกต่างกัน
ตัวอย่าง
บริการระยะสั้นหยุดก่อนปลายทางปกติ
ป้ายรถโดยสาร
ที่รถรับส่งผู้โดยสาร ป้ายเปิดไม่มีข้อมูลเวลารถต่อไปเสมอไป
ตัวอย่าง
ป้ายรถเมล์ที่ไม่มีเวลาขึ้นรถ
ป้ายเวลาบันทึก
ข้อมูลเวลาที่เกี่ยวข้องกับข้อมูลหรือเหตุการณ์ ความหมายขึ้นกับฟิลด์: การสังเกต, การอัปเดต, การรับ หรือหมดอายุ
ตัวอย่าง
source_updated_at และ received_at บอกช่วงเวลาต่างกัน
ผ
ผลลัพธ์บางส่วน — partial
ข้อมูลใช้ได้แต่มีข้อจำกัดหรือข้อมูลหาย แสดงคำเตือนที่เกี่ยวข้อง
ตัวอย่าง
แหล่งข้อมูลหนึ่งตอบ แต่แหล่งอื่นล้มเหลว
ผลลัพธ์ว่าง — empty
ค้นหาไม่เจอข้อมูลในขอบเขต ไม่แปลว่าไม่มีบริการจริงนอกข้อมูล
ตัวอย่าง
ไม่เจอป้ายตามตัวกรอง
ผู้ที่เคลื่อนที่ลำบาก — PMR
ผู้มีความยากลำบากในการเคลื่อนที่ถาวรหรือชั่วคราว คำ PMR ไม่ระบุอุปกรณ์หรือการเข้าถึงทั้งหมด
ตัวอย่าง
แค่มีทางลาดไม่แปลว่าปราศจากอุปสรรคทุกชนิด
ฝ
ฝัง — แผนที่ฝัง
แทรกประสบการณ์จากภายนอกในหน้า เช่น แผนที่ผ่าน iframe พารามิเตอร์และสิทธิ์กำหนดบริบทการใช้
ตัวอย่าง
iframe ROOTE แสดงจักรยานรอบบอร์โดซ์
พ
พารามิเตอร์ชุดคำขอ
ค่าส่งใน URL หลังเครื่องหมายคำถาม ชื่อและรูปแบบขึ้นกับคะแนนที่ใช้
ตัวอย่าง
modes=bus,tram เลือกโหมดใน URL ที่เข้ากันได้
พิกัด GPS
ค่าระบุตำแหน่งบนภูมิศาสตร์ โดยทั่วไปใช้ละติจูดและลองจิจูด ต้องระบุลำดับในอินเทอร์เฟซ
ตัวอย่าง
การค้นหาใกล้จะมีพิกัดสองค่าแยกกัน
ร
รถออกถัดไป
เที่ยวรถหรือขาออกถัดไปที่แสดงสำหรับสถานที่และบริการ การหาแค่ป้ายไม่ใช่การค้นหาเที่ยวรถถัดไป
ตัวอย่าง
ผลลัพธ์ป้ายและผลลัพธ์เที่ยวรถถัดไปเป็นคนละรายการ
ระยะทางทางภูมิศาสตร์
ระยะทางคำนวณระหว่างตำแหน่งตามวิธีของบริการ ไม่ใช่เส้นทางหรือเวลาการเดินโดยอัตโนมัติ
ตัวอย่าง
สถานที่ใกล้อาจต้องเลี่ยงเพื่อเข้าถึง
รัศมีการค้นหา
ระยะทางรอบจุดตั้งต้นที่ใช้กำหนดขอบเขตการค้นหา หน่วยและขอบเขตขึ้นกับสัญญาเส้นทางหรือเครื่องมือ
ตัวอย่าง
radius=600 หมายถึงรัศมี 600 เมตรในตัวอย่าง REST
ล
ลองจิจูด
ค่าพิกัดบอกตำแหน่งตะวันออกหรือตะวันตก จากเมริเดียนหลัก ค่าในตัวอย่าง ROOTE อยู่ในช่วง −180 ถึง 180
ตัวอย่าง
ลองจิจูดอาจส่งใน lon หรือชื่อย่อ lng
ละติจูด
ค่าพิกัดบอกตำแหน่งเหนือหรือต่ำกว่าเส้นศูนย์สูตร ในหน่วยองศา ค่าถูกต้องตั้งแต่ −90 ถึง 90
ตัวอย่าง
ละติจูดของจุดค้นหาส่งใน lat
ส
สถานะ HTTP
รหัสผลลัพธ์ในระดับ HTTP ต้องตรวจสอบเนื้อหาและสถานะทางธุรกิจเพิ่มเติม
ตัวอย่าง
HTTP 200 อาจรวมสถานะธุรกิจ error
สถานีจักรยาน
สถานที่จัดระบบสำหรับยืมหรือคืนจักรยานแชร์ พิกัด ความจุ และความพร้อมบอกข้อมูลต่างๆ ของสถานี
ตัวอย่าง
สถานีหนึ่งอาจแสดงบนแผนที่แต่ไม่มีจักรยาน
สายรถ
บริการขนส่งที่ระบุในเครือข่าย มีเส้นทางหรือรูปแบบหลายแบบ ชื่อสายไม่พอให้รู้ทิศทางที่ถูกต้อง
ตัวอย่าง
สายเดียวกันมีปลายทางหลายแห่ง
ห
หมดเวลา — timeout
หยุดรอเกินเวลาที่กำหนด แปลว่าค้นหาไม่สำเร็จ ไม่ใช่ไม่มีผลลัพธ์
ตัวอย่าง
แอปแนะนำให้ลองใหม่แทนแสดงว่าง
ห้องน้ำสาธารณะ
ห้องน้ำสำหรับใช้สาธารณะตามเงื่อนไขท้องที่ การมีในข้อมูลไม่รับประกันฟรี เปิด หรือเข้าถึงได้จริง
ตัวอย่าง
ตรวจสอบเงื่อนไขก่อนเดินทาง
อ
อ่านอย่างเดียว
ดูข้อมูลโดยไม่สามารถเปลี่ยนแปลงได้ เช่น ดูความพร้อมไม่ได้จองหรือปลดล็อครถ
ตัวอย่าง
เครื่องมือข้อมูล ROOTE ใช้เรียกดูข้อมูลเท่านั้น
อายุข้อมูล — TTL
ช่วงเวลาที่ใช้จัดการความถูกต้องหรือต่ออายุข้อมูลในแคช ตามสัญญา ไม่บอกเวลาการสังเกตต้นทางแน่นอน
ตัวอย่าง
แคชที่หมดอายุต้องปฏิบัติตามนโยบายรีเฟรช
A
G
GBFS
รูปแบบมาตรฐานข้อมูลสาธารณะสำหรับการเคลื่อนที่แบบแชร์ แสดงระบบ, สถานี, ยานพาหนะ และสถานะตามเวอร์ชันและฟลักซ์
ตัวอย่าง
ข้อมูลสถานีและนับความพร้อมแยกจากกัน
GTFS Realtime — GTFS-RT
รูปแบบมาตรฐานส่งข้อมูลอัปเดตเที่ยวรถ, ตำแหน่งรถ และแจ้งเตือน ประเภทข้อมูลขึ้นกับผู้ผลิต
ตัวอย่าง
ฟลักซ์ตำแหน่งไม่แปลว่ามีเวลาประเมินทุกป้าย
GTFS Schedule
รูปแบบมาตรฐานบรรยายบริการขนส่งวางแผน: ป้าย, สาย, เที่ยวรถ, ปฏิทิน และเวลาผ่าน ไม่รวมข้อมูลอัปเดตเรียลไทม์อัตโนมัติ
ตัวอย่าง
เวลาผ่านเชื่อมกับเที่ยวรถและวันให้บริการ
H
HTTP สตรีมมิง
วิธีส่งข้อมูล MCP ผ่าน HTTP ต้องตรวจสอบว่าไคลเอนต์รองรับ
ตัวอย่าง
เซิร์ฟเวอร์ ROOTE ใช้ https://mcp.roote.ai/mcp
I
iframe
แท็ก HTML โหลดเอกสารในหน้า ถ้า domain ต่างกัน หน้าหลักอ่านสถานะภายในไม่ได้
ตัวอย่าง
การเปลี่ยนค้นหาต้องสื่อสารกับหน้ารองรับ
J
JSON
รูปแบบข้อความโครงสร้าง ที่ใช้วัตถุ, อาเรย์, สตริง และจำนวน JSON ถูกต้องทางไวยากรณ์อาจไม่ตรงสกีม API
ตัวอย่าง
ชุดสถานีต้องมีชนิดและฟิลด์ตามที่คาด
M
MCP — โปรโตคอลบริบทโมเดล
โปรโตคอลสื่อสารแอป AI กับเซิร์ฟเวอร์เครื่องมือหรือบริบท ไม่กำหนดคุณภาพข้อมูลที่ได้เอง
ตัวอย่าง
ผู้ช่วยค้นหาเครื่องมือ ROOTE
O
OpenAPI
สเปกกำหนดสัญญา API HTTP ในเอกสารโครงสร้าง ช่วยตรวจสอบเส้นทาง, พารามิเตอร์, การตอบกลับ และแผนผัง
ตัวอย่าง
สัญญา ROOTE เผยแพร่ใน openapi.json
ไม่พบคำนิยามที่ตรงกัน ลองใช้คำอื่นหรือลบตัวกรอง
แหล่งข้อมูลสำหรับศึกษาเพิ่มเติม
คำศัพท์เฉพาะของ ROOTE ปฏิบัติตามสัญญาที่ระบุไว้ เอกสารและมาตรฐานมีแหล่งข้อมูลทางการของตนเอง
กลับสู่ศูนย์ทรัพยากร