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

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

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

راه‌اندازی BigQuery

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

پیش‌نیازها

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

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

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

داده‌های جاده‌ای شما ازطریق تبادل داده خصوصی در 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 در این جدول گنجانده شده است.
  • فراداده و وضعیت مسیرها هر ساعت به‌طور مداوم به‌روزرسانی می‌شود.
  • پس‌از ایجاد مسیر جدید در «میانای برنامه‌سازی کاربردی انتخاب جاده‌ها»، تا ۱ ساعت صبر کنید تا مسیر را در این جدول ببینید.
  • پس‌از حذف مسیر از «میانای برنامه‌سازی کاربردی انتخاب جاده‌ها»، تا ۱ ساعت صبر کنید تا مسیر انتخاب‌شده از این جدول برداشته شود.