مقدمة
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 (القديمة) أي عدد من نقاط الانطلاق (نقاط البداية) والوجهات، وتعرض المسافة ومدة الرحلة بين كل نقطة انطلاق وجميع الوجهات المطلوبة، بدءًا من نقطة الانطلاق الأولى في الطلب والانتقال خطوة بخطوة إلى النقطة التالية.
على سبيل المثال، إذا حدّد طلبك "أ" و"ب" كنقاط انطلاق، و"ج" و"د" كوجهات، ستظهر المسافات ومدة الرحلة بهذا الترتيب:
- من أ إلى ج
- من (أ) إلى (د)
- B to 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 (الإصدار القديم) بالإضافة إلى البيانات التي تعرضها.
| مصادر البيانات | البيانات التي تم عرضها | تنسيق الإرجاع |
|---|---|---|
| مصفوفة المسافات
أدخِل نقاط الانطلاق والوجهات على شكل أرقام تعريف أماكن أو عناوين أو إحداثيات خطوط العرض/الطول. |
|
|
كيفية استخدام Distance Matrix API (الإصدار القديم)
| 1 | البدء | ابدأ بإعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد التالية. |
| 2 | تجربة طلب مصفوفة المسافات | بعد الحصول على مفتاح واجهة برمجة التطبيقات، يمكنك البدء في اختبار Distance Matrix API (الإصدار القديم) مباشرةً من متصفّحك. يمكنك الاطّلاع على نماذج الطلبات في دليل البدء للحصول على أمثلة. |
| 3 | إنشاء طلب أكثر تعقيدًا | جرِّب طلبًا يوفّر نقاط انطلاق ووجهات متعددة. تعرَّف على المَعلمات الاختيارية لتقييد العمليات الحسابية، مثل وقت مغادرة محدّد أو قيود على المسار. يمكنك الاطّلاع على المَعلمات الاختيارية في دليل طلب Distance Matrix (الإصدار القديم) والردّ عليه. |
| 4 | التعرّف على أساسيات الردود | استكشِف الردود على البيانات للاستعداد لاستخدام بيانات مصفوفة المسافة في تطبيقك. يُرجى الاطّلاع على الردود على مصفوفة المسافة لمعرفة التفاصيل. |
| 5 | يمكنك دمج بيانات مصفوفة المسافات في تطبيقك الخاص. | يمكنك استخدام هذه البيانات لاحتساب مسافة السفر ومدته. |
مكتبات العملاء المتاحة
يمكنك طلب بيانات واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات البرامج التالية:
- برنامج Java العميل لخدمات "خرائط Google"
- برنامج Python لخدمات "خرائط Google"
- Go Client for Google Maps Services
- عميل Node.js لخدمات "خرائط Google"
إنّ عميل Java وعميل Python وعميل Go وعميل Node.js لخدمات "خرائط Google" هي مكتبات عملاء يدعمها المنتدى، وهي مفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت والرمز النموذجي.
الخطوات التالية
- بدء استخدام Distance Matrix (Legacy): انتقِل إلى البدء.
- البدء باستخدام نماذج الطلبات والردود: انتقِل إلى طلب Distance Matrix والردّ عليه.
- اتّباع أفضل الممارسات: انتقِل إلى أفضل ممارسات خدمة الويب.