نظرة عامة على 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 تجربة العرض التوضيحي بعد حصولك على مفتاح واجهة برمجة التطبيقات ومشروع على السحابة الإلكترونية، يمكنك تجربة العرض التوضيحي للاتّجاهات بدون أي رسوم. يُرجى الاطّلاع على العرض التوضيحي لواجهة برمجة تطبيقات Directions API.
3 إنشاء طلب اطّلِع على نماذج الطلبات وتعرَّف على الخيارات المتاحة التي يمكنك تقديمها، مثل وسائل النقل ونقاط الطريق والقيود المفروضة على المسارات. راجِع أمثلة على الاتجاهات.
4 فهم أساسيات الردود استكشِف ردود البيانات للاستعداد لاستخدام بيانات الاتجاهات لتطبيقك. ويمكنك الاطّلاع على الردود على الاتجاهات لمعرفة التفاصيل.
5 أدرِج بيانات الاتجاهات في تطبيقك. يمكنك استخدام هذه البيانات لحساب مسافة السفر ووقته.

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

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

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

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