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

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

سبب استخدام Distance Matrix API

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

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

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

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

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

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

آلية عمل Distance Matrix API

تستخدِم Distance 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

الموارد

يلخِّص الجدول التالي الموارد المتاحة من خلال واجهة برمجة التطبيقات Distance Matrix API بالإضافة إلى البيانات التي تعرِضها.

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

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

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

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

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

مكتبات البرامج المتاحة

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

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

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