نظرة عامة على 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 وGo Client وعميل Node.js في "خدمات خرائط Google" هي مكتبات عملاء يوفّرها المنتدى، وهي مفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج للرمز.

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