نظرة عامة على Distance Matrix API (الإصدار القديم)

مطوّرو المنطقة الاقتصادية الأوروبية (EEA)

مقدمة

‫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 (الإصدار القديم) أي عدد من نقاط الانطلاق (نقاط البداية) والوجهات، وتعرض المسافة ومدة الرحلة بين كل نقطة انطلاق وجميع الوجهات المطلوبة، بدءًا من نقطة الانطلاق الأولى في الطلب والانتقال خطوة بخطوة إلى النقطة التالية.

على سبيل المثال، إذا كان طلبك يحدّد A وB كنقطتَي انطلاق وC وD كوجهتَين، سيعرض المسافات ومدة الرحلة بهذا الترتيب:

  • من A إلى C
  • من A إلى D
  • من B إلى C
  • من 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

الموارد

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

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

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

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

كيفية استخدام Distance Matrix API (الإصدار القديم)

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

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

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

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

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