أسباب استخدام واجهة برمجة تطبيقات مصفوفة المسافة
يمكنك استخدام واجهة برمجة تطبيقات مصفوفة المسافة للمساعدة في تحديد أكثر واجهات العرض مسارات السفر بين مصادر ووجهات متعددة محتملة. بالنسبة مثل، العاملين الذين يجب إرسالهم إلى مواقع العمل، أو المستودعات التي يتم الإرسال منها حزم.
الإجراءات التي يمكنك اتّخاذها باستخدام واجهة برمجة التطبيقات لمصفوفة المسافة
باستخدام واجهة برمجة تطبيقات مصفوفة المسافة، يمكنك توفير مسافة السفر والوقت مصفوفة من الأصول والوجهات. يمكنك تحديد عدة خيارات، بما في ذلك وسيلة النقل، مثل القيادة أو ركوب الدراجات أو النقل العام أو المشي، فضلاً عن وسائل النقل العام، مثل الحافلات أو مترو الأنفاق أو القطار أو الترام أو السكك الحديدية
توفّر واجهة برمجة التطبيقات لمصفوفة المسافة المعلومات استنادًا إلى المسار المقترَح بين نقطتي البداية والنهاية. يمكنك طلب هذه الأنواع من بيانات المسافة:
- المسافة لوضع السفر الذي تم اختياره
- المسافة بالكيلومتر أو الأميال
- الوقت التقديري للسفر في حركة المرور
آلية عمل واجهة برمجة التطبيقات لمصفوفة المسافة
تستخدم واجهة برمجة التطبيقات لمصفوفة المسافات أي عدد من الأصول (نقاط البداية) والوجهات، وتعرض المسافة ووقت السفر بين كل منها المصدر وجميع الوجهات المطلوبة، بدءًا من المصدر الأول في الطلب والمتابعة خطوة بخطوة إلى ما يلي.
على سبيل المثال، إذا حدَّد طلبك "أ" و"ب" كأصل، و"ج" و"د" كوجهتين، سيتم عرض المسافات ووقت السفر بهذا الترتيب:
- من أ إلى ج
- أ إلى ي
- ب إلى ج
- من ب إلى ي
يوضّح المثال التالي طلبًا لمصدرَين: واشنطن العاصمة وبوسطن، ولها وجهة واحدة، وهي مدينة نيويورك، ونيويورك، في تنسيق JSON:
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=New%20York%20City%2C%20NY &origins=Washington%2C%20DC%7CBoston &units=imperial &key=YOUR_API_KEY
الموارد
يلخص الجدول التالي الموارد المتاحة من خلال واجهة برمجة التطبيقات لمصفوفة المسافة مع البيانات التي تعرضها.
| موارد البيانات | تم إرجاع البيانات | تنسيق الإرجاع |
|---|---|---|
| مصفوفة المسافة
احرص على توفير مصادر ووجهات الأماكن في شكل معرّفات الأماكن والعناوين أو إحداثيات خطوط العرض/خطوط الطول. |
|
|
كيفية استخدام واجهة برمجة تطبيقات مصفوفة المسافة
| 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، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.
الخطوات التالية
- بدء استخدام مصفوفة المسافة: انتقِل إلى البدء.
- البدء في استخدام نماذج للطلبات والردود: انتقِل إلى مصفوفة المسافة. الطلب والردّ
- اتّباع أفضل الممارسات: الانتقال إلى أفضل ممارسات الويب الممارسات: