ข้อมูลถนนที่สะสม

ข้อมูลถนนที่สะสมหมายถึงข้อมูลที่คุณสามารถสร้างขึ้นเมื่อเวลาผ่านไปสำหรับเส้นทางที่เลือก คุณจะเริ่มได้รับข้อมูลเมื่อสร้างเส้นทางด้วย Roads Selection API จากนั้นคุณสามารถใช้ข้อมูลนี้เพื่อการวิเคราะห์เชิงลึก การวางแผนเชิงกลยุทธ์ และการทำความเข้าใจลักษณะการทำงานของเส้นทางในระยะยาว

ข้อมูลถนนที่สะสมจะแสดงเป็นข้อมูลอนุกรมเวลา ซึ่งรวมถึงข้อมูลต่อไปนี้

ตั้งค่า BigQuery

ก่อนที่จะเข้าถึงข้อมูลถนนใน BigQuery ได้ คุณต้องตั้งค่าโปรเจ็กต์ Google Cloud และสมัครใช้บริการการแลกเปลี่ยนข้อมูล

ข้อกำหนดเบื้องต้น

ตรวจสอบว่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์และบัญชี Google Cloud มีการกำหนดค่าต่อไปนี้

  1. เปิดใช้ BigQuery API โปรดดูวิธีการที่หัวข้อค้นหาชุดข้อมูลสาธารณะด้วยคอนโซล Google Cloud
  2. เปิดใช้ Analytics Hub API ดู Analytics Hub API
  3. ให้บทบาท IAM ที่จำเป็น ตรวจสอบว่าบัญชีของคุณมีบทบาทต่อไปนี้เพื่อทำงานของผู้สมัครใช้บริการและสร้างชุดข้อมูล
  4. Analytics Hub Subscriber (roles/analyticshub.subscriber)

สมัครใช้บริการการแลกเปลี่ยนข้อมูล

ระบบจะแชร์ข้อมูลถนนกับคุณผ่านการแลกเปลี่ยนข้อมูลส่วนตัวใน BigQuery (Analytics Hub) คุณจะได้รับลิงก์การสมัครใช้บริการที่เฉพาะเจาะจงจากพาร์ทเนอร์ของ Google เพื่อเข้าถึงข้อมูลของคุณ ชุดข้อมูลนี้เป็นไปตามรูปแบบการตั้งชื่อต่อไปนี้

historical_roads_data_PROJECT_NUMBER.

วิธีสมัครรับข้อมูล

  1. คลิกลิงก์การสมัครใช้บริการที่ Google Partner ให้มา ลิงก์นี้จะนำคุณไปยังการแลกเปลี่ยนข้อมูลในคอนโซล Google Cloud โดยตรง
  2. ตรวจสอบรายละเอียดการแลกเปลี่ยนข้อมูลในคอนโซล Google Cloud
  3. คลิกปุ่มสมัครใช้บริการในกล่องโต้ตอบ
  4. เมื่อสมัครใช้บริการเสร็จสมบูรณ์แล้ว ชุดข้อมูลที่ลิงก์จะปรากฏในแผงโปรแกรมสำรวจ BigQuery ในคอนโซล Google Cloud ตอนนี้คุณสามารถใช้ชื่อตารางที่แสดงในแผง Explorer เพื่อเข้าถึงข้อมูลในการค้นหา SQL ได้แล้ว

ตาราง BigQuery

ข้อมูลถนนที่สะสมของเส้นทางที่คุณเลือกจะโฮสต์อยู่ภายใต้ชุดข้อมูล BigQuery ที่แยกต่างหากของโปรเจ็กต์ที่อยู่ในระบบคลาวด์ซึ่ง Google เป็นเจ้าของ โดยจะแชร์กับคุณผ่านการแลกเปลี่ยนข้อมูลส่วนตัวที่สร้างขึ้นเพื่อคุณโดยเฉพาะในการแชร์ BigQuery (Analytics Hub) หากต้องการเข้าถึงข้อมูล คุณต้องสมัครใช้บริการการแลกเปลี่ยนข้อมูลและสร้างชุดข้อมูลที่ลิงก์ไว้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ Google

ชุดข้อมูล BigQuery ที่แชร์ประกอบด้วยตาราง BigQuery บางตารางที่ Google กำหนดและสร้างขึ้น รายละเอียดของแต่ละตารางมีดังนี้

ตาราง historical_travel_time

