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

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

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

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

الإجراءات التي يمكنك تنفيذها باستخدام Distance Matrix API

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

تقدّم Distance 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

كيفية استخدام Distance Matrix API

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

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

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

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

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