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

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

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

إعداد BigQuery

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

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

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

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

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

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

historical_roads_data_PROJECT_NUMBER.

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

  1. انقر على رابط الاشتراك الذي قدّمه لك شريك Google. سينقلك هذا الرابط مباشرةً إلى صفحة تبادل البيانات في وحدة تحكّم Google Cloud.
  2. في وحدة تحكّم Google Cloud، راجِع تفاصيل تبادل البيانات.
  3. انقر على الزر اشتراك في مربّع الحوار.
  4. عند اكتمال الاشتراك، تظهر مجموعة البيانات المرتبطة في لوحة المستكشف في BigQuery ضمن Google Cloud Console. يمكنك الآن استخدام أسماء الجداول المعروضة في لوحة "المستكشف" للوصول إلى البيانات في طلبات البحث المستندة إلى 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 قيمة عائمة مدة المسار استنادًا إلى حركة المرور يتم حذف (NULL) عندما تكون قيمة has_road_closure هي true.
static_duration_in_seconds NULLABLE قيمة عائمة مدة المسار بدون احتساب حركة المرور
route_geometry NULLABLE GEOGRAPHY الشكل الهندسي المتعدّد الخطوط للمسار الذي يراعي حركة المرور
road_segment_ids متكرر سلسلة أجزاء الطريق على طول المسار، ممثَّلة كأرقام تعريف الأماكن
has_road_closure NULLABLE قيمة منطقية ما إذا كان هناك إغلاق كامل للطريق على المسار عندما تكون قيمة true، يتم حذف duration_in_seconds (NULL) لأنّ المسار غير سالك. تشير القيمة NULL إلى أنّ معلومات إغلاق الطريق غير محدّدة.

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

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

جدول 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 قيمة عائمة مدة المسار استنادًا إلى حركة المرور يتم حذف (NULL) عندما تكون قيمة has_road_closure هي true.
static_duration_in_seconds NULLABLE قيمة عائمة مدة المسار بدون احتساب حركة المرور
route_geometry NULLABLE GEOGRAPHY الشكل الهندسي المتعدّد الخطوط للمسار الذي يراعي حركة المرور
speed_reading_intervals متكرر سجلّ الفواصل الزمنية القديمة لقراءة السرعة المستندة إلى الإحداثيات قد يتوقف ملؤها في 9 نوفمبر 2026 أو بعده. يمكنك استخدام speed_reading_offsets كبديل. راجِع فواصل قراءة السرعة.
speed_reading_intervals.interval_coordinates متكرر GEOGRAPHY قديمة قد يتوقف ملؤها في 9 نوفمبر 2026 أو بعده. يمكنك استخدام speed_reading_offsets كبديل. تمثّل هذه السمة الشكل الهندسي لهذا الفاصل الزمني
speed_reading_intervals.speed NULLABLE سلسلة قديمة قد يتوقف ملؤها في 9 نوفمبر 2026 أو بعده. يمكنك استخدام speed_reading_offsets كبديل. تصنيف السرعة لهذه الفترة الزمنية القيم المحتملة: NORMAL وSLOW وTRAFFIC_JAM. في هذا الحقل القديم، يتم أيضًا الإبلاغ عن الاختناقات المرورية الشديدة (باللون الأحمر الداكن) على أنّها TRAFFIC_JAM، ولا يتم استخدام TRAFFIC_JAM_HEAVY مطلقًا.
road_segment_ids متكرر سلسلة أجزاء الطريق على طول المسار، ممثَّلة كأرقام تعريف الأماكن
speed_reading_offsets متكرر سجلّ تمثّل هذه السمة الفترات الزمنية لقراءة السرعة المستندة إلى الإزاحة، والتي تشير إلى كثافة حركة المرور على طول المسار. يتم تحديد كل فترة زمنية من خلال إزاحة المسافة من بداية المسار. يتم حذف هذه السمة عندما تكون قيمة السمة has_road_closure هي true. راجِع فواصل قراءة السرعة.
speed_reading_offsets.start_offset NULLABLE عدد صحيح تمثّل هذه السمة المسافة من بداية المسار بالأمتار لبداية الفاصل الزمني (مشمولة)
speed_reading_offsets.end_offset NULLABLE عدد صحيح تمثّل هذه السمة المسافة من بداية المسار بالأمتار حتى نهاية الفاصل الزمني (غير مشمولة، وتساوي قيمة start_offset للفاصل الزمني التالي)
speed_reading_offsets.speed NULLABLE سلسلة تصنيف السرعة لهذه الفترة الزمنية، بما يتوافق مع الألوان في طبقة حركة المرور في "خرائط Google". القيم المحتملة: NORMAL (أخضر)، SLOW (أصفر)، TRAFFIC_JAM (أحمر)، TRAFFIC_JAM_HEAVY (أحمر داكن، متاح اعتبارًا من 8 أكتوبر 2026)
has_road_closure NULLABLE قيمة منطقية ما إذا كان هناك إغلاق كامل للطريق على المسار عندما يتم حذف true وduration_in_seconds وspeed_reading_offsets لأنّ المسار غير سالك وتشير القيمة NULL إلى أنّ معلومات إغلاق الطريق غير محدّدة.

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

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

جدول routes_status

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

الاسم الوضع النوع الوصف
selected_route_id NULLABLE سلسلة ‫selected_route_id من المسار
display_name NULLABLE سلسلة الاسم المعروض للمسار
status* 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 نقطة الوصول على المسار
intermediates متكرر 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.