أسباب استخدام 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 من مسار. تتضمن إحداثيات خطوط الطول/العرض المحددة للطريق إلى جانب معرّفات الأماكن. يمكنك الاطّلاع على التفاصيل في الردود ضمن دليل محاذاة إلى الطرق. |
|
أقرب الطرق |
مصفوفة مكوّنة من 100 إحداثيات مستقلة لخط العرض/الطول بالإضافة إلى معرّفات الأماكن لأقرب طريق لكل نقطة محددة. لا يلزم أن تكون النقاط مستمرة. يمكنك الاطّلاع على التفاصيل في الردود ضمن دليل أقرب الطرق. |
|
حدود السرعة |
مصفوفة تضم ما يصل إلى 100 عنصر من البيانات الوصفية للطريق. تحتوي هذه الطرق على حدود للسرعة ومعرّفات الأماكن، ويجب أن تكون وحداتها إما كم ساعة أو ميل في الساعة. يمكنك الاطّلاع على التفاصيل في الردود في دليل حدود السرعة. |
كيفية استخدام Roads API
1 | تجربة العرض التوضيحي للطرق السريعة | انقر على العرض التوضيحي لإنشاء مسار وشاهد كيف توفر نقطة نهاية محاذاة إلى الطرق بيانات سلسة. اطّلِع على العرض التوضيحي في دليل محاذاة إلى الطرق. لست بحاجة إلى مفتاح واجهة برمجة التطبيقات. |
2 | البدء | يمكنك الاطّلاع على المقالة إعداد مشروعك على Google Cloud وإكمال تعليمات الإعداد ثم التعرّف على كيفية استخدام مفتاح واجهة برمجة التطبيقات. |
3 | تجربة طلب محاذاة إلى الطرق | استخدِم إحدى نماذج الصور السريعة للطرق وجرِّب نموذجًا يتناسب مع حالة الاستخدام الخاصة بك. |
4 | التعرُّف على حدود السرعة لمسار الطريق | باستخدام بيانات المسار نفسها التي قدّمتها لطلب الانتقال إلى الطرق، يمكنك إصدار طلب بحث عن حدّ السرعة. راجِع مثال على طلب باستخدام مسار. |
5 | التعرّف على كيفية معالجة المسارات الطويلة | اتّبِع الأقسام التي تتناول معالجة المسارات الطويلة في دليل المفاهيم المتقدمة. |
6 | دمج بيانات الطرقات في تطبيقك الخاص | يمكنك الاطّلاع على مثال مفصَّل عن الرمز من العرض التوضيحي الذي تم التقاطه للطريق لبدء تضمين وظائف بيانات الطريق في تطبيقك الخاص. |
مكتبات العملاء المتاحة
يمكنك استدعاء واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات العملاء التالية:
- برنامج Java لخدمات "خرائط Google"
- برنامج Python لخدمات "خرائط Google"
- برنامج Go Client لخدمات "خرائط Google"
- برنامج Node.js لخدمات "خرائط Google"
إنّ Java Client وعميل Python وGo Client وعميل Node.js في "خدمات خرائط Google" هي مكتبات عملاء يوفّرها المنتدى، وهي مفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج للرمز.
الخطوات التالية
- تجربة Roads API: انتقِل إلى Roads Inspector (أداة فحص الطرق).
- تعرَّف على كيفية تقديم طلبات البيانات من Roads API: انتقِل إلى الخدمة التي تهمّك:
- فهم المفاهيم المتقدمة: الانتقال إلى المفاهيم المتقدمة
- اتّباع أفضل الممارسات: انتقِل إلى أفضل ممارسات خدمات الويب.