توفر واجهة برمجة التطبيقات لمصفوفة المسافات مسافة السفر والوقت لمصفوفة المنشأ والوجهات، وتتكون من صفوف تحتوي على قيم duration
وdistance
لكل زوج. تتوفر مصفوفة المسافة بعدة أشكال:
- كواجهة برمجة تطبيقات مستقلة
- كجزء من واجهة برمجة تطبيقات JavaScript للخرائط من جهة العميل
- للاستخدام من جانب الخادم كجزء من مكتبات العملاء لخدمات ويب خرائط Google
ما أهمية واجهة برمجة التطبيقات لمصفوفة المسافات؟
تعرض واجهة برمجة التطبيقات المعلومات استنادًا إلى المسار الموصى به بين نقاط البداية والنهاية. يمكنك طلب بيانات المسافة لأوضاع السفر المختلفة، وطلب بيانات المسافة بوحدات مختلفة مثل الكيلومترات أو الأميال، وتقدير وقت السفر في حركة المرور.
للحصول على المزيد من الأمثلة، راجع دليل مطوّر واجهة برمجة التطبيقات لمصفوفة المسافات، الذي يوفر مقدمة حول استخدام واجهة برمجة التطبيقات والمواد المرجعية حول المعلمات المتاحة.
لماذا نستخدم مصفوفة المسافة؟
يمكنك استخدام واجهة برمجة التطبيقات لمصفوفة المسافات عندما يتطلب حلك المسافة ومدة السفر بين قائمة كبيرة من نقاط المنشأ.
إذا كنت تريد استخدام وظيفة مصفوفة المسافة والحصول على تسلسل الطلبات والتسلسل التسلسلي للردود وعمليات إعادة المحاولة التلقائية وبعض التحقُّق من صحة الطلبات للعملاء، يمكنك تجربة إحدى مكتبات العملاء. إذا كنت تستخدم واجهة برمجة تطبيقات JavaScript للخرائط، استخدِم خدمة مصفوفة المسافة للحصول على وظيفة واجهة برمجة التطبيقات لمصفوفة المسافات.
كيفية استخدام مصفوفة المسافة
يمكنك الوصول إلى واجهة برمجة التطبيقات لمصفوفة المسافات من خلال واجهة HTTP، مع الطلبات التي تم إنشاؤها كسلسلة عناوين URL، وتمرّر الأصول والوجهات، بالإضافة إلى مفتاح واجهة برمجة التطبيقات.
- إذا كنت تريد استخدام إحدى مكتبات العملاء بدلاً من واجهة برمجة تطبيقات مصفوفة المسافة المستقلة أو خدمة الويب من جهة العميل، يمكنك تنزيلها وتثبيتها. تعرَّف على مكتبات العملاء.
- اختر مشروعًا أو أنشئه، ومكّن الفوترة، ومكّن واجهة برمجة التطبيقات لمصفوفة المسافات. يُرجى الاطِّلاع على الإعداد في Cloud Console.
- يمكنك إنشاء مفتاح واجهة برمجة تطبيقات وتقييده وإضافته إلى الرمز. راجع استخدام مفتاح واجهة برمجة تطبيقات.
- عرض طلب مصفوفة المسافة والرد عليها وتجربة نموذج طلب.
المحتوى المقترَح
- مكتبات العملاء - استخدم إحدى مكتبات العملاء التي تتضمن وظائف واجهات برمجة تطبيقات متعددة بما في ذلك مصفوفة المسافات.
- أفضل ممارسات خدمة الويب - تعرّف على العديد من أفضل الممارسات لاستخدام مصفوفة المسافة والعمل معها.
- ملاحظات الإصدار - اطلع على ملاحظات الإصدار لمصفوفة المسافات.
- الحصة ومعلومات الفوترة - ابحث عن وحدات الفوترة والتكاليف لمصفوفة المسافة.
- السياسات والقيود - استيعاب القيود المفروضة على استخدام مصفوفة المسافة.