Distance Matrix API

تحسب Matrix API أوقات السفر والمسافات بين كل تركيبة ممكنة من نقاط الانطلاق والوجهات في طلب واحد. تشمل حالات الاستخدام النموذجية إيجاد أقرب سائق أو فني لمهمة معينة، وحل مشكلات توجيه المركبات، وتقدير نوافذ وقت التوصيل للعملاء، وحساب تغطية منطقة الخدمة لتخطيط المرافق.

تُرجع Directions API مسارًا واحدًا مفصلًا بين نقطتين يشمل تعليمات الانعطاف والهندسة. بينما تُرجع Matrix API جدولًا بالمسافات والفترات الزمنية لأزواج متعددة من الانطلاق والوجهة دون هندسة المسار. إذا كنت بحاجة إلى مقارنة مواقع كثيرة بكفاءة، فإن Matrix API أسرع وأكثر فعالية من حيث التكلفة من إجراء استدعاءات Directions فردية.

تدعم الواجهة مصفوفات تصل إلى 100 نقطة انطلاق في مقابل 100 وجهة في طلب واحد، مما يُعطي ما يصل إلى 10,000 زوج من نقاط الانطلاق والوجهات لكل استدعاء. لا يلزم أن تكون المصفوفات مربعة: يمكنك إرسال نقطة انطلاق واحدة في مقابل 100 وجهة للبحث عن أقرب موقع، أو 50 في مقابل 50 لتعيين أسطول كامل إلى عملاء.

تدعم Matrix API القيادة والمشي وركوب الدراجات والنقل العام. يُعيَّن وضع السفر لكل طلب. تستخدم جميع الأزواج في طلب واحد الوضع نفسه. إذا احتجت إلى نتائج بأوضاع مختلطة، أرسل طلبات منفصلة لكل وضع ودمّج الاستجابات في تطبيقك.

تستخدم Matrix API افتراضيًا سرعات السير الحر التمثيلية لظروف السفر النموذجية. تتوفر الفترات الزمنية المعدَّلة وفق حركة المرور الفعلية في الخطط المؤهلة. اضبط معامل departure_time على طابع زمني مستقبلي للحصول على تقديرات سفر تبعًا لوقت اليوم استنادًا إلى أنماط حركة المرور التاريخية.

أرسل موقع الاستعلام الواحد كنقطة انطلاق وقائمة المواقع المرشحة كوجهات. تُرجع الواجهة وقت السفر والمسافة من نقطة الاستعلام إلى كل مرشح في استدعاء واحد. رتّب الاستجابة حسب الفترة الزمنية للعثور على الخيار الأقرب. هذا أكثر كفاءة بكثير من استدعاء Directions API في حلقة تكرار لكل مرشح.