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

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

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

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