بيانات الطرق المتراكمة

تشير بيانات الطرق المتراكمة إلى البيانات التي يمكنك جمعها بمرور الوقت للطرق التي اخترتها. ستبدأ في تلقّي البيانات بعد إنشاء مسار باستخدام Roads Selection API. ويمكن استخدام هذه البيانات بعد ذلك لإجراء تحليل معمّق، ووضع خطط استراتيجية، وفهم السلوك طويل الأمد للطرق.

يتم تقديم بيانات الطرق المتراكمة كسلسلة زمنية من البيانات، وتشمل ما يلي:

  • مدة الرحلة
  • فواصل القراءة السريعة (SRIs)
  • شكل المسار

إعداد BigQuery

قبل أن تتمكّن من الوصول إلى بيانات الطرق في BigQuery، عليك إعداد مشروعك على Google Cloud والاشتراك في خدمة تبادل البيانات.

المتطلبات الأساسية

تأكَّد من أنّ مشروعك على السحابة الإلكترونية وحسابك على Google Cloud يتضمّنان الإعدادات التالية:

  1. فعِّل BigQuery API. للحصول على التعليمات، يُرجى الاطّلاع على إجراء طلب بحث في مجموعة بيانات عامة باستخدام وحدة تحكّم Google Cloud.
  2. فعِّل Analytics Hub API. اطّلِع على Analytics Hub API.
  3. منح أدوار "إدارة الهوية وإمكانية الوصول" اللازمة تأكَّد من أنّ حسابك يتضمّن الأدوار التالية لتنفيذ مهام المشترك وإنشاء مجموعات البيانات:
  4. مشترك في "مركز الإحصاءات" (roles/analyticshub.subscriber)

الاشتراك في خدمة تبادل البيانات

تتم مشاركة بيانات الطرق معك من خلال تبادل خاص للبيانات في BigQuery‏(Analytics Hub). ستتلقّى رابط اشتراك محدّدًا من أحد شركاء Google للوصول إلى بياناتك. تلتزم مجموعة البيانات هذه باتّباع اصطلاح التسمية التالي:

historical_roads_data_PROJECT_NUMBER.

للاشتراك في بياناتك، اتّبِع الخطوات التالية:

  1. انقر على رابط الاشتراك الذي يقدّمه شريك Google. سينقلك هذا الرابط مباشرةً إلى صفحة تبادل البيانات في وحدة تحكّم Google Cloud.
  2. في Google Cloud Console، راجِع تفاصيل تبادل البيانات.
  3. انقر على الزر اشتراك في مربّع الحوار.
  4. بعد اكتمال الاشتراك، تظهر مجموعة البيانات المرتبطة في لوحة المستكشف في BigQuery ضمن وحدة تحكّم Google Cloud. يمكنك الآن استخدام أسماء الجداول المعروضة في لوحة "المستكشف" للوصول إلى البيانات في طلبات بحث SQL.

جداول BigQuery

تتم استضافة بيانات الطرق المجمّعة للمسارات المحدّدة ضمن مجموعة بيانات BigQuery معزولة تابعة لمشروع على السحابة الإلكترونية تملكه Google. تتم مشاركتها معك من خلال تبادل خاص للبيانات تم إنشاؤه حصريًا لك في ميزة مشاركة BigQuery (مركز الإحصاءات). للوصول إلى البيانات، عليك الاشتراك في تبادل البيانات وإنشاء مجموعة بيانات مرتبطة ضمن مشروعك على 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 قيمة عائمة مدة المسار مع مراعاة حركة المرور
static_duration_in_seconds NULLABLE قيمة عائمة مدة المسار بدون مراعاة حركة المرور
route_geometry NULLABLE GEOGRAPHY الشكل الهندسي المتعدّد الخطوط للمسار الذي يراعي حركة المرور
road_segment_ids متكررة سلسلة أجزاء الطريق على طول المسار، ويتم تمثيلها كأرقام تعريف الأماكن

