داده‌های جاده‌ای انباشته‌شده

داده‌های انباشته‌شده جاده به داده‌هایی اشاره دارد که می‌توانید درطول زمان برای مسیرهای انتخابی‌تان ایجاد کنید. وقتی با Roads Selection API مسیری ایجاد کنید، دریافت داده را شروع می‌کنید. سپس می‌توان از این داده‌ها برای تحلیل عمیق، برنامه‌ریزی استراتژیک، و درک رفتار بلندمدت مسیرها استفاده کرد.

داده‌های انباشته‌شده جاده به‌صورت داده‌های سری زمانی ارائه می‌شود که شامل موارد زیر است:

• مدت سفر
• فاصله‌های زمانی خواندن سریع (SRI)
• هندسه مسیر

راه‌اندازی BigQuery

قبل‌از اینکه بتوانید به داده‌های جاده‌ای خود در BigQuery دسترسی پیدا کنید، باید پروژه Google Cloud خود را راه‌اندازی کنید و در تبادل داده مشترک شوید.

پیش‌نیازها

مطمئن شوید پروژه و حساب Google Cloud شما پیکربندی‌های زیر را داشته باشد:

1. میانای برنامه‌سازی کاربردی BigQuery را فعال کنید. برای دستورالعمل‌ها، به پُرسمان کردن مجموعه داده عمومی با کنسول Google Cloud مراجعه کنید.
2. Analytics Hub API را فعال کنید. Analytics Hub API را ببینید.
3. نقش‌های IAM لازم را اعطا کنید. مطمئن شوید حسابتان نقش‌های زیر را برای انجام تکالیف مشترک و ایجاد مجموعه داده داشته باشد:
4. مشترک Analytics Hub (roles/analyticshub.subscriber)
   • کاربر BigQuery (roles/bigquery.user)

مشترک شدن در تبادل داده

داده‌های جاده شما ازطریق تبادل داده خصوصی در BigQuery (کانون Analytics) با شما هم‌رسانی می‌شود. برای دسترسی به داده‌هایتان، پیوند اشتراک خاصی از شریک Google دریافت خواهید کرد. این مجموعه داده از قرارداد نام‌گذاری زیر پیروی می‌کند:

historical_roads_data_PROJECT_NUMBER.

برای مشترک شدن در داده‌هایتان:

1. روی پیوند اشتراک ارائه‌شده توسط شریک Google کلیک کنید. این پیوند شما را مستقیماً به تبادل داده در کنسول Google Cloud می‌برد.
2. در کنسول Google Cloud، جزئیات تبادل داده را مرور کنید.
3. روی دکمه مشترک شدن در کادر گفتگو کلیک کنید.
4. وقتی اشتراک تکمیل شد، مجموعه داده پیوندشده در پانل کاوشگر BigQuery در کنسول Google Cloud نشان داده می‌شود. اکنون می‌توانید از نام‌های جدول نشان‌داده‌شده در پانل «کاوشگر» برای دسترسی به داده‌ها در پُرسمان‌های SQL استفاده کنید.

جدول‌های BigQuery

داده‌های جاده‌ای انباشته‌شده از مسیرهای انتخابی شما در یک مجموعه‌داده BigQuery مجزا از پروژه ابری متعلق به Google میزبانی می‌شود. این داده‌ها ازطریق تبادل داده خصوصی که منحصراً برای شما در هم‌رسانی BigQuery (کانون Analytics) ایجاد شده است با شما هم‌رسانی می‌شود. برای دسترسی به داده‌ها، باید در تبادل داده مشترک شوید و مجموعه داده پیوندشده‌ای در پروژه Google Cloud خود ایجاد کنید.

مجموعه‌داده BigQuery هم‌رسانی‌شده شامل چند جدول BigQuery است که توسط Google تعریف و ایجاد شده‌اند. جزئیات هر جدول در زیر آمده است.

جدول historical_travel_time

طرح جدول BigQuery historical_travel_time در زیر آمده است:

نام	حالت	نوع	شرح
selected_route_id	NULLABLE	رشته	selected_route_id از مسیر
display_name	NULLABLE	رشته	نام نمایشی مسیر
record_time	NULLABLE	مُهر زمان	مُهر زمان محاسبه داده‌های مسیر
duration_in_seconds	NULLABLE	شناور	مدت مسیر با درنظر گرفتن ترافیک. وقتی has_road_closure، true است، حذف می‌شود (NULL).
static_duration_in_seconds	NULLABLE	شناور	مدت مسیر بدون درنظر گرفتن ترافیک
route_geometry	NULLABLE	GEOGRAPHY	هندسه چندخطی آگاه از ترافیک مسیر
road_segment_ids	تکرارشده	رشته	بخش‌های جاده درطول مسیر، که به‌صورت «شناسه مکان» نشان داده شده است
has_road_closure	NULLABLE	مقدار منطقی	آیا جاده در مسیر کاملاً بسته است یا نه. وقتی true، duration_in_seconds حذف می‌شود (NULL) چون مسیر غیرقابل‌عبور است. مقدار NULL نشان می‌دهد که اطلاعات راه‌بندان نامشخص است.

