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

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

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

  • مدة الرحلة
  • فواصل سرعة القراءة (SRIs)
  • هندسة المسار

إعداد BigQuery

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

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

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

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

الاشتراك في تبادل البيانات

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

historical_roads_data_PROJECT_NUMBER.

للاشتراك في بياناتك:

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

جداول BigQuery

تتم استضافة بيانات الطرق المجمّعة لمساراتك المحدّدة ضمن مجموعة بيانات BigQuery معزولة لمشروع على السحابة الإلكترونية مملوك لشركة Google. تتم مشاركتها معك من خلال تبادل بيانات خاص تم إنشاؤه خصيصًا لك في ميزة مشاركة BigQuery (مركز إحصاءات Google). للوصول إلى البيانات، عليك الاشتراك في تبادل البيانات وإنشاء مجموعة بيانات مرتبطة ضمن مشروعك على Google Cloud.

تتضمّن مجموعة بيانات BigQuery المشترَكة بعض جداول BigQuery التي تحدّدها Google وتنشئها. في ما يلي تفاصيل كل جدول.

جدول historical_travel_time

في ما يلي مخطط جدول historical_travel_time في BigQuery:

الاسم الوضع النوع الوصف
selected_route_id NULLABLE STRING selected_route_id للمسار
display_name NULLABLE STRING الاسم المعروض للمسار
record_time NULLABLE TIMESTAMP الطابع الزمني الذي يتم فيه احتساب بيانات المسار
duration_in_seconds NULLABLE قيمة عائمة مدة المسار مع مراعاة حركة المرور
static_duration_in_seconds NULLABLE قيمة عائمة مدة المسار بدون مراعاة حركة المرور
route_geometry NULLABLE GEOGRAPHY هندسة الخطوط المتعدّدة للمسار مع مراعاة حركة المرور

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

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

جدول recent_roads_data

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

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

الاسم الوضع النوع الوصف
selected_route_id NULLABLE STRING selected_route_id للمسار
display_name NULLABLE STRING الاسم المعروض للمسار
record_time NULLABLE TIMESTAMP الطابع الزمني الذي يتم فيه احتساب بيانات المسار
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 STRING تصنيف السرعة لهذا الفاصل الزمني القيم المحتمَلة: NORMAL وSLOW وTRAFFIC_JAM

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

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

جدول routes_status

يحتوي الجدول على البيانات الوصفية ومعلومات الحالة للمسارات المحدّدة. ويهدف إلى توفير طريقة أسهل لعرض جميع المسارات وحالاتها. يمكن ربطه بالجدولَين الآخرَين لفلترة البيانات. في ما يلي المخطط في BigQuery:

الاسم الوضع النوع الوصف
selected_route_id NULLABLE STRING selected_route_id للمسار
display_name NULLABLE STRING الاسم المعروض للمسار
status* NULLABLE STRING حالة المسار
validation_error NULLABLE STRING خطأ التحقّق من صحة المسار
low_road_usage_start_time NULLABLE TIMESTAMP الوقت الذي تم فيه رصد انخفاض استخدام الطريق لأول مرة أثناء إعادة التحقّق من صحة المسار يرتبط هذا الوقت بالخطأ VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING السمات المخصّصة للمسار المحدّد

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

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

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