التسوية والدقة
يمكنك تخصيص مظهر المضلعات الناتجة ودقتها باستخدام المعلَمتَين 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 وTWO_WHEELER، أو 7,200 ثانية للأوضاع الأخرى.NOT_FOUND (404): تعذّر ربط نقطة المصدر بطريق. حاول نقل الإحداثية بالقرب من شارع معروف أو تأكَّد من أنّ المنطقة متوافقة.