رفتارها و واقعیت‌های جدول

• جدول براساس روز تقسیم‌بندی شده است و برای هر بخش انقضای ۱۰ ساله تنظیم شده است.
• این جدول هر ساعت با جدیدترین داده‌های ترافیک که به‌صورت دسته‌ای نوشته شده است به‌روز می‌شود.
• وقتی مسیر جدیدی در Roads Selection API ایجاد می‌شود، انتظار می‌رود تا ۱ ساعت طول بکشد تا داده‌ها در این جدول دردسترس قرار بگیرد.
• وقتی مسیری از Roads Selection API حذف می‌شود، هیچ داده جدیدی برای آن مسیر در این جدول نوشته نمی‌شود. بااین‌حال، داده‌های گذشته تا زمان انقضا باقی می‌مانند.
• بخش‌های جاده درطول مسیر از ترتیب توپولوژیکی پیروی می‌کنند و همیشه به‌هم متصل هستند.
• پرچم has_road_closure با وضعیت راه‌بندان کامل در Google Maps مطابقت دارد.

جدول recent_roads_data

توجه: این جدول فقط زمانی دردسترس است که قراردادتان شامل داده‌های جاده‌ای بی‌درنگ باشد.

این جدول برخلاف historical_travel_time، فاصله‌های خواندن سرعت مبتنی بر آفست (speed_reading_offsets) و فاصله‌های خواندن سرعت مبتنی بر مختصات قدیمی (speed_reading_intervals) را نیز دربرمی‌گیرد. طرح‌واره در BigQuery به‌صورت زیر است:

نام	حالت	نوع	شرح
selected_route_id	NULLABLE	رشته	selected_route_id از مسیر
display_name	NULLABLE	رشته	نام نمایشی مسیر
record_time	NULLABLE	مُهر زمان	مُهر زمان محاسبه داده‌های مسیر
duration_in_seconds	NULLABLE	شناور	مدت مسیر با درنظر گرفتن ترافیک. وقتی has_road_closure، true است، حذف می‌شود (NULL).
static_duration_in_seconds	NULLABLE	شناور	مدت مسیر بدون درنظر گرفتن ترافیک
route_geometry	NULLABLE	GEOGRAPHY	هندسه چندخطی آگاه از ترافیک مسیر
speed_reading_intervals	تکرارشده	RECORD	فواصل خواندن سرعت مبتنی بر مختصات قدیمی. ممکن است از ۹ نوامبر ۲۰۲۶ یا پس‌از آن دیگر پر نشود. درعوض از speed_reading_offsets استفاده کنید. فاصله‌های زمانی خواندن سرعت را ببینید.
speed_reading_intervals.interval_coordinates	تکرارشده	GEOGRAPHY	قدیمی. ممکن است در تاریخ ۹ نوامبر ۲۰۲۶ یا پس‌از آن دیگر پر نشود. درعوض از speed_reading_offsets استفاده کنید. هندسه برای این بازه
speed_reading_intervals.speed	NULLABLE	رشته	قدیمی. ممکن است در تاریخ ۹ نوامبر ۲۰۲۶ یا پس‌از آن دیگر پر نشود. درعوض از speed_reading_offsets استفاده کنید. طبقه‌بندی سرعت برای این بازه. مقادیر ممکن: NORMAL،‏ SLOW،‏ TRAFFIC_JAM. در این فیلد قدیمی، ترافیک سنگین (قرمز تیره) نیز به‌عنوان TRAFFIC_JAM گزارش می‌شود؛ TRAFFIC_JAM_HEAVY هرگز استفاده نمی‌شود.
road_segment_ids	تکرارشده	رشته	بخش‌های جاده درطول مسیر، که به‌صورت «شناسه مکان» نشان داده شده است
speed_reading_offsets	تکرارشده	RECORD	فاصله‌های خواندن سرعت مبتنی بر انحراف که نشان‌دهنده تراکم ترافیک در سراسر مسیر است؛ هر فاصله با انحراف فاصله از شروع مسیر مشخص می‌شود. وقتی has_road_closure true باشد، حذف می‌شود. فاصله‌های زمانی خواندن سرعت را ببینید.
speed_reading_offsets.start_offset	NULLABLE	عدد صحیح	فاصله آفست از شروع مسیر برحسب متر برای شروع فاصله زمانی (شامل)
speed_reading_offsets.end_offset	NULLABLE	عدد صحیح	آفست فاصله از شروع مسیر برحسب متر برای پایان بازه (انحصاری؛ برابر با start_offset بازه بعدی)
speed_reading_offsets.speed	NULLABLE	رشته	طبقه‌بندی سرعت برای این بازه، هم‌راستا با رنگ‌های لایه ترافیک Google Maps. مقادیر ممکن: NORMAL (سبز)، SLOW (زرد)، TRAFFIC_JAM (قرمز)، TRAFFIC_JAM_HEAVY (قرمز تیره، از ۸ اکتبر ۲۰۲۶ دردسترس است)
has_road_closure	NULLABLE	مقدار منطقی	آیا جاده در مسیر کاملاً بسته است یا نه. وقتی true، duration_in_seconds و speed_reading_offsets حذف می‌شوند چون مسیر غیرقابل‌عبور است. مقدار NULL نشان می‌دهد که اطلاعات راه‌بندان نامشخص است.

