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

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

مميزات استخدام واجهة برمجة تطبيقات الطرق

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

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

الإجراءات التي يمكنك اتّخاذها باستخدام واجهة برمجة تطبيقات الطرق

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

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

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

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

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 عنصر من عناصر البيانات الوصفية للطرق. تحتوي هذه القيم على حدود السرعة ومعرّفات الأماكن، بوحدات إما بالكيلومتر في الساعة أو بالميل في الساعة. يمكنك الاطّلاع على التفاصيل في الردود في دليل حدود السرعة.

كيفية استخدام واجهة برمجة تطبيقات الطرق

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

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

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

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

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