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

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

أسباب استخدام Roads API

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

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

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

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

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

طريقة عمل 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 من مسار معيّن. وتتضمّن إحداثيات خطوط الطول/العرض التي تم التقاطها على الطريق مع أرقام تعريف الأماكن. يمكنك الاطّلاع على التفاصيل في الردود في دليل Snap to roads.
  • JSON
أقرب الطرق

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

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

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

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

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

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

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

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