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