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

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

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

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

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

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

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

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

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

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

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

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

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

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

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