แนวทางปฏิบัติแนะนำสำหรับ Isochrone API

การปรับให้เรียบและแม่นยำ

คุณสามารถปรับแต่งลักษณะที่ปรากฏและความแม่นยำของรูปหลายเหลี่ยมเอาต์พุตได้โดยใช้พารามิเตอร์ polygon_fidelity และ enable_smoothing แม้ว่าตัวเลือกเหล่านี้จะทำงานแยกกัน แต่ก็ทำงานร่วมกันเพื่อกำหนดรูปร่างสุดท้าย

• polygon_fidelity: ความละเอียด ควบคุมขนาดของเซลล์กริดพื้นฐาน (เซลล์ S2) ที่ใช้ในการคำนวณพื้นที่ที่เข้าถึงได้
  • LOW: ใช้เซลล์กริดขนาดใหญ่ เหมาะสำหรับการครอบคลุมพื้นที่ขนาดใหญ่โดยไม่มีช่องว่าง ซึ่งจะทำให้ได้รูปร่างทั่วไป
  • MEDIUM: ความแม่นยำที่สมดุล
  • HIGH: ใช้เซลล์กริดขนาดเล็ก ทำให้พอดีกับเครือข่ายถนนมากขึ้น แต่อาจทำให้เกิดพื้นที่ว่างหรือ "รู" ในบริเวณที่เครือข่ายถนนเบาบาง
  • ค่าเริ่มต้น: หากไม่ได้ระบุไว้ บริการจะเลือกความแม่นยำแบบไดนามิกตามระยะเวลาการเดินทางที่ขอ

เคล็ดลับ: ลดรูในรูปหลายเหลี่ยม
เนื่องจากไอโซโครนคำนวณระยะที่เดินทางถึงได้โดยใช้เครือข่ายถนนจริง พื้นที่ที่มีถนนเบาบาง เช่น สวนสาธารณะขนาดใหญ่ พื้นที่ส่วนตัวที่ไม่ได้ทำแผนที่ หรือเขตอุตสาหกรรม อาจปรากฏเป็น "รู" ที่ไม่สามารถเข้าถึงได้ภายในรูปหลายเหลี่ยมที่สร้างขึ้น หากกรณีการใช้งานของคุณต้องใช้พื้นที่ครอบคลุมทั่วไปแบบทึบโดยไม่มีช่องว่างเหล่านี้ ให้ตั้งค่า polygon_fidelity เป็น MEDIUM หรือ LOW อย่างชัดเจน

• enable_smoothing: ความสวยงาม ควบคุมว่าจะปัดขอบคมของเซลล์กริดที่กำหนดโดยความแม่นยำหรือไม่
  • false (ดิบ): แสดงผลการคำนวณทางเรขาคณิตที่แน่นอน ขอบจะปรากฏเป็นหยักๆ หรือเป็นขั้นๆ ซึ่งสะท้อนถึงเซลล์กริด เหมาะสำหรับความแม่นยำในการวิเคราะห์ เช่น การทดสอบจุดในรูปหลายเหลี่ยมที่เข้มงวด
  • true (ปรับให้เรียบ): ใช้การประมวลผลภายหลังด้วยอัลกอริทึมเพื่อปัดมุม เหมาะสำหรับการแสดงภาพบนแผนที่

วิธีที่พารามิเตอร์เหล่านี้ทำงานร่วมกัน: ความแม่นยำจะกำหนด รายละเอียดพื้นฐาน ที่อัลกอริทึมการปรับให้เรียบ จะทำงาน

• ความแม่นยำสูง + การปรับให้เรียบ: สร้างรูปร่างที่มีรายละเอียดและดูเป็นธรรมชาติซึ่งเป็นไปตามจุดสิ้นสุดของถนน
• ความแม่นยำต่ำ + การปรับให้เรียบ: สร้างรูปร่าง "หยด" ทั่วไปแบบกว้าง

ขนาดเพย์โหลดและการแสดงผล

ไอโซโครนขนาดใหญ่อาจมีพิกัดหลายพันรายการ และเพย์โหลดอาจมีขนาดระหว่าง 300 ถึง 500 กิโลไบต์

• แบนด์วิดท์: โปรดทราบว่าขนาดการตอบกลับ JSON มีนัยสำคัญสำหรับคำขอระยะเวลาสูงสุด
• การแสดงผล: การแสดงผลรูปหลายเหลี่ยมที่มีรายละเอียดมากเกินไปจะส่งผลต่อประสิทธิภาพ ลองใช้พารามิเตอร์ enable_smoothing หรือไลบรารีการลดความซับซ้อนฝั่งไคลเอ็นต์เพื่อลดจำนวนจุดยอดสำหรับการแสดงผล

การจัดการข้อผิดพลาด

ใช้ตรรกะการลองใหม่ด้วย Exponential Backoff สำหรับข้อผิดพลาดของเซิร์ฟเวอร์ 5xx อย่างไรก็ตาม อย่า ลองใหม่สำหรับข้อผิดพลาดของไคลเอ็นต์ 4xx โดยไม่เปลี่ยนพารามิเตอร์

• INVALID_ARGUMENT (400): ตรวจสอบว่าระยะเวลาเป็นค่าบวกและอยู่ภายในขีดจำกัดสำหรับโหมดที่เลือก ซึ่งไม่เกิน 3,600 วินาทีสำหรับโหมดขับรถ หรือ 7,200 วินาทีสำหรับโหมดอื่นๆ
• NOT_FOUND (404): จุดเริ่มต้นไม่สามารถจัดพอดีกับถนนได้ ลองย้ายพิกัดให้ใกล้กับถนนที่รู้จักหรือตรวจสอบว่าระบบรองรับภูมิภาคนั้น