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

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

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

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

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

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

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

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

آلية عمل 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 for Google Maps هي مكتبات عملاء مدعومة من المنتدى، ومفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.

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