نظرة عامة على 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