ต่อไปนี้คือสคีมาสำหรับตาราง BigQuery historical_travel_time

ชื่อ โหมด ประเภท คำอธิบาย
selected_route_id NULLABLE STRING selected_route_id ของเส้นทาง
display_name NULLABLE STRING ชื่อที่แสดงของเส้นทาง
record_time NULLABLE การประทับเวลา การประทับเวลาเมื่อมีการคำนวณข้อมูลเส้นทาง
duration_in_seconds NULLABLE FLOAT ระยะเวลาของเส้นทางที่คำนึงถึงการจราจร ละเว้น (NULL) เมื่อ has_road_closure เป็น true
static_duration_in_seconds NULLABLE FLOAT ระยะเวลาของเส้นทางโดยไม่คำนึงถึงการจราจร
route_geometry NULLABLE ภูมิศาสตร์ เรขาคณิตของเส้นประกอบที่คำนึงถึงการจราจรของเส้นทาง
road_segment_ids ซ้ำ STRING ส่วนของถนนตามเส้นทาง ซึ่งแสดงเป็นรหัสสถานที่
has_road_closure NULLABLE BOOLEAN มีการปิดถนนทั้งเส้นในเส้นทางหรือไม่ เมื่อ true ระบบจะละเว้น duration_in_seconds (NULL) เนื่องจาก เส้นทางผ่านไม่ได้ ค่า NULL บ่งชี้ว่าข้อมูลการปิดถนนยังไม่ได้รับการระบุ

ลักษณะการทำงานและข้อเท็จจริงเกี่ยวกับตาราง

  • ตารางจะแบ่งพาร์ติชันตามวันและมีการตั้งค่าวันหมดอายุ 10 ปีสำหรับแต่ละพาร์ติชัน
  • ตารางจะอัปเดตทุกชั่วโมงด้วยข้อมูลการเข้าชมล่าสุดที่เขียนเป็นกลุ่ม
  • เมื่อสร้างเส้นทางใหม่ใน Roads Selection API แล้ว โปรดรอไม่เกิน 1 ชั่วโมงจึงจะเห็นข้อมูลที่พร้อมใช้งานในตารางนี้
  • เมื่อลบเส้นทางออกจาก Roads Selection API แล้ว ระบบจะไม่เขียนข้อมูลใหม่ลงในตารางนี้สำหรับเส้นทางดังกล่าว แต่ข้อมูลย้อนหลังจะยังคงอยู่จนกว่าจะหมดอายุ
  • ส่วนของถนนตามเส้นทางจะเป็นไปตามลำดับเชิงทอพอโลยีและเชื่อมต่อกันเสมอ
  • แฟล็ก has_road_closure สอดคล้องกับสถานะการปิดถนนทั้งหมดใน Google Maps

ตาราง recent_roads_data

หมายเหตุ: ตารางนี้จะใช้ได้ก็ต่อเมื่อสัญญาของคุณมีข้อมูลถนนแบบเรียลไทม์เท่านั้น

ตารางนี้แตกต่างจาก historical_travel_time ตรงที่ยังมีช่วงการอ่านความเร็วตามออฟเซ็ต (speed_reading_offsets) และช่วงการอ่านความเร็วตามพิกัดเดิม (speed_reading_intervals) ด้วย สคีมาใน BigQuery มีดังนี้

