Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Khái niệm chính

Để tạo đường đẳng thời, hãy cung cấp cho API một điểm xuất phát, một chế độ di chuyển (chẳng hạn như lái xe, đạp xe hoặc đi bộ) và một giới hạn thời gian. Bạn cũng có thể điều chỉnh các lựa chọn ưu tiên về định tuyến và giao diện trực quan của đa giác kết quả.

Thời điểm nhất định

Ràng buộc chính mà bạn cung cấp cho dịch vụ là travel_duration. Điều này xác định khoảng thời gian để tính toán.

Thời lượng tối đa: API này hỗ trợ thời gian di chuyển tối đa là 3.600 giây (1 giờ) cho chế độ DRIVE và 7.200 giây (2 giờ) cho chế độ WALK và BICYCLE.
Hiệu suất: Thời gian tính toán tỷ lệ thuận với thời lượng được yêu cầu và chế độ di chuyển đã chọn. Đường đẳng thời lái xe trong một giờ bao phủ một khu vực địa lý và mạng lưới đường bộ lớn hơn đáng kể so với đường đẳng thời đi bộ trong một giờ, dẫn đến độ trễ cao hơn cho yêu cầu lái xe.

Điểm xuất phát và tính năng căn chỉnh đường

Bạn có thể chỉ định điểm xuất phát cho đường đẳng thời theo hai cách:

Toạ độ: Một cặp vĩ độ và kinh độ (location).
Mã địa điểm: Giá trị nhận dạng riêng biệt cho một địa điểm cụ thể trên Google Maps (place). Khi bạn cung cấp mã địa điểm, dịch vụ sẽ sử dụng tâm của địa điểm đó làm điểm xuất phát. Xin lưu ý rằng API này yêu cầu định dạng tên tài nguyên, chẳng hạn như places/ChIJ.... Để biết thêm thông tin về mã địa điểm, hãy xem bài viết Mã địa điểm.

Bất kể phương thức nhập nào, API sẽ không tính thời gian di chuyển từ điểm thực tế chính xác nếu điểm đó không nằm trên đường, chẳng hạn như bên trong công viên hoặc toà nhà. Để xử lý tình huống này, dịch vụ sẽ sử dụng tính năng căn chỉnh theo đường. Tính năng khớp đường có các đặc điểm sau:

Tính năng liên kết thông minh: Dịch vụ này sẽ cố gắng liên kết điểm xuất phát của bạn với đoạn đường gần nhất có thể đi qua.
Nhận biết chế độ: Logic liên kết sẽ xem xét travel_mode của bạn. Nếu bạn yêu cầu DRIVE, API sẽ bỏ qua các đường chỉ dành cho người đi bộ và tìm đường gần nhất có thể lái xe. Nếu bạn yêu cầu WALK, API sẽ ưu tiên các đường và vỉa hè có thể đi bộ.
Trường hợp thất bại: Nếu không tìm thấy đoạn đường phù hợp trong phạm vi khoảng 100 mét tính từ điểm xuất phát của bạn, API sẽ trả về lỗi 404 NOT_FOUND. Điều này thường cho biết rằng điểm đó ở quá xa mạng lưới đường hoặc ở một khu vực mà dữ liệu bản đồ không hỗ trợ chế độ di chuyển được yêu cầu.

Nhận biết về giao thông

Kiểm soát cách dữ liệu giao thông ảnh hưởng đến đa giác được tạo bằng tham số routing_preference:

TRAFFIC_UNAWARE (Mặc định): Sử dụng giới hạn tốc độ và phân cấp đường để tạo đa giác đẳng thời. Điều này tạo ra một hình dạng xác định không dao động dựa trên thời gian trong ngày. Tham số này phù hợp với hoạt động phân tích chung hoặc lập kế hoạch kịch bản cơ sở.
TRAFFIC_AWARE: Tính toán đường đẳng thời bằng cách sử dụng điều kiện giao thông thực tế hoặc dự đoán tại thời điểm đưa ra yêu cầu, khiến khu vực có thể tiếp cận bị thu hẹp trong thời gian tắc nghẽn và mở rộng trong thời gian thấp điểm.

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: Kiểm soát kích thước của các ô lưới cơ bản dùng để tính toán khu vực có thể truy cập.
- 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ả phù hợ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 nếu mạng lưới đường bộ thưa thớt.
- POLYGON_FIDELITY_UNSPECIFIED: 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.
  
  Độ trung thực cao, trung bình và thấp của đa giác
enable_smoothing: Kiểm soát việc các cạnh sắc của ô lưới do độ trung thực xác định có được bo tròn hay không.
- false (Thô): Mặc định. Trả về kết quả tính toán 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ù hợp nhất cho độ chính xác về 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. Độ trễ thấp hơn so với độ trễ được làm mượt.
- 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 đồ.
  
  Đường đẳng thời có làm mịn và không làm mịn