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

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

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

ตั้งค่า BigQuery

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

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

ตรวจสอบว่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์และบัญชี 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 มอบให้ ลิงก์นี้จะนำคุณไปยังการแลกเปลี่ยนข้อมูลในคอนโซล Google Cloud โดยตรง
  2. ตรวจสอบรายละเอียดการแลกเปลี่ยนข้อมูลในคอนโซล Google Cloud
  3. คลิกปุ่มติดตามในกล่องโต้ตอบ
  4. เมื่อการสมัครใช้บริการเสร็จสมบูรณ์แล้ว ชุดข้อมูลที่ลิงก์จะปรากฏในแผงExplorer ของ 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 เว้นว่างได้ STRING selected_route_id ของเส้นทาง
display_name NULLABLE STRING ชื่อที่แสดงของเส้นทาง
record_time เว้นว่างได้ การประทับเวลา การประทับเวลาเมื่อมีการคำนวณข้อมูลเส้นทาง
duration_in_seconds NULLABLE FLOAT ระยะเวลาของเส้นทางที่พิจารณาสภาพการจราจร
static_duration_in_seconds NULLABLE FLOAT ระยะเวลาของเส้นทางที่ไม่ทราบสภาพการจราจร
route_geometry NULLABLE ภูมิศาสตร์ เรขาคณิตเส้นประกอบที่รับรู้การจราจรของเส้นทาง
road_segment_ids ซ้ำ STRING ส่วนของถนนตามเส้นทาง ซึ่งแสดงเป็นรหัสสถานที่

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

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

ตาราง recent_roads_data

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

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

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

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

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

ตาราง routes_status

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

ชื่อ โหมด ประเภท คำอธิบาย
selected_route_id เว้นว่างได้ STRING selected_route_id ของเส้นทาง
display_name NULLABLE STRING ชื่อที่แสดงของเส้นทาง
status* เว้นว่างได้ STRING สถานะของเส้นทาง
validation_error เว้นว่างได้ STRING ข้อผิดพลาดในการตรวจสอบของเส้นทาง
low_road_usage_start_time NULLABLE การประทับเวลา เวลาที่สังเกตเห็นครั้งแรกว่าเส้นทางมีการใช้งานถนนต่ำในระหว่างการตรวจสอบซ้ำ โดยเชื่อมโยงกับ VALIDATION_ERROR_LOW_ROAD_USAGE
route_attributes NULLABLE STRING แอตทริบิวต์ที่กำหนดเองสำหรับเส้นทางที่เลือก

*สถานะเส้นทางในตารางนี้จะขึ้นต้นด้วย STATUS_ แทนที่จะเป็น STATE_ ไม่เช่นนั้นจะสอดคล้องกับ Roads Selection API

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

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