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

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

مزايا استخدام Directions API

باستخدام Directions API، يمكنك الحصول على اتجاهات لعدة وسائل نقل، مثل النقل العام أو القيادة أو المشي أو ركوب الدراجات.

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

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