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

Directions API هي خدمة تقبل طلب HTTP وترجع الاتجاهات بتنسيق JSON أو XML بين المواقع الجغرافية

أسباب استخدام واجهة برمجة التطبيقات 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 والبيانات التي تعرضها.

موارد البيانات تم إرجاع البيانات تنسيق الإرجاع
الاتجاهات

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

الاتجاهات التفصيلية، مقسمة إلى مسارات وأرجل وخطوات. عرض يمكنك الردود على التوجيهات للاطّلاع على التفاصيل.
  • JSON
  • XML

طريقة استخدام واجهة Directions API

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

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

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

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

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