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

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

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

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

راه‌اندازی BigQuery

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

پیش‌نیازها

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

1. میانای برنامه‌سازی کاربردی BigQuery را فعال کنید. برای دریافت دستورالعمل، به پُرسمان کردن مجموعه داده عمومی با کنسول Google Cloud مراجعه کنید.
2. «میانای برنامه‌سازی کاربردی Analytics Hub» را فعال کنید. مرکز Analytics 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	تهی	رشته	‫selected_route_id مسیر
display_name	تهی	رشته	نام نمایشی مسیر
record_time	تهی	مُهر زمان	مُهر زمان محاسبه داده‌های مسیر
duration_in_seconds	NULLABLE	شناور	مدت زمان مسیر با درنظر گرفتن ترافیک
static_duration_in_seconds	NULLABLE	شناور	مدت مسیر بدون درنظر گرفتن ترافیک
route_geometry	تهی	GEOGRAPHY	هندسه چندخطی آگاه از ترافیک مسیر
road_segment_ids	تکرارشده	رشته	بخش‌های جاده درطول مسیر، که به‌صورت «شناسه مکان» نشان داده شده است

عملکردها و حقایق جدول

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

جدول recent_roads_data

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

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

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

عملکردها و حقایق جدول

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

جدول routes_status

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

نام	حالت	نوع	شرح
selected_route_id	تهی	رشته	‫selected_route_id مسیر
display_name	تهی	رشته	نام نمایشی مسیر
وضعیت*	تهی	رشته	وضعیت مسیر
validation_error	تهی	رشته	خطای اعتبارسنجی مسیر
low_road_usage_start_time	تهی	مُهر زمان	زمانی که برای اولین‌بار درطول اعتبارسنجی مجدد، استفاده کم از جاده در مسیر مشاهده شد. با VALIDATION_ERROR_LOW_ROAD_USAGE مرتبط است.
route_attributes	تهی	رشته	مشخصه‌های سفارشی برای مسیر انتخاب‌شده

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

عملکردها و حقایق جدول

• فقط مسیرهای دارای وضعیت STATUS_RUNNING یا STATUS_INVALID در این جدول گنجانده شده است.
• فراداده و وضعیت مسیرها هر ساعت به‌طور مداوم به‌روزرسانی می‌شود.
• پس‌از ایجاد مسیر جدید در «میانای برنامه‌سازی کاربردی انتخاب جاده‌ها»، تا ۱ ساعت صبر کنید تا مسیر را در این جدول ببینید.
• پس‌از حذف مسیر از «میانای برنامه‌سازی کاربردی انتخاب جاده‌ها»، تا ۱ ساعت صبر کنید تا مسیر انتخاب‌شده از این جدول برداشته شود.