أهمية استخدام 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 (الإصدار القديم): انتقِل إلى البدء.
- البدء في تقديم طلبات الاتجاهات: انتقِل إلى الحصول على الاتجاهات.
- اتّباع أفضل الممارسات: انتقِل إلى أفضل ممارسات خدمة الويب.