نظرة عامة على 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
delete	توقِف هذه السمة عملية جمع البيانات لمسار معيّن من خلال توفير selectedRouteId.	JSON
list	تعرض هذه الطريقة قائمة بجميع المسارات التي أنشأتها.	JSON