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