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