نظرة عامة على واجهة برمجة التطبيقات للطرق

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

لماذا يتم استخدام Roads API؟

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

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

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

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

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

آلية عمل Roads API

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

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

الموارد

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

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

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

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

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

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

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

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

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

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

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