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

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

استخدِم Roads Selection API للاشتراك في المسارات التي تريد جمع بيانات الطرق لها. بعد الاشتراك في مسار معيّن، تسترد واجهة برمجة التطبيقات المعلومات الخاصة بالمسار وتنشرها بشكل دوري في جدول Big Query أو اشتراك 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