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

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

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

  • ระยะเวลาเดินทาง
  • ช่วงเวลาการอ่านเร็ว (SRI)
  • รูปทรงเรขาคณิตของเส้นทาง

ตั้งค่า 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 ตรงที่มีข้อมูล SpeedReadingInterval ด้วย ต่อไปนี้คือสคีมาใน 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 ช่วงเวลาที่แสดงความหนาแน่นของการจราจรตลอดเส้นทาง ดู คำจำกัดความเดิม ใน Routes API
speed_reading_intervals.interval_coordinates ซ้ำ ภูมิศาสตร์ รูปทรงเรขาคณิตสำหรับช่วงเวลานี้
speed_reading_intervals.speed เว้นว่างได้ STRING การจัดประเภทความเร็วสำหรับช่วงเวลานี้ ค่าที่เป็นไปได้ NORMAL, SLOW, TRAFFIC_JAM
road_segment_ids ซ้ำ STRING ส่วนของถนนตามเส้นทาง ซึ่งแสดงเป็นรหัสสถานที่

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

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

ตาราง 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 ชั่วโมงเพื่อให้ระบบนำเส้นทางที่เลือกออกจากตารางนี้