رفتارها و واقعیت‌های جدول

• جدول براساس روز تقسیم‌بندی شده است و برای هر بخش انقضای ۶۰ روزه تنظیم شده است.
• این جدول هر ساعت با جدیدترین داده‌های ترافیک که به‌صورت دسته‌ای نوشته شده است به‌روز می‌شود.
• وقتی مسیر جدیدی در Roads Selection API ایجاد می‌شود، انتظار می‌رود تا ۱ ساعت طول بکشد تا داده‌ها در این جدول دردسترس قرار بگیرد.
• وقتی مسیری از Roads Selection API حذف شود، هیچ داده جدیدی برای آن مسیر در این جدول نوشته نخواهد شد. بااین‌حال، داده‌های گذشته تا زمان انقضا باقی می‌مانند.
• بخش‌های جاده درطول مسیر از ترتیب توپولوژیکی پیروی می‌کنند و همیشه به‌هم متصل هستند.
• ستون speed_reading_offsets برای ردیف‌های ثبت‌شده در ۸ اکتبر ۲۰۲۶ یا پس‌از آن پر شده است. ردیف‌های قبلی آرایه‌های خالی دارند.
• ممکن است ستون قدیمی speed_reading_intervals از ۹ نوامبر ۲۰۲۶ یا پس‌از آن دیگر پر نشود. درعوض از speed_reading_offsets استفاده کنید.
• پرچم has_road_closure با وضعیت راه‌بندان کامل در Google Maps مطابقت دارد.

جدول routes_status

این جدول حاوی فراداده‌های مسیرهای انتخاب‌شده و اطلاعات وضعیت است. هدف آن ارائه روشی آسان‌تر برای مشاهده همه مسیرها و وضعیت است. می‌توان آن را برای فیلتر کردن داده‌ها به دو جدول دیگر پیوست کرد. این طرح‌واره در BigQuery است:

نام	حالت	نوع	شرح
selected_route_id	NULLABLE	رشته	selected_route_id از مسیر
display_name	NULLABLE	رشته	نام نمایشی مسیر
وضعیت*	NULLABLE	رشته	وضعیت مسیر
validation_error	NULLABLE	رشته	خطای اعتبارسنجی مسیر
low_road_usage_start_time	NULLABLE	مُهر زمان	زمانی که برای اولین‌بار درطول اعتبارسنجی مجدد، استفاده کم از جاده در مسیر مشاهده شد. با VALIDATION_ERROR_LOW_ROAD_USAGE مرتبط است.
route_attributes	NULLABLE	رشته	مشخصه‌های سفارشی برای مسیر انتخاب‌شده
dynamic_routing	NULLABLE	مقدار منطقی	نشان می‌دهد که مسیر پویا (true) یا ثابت (false) است. dynamicRouting را ببینید.
منشأ	NULLABLE	GEOGRAPHY	نقطه‌مسیر مبدأ مسیر
مقصد	NULLABLE	GEOGRAPHY	نقطه‌مسیر مقصد در مسیر
واسطه‌ها	تکرارشده	GEOGRAPHY	نقطه‌مسیرهای میانی مسیر
static_route_geometry	NULLABLE	GEOGRAPHY	هندسه چندخطی مسیر ثابت محاسبه‌شده بدون ترافیک زنده از نقطه‌مسیرها
road_segment_ids	تکرارشده	رشته	بخش‌های جاده درطول مسیر ایستا که بدون ترافیک زنده محاسبه شده‌اند و به‌صورت «شناسه مکان» نشان داده می‌شوند

توجه: وضعیت مسیر در این جدول با STATUS_ به‌جای STATE_ شروع می‌شود. درغیراین‌صورت، با Roads Selection API سازگار است.

رفتارها و واقعیت‌های جدول

• فقط مسیرهای دارای وضعیت STATUS_RUNNING یا STATUS_INVALID در این جدول گنجانده شده‌اند.
• فراداده و وضعیت مسیرها هر ساعت به‌طور مداوم به‌روز می‌شود.
• وقتی مسیر جدیدی در Roads Selection API ایجاد می‌شود، انتظار می‌رود تا ۱ ساعت طول بکشد تا مسیر در این جدول دردسترس قرار گیرد.
• وقتی مسیری از Roads Selection API حذف می‌شود، انتظار می‌رود تا ۱ ساعت طول بکشد تا مسیر انتخاب‌شده از این جدول برداشته شود.
• برای مسیرهای ثابت (dynamic_routing: false)، «شناسه‌های جا» در road_segment_ids به‌طور خودکار به‌روزرسانی می‌شوند تا تغییرات در شبکه جاده‌ای Google را منعکس کنند و درعین‌حال همان مسیر را نشان دهند. برای مسیرهای پویا (dynamic_routing: true)، road_segment_ids به‌روز نشده است.