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

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

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

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

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

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

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

• المسافة لوضع سفر محدّد
• المسافة بالكيلومتر أو الأميال
• مدة الرحلة المقدَّرة في حركة المرور

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

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

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

• أ إلى ج
• من أ إلى د
• ب إلى ج
• من B إلى D

يوضح المثال التالي طلبًا لمصدرَين: واشنطن العاصمة وبوسطن، وله وجهة واحدة، مدينة نيويورك، نيويورك، بتنسيق 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 لخدمات "خرائط Google"
• برنامج عميل Python لخدمات "خرائط Google"
• برنامج Go Client لخدمات "خرائط Google"
• برنامج Node.js لخدمات "خرائط Google"

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

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

• بدء استخدام مصفوفة المسافة: انتقِل إلى البدء.
• بدء استخدام نماذج الطلبات والردود: انتقِل إلى طلب مصفوفة المسافة والردّ عليها.
• اتّباع أفضل الممارسات: انتقِل إلى أفضل الممارسات بشأن خدمات الويب.