تُعدّ واجهة 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
|
تستردّ هذه الطريقة تفاصيل عن مسار تم إنشاؤه سابقًا من خلال تقديم
|
JSON |
list
|
تسترد هذه الطريقة قائمة بجميع المسارات التي أنشأتها. |
JSON |
patch
|
تعديل تفاصيل مسار تم إنشاؤه سابقًا من خلال تقديم
|
JSON |
batchUpdate
|
تعديل تفاصيل مسارات متعددة في الوقت نفسه |
JSON |
delete
|
يؤدي هذا الإجراء إلى إيقاف جمع البيانات لمسار معيّن من خلال تقديم
|
JSON |
batchDelete
|
يؤدي هذا الإجراء إلى إيقاف جمع البيانات لمسارات متعددة في الوقت نفسه. |
JSON |
الخطوات التالية
يمكنك مواصلة إعداد المسارات وإدارتها باستخدام المراجع التالية:
- أنشئ مسارات فردية أو مجمّعة في إنشاء المسارات المحدّدة.
- يمكنك مراجعة أفضل الممارسات المتعلّقة بالطرق السريعة المقسّمة والجسور والأنفاق والنقاط على المسار في دليل اختيار المسار في "بيانات إدارة الطرق".
- يمكنك استكشاف أدوات إعداد المسارات التفاعلية ونماذج التطبيقات وطلبات بحث SQL في BigQuery في الأدوات والمراجع.