Các phương pháp hay nhất về Isochrones API

Làm mịn và độ trung thực

Bạn có thể tuỳ chỉnh giao diện và độ chính xác của các đa giác đầu ra bằng cách sử dụng các tham số polygon_fidelity và enable_smoothing. Mặc dù các lựa chọn này độc lập với nhau, nhưng chúng phối hợp với nhau để xác định hình dạng cuối cùng.

  • polygon_fidelity: Độ phân giải. Kiểm soát kích thước của các ô lưới cơ bản (ô S2) được dùng để tính toán khu vực có thể tiếp cận.
    • LOW: Sử dụng các ô lưới lớn hơn. Phù hợp nhất để bao phủ các khu vực rộng lớn mà không có khoảng trống, tạo ra một hình dạng tổng quát.
    • MEDIUM: Độ chính xác cân bằng.
    • HIGH: Sử dụng các ô lưới nhỏ hơn. Kết quả sẽ khớp hơn với mạng lưới đường bộ nhưng có thể tạo ra các khu vực trống hoặc "lỗ hổng" khi mạng lưới đường bộ thưa thớt.
    • Mặc định: Nếu không được chỉ định, dịch vụ sẽ tự động chọn độ trung thực dựa trên thời lượng chuyến đi được yêu cầu.
  • enable_smoothing: Tính thẩm mỹ. Kiểm soát xem các cạnh sắc của ô lưới do độ trung thực xác định có được làm tròn hay không.
    • false (Thô): Trả về phép tính hình học chính xác. Các cạnh xuất hiện lởm chởm hoặc có dạng bậc thang, phản ánh các ô lưới. Phù hợp nhất cho độ chính xác phân tích, chẳng hạn như các kiểm thử nghiêm ngặt về điểm trong đa giác.
    • true (Được làm mịn): Áp dụng một thuật toán xử lý hậu kỳ để làm tròn các góc. Phù hợp nhất để hiển thị trực quan trên bản đồ.

Cách chúng tương tác: Độ trung thực đặt chi tiết cơ bản mà thuật toán làm mịn tác động lên.

  • Độ trung thực cao + Làm mịn: Tạo ra một hình dạng chi tiết, tự nhiên và gần giống với đường kết thúc.
  • Độ trung thực thấp + Làm mịn: Tạo ra một hình dạng "đốm" rộng, tổng quát.

Kích thước và cách hiển thị tải trọng

Các đường đẳng thời lớn có thể chứa hàng nghìn toạ độ và tải trọng có thể nằm trong khoảng từ 300 đến 500 kilobyte.

  • Băng thông: Xin lưu ý rằng kích thước phản hồi JSON là đáng kể đối với các yêu cầu có thời lượng tối đa.
  • Kết xuất: Việc kết xuất các đa giác cực kỳ chi tiết sẽ ảnh hưởng đến hiệu suất. Hãy cân nhắc sử dụng tham số enable_smoothing hoặc các thư viện đơn giản hoá phía máy khách để giảm số lượng đỉnh cần hiển thị.

Xử lý lỗi

Triển khai logic thử lại với thuật toán đợi luỹ tiến cho lỗi máy chủ 5xx. Tuy nhiên, không thử lại lỗi ứng dụng 4xx mà không thay đổi các tham số của bạn:

  • INVALID_ARGUMENT (400): Kiểm tra để đảm bảo thời lượng của bạn là số dương và nằm trong giới hạn của chế độ đã chọn, tức là tối đa 3.600 giây đối với chế độ LÁI XE hoặc 7.200 giây đối với các chế độ khác.
  • NOT_FOUND (404): Điểm xuất phát không bám theo đường. Hãy thử di chuyển toạ độ đến gần một con đường đã biết hoặc đảm bảo khu vực đó được hỗ trợ.