التنعيم والدقة
يمكنك تخصيص مظهر المضلّعات الناتجة ودقتها باستخدام المَعلمتَين polygon_fidelity وenable_smoothing. على الرغم من أنّ هذه الخيارات مستقلة، إلا أنّها تعمل معًا لتحديد الشكل النهائي.
polygon_fidelity: الدقة تتحكّم هذه السمة في حجم خلايا الشبكة الأساسية (خلايا S2) المستخدَمة لحساب المساحة التي يمكن الوصول إليها.LOW: تستخدم خلايا شبكة أكبر، وهي الأفضل لتغطية مساحات كبيرة بدون فجوات، ما يؤدي إلى شكل عام.-
MEDIUM: دقة متوازنة HIGH: تستخدم خلايا شبكة أصغر، ما يؤدي إلى تطابق أفضل مع شبكة الطرق، ولكن قد ينتج عن ذلك مناطق فارغة أو "ثقوب" في المناطق التي تكون فيها شبكة الطرق قليلة.- القيمة التلقائية: إذا لم يتم تحديدها، تختار الخدمة مستوى الدقة بشكل ديناميكي استنادًا إلى مدة الرحلة المطلوبة.
enable_smoothing: الجانب الجمالي، ويتحكّم في ما إذا كانت الحواف الحادة لخلايا الشبكة المحدّدة بواسطة الدقة سيتم تقريبها.false(الأولي): تعرض هذه السمة الحساب الهندسي الدقيق، وتظهر الحواف بشكل متعرّج أو متدرّج، ما يعكس خلايا الشبكة. وتكون هذه السمة الأفضل للدقة التحليلية، مثل اختبارات النقطة في المضلّع الصارمة.true(تمّت تسويته): يتم تطبيق خوارزمية معالجة لاحقة لتقريب الزوايا. الأفضل للعرض المرئي على الخرائط
طريقة التفاعل: تحدّد الدقة التفاصيل الأساسية التي تعمل عليها خوارزمية التنعيم.
- الدقة العالية والتنعيم: ينتج عنه شكل تفصيلي طبيعي المظهر يتطابق بشكل وثيق مع نهايات الطرق.
- الدقة المنخفضة + التنعيم: ينتج عنه شكل "بقعة" عامة وواسعة.
حجم الحمولة وعرضها
يمكن أن تحتوي منحنيات تساوي الزمن الكبيرة على آلاف الإحداثيات، ويمكن أن يتراوح حجم الحمولة بين 300 و500 كيلوبايت.
- النطاق الترددي: يُرجى العِلم أنّ حجم استجابة JSON كبير بالنسبة إلى طلبات المدة القصوى.
- العرض: يؤثر عرض المضلّعات التفصيلية للغاية في الأداء.
ننصحك باستخدام المَعلمة
enable_smoothingأو مكتبات التبسيط من جهة العميل لتقليل عدد الرؤوس المعروضة.
معالجة الأخطاء
نفِّذ منطق إعادة المحاولة مع التمهّل بين عمليات إعادة المحاولة لأخطاء الخادم 5xx، ولكن لا تعِد محاولة أخطاء العميل 4xx بدون تغيير المَعلمات:
INVALID_ARGUMENT (400): تأكَّد من أنّ المدة موجبة وضمن الحدّ الأقصى للوضع المحدّد، أي 3,600 ثانية كحدّ أقصى في وضع DRIVE أو 7,200 ثانية في الأوضاع الأخرى.NOT_FOUND (404): تعذّر محاذاة نقطة البداية مع طريق. جرِّب تقريب الإحداثيات من شارع معروف أو تأكَّد من أنّ المنطقة متوافقة.