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