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

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

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

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

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

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

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

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