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

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

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

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

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

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

كيفية استخدام Directions API

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

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

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

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

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