نظرة عامة على Roads Selection API

تُعدّ واجهة Roads Selection API مكوّنًا أساسيًا في منتج بيانات إدارة الطرق.

استخدِم Roads Selection API للاشتراك في المسارات التي تريد جمع بيانات الطرق لها. بعد الاشتراك في مسار معيّن، تسترد واجهة برمجة التطبيقات المعلومات الخاصة بالمسار وتنشرها بشكل دوري في جدول BigQuery أو اشتراك Pub/Sub لأغراض التحليل والمراقبة.

طريقة عمل Roads Selection API

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

يمكنك أيضًا استرداد التفاصيل وتعديلها من أي من مساراتك المسجّلة، وإيقاف جمع البيانات من أي مسار عند الحاجة. ويمكن تنفيذ هذه العمليات على مسارات فردية أو بشكل مجمّع.

موارد API

يلخّص الجدول التالي المورد الأساسي ونقاط النهاية المتاحة من خلال Roads Selection API وأغراضها.

نقطة النهاية لواجهة برمجة التطبيقات الوصف التنسيق
create

تسجّل هذه الطريقة اهتمامك ببيانات الطرق المستمرة لمسار محدّد حسب نقطة الانطلاق والوجهة والنقاط على المسار الوسيطة الاختيارية.

JSON

batchCreate

تسجّل هذه الطريقة مسارات متعددة لجمع البيانات من خلال توفير نقطة الانطلاق والوجهة والنقاط على المسار لكل مسار.

JSON

get

تستردّ هذه الطريقة تفاصيل عن مسار تم إنشاؤه سابقًا من خلال تقديم selectedRouteId.

JSON

list

تسترد هذه الطريقة قائمة بجميع المسارات التي أنشأتها.

JSON

patch

تعديل تفاصيل مسار تم إنشاؤه سابقًا من خلال تقديم selectedRouteId الخاص به

JSON

batchUpdate

تعديل تفاصيل مسارات متعددة في الوقت نفسه

JSON

delete

يؤدي هذا الإجراء إلى إيقاف جمع البيانات لمسار معيّن من خلال تقديم selectedRouteId.

JSON

batchDelete

يؤدي هذا الإجراء إلى إيقاف جمع البيانات لمسارات متعددة في الوقت نفسه.

JSON

الخطوات التالية

يمكنك مواصلة إعداد المسارات وإدارتها باستخدام المراجع التالية: