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