Bản dùng thử: Sản phẩm hoặc tính năng này đang ở trạng thái giai đoạn trước khi phát hành rộng rãi. Các sản phẩm và tính năng ở giai đoạn trước khi phát hành rộng rãi có thể có chế độ hỗ trợ hạn chế và các thay đổi đối với sản phẩm và tính năng ở giai đoạn trước khi phát hành rộng rãi có thể không tương thích với các phiên bản ở giai đoạn trước khi phát hành rộng rãi khác. Các Sản phẩm giai đoạn trước khi phát hành rộng rãi tuân theo Điều khoản dịch vụ dành riêng cho Google Maps Platform. Để biết thêm thông tin, hãy xem phần mô tả về giai đoạn phát hành .

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

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 phương tiện đi lại (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 sẽ thay đổi theo 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.
Định dạng: Vì API sử dụng google.protobuf.Duration, nên thời lượng phải được định dạng dưới dạng một chuỗi kết thúc bằng "s" (ví dụ: "3600s") thay vì một số nguyên.

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

Bạn có thể chỉ định điểm bắt đầu 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 đều 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 chụp nhanh 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 đi bộ và vỉa hè.
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.

Hướng đi (Đi vào so với Đi ra)

Bạn có thể tính toán khả năng tiếp cận cả chiều đi và chiều về bằng tham số travelDirection:

FROM (Đi): Tính toán khu vực có thể tiếp cận từ điểm xuất phát trong giới hạn thời gian đã chỉ định. Điều này phù hợp với các trường hợp sử dụng như vùng giao hàng hoặc phạm vi cung cấp dịch vụ.
TO (Đến): Tính toán khu vực mà bạn có thể di chuyển đến điểm xuất phát trong giới hạn thời gian đã chỉ định. Điều này phù hợp để xác định các vùng thu hút, chẳng hạn như nơi nhân viên có thể đi làm để đến văn phòng trung tâm.

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 cho 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ưu ý: Tính năng định tuyến dựa trên lưu lượng truy cập chỉ được hỗ trợ khi travelMode được đặt thành DRIVE.

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 bạn không 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 (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. Thích hợp nhất để hiển thị trực quan trên bản đồ.
  
  Đường đẳng thời có và không có tính năng làm mượt