نظرة عامة على 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 وGo Client وعميل Node.js في "خدمات خرائط Google" هي مكتبات عملاء يوفّرها المنتدى، وهي مفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج للرمز.

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