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