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