نظرة عامة على واجهة برمجة التطبيقات لمصفوفة المسافات

واجهة برمجة تطبيقات مصفوفة المسافة هي خدمة تقبل طلبات HTTPS تحتوي على أصول ووجهات وسيلة نقل معيّنة. لكل منها بين نقطة الانطلاق والوجهة، فإنها تعرض مسافة السفر ومدته.

أسباب استخدام واجهة برمجة تطبيقات مصفوفة المسافة

يمكنك استخدام واجهة برمجة تطبيقات مصفوفة المسافة للمساعدة في تحديد أكثر واجهات العرض مسارات السفر بين مصادر ووجهات متعددة محتملة. بالنسبة مثل، العاملين الذين يجب إرسالهم إلى مواقع العمل، أو المستودعات التي يتم الإرسال منها الحزم.

الإجراءات التي يمكنك اتّخاذها باستخدام واجهة برمجة التطبيقات لمصفوفة المسافة

باستخدام واجهة برمجة تطبيقات مصفوفة المسافة، يمكنك توفير مسافة السفر والوقت مصفوفة من الأصول والوجهات. يمكنك تحديد عدة خيارات، بما في ذلك وسيلة النقل، مثل القيادة أو ركوب الدراجات أو النقل العام أو المشي، فضلاً عن وسائل النقل العام، مثل الحافلات أو مترو الأنفاق أو القطار أو الترام أو السكك الحديدية

توفّر واجهة برمجة التطبيقات لمصفوفة المسافة المعلومات استنادًا إلى المسار المقترَح بين نقطتي البداية والنهاية. يمكنك طلب هذه الأنواع من بيانات المسافة:

  • المسافة لوضع السفر الذي تم اختياره
  • المسافة بالكيلومتر أو الأميال
  • الوقت التقديري للسفر في حركة المرور

خريطة تعرض نقطة الانطلاق والوجهات على خريطة وفي الردّ من واجهة برمجة التطبيقات

آلية عمل واجهة برمجة التطبيقات لمصفوفة المسافة

تستخدم واجهة برمجة التطبيقات لمصفوفة المسافات أي عدد من الأصول (نقاط البداية) والوجهات، وتعرض المسافة ووقت السفر بين كل منها المصدر وجميع الوجهات المطلوبة، بدءًا من المصدر الأول في الطلب والمتابعة خطوة بخطوة إلى ما يلي.

على سبيل المثال، إذا حدَّد طلبك "أ" و"ب" كأصل، و"ج" و"د" كوجهتين، سيتم عرض المسافات ووقت السفر بهذا الترتيب:

  • من أ إلى ج
  • أ إلى ي
  • ب إلى ج
  • من ب إلى ي

يوضّح المثال التالي طلبًا لمصدرَين: واشنطن العاصمة وبوسطن، ولها وجهة واحدة، وهي مدينة نيويورك، ونيويورك، في تنسيق 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

الموارد

يلخص الجدول التالي الموارد المتاحة من خلال واجهة برمجة التطبيقات لمصفوفة المسافة مع البيانات التي تعرضها.

موارد البيانات تم إرجاع البيانات تنسيق الإرجاع
مصفوفة المسافة

احرص على توفير مصادر ووجهات الأماكن في شكل معرّفات الأماكن والعناوين أو إحداثيات خطوط العرض/خطوط الطول.

  • المسافة ومدة الرحلة بين كل نقطة انطلاق وكل منها الوجهة
  • المدة في حركة المرور إذا حددت وضع القيادة وقت المغادرة
  • JSON
  • XML

كيفية استخدام واجهة برمجة تطبيقات مصفوفة المسافة

1 بدء الإعداد ابدأ بـ إعداد مشروع Google Cloud وإكمال عملية الإعداد والتعليمات التالية.
2 تجربة طلب مصفوفة المسافة بمجرد حصولك على مفتاح واجهة برمجة التطبيقات، يمكنك البدء في اختبار واجهة برمجة تطبيقات مصفوفة المسافة مباشرةً من متصفحك. الاطّلاع على نماذج الطلبات في دليل البدء للاطّلاع على أمثلة.
3 إنشاء طلب أكثر تعقيدًا جرِّب طلبًا يوفّر عدّة مصادر ووجهات. التعلّم حول المعلمات الاختيارية لتقييد العمليات الحسابية، مثل معلمة أو وقت المغادرة أو قيود المسار. الاطّلاع على المَعلمات الاختيارية في دليل طلب واستجابة مصفوفة المسافة.
4 فهم أساسيات الردود يمكنك استكشاف استجابات البيانات للاستعداد لاستخدام بيانات مصفوفة المسافة لتطبيقك. عرض استجابات مصفوفة المسافة لمزيد من التفاصيل.
5 يمكنك دمج بيانات مصفوفة المسافة في تطبيقك. ويمكنك استخدام هذه البيانات لحساب مسافة السفر ووقته.

مكتبات العملاء المتاحة

استدعِ واجهة برمجة التطبيقات هذه بلغة حسب اختيارك من خلال إحدى مكتبات العملاء التالية:

عميل Java، وعميل Python، وعميل Go، وعميل Node.js لخرائط Google والخدمات هي مكتبات عملاء مدعومة من خلال المنتدى، وتكون مفتوحة المصدر ضمن ترخيص Apache 2.0: قم بتنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.

الخطوات التالية