ชื่อ โหมด ประเภท คำอธิบาย
selected_route_id NULLABLE STRING selected_route_id ของเส้นทาง
display_name NULLABLE STRING ชื่อที่แสดงของเส้นทาง
record_time NULLABLE การประทับเวลา การประทับเวลาเมื่อมีการคำนวณข้อมูลเส้นทาง
duration_in_seconds NULLABLE FLOAT ระยะเวลาของเส้นทางที่คำนึงถึงการจราจร ละเว้น (NULL) เมื่อ has_road_closure เป็น true
static_duration_in_seconds NULLABLE FLOAT ระยะเวลาของเส้นทางโดยไม่คำนึงถึงการจราจร
route_geometry NULLABLE ภูมิศาสตร์ เรขาคณิตของเส้นประกอบที่คำนึงถึงการจราจรของเส้นทาง
speed_reading_intervals ซ้ำ RECORD ช่วงการฝึกวิ่งเร็วตามพิกัดเดิม อาจหยุดสร้างข้อมูลในวันที่ 9 พฤศจิกายน 2026 หรือหลังจากนั้น โปรดใช้ speed_reading_offsets แทน ดูช่วงเวลาการอ่านความเร็ว
speed_reading_intervals.interval_coordinates ซ้ำ ภูมิศาสตร์ เดิม อาจหยุดสร้างข้อมูลในวันที่ 9 พฤศจิกายน 2026 หรือหลังจากนั้น โปรดใช้ speed_reading_offsets แทน เรขาคณิตสำหรับช่วงเวลานี้
speed_reading_intervals.speed NULLABLE STRING เดิม อาจหยุดสร้างข้อมูลในวันที่ 9 พฤศจิกายน 2026 หรือหลังจากนั้น โปรดใช้ speed_reading_offsets แทน การจัดประเภทความเร็วสำหรับช่วงเวลานี้ ค่าที่เป็นไปได้: NORMAL, SLOW, TRAFFIC_JAM ในช่องเดิมนี้ การจราจรติดขัดอย่างหนัก (สีแดงเข้ม) จะรายงานเป็น TRAFFIC_JAM ด้วย โดยจะไม่มีการใช้ TRAFFIC_JAM_HEAVY
road_segment_ids ซ้ำ STRING ส่วนของถนนตามเส้นทาง ซึ่งแสดงเป็นรหัสสถานที่
speed_reading_offsets ซ้ำ RECORD ช่วงการอ่านความเร็วตามออฟเซ็ตที่แสดงความหนาแน่นของการจราจรตลอดเส้นทาง โดยแต่ละช่วงจะคั่นด้วยออฟเซ็ตระยะทางจากจุดเริ่มต้นของเส้นทาง ละเว้นเมื่อ has_road_closure เป็น true ดูช่วงเวลาการอ่านความเร็ว
speed_reading_offsets.start_offset NULLABLE INTEGER ระยะทางที่ออฟเซ็ตจากจุดเริ่มต้นของเส้นทางเป็นเมตรสำหรับจุดเริ่มต้นของช่วงเวลา (รวมจุดเริ่มต้น)
speed_reading_offsets.end_offset NULLABLE INTEGER ระยะทางที่ออฟเซ็ตจากจุดเริ่มต้นของเส้นทางเป็นเมตรสำหรับจุดสิ้นสุดของช่วงเวลา (ไม่รวมจุดสิ้นสุด เท่ากับ start_offset ของช่วงเวลาถัดไป)
speed_reading_offsets.speed NULLABLE STRING การจัดประเภทความเร็วสำหรับช่วงเวลานี้ ซึ่งสอดคล้องกับสีในเลเยอร์การจราจรของ Google Maps ค่าที่เป็นไปได้: NORMAL (สีเขียว), SLOW (สีเหลือง), TRAFFIC_JAM (สีแดง), TRAFFIC_JAM_HEAVY (สีแดงเข้ม พร้อมใช้งานตั้งแต่วันที่ 8 ตุลาคม 2026)
has_road_closure NULLABLE BOOLEAN มีการปิดถนนทั้งเส้นในเส้นทางหรือไม่ เมื่อละเว้น true, duration_in_seconds และ speed_reading_offsets เนื่องจากเส้นทางผ่านไม่ได้ ค่า NULL บ่งชี้ว่าข้อมูลการปิดถนนยังไม่ได้รับการระบุ

ลักษณะการทำงานและข้อเท็จจริงเกี่ยวกับตาราง

  • ตารางจะแบ่งพาร์ติชันตามวันและมีการตั้งค่าวันหมดอายุ 60 วันสำหรับแต่ละพาร์ติชัน
  • ตารางจะอัปเดตทุกชั่วโมงด้วยข้อมูลการเข้าชมล่าสุดที่เขียนเป็นกลุ่ม
  • เมื่อสร้างเส้นทางใหม่ใน Roads Selection API แล้ว โปรดรอไม่เกิน 1 ชั่วโมงจึงจะเห็นข้อมูลที่พร้อมใช้งานในตารางนี้
  • เมื่อลบเส้นทางออกจาก Roads Selection API แล้ว ระบบจะไม่เขียนข้อมูลใหม่ลงในตารางนี้สำหรับเส้นทางดังกล่าว แต่ข้อมูลย้อนหลังจะยังคงอยู่จนกว่าจะหมดอายุ
  • ส่วนของถนนตามเส้นทางจะเป็นไปตามลำดับเชิงทอพอโลยีและเชื่อมต่อกันเสมอ
  • คอลัมน์ speed_reading_offsets จะมีข้อมูลสำหรับแถวที่บันทึกในวันที่ 8 ตุลาคม 2026 หรือหลังจากนั้น แถวก่อนหน้ามีอาร์เรย์ว่างเปล่า
  • คอลัมน์ speed_reading_intervals เดิมอาจหยุดป้อนข้อมูลในวันที่ 9 พฤศจิกายน 2026 หรือหลังจากนั้น โปรดใช้ speed_reading_offsets แทน
  • แฟล็ก has_road_closure สอดคล้องกับสถานะการปิดถนนทั้งหมดใน Google Maps

ตาราง routes_status

ตารางประกอบด้วยข้อมูลเมตาและข้อมูลสถานะของเส้นทางที่เลือก โดยมีจุดประสงค์เพื่อช่วยให้ดูเส้นทางและสถานะทั้งหมดได้ง่ายขึ้น โดยสามารถรวมเข้ากับตารางอีก 2 ตารางเพื่อกรองข้อมูลได้ สคีมาใน BigQuery มีดังนี้

ชื่อ โหมด ประเภท คำอธิบาย
selected_route_id NULLABLE STRING selected_route_id ของเส้นทาง
display_name NULLABLE STRING ชื่อที่แสดงของเส้นทาง
status* NULLABLE STRING สถานะของเส้นทาง
validation_error NULLABLE STRING ข้อผิดพลาดในการตรวจสอบเส้นทาง
low_road_usage_start_time NULLABLE การประทับเวลา เวลาที่สังเกตเห็นเป็นครั้งแรกว่าเส้นทางมีการใช้งานถนนต่ำในระหว่างการตรวจสอบอีกครั้ง ซึ่งเชื่อมโยงกับ VALIDATION_ERROR_LOW_ROAD_USAGE
route_attributes NULLABLE STRING แอตทริบิวต์ที่กำหนดเองสำหรับเส้นทางที่เลือก
dynamic_routing NULLABLE BOOLEAN ระบุว่าเส้นทางเป็นแบบไดนามิก (true) หรือแบบคงที่ (false) ดูหัวข้อdynamicRouting
origin NULLABLE ภูมิศาสตร์ จุดอ้างอิงต้นทางของเส้นทาง
ปลายทาง NULLABLE ภูมิศาสตร์ จุดอ้างอิงปลายทางของเส้นทาง
ระดับกลาง ซ้ำ ภูมิศาสตร์ จุดอ้างอิงระดับกลางของเส้นทาง
static_route_geometry NULLABLE ภูมิศาสตร์ เรขาคณิตของเส้นประกอบของเส้นทางคงที่ที่คำนวณโดยไม่มีการจราจรแบบเรียลไทม์จากจุดอ้างอิง
road_segment_ids ซ้ำ STRING ส่วนของถนนตามเส้นทางคงที่ที่คำนวณโดยไม่มีการจราจรแบบเรียลไทม์ ซึ่งแสดงเป็นรหัสสถานที่

ลักษณะการทำงานและข้อเท็จจริงเกี่ยวกับตาราง

  • ตารางนี้จะรวมเฉพาะเส้นทางในสถานะ STATUS_RUNNING หรือ STATUS_INVALID เท่านั้น
  • ข้อมูลเมตาและสถานะของเส้นทางจะอัปเดตทุกชั่วโมงอย่างต่อเนื่อง
  • เมื่อสร้างเส้นทางใหม่ใน Roads Selection API แล้ว โปรดรอไม่เกิน 1 ชั่วโมงจึงจะเห็นเส้นทางที่พร้อมใช้งานในตารางนี้
  • เมื่อลบเส้นทางออกจาก Roads Selection API แล้ว โปรดรอไม่เกิน 1 ชั่วโมงเพื่อให้ระบบนำเส้นทางที่เลือกออกจากตารางนี้
  • สำหรับเส้นทางคงที่ (dynamic_routing: false) รหัสสถานที่ใน road_segment_ids จะอัปเดตโดยอัตโนมัติเพื่อแสดงการเปลี่ยนแปลงในเครือข่ายถนนของ Google ขณะที่ยังคงแสดงเส้นทางเดิม สำหรับเส้นทางแบบไดนามิก (dynamic_routing: true) ระบบจะไม่อัปเดต road_segment_ids