بهترین شیوه‌های Isochrones API

روان بودن و وفاداری

شما می‌توانید ظاهر و دقت چندضلعی‌های خروجی را با استفاده از پارامترهای polygon_fidelity و enable_smoothing سفارشی کنید. اگرچه این گزینه‌ها مستقل هستند، اما برای تعیین شکل نهایی با هم کار می‌کنند.

  • polygon_fidelity : وضوح تصویر. اندازه سلول‌های شبکه زیرین (سلول‌های S2) مورد استفاده برای محاسبه مساحت قابل دسترسی را کنترل می‌کند.
    • LOW : از سلول‌های شبکه‌ای بزرگتر استفاده می‌کند. بهترین گزینه برای پوشش مناطق بزرگ بدون شکاف، که منجر به یک شکل کلی می‌شود.
    • MEDIUM : دقت متعادل.
    • HIGH : از سلول‌های شبکه‌ای کوچک‌تر استفاده می‌کند. منجر به تطابق بیشتر با شبکه جاده می‌شود، اما ممکن است نواحی خالی یا "حفره‌هایی" در جایی که شبکه جاده پراکنده است، ایجاد کند.
    • پیش‌فرض: اگر مشخص نشود، سرویس به صورت پویا بر اساس مدت زمان سفر درخواستی، میزان وفاداری را انتخاب می‌کند.
  • enable_smoothing : جنبه زیبایی‌شناختی. کنترل می‌کند که آیا لبه‌های تیز سلول‌های شبکه که توسط fidelity تعریف شده‌اند، گرد شده‌اند یا خیر.
    • false (خام): محاسبه هندسی دقیق را برمی‌گرداند. لبه‌ها دندانه‌دار یا پله‌ای به نظر می‌رسند و سلول‌های شبکه را منعکس می‌کنند. برای دقت تحلیلی، مانند آزمایش‌های دقیق نقطه در چندضلعی، بهترین گزینه است.
    • true (هموار شده): یک الگوریتم پس پردازش برای گرد کردن گوشه‌ها اعمال می‌کند. بهترین گزینه برای نمایش بصری روی نقشه‌ها.

نحوه تعامل آنها: فیدلیتی جزئیات پایه‌ای را که الگوریتم هموارسازی بر اساس آن عمل می‌کند، تعیین می‌کند.

  • دقت بالا + هموارسازی: شکلی با جزئیات و ظاهری طبیعی ایجاد می‌کند که از نزدیک انتهای جاده را دنبال می‌کند.
  • دقت پایین + هموارسازی: یک شکل "لکه" گسترده و عمومی ایجاد می‌کند.

اندازه بار مفید و رندرینگ

ایزوکرون‌های بزرگ می‌توانند شامل هزاران مختصات باشند و حجم داده‌ها می‌تواند بین ۳۰۰ تا ۵۰۰ کیلوبایت باشد.

  • پهنای باند: توجه داشته باشید که اندازه پاسخ JSON برای درخواست‌های با حداکثر مدت زمان، اهمیت زیادی دارد.
  • رندرینگ: رندرینگ چندضلعی‌های بسیار دقیق، عملکرد را تحت تأثیر قرار می‌دهد. استفاده از پارامتر enable_smoothing یا کتابخانه‌های ساده‌سازی سمت کلاینت را برای کاهش تعداد رأس‌ها برای نمایش در نظر بگیرید.

مدیریت خطا

منطق تلاش مجدد را با backoff نمایی برای خطاهای سرور 5xx پیاده‌سازی کنید. با این حال، بدون تغییر پارامترهای خود، خطاهای کلاینت 4xx را دوباره امتحان نکنید :

  • INVALID_ARGUMENT (400) : بررسی کنید که مدت زمان شما مثبت و در محدوده حالت انتخاب شده باشد، که حداکثر ۳۶۰۰ ثانیه برای DRIVE یا ۷۲۰۰ ثانیه برای حالت‌های دیگر است.
  • NOT_FOUND (404) : نقطه مبدا نتوانست به یک جاده متصل شود. سعی کنید مختصات را به یک خیابان شناخته شده نزدیک‌تر کنید یا مطمئن شوید که منطقه پشتیبانی می‌شود.