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