
أهمية استخدام 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 API (الإصدار القديم)
| 1 | إعداد الميزة: | ابدأ بإعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد التالية. |
| 2 | تجربة العرض التوضيحي | بعد الحصول على مفتاح واجهة برمجة التطبيقات وإنشاء مشروع على السحابة الإلكترونية، يمكنك تجربة النسخة التجريبية من ميزة الاتجاهات بدون أي رسوم. يمكنك الاطّلاع على الإصدار التجريبي من Directions API (القديمة). |
| 3 | إنشاء طلب | اطّلِع على أمثلة الطلبات وتعرَّف على الخيارات المتاحة التي يمكنك تقديمها، مثل وسائل النقل والنقاط على المسار والقيود المفروضة على المسار. يمكنك الاطّلاع على أمثلة على الاتجاهات. |
| 4 | التعرّف على أساسيات الردود | استكشِف الردود على طلبات البيانات للاستعداد لاستخدام بيانات الاتجاهات في تطبيقك. يُرجى الاطّلاع على الردود على طلبات الاتجاهات لمعرفة التفاصيل. |
| 5 | دمج بيانات الاتجاهات في تطبيقك | يمكنك استخدام هذه البيانات لاحتساب مسافة الرحلة ومدتها. |
مكتبات العملاء المتاحة
يمكنك طلب بيانات واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات البرامج التالية:
- برنامج Java التابع لخدمات "خرائط Google"
- برنامج Python لخدمات "خرائط Google"
- Go Client for Google Maps Services
- عميل Node.js لخدمات "خرائط Google"
إنّ عملاء Java وPython وGo وNode.js لخدمات "خرائط Google" هم مكتبات عملاء يدعمها المنتدى، وهي مفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت والرمز النموذجي.
الخطوات التالية
- بدء استخدام Directions API (الإصدار القديم): انتقِل إلى البدء.
- البدء في تقديم طلبات الاتجاهات: انتقِل إلى الحصول على الاتجاهات.
- اتّباع أفضل الممارسات: انتقِل إلى أفضل ممارسات خدمة الويب.