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

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

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

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

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

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

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

  • المحاذاة إلى الطرق تعرض هذه الخدمة النتائج الأكثر احتمالاً الطرق المقطوعة بناءً على مجموعة إحداثيات نظام تحديد المواقع العالمي (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

الموارد

يلخص الجدول التالي الموارد المتاحة من خلال Roads API مع البيانات التي تعرضها.

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

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

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

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

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

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

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

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

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

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