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