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

ข้อมูลถนนที่สะสมหมายถึงข้อมูลที่คุณสร้างขึ้นได้เมื่อเวลาผ่านไปสำหรับเส้นทางที่คุณเลือก คุณจะเริ่มได้รับข้อมูลเมื่อสร้างเส้นทางด้วย 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 Cloud

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