نظرة عامة على 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 (الإصدار القديم) والبيانات التي تعرضها.

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

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

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

كيفية استخدام Directions API (الإصدار القديم)

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

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

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

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

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