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

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

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

BigQuery را تنظیم کنید

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

پیش نیازها

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

  1. BigQuery API را فعال کنید. برای دستورالعمل‌ها، به جستجوی مجموعه داده عمومی با کنسول Google Cloud مراجعه کنید.
  2. Analytics Hub API را فعال کنید. به Analytics Hub API مراجعه کنید.
  3. نقش های ضروری IAM را اعطا کنید. اطمینان حاصل کنید که حساب شما دارای نقش های زیر برای انجام وظایف مشترک و ایجاد مجموعه داده ها است:

در تبادل اطلاعات خود مشترک شوید

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

historical_roads_data_PROJECT_NUMBER.

برای اشتراک در داده های خود:

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

جداول BigQuery

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

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

جدول historical_travel_time

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

نام حالت تایپ کنید توضیحات
select_route_id پوچ STRING selected_route_id مسیر
display_name پوچ STRING نمایش نام مسیر
رکورد_زمان پوچ TIMESTAMP مهر زمانی که داده های مسیر محاسبه می شود
duration_in_secons پوچ شناور مدت زمان آگاهی از ترافیک مسیر
static_duration_in_secons پوچ شناور ترافیک-مدت زمان ناآگاه مسیر
route_geometry پوچ جغرافی هندسه چند خطی آگاه از ترافیک مسیر

رفتارها و حقایق جدولی

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

جدول داده recent_roads_data

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

این جدول متفاوت از historical_travel_time ، داده های SpeedReadingInterval نیز در خود جای می دهد. این طرح در BigQuery است:

نام حالت تایپ کنید توضیحات
select_route_id پوچ STRING selected_route_id مسیر
display_name پوچ STRING نمایش نام مسیر
رکورد_زمان پوچ TIMESTAMP مهر زمانی که داده های مسیر محاسبه می شود
duration_in_secons پوچ شناور مدت زمان آگاهی از ترافیک مسیر
static_duration_in_secons پوچ شناور ترافیک-مدت زمان ناآگاه مسیر
route_geometry پوچ جغرافی هندسه چند خطی آگاه از ترافیک مسیر
فواصل_سرعت_خواندن تکرار شد ضبط فواصل زمانی نشان دهنده تراکم ترافیک در سراسر مسیر است. تعریف اصلی را در Routes API ببینید
speed_reading_intervals.interval_coordinates تکرار شد جغرافی هندسه برای این فاصله
speed_reading_intervals.speed پوچ STRING طبقه بندی سرعت برای این بازه. مقادیر ممکن: NORMAL، SLOW، TRAFFIC_JAM

رفتارها و حقایق جدولی

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

جدول routes_status

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

نام حالت تایپ کنید توضیحات
select_route_id پوچ STRING selected_route_id مسیر
display_name پوچ STRING نمایش نام مسیر
وضعیت پوچ STRING وضعیت مسیر
اعتبار_خطا پوچ STRING خطای اعتبارسنجی مسیر
low_road_usage_start_time پوچ TIMESTAMP زمانی که مسیر برای اولین بار در طول اعتبار سنجی مجدد، استفاده کم از جاده را مشاهده کرد. با VALIDATION_ERROR_LOW_ROAD_USAGE مرتبط است.
route_attributes پوچ STRING ویژگی های سفارشی برای مسیر انتخاب شده

رفتارها و حقایق جدولی

  • فقط مسیرهایی در وضعیت STATE_RUNNING یا STATE_INVALID در این جدول گنجانده شده است.
  • فراداده و وضعیت مسیرها هر ساعت و بدون توقف به روز می شوند.
  • هنگامی که یک مسیر جدید در Roads Selection API ایجاد شد، انتظار داشته باشید تا 1 ساعت منتظر بمانید تا مسیر موجود در این جدول را ببینید.
  • هنگامی که مسیری از API انتخاب جاده ها حذف شد، انتظار داشته باشید تا 1 ساعت صبر کنید تا ببینید مسیر انتخاب شده از این جدول حذف می شود.