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

تشير بيانات الطرق المتراكمة إلى البيانات التي يمكنك إنشاؤها بمرور الوقت للمسارات التي اخترتها. ستبدأ في تلقّي البيانات بعد إنشاء مسار باستخدام 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 Console، راجِع تفاصيل تبادل البيانات.
  3. انقر على الزر اشتراك في مربّع الحوار.
  4. بعد اكتمال الاشتراك، تظهر مجموعة البيانات المرتبطة في لوحة المستكشف في BigQuery ضمن وحدة تحكّم Google Cloud. يمكنك الآن استخدام أسماء الجداول المعروضة في لوحة "المستكشف" للوصول إلى البيانات في طلبات بحث SQL.

جداول BigQuery

تتم استضافة بيانات الطرق المجمّعة للمسارات المحدّدة ضمن مجموعة بيانات BigQuery معزولة تابعة لمشروع على السحابة الإلكترونية تملكه Google. تتم مشاركتها معك من خلال تبادل خاص للبيانات تم إنشاؤه حصريًا لك في ميزة مشاركة BigQuery (مركز إحصاءات Google). للوصول إلى البيانات، عليك الاشتراك في خدمة تبادل البيانات وإنشاء مجموعة بيانات مرتبطة ضمن مشروعك على 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، فهو يتضمّن أيضًا فواصل قراءة سريعة مستندة إلى الإزاحة (speed_reading_offsets) وفواصل قراءة سريعة قديمة مستندة إلى الإحداثيات (speed_reading_intervals). إليك المخطّط في 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 The traffic-aware polyline geometry of the route
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 متكرر سجلّ فواصل قراءة السرعة المستندة إلى الإزاحة والتي تمثّل كثافة حركة المرور على طول المسار، ويتم تحديد كل فاصل من خلال إزاحة المسافة من بداية المسار. اطّلِع على فواصل القراءة السريعة.
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)

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

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

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

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

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

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