أسباب استخدام واجهة برمجة التطبيقات Directions API
باستخدام واجهة برمجة التطبيقات Directions API، يمكنك الحصول على الاتجاهات للعديد من وسائل النقل، مثل النقل العام أو القيادة أو المشي أو ركوب الدراجات.
ما الذي يمكنك فعله باستخدام Directions API؟
باستخدام Directions API، يمكنك احتساب الاتجاهات بين المواقع الجغرافية، بما في ذلك التفاصيل التالية:
- اتجاهات عدة وسائل نقل، بما في ذلك النقل العام أو القيادة أو المشي أو ركوب الدراجات.
- الاتجاهات متعددة الأجزاء باستخدام سلسلة من نقاط الطريق.
- حدِّد المصادر والوجهات ونقاط الطريق بعدة طرق، بما في ذلك سلاسل نصية (على سبيل المثال، "شيكاغو، إلينوي" أو "داروين، NT، أستراليا")، أو أرقام تعريف الأماكن، أو إحداثيات خطوط العرض/الطول.
آلية عمل Directions API
تعرض Directions API المسارات الأكثر كفاءة عند حساب الاتجاهات. عوامل المنتج في عناصر السفر التالية عند تحديد المسار الأكثر كفاءة:
- مدة السفر (الأساسية)
- المسافة
- عدد الدورات
يعرض المثال التالي لطلب الاتجاهات اتجاهات القيادة من تورنتو، أونتاريو إلى مونتريال، كيبك بتنسيق JSON:
https://maps.googleapis.com/maps/api/directions/json ?destination=Montreal &origin=Toronto &key=YOUR_API_KEY
الموارد
يلخص الجدول التالي الموارد المتاحة من خلال Directions API إلى جانب البيانات التي يعرضها.
| موارد البيانات | تم إرجاع البيانات | تنسيق الإرجاع |
|---|---|---|
| الاتجاهات
أدخِل معلومات الأصول والوجهات في شكل معرّفات أماكن أو عناوين أو إحداثيات خطوط الطول/العرض. راجِع المعلَمات المطلوبة للاطّلاع على التفاصيل. |
الاتجاهات التفصيلية، مقسمة إلى مسارات وأرجل وخطوات. يمكنك الاطّلاع على الردود على الاتجاهات لمعرفة التفاصيل. |
|
كيفية استخدام Directions API
| 1 | البدء في الإعداد | ابدأ بعبارة إعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد الموضّحة. |
| 2 | تجربة العرض التوضيحي | بعد الحصول على مفتاح واجهة برمجة التطبيقات ومشروع على السحابة الإلكترونية، يمكنك بدء استخدام الإصدار التجريبي من ميزة "الاتجاهات" بدون أي رسوم. اطّلِع على العرض التجريبي لواجهة برمجة التطبيقات Directions API. |
| 3 | إنشاء طلب | اطّلِع على أمثلة الطلبات وتعرَّف على الخيارات المتاحة التي يمكنك تقديمها، مثل أوضاع التنقّل ونقاط الالتقاء والقيود المفروضة على المسار. اطّلِع على أمثلة على الاتجاهات. |
| 4 | التعرّف على أساسيات الاستجابة | يمكنك استكشاف ردود البيانات للاستعداد لاستخدام بيانات الاتجاهات لتطبيقك. ويمكنك الاطّلاع على الردود المتعلقة بالاتجاهات لمعرفة التفاصيل. |
| 5 | دمج بيانات الاتجاهات في تطبيقك | ويمكنك استخدام هذه البيانات لحساب مسافة السفر ووقته. |
مكتبات العملاء المتاحة
ويمكنك استدعاء واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات العملاء التالية:
- Java برنامج مخصّص لاستخدام خدمات "خرائط Google"
- Python برنامج عملاء "خدمات خرائط Google"
- Go Client لخدمات "خرائط Google"
- Node.js عميل لخدمات "خرائط Google"
مكتبة Java Client وPython Client وGo Client وNode.js Client لخدمات "خرائط Google" هي مكتبات عملاء مفتوحة المصدر تدعمها جهات خارجية بموجب ترخيص Apache 2.0. قم بتنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.
الخطوات التالية
- بدء استخدام Directions API: انتقِل إلى البدء.
- بدء تقديم طلبات للحصول على الاتجاهات: انتقِل إلى الحصول على الاتجاهات.
- اتّباع أفضل الممارسات: انتقِل إلى أفضل الممارسات المتعلقة بخدمة الويب.