نظرة عامة على 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 بالإضافة إلى البيانات التي تعرضها.

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

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

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

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

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

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

مكتبات البرامج المتاحة

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

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

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