نظرة عامة على Roads API

‫Roads API هي خدمة تقبل طلبات HTTPS التي تتضمّن إحداثيات خط العرض/الطول لنقطة واحدة أو أكثر على الخريطة. ويستخدم هذه النقاط للعثور على أجزاء الطرق المجاورة وعرض رقم تعريف مكان مع البيانات الوصفية مثل أقرب جزء من الطريق والحدود القصوى للسرعة.

مزايا استخدام Roads API

باستخدام Roads API، يمكنك الحصول على حدود السرعة أو أوقات الوصول المقدَّرة أو البيانات الوصفية الأخرى للطرق. باستخدام هذه ال metadata للطرق، يمكنك تحسين تطبيقات القيادة من خلال الإمكانات التالية:

  • اربط إحداثيات خطوط العرض/الطول بطريق أو طرق.
  • العثور على أقرب طريق لمجموعة من الإحداثيات
  • الحصول على حدود السرعة لمقاطع الطرق

الإجراءات التي يمكنك تنفيذها باستخدام Roads API

باستخدام Roads API، يمكنك ربط إحداثيات نظام تحديد المواقع العالمي (GPS) بأشكال الطريق وتحديد الحد الأقصى للسرعة على طول أجزاء الطريق.

  • الاقتران بالطرق تعرِض هذه الخدمة الطرق التي يُرجَّح أن تكون قد تم التنقّل عليها استنادًا إلى مجموعة إحداثيات GPS المقدَّمة. يمكنك تحديد ما يصل إلى 100 نقطة GPS تم جمعها على طول مسار. يمكنك أيضًا اختياريًا أن تطلب من الخدمة إدراج نقاط إضافية، ما يؤدي إلى إنشاء مسار يتّبع بشكل سلس الشكل الهندسي للطريق.
  • أقرب الطرق تعرِض هذه الخدمة أقرب جزء من الطريق لنقطة GPS. يمكنك تحديد ما يصل إلى 100 نقطة نظام تحديد المواقع العالمي (GPS). ولا يلزم أن تكون النقاط التي تحدّدها جزءًا من مسار مستمر.
  • حدود السرعة تعرض هذه الخدمة الحد الأقصى للسرعة المُعلَن عنه لجزء من الطريق. تتوفّر خدمة "حدود السرعة" لجميع العملاء الذين لديهم ترخيص تتبُّع مواد العرض. بالنسبة إلى عملاء خطة Google Maps Platform المميّزة الذين انتقلوا إلى الأسعار المستندة إلى الاستخدام، ستظل الميزة فعالة.

آلية عمل واجهة برمجة التطبيقات Roads API

تستخدِم واجهة برمجة التطبيقات Roads API ثلاث نقاط نهاية تقبل إحداثيات خط الطول/العرض أو أرقام تعريف الأماكن لتوفير مسارات الطرق أو أقسامها أو بيانات حدود السرعة. يعرض المثال التالي طلبًا للطرق الأقرب استنادًا إلى مجموعة من إحداثيات خطوط العرض/الطول:

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

الموارد

يلخِّص الجدول التالي الموارد المتاحة من خلال واجهة برمجة التطبيقات Roads API بالإضافة إلى البيانات التي تعرِضها.

مصادر البيانات البيانات التي تم عرضها تنسيق الإرجاع
المحاذاة إلى الطرق

لعرض صفيف يتضمّن ما يصل إلى 100 نقطة نظام تحديد المواقع العالمي (GPS) من مسار تتضمّن إحداثيات خط الطول/العرض الملتقطة على الطريق مع أرقام تعريف الأماكن. اطّلِع على التفاصيل في الردود في دليل الانطباق على الطرق.
  • JSON
أقرب الطرق

صفيف يتضمّن ما يصل إلى 100 إحداثي خط عرض/طول مستقل بالإضافة إلى أرقام تعريف الأماكن لأقرب طريق لكل نقطة محدّدة ولا يلزم أن تكون النقاط متّصلة. اطّلِع على التفاصيل في الردود في دليل أقرب الطرق.
حدود السرعة

مصفوفة تضم ما يصل إلى 100 عنصر من البيانات الوصفية للطرق وتحتوي هذه البيانات على حدود السرعة ومعرّفات الأماكن، مع وحدات القياس إما كيلومتر في الساعة أو ميل في الساعة. اطّلِع على التفاصيل في الردود في دليل حدود السرعة.

كيفية استخدام Roads API

1 تجربة العرض التجريبي لميزة "الاقتران بالطرق" انقر على العرض التجريبي لإنشاء مسار ومعرفة كيفية حصول نقطة النهاية "الاقتران بالطرق" على بيانات سلسة. اطّلِع على العرض التقديمي في دليل الربط بالطرق. لست بحاجة إلى مفتاح واجهة برمجة التطبيقات.
2 الإعداد ابدأ بـ إعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد التي تليها، ثم تعرَّف على كيفية استخدام مفتاح واجهة برمجة التطبيقات.
3 تجربة طلب "الاقتران بالطرق" استخدِم أحد أمثلة التصغير إلى الطرق وجرِّب أحدها ذا صلة بحالة الاستخدام.
4 الحصول على حدود السرعة لمسار الطريق باستخدام بيانات المسار نفسها التي قدّمتها لطلب "الربط بالطرق"، أدخِل طلبًا للحصول على معلومات عن حدود السرعة. اطّلِع على مثال على طلب باستخدام مسار.
5 التعرّف على كيفية معالجة المسارات الطويلة اتّبِع الأقسام حول معالجة المسارات الطويلة في دليل المفاهيم المتقدّمة.
6 دمج بيانات الطرق في تطبيقك اطّلِع على مثال التعليمات البرمجية المفصّل من العرض التجريبي للطريق المقتطعة لبدء إنشاء وظيفة بيانات الطرق في تطبيقك.

مكتبات العملاء المتاحة

يمكنك طلب بيانات من واجهة برمجة التطبيقات هذه بلغة اختيارك من خلال إحدى مكتبات العملاء التالية:

مكتبة Java Client وPython Client وGo Client وNode.js Client لخدمات Google Maps هي مكتبات عملاء مفتوحة المصدر تدعمها جهات خارجية بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونماذج الرموز البرمجية.

الخطوات التالية