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