يمكنك تجربة الجيل التالي من ميزات مصفوفة المسافة مع Routes API التي تتوفّر الآن في المعاينة.

نظرة عامة على واجهة برمجة التطبيقات لمصفوفة المسافة

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

توفر واجهة برمجة التطبيقات لمصفوفة المسافات مسافة السفر والوقت لمصفوفة المنشأ والوجهات، وتتكون من صفوف تحتوي على قيم duration وdistance لكل زوج. تتوفر مصفوفة المسافة بعدة أشكال:

ما أهمية واجهة برمجة التطبيقات لمصفوفة المسافات؟

تعرض واجهة برمجة التطبيقات المعلومات استنادًا إلى المسار الموصى به بين نقاط البداية والنهاية. يمكنك طلب بيانات المسافة لأوضاع السفر المختلفة، وطلب بيانات المسافة بوحدات مختلفة مثل الكيلومترات أو الأميال، وتقدير وقت السفر في حركة المرور.

للحصول على المزيد من الأمثلة، راجع دليل مطوّر واجهة برمجة التطبيقات لمصفوفة المسافات، الذي يوفر مقدمة حول استخدام واجهة برمجة التطبيقات والمواد المرجعية حول المعلمات المتاحة.

لماذا نستخدم مصفوفة المسافة؟

يمكنك استخدام واجهة برمجة التطبيقات لمصفوفة المسافات عندما يتطلب حلك المسافة ومدة السفر بين قائمة كبيرة من نقاط المنشأ.

إذا كنت تريد استخدام وظيفة مصفوفة المسافة والحصول على تسلسل الطلبات والتسلسل التسلسلي للردود وعمليات إعادة المحاولة التلقائية وبعض التحقُّق من صحة الطلبات للعملاء، يمكنك تجربة إحدى مكتبات العملاء. إذا كنت تستخدم واجهة برمجة تطبيقات JavaScript للخرائط، استخدِم خدمة مصفوفة المسافة للحصول على وظيفة واجهة برمجة التطبيقات لمصفوفة المسافات.

كيفية استخدام مصفوفة المسافة

يمكنك الوصول إلى واجهة برمجة التطبيقات لمصفوفة المسافات من خلال واجهة HTTP، مع الطلبات التي تم إنشاؤها كسلسلة عناوين URL، وتمرّر الأصول والوجهات، بالإضافة إلى مفتاح واجهة برمجة التطبيقات.

  1. إذا كنت تريد استخدام إحدى مكتبات العملاء بدلاً من واجهة برمجة تطبيقات مصفوفة المسافة المستقلة أو خدمة الويب من جهة العميل، يمكنك تنزيلها وتثبيتها. تعرَّف على مكتبات العملاء.
  2. اختر مشروعًا أو أنشئه، ومكّن الفوترة، ومكّن واجهة برمجة التطبيقات لمصفوفة المسافات. يُرجى الاطِّلاع على الإعداد في Cloud Console.
  3. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات وتقييده وإضافته إلى الرمز. راجع استخدام مفتاح واجهة برمجة تطبيقات.
  4. عرض طلب مصفوفة المسافة والرد عليها وتجربة نموذج طلب.

المحتوى المقترَح