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

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

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

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

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

الإجراءات التي يمكنك تنفيذها باستخدام 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 بالإضافة إلى البيانات التي تعرضها.

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

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

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

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

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

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

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

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

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

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