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

ข้อมูลถนนที่สะสมหมายถึงข้อมูลที่คุณสร้างขึ้นได้เมื่อเวลาผ่านไปสำหรับเส้นทางที่คุณเลือก คุณจะเริ่มได้รับข้อมูลเมื่อสร้างเส้นทางด้วย 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 (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 เว้นว่างได้ STRING ชื่อที่แสดงของเส้นทาง
record_time เว้นว่างได้ การประทับเวลา การประทับเวลาเมื่อมีการคำนวณข้อมูลเส้นทาง
duration_in_seconds เว้นว่างได้ FLOAT ระยะเวลาของเส้นทางที่พิจารณาสภาพการจราจร
static_duration_in_seconds เว้นว่างได้ FLOAT ระยะเวลาของเส้นทางที่ไม่ทราบสภาพการจราจร
route_geometry เว้นว่างได้ ภูมิศาสตร์ เรขาคณิตเส้นประกอบที่รับรู้การจราจรของเส้นทาง
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 เว้นว่างได้ STRING ชื่อที่แสดงของเส้นทาง
record_time เว้นว่างได้ การประทับเวลา การประทับเวลาเมื่อมีการคำนวณข้อมูลเส้นทาง
duration_in_seconds เว้นว่างได้ FLOAT ระยะเวลาของเส้นทางที่พิจารณาสภาพการจราจร
static_duration_in_seconds เว้นว่างได้ FLOAT ระยะเวลาของเส้นทางที่ไม่ทราบสภาพการจราจร
route_geometry เว้นว่างได้ ภูมิศาสตร์ เรขาคณิตเส้นประกอบที่รับรู้การจราจรของเส้นทาง
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 แทน การจัดประเภท ความเร็วสำหรับช่วงเวลานี้ ค่าที่เป็นไปได้: ปกติ ช้า รถติด ในฟิลด์เดิมนี้ การจราจรติดขัดอย่างหนัก (สีแดงเข้ม) จะรายงานเป็น TRAFFIC_JAM ด้วย และจะไม่มีการใช้ TRAFFIC_JAM_HEAVY
road_segment_ids ซ้ำ STRING ส่วนของถนนตามเส้นทาง ซึ่งแสดงเป็นรหัสสถานที่
speed_reading_offsets ซ้ำ RECORD ช่วงการอ่านความเร็วตามออฟเซ็ตซึ่งแสดงความหนาแน่นของการจราจร ตลอดเส้นทาง โดยแต่ละช่วงจะมีการกำหนดขอบเขตด้วยออฟเซ็ตระยะทาง จากจุดเริ่มต้นของเส้นทาง ดู ช่วงเวลาในการอ่านเร็ว
speed_reading_offsets.start_offset เว้นว่างได้ 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 เว้นว่างได้ STRING ชื่อที่แสดงของเส้นทาง
สถานะ* เว้นว่างได้ STRING สถานะของเส้นทาง
validation_error เว้นว่างได้ STRING ข้อผิดพลาดในการตรวจสอบของเส้นทาง
low_road_usage_start_time เว้นว่างได้ การประทับเวลา เวลาที่สังเกตเห็นครั้งแรกว่าเส้นทางมีการใช้งานถนนต่ำในระหว่างการตรวจสอบซ้ำ โดยเชื่อมโยงกับ VALIDATION_ERROR_LOW_ROAD_USAGE
route_attributes เว้นว่างได้ STRING แอตทริบิวต์ที่กำหนดเองสำหรับเส้นทางที่เลือก

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

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

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