سلوكيات وحقائق الجدول

  • يتم تقسيم الجدول حسب اليوم، ويتم ضبط تاريخ انتهاء صلاحية مدته 10 سنوات لكل قسم.
  • يتم تعديل الجدول كل ساعة بأحدث بيانات الزيارات المكتوبة في حزمة.
  • بعد إنشاء مسار جديد في Roads Selection API، عليك الانتظار لمدة تصل إلى ساعة واحدة لكي تظهر البيانات في هذا الجدول.
  • بعد حذف مسار من Roads Selection API، لن تتم كتابة أي بيانات جديدة في هذا الجدول للمسار. ومع ذلك، تبقى البيانات السابقة متاحة حتى انتهاء صلاحيتها.
  • تتّبع مقاطع الطريق على طول المسار ترتيبًا طوبولوجيًا وتكون متصلة دائمًا.

جدول recent_roads_data

ملاحظة: لا يتوفّر هذا الجدول إلا عندما يتضمّن عقدك بيانات الطرق في الوقت الفعلي.

يختلف هذا الجدول عن historical_travel_time، إذ يتضمّن أيضًا بيانات SpeedReadingInterval. في ما يلي المخطط في BigQuery:

الاسم الوضع النوع الوصف
selected_route_id NULLABLE سلسلة ‫selected_route_id من المسار
display_name NULLABLE سلسلة الاسم المعروض للمسار
record_time NULLABLE طابع زمني الطابع الزمني لوقت احتساب بيانات المسار
duration_in_seconds NULLABLE قيمة عائمة مدة المسار مع مراعاة حركة المرور
static_duration_in_seconds NULLABLE قيمة عائمة مدة المسار بدون مراعاة حركة المرور
route_geometry NULLABLE GEOGRAPHY الشكل الهندسي المتعدّد الخطوط للمسار الذي يراعي حركة المرور
speed_reading_intervals متكررة سجلّ فواصل زمنية تمثّل كثافة حركة المرور على طول المسار يمكنك الاطّلاع على التعريف الأصلي في Routes API
speed_reading_intervals.interval_coordinates متكررة GEOGRAPHY الشكل الهندسي لهذا الفاصل الزمني
speed_reading_intervals.speed NULLABLE سلسلة تصنيف السرعة لهذه الفترة الزمنية القيم المحتملة: NORMAL وSLOW وTRAFFIC_JAM
road_segment_ids متكررة سلسلة أجزاء الطريق على طول المسار، ويتم تمثيلها كأرقام تعريف الأماكن

سلوكيات وحقائق الجدول

  • يتم تقسيم الجدول حسب اليوم، ويتم ضبط تاريخ انتهاء صلاحية مدته 60 يومًا لكل قسم.
  • يتم تعديل الجدول كل ساعة بأحدث بيانات الزيارات المكتوبة في حزمة.
  • بعد إنشاء مسار جديد في Roads Selection API، عليك الانتظار لمدة تصل إلى ساعة واحدة لكي تظهر البيانات في هذا الجدول.
  • بعد حذف مسار من Roads Selection API، لن تتم كتابة أي بيانات جديدة في هذا الجدول للمسار. ومع ذلك، تبقى البيانات السابقة متاحة حتى انتهاء صلاحيتها.
  • تتّبع مقاطع الطريق على طول المسار ترتيبًا طوبولوجيًا وتكون متصلة دائمًا.

جدول 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 سلسلة السمات المخصّصة للمسار المحدّد

*تبدأ حالة المسار في هذا الجدول بـ STATUS_ بدلاً من STATE_. وهي تتوافق مع Roads Selection API في ما عدا ذلك.

سلوكيات وحقائق الجدول

  • لا يتضمّن هذا الجدول سوى المسارات التي تكون حالتها STATUS_RUNNING أو STATUS_INVALID.
  • يتم تعديل البيانات الوصفية للحافلات وحالتها كل ساعة بدون توقّف.
  • بعد إنشاء مسار جديد في Roads Selection API، عليك الانتظار لمدة تصل إلى ساعة واحدة لكي يظهر المسار في هذا الجدول.
  • بعد حذف مسار من Roads Selection API، عليك الانتظار لمدة تصل إلى ساعة واحدة حتى تتم إزالة المسار المحدّد من هذا الجدول.