ระบบจะแสดงข้อมูลถนนที่สะสมเป็นข้อมูลอนุกรมเวลา ซึ่งรวมถึงข้อมูลต่อไปนี้
- ระยะเวลาเดินทาง
- ช่วงการอ่านความเร็ว (SRI)
- เรขาคณิตของเส้นทาง
ตั้งค่า BigQuery
คุณต้องตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google และสมัครใช้บริการ Data Exchange ก่อนจึงจะเข้าถึงข้อมูลถนนใน BigQuery ได้
ข้อกำหนดเบื้องต้น
ตรวจสอบว่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์และบัญชี Google Cloud มีการกำหนดค่าต่อไปนี้
- เปิดใช้ BigQuery API ดูวิธีการได้ที่ค้นหาชุดข้อมูลสาธารณะ ด้วยคอนโซล Google Cloud
- เปิดใช้ Analytics Hub API ดูข้อมูลเพิ่มเติมได้ที่ Analytics Hub API
- ให้สิทธิ์บทบาท IAM ที่จำเป็น ตรวจสอบว่าบัญชีของคุณมีบทบาทต่อไปนี้เพื่อทำงานของผู้สมัครใช้บริการและสร้างชุดข้อมูล
- ผู้สมัครใช้บริการ Analytics Hub
(
roles/analyticshub.subscriber)- ผู้ใช้ BigQuery
(
roles/bigquery.user)
- ผู้ใช้ BigQuery
(
สมัครใช้บริการ Data Exchange
ระบบจะแชร์ข้อมูลถนนกับคุณผ่าน Data Exchange ส่วนตัวใน BigQuery (Analytics Hub) คุณจะได้รับลิงก์การสมัครใช้บริการที่เฉพาะเจาะจงจากพาร์ทเนอร์ของ Google เพื่อเข้าถึงข้อมูล ชุดข้อมูลนี้เป็นไปตามรูปแบบการตั้งชื่อต่อไปนี้
historical_roads_data_PROJECT_NUMBER.
วิธีสมัครใช้บริการข้อมูล
- คลิกลิงก์การสมัครใช้บริการที่พาร์ทเนอร์ของ Google ให้ไว้ ลิงก์นี้จะนำคุณไปยัง Data Exchange ในคอนโซล Google Cloud โดยตรง
- ตรวจสอบรายละเอียด Data Exchange ในคอนโซล Google Cloud
- คลิกปุ่มสมัครใช้บริการ ในกล่องโต้ตอบ
- เมื่อการสมัครใช้บริการเสร็จสมบูรณ์ ชุดข้อมูลที่ลิงก์จะปรากฏในแผงExplorer ของ BigQuery ในคอนโซล Google Cloud ตอนนี้คุณสามารถใช้ชื่อตารางที่แสดงในแผง Explorer เพื่อเข้าถึงข้อมูลในการค้นหา SQL ได้แล้ว
ตาราง BigQuery
ระบบจะโฮสต์ข้อมูลถนนที่สะสมของเส้นทางที่เลือกไว้ในชุดข้อมูล BigQuery ที่แยกต่างหากของโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่เป็นของ Google และแชร์กับคุณผ่าน Data Exchange ส่วนตัวที่สร้างขึ้นสำหรับคุณโดยเฉพาะในการแชร์ BigQuery (Analytics Hub) หากต้องการเข้าถึงข้อมูล คุณต้องสมัครใช้บริการ Data Exchange และสร้างชุดข้อมูลที่ลิงก์ไว้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ Google
ชุดข้อมูล BigQuery ที่แชร์จะมีตาราง BigQuery 2-3 ตารางที่ Google กำหนดและสร้างขึ้น รายละเอียดของแต่ละตารางมีดังนี้
ตาราง historical_travel_time
ต่อไปนี้คือสคีมาสำหรับตาราง BigQuery historical_travel_time
| ชื่อ | โหมด | ประเภท | คำอธิบาย |
|---|---|---|---|
| selected_route_id | เว้นว่างได้ | STRING | selected_route_id ของเส้นทาง |
| display_name | เว้นว่างได้ | STRING | ชื่อที่แสดงของเส้นทาง |
| record_time | เว้นว่างได้ | TIMESTAMP | การประทับเวลาที่คำนวณข้อมูลเส้นทาง |
| duration_in_seconds | เว้นว่างได้ | FLOAT | ระยะเวลาของเส้นทางที่พิจารณาการจราจร |
| static_duration_in_seconds | เว้นว่างได้ | FLOAT | ระยะเวลาของเส้นทางที่ไม่พิจารณาการจราจร |
| route_geometry | เว้นว่างได้ | GEOGRAPHY | เรขาคณิตแบบเส้นประกอบของเส้นทางที่พิจารณาการจราจร |
ลักษณะการทำงานและข้อเท็จจริงของตาราง
- ตารางจะแบ่งพาร์ติชันตามวันและมีการตั้งค่าการหมดอายุ 10 ปีสำหรับแต่ละพาร์ติชัน
- ตารางจะอัปเดตทุกชั่วโมงด้วยข้อมูลการจราจรล่าสุดที่เขียนเป็นชุด
- เมื่อสร้างเส้นทางใหม่ใน Roads Selection API คุณจะต้องรอสูงสุด 1 ชั่วโมงจึงจะเห็นข้อมูลในตารางนี้
- เมื่อลบเส้นทางออกจาก Roads Selection API ระบบจะไม่เขียนข้อมูลใหม่ลงในตารางนี้สำหรับเส้นทางดังกล่าว อย่างไรก็ตาม ข้อมูลย้อนหลังจะยังคงอยู่จนกว่าจะหมดอายุ
ตาราง recent_roads_data
หมายเหตุ: ตารางนี้จะใช้ได้เฉพาะเมื่อสัญญาของคุณรวมข้อมูลถนนแบบเรียลไทม์
ตารางนี้จะเก็บข้อมูล SpeedReadingInterval ด้วย ซึ่งแตกต่างจากตาราง historical_travel_time โดยมีสคีมาใน BigQuery ดังนี้
| ชื่อ | โหมด | ประเภท | คำอธิบาย |
|---|---|---|---|
| selected_route_id | เว้นว่างได้ | STRING | selected_route_id ของเส้นทาง |
| display_name | เว้นว่างได้ | STRING | ชื่อที่แสดงของเส้นทาง |
| record_time | เว้นว่างได้ | TIMESTAMP | การประทับเวลาที่คำนวณข้อมูลเส้นทาง |
| duration_in_seconds | เว้นว่างได้ | FLOAT | ระยะเวลาของเส้นทางที่พิจารณาการจราจร |
| static_duration_in_seconds | เว้นว่างได้ | FLOAT | ระยะเวลาของเส้นทางที่ไม่พิจารณาการจราจร |
| route_geometry | เว้นว่างได้ | GEOGRAPHY | เรขาคณิตแบบเส้นประกอบของเส้นทางที่พิจารณาการจราจร |
| speed_reading_intervals | ซ้ำ | RECORD | ช่วงเวลาที่แสดงความหนาแน่นของการจราจรตลอดเส้นทาง ดูคำจำกัดความเดิมได้ใน Routes API |
| speed_reading_intervals.interval_coordinates | ซ้ำ | GEOGRAPHY | เรขาคณิตสำหรับช่วงเวลานี้ |
| speed_reading_intervals.speed | เว้นว่างได้ | STRING | การจัดประเภทความเร็วสำหรับช่วงเวลานี้ ค่าที่เป็นไปได้คือ: NORMAL, SLOW, TRAFFIC_JAM |
ลักษณะการทำงานและข้อเท็จจริงของตาราง
- ตารางจะแบ่งพาร์ติชันตามวันและมีการตั้งค่าการหมดอายุ 60 วันสำหรับแต่ละพาร์ติชัน
- ตารางจะอัปเดตทุกชั่วโมงด้วยข้อมูลการจราจรล่าสุดที่เขียนเป็นชุด
- เมื่อสร้างเส้นทางใหม่ใน Roads Selection API คุณจะต้องรอสูงสุด 1 ชั่วโมงจึงจะเห็นข้อมูลในตารางนี้
- เมื่อลบเส้นทางออกจาก Roads Selection API ระบบจะไม่เขียนข้อมูลใหม่ลงในตารางนี้สำหรับเส้นทางดังกล่าว อย่างไรก็ตาม ข้อมูลย้อนหลังจะยังคงอยู่จนกว่าจะหมดอายุ
ตาราง routes_status
ตารางนี้มีข้อมูลเมตาและข้อมูลสถานะของเส้นทางที่เลือก โดยมีวัตถุประสงค์เพื่อให้ดูเส้นทางและสถานะทั้งหมดได้ง่ายขึ้น และสามารถรวมกับตารางอื่นๆ 2 ตารางเพื่อกรองข้อมูลได้ โดยมีสคีมาใน BigQuery ดังนี้
| ชื่อ | โหมด | ประเภท | คำอธิบาย |
|---|---|---|---|
| selected_route_id | เว้นว่างได้ | STRING | selected_route_id ของเส้นทาง |
| display_name | เว้นว่างได้ | STRING | ชื่อที่แสดงของเส้นทาง |
| status* | เว้นว่างได้ | STRING | สถานะ ของเส้นทาง |
| validation_error | เว้นว่างได้ | STRING | ข้อผิดพลาดในการตรวจสอบ ของเส้นทาง |
| low_road_usage_start_time | เว้นว่างได้ | TIMESTAMP | เวลาที่สังเกตเห็นการใช้งานถนนต่ำครั้งแรกในเส้นทางระหว่างการตรวจสอบซ้ำ ซึ่งเชื่อมโยงกับ 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 ชั่วโมงจึงจะเห็นเส้นทางที่เลือกถูกนำออกจากตารางนี้