Package google.maps.isochrones.v1

Chỉ mục

IsochroneService

Dịch vụ tính toán đường đẳng thời. Đường đẳng thời là một khu vực có phạm vi có thể đến được từ một điểm xuất phát nhất định trong một khoảng thời gian di chuyển cụ thể.

GenerateIsochrone

rpc GenerateIsochrone(GenerateIsochroneRequest) returns (GenerateIsochroneResponse)

Tính toán và trả về một đường đẳng thời cho một tập hợp tham số nhất định.

GenerateIsochroneRequest

Yêu cầu tạo một đường đẳng thời.

Trường
travel_duration

Duration

Bắt buộc. Thời gian di chuyển để tính toán đường đẳng thời. Giá trị phải là số dương và tối đa là 7200 giây (120 phút). Đối với chế độ LÁI XE, thời lượng tối đa cho phép là 3600 giây (60 phút).

travel_mode

TravelMode

Bắt buộc. Phương thức di chuyển.

travel_direction

TravelDirection

Bắt buộc. Hướng di chuyển.

routing_preference

RoutingPreference

Không bắt buộc. Chỉ định lựa chọn ưu tiên về cách định tuyến. Giá trị mặc định là TRAFFIC_UNAWARE.

enable_smoothing

bool

Không bắt buộc. Chỉ định xem có làm mượt các cạnh của đa giác đường đẳng thời kết quả hay không.

polygon_fidelity

PolygonFidelity

Không bắt buộc. Kiểm soát độ chính xác của đa giác được tạo. Giá trị mặc định là POLYGON_FIDELITY_UNSPECIFIED.

Trường nhóm origin. Bắt buộc. Điểm xuất phát để tính toán đường đẳng thời. origin chỉ có thể là một trong những giá trị sau:
location

LatLng

Điểm xuất phát dưới dạng toạ độ vĩ độ/kinh độ.

place

string

Tên tài nguyên của một địa điểm, ở định dạng places/{place_id}.

PolygonFidelity

Kiểm soát mức độ chi tiết trong đa giác đường đẳng thời.

Enum
POLYGON_FIDELITY_UNSPECIFIED Không chỉ định độ chính xác của đa giác. Máy chủ sẽ sử dụng giá trị mặc định dựa trên thời gian di chuyển.
LOW Độ chính xác thấp. Phù hợp để bao phủ các khu vực rộng lớn với ít đỉnh hơn.
MEDIUM Độ chính xác trung bình. Cân bằng giữa mức độ chi tiết và kích thước cấu phần phần mềm.
HIGH Độ chính xác cao. Các cạnh có độ chính xác cao, nhưng có thể tạo ra các lỗ trong đa giác khi mật độ mạng lưới đường bộ thấp.

RoutingPreference

Xác định cách kết hợp tình trạng giao thông vào phép tính.

Enum
ROUTING_PREFERENCE_UNSPECIFIED Không chỉ định lựa chọn ưu tiên về định tuyến. Máy chủ sẽ sử dụng giá trị mặc định là TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Phép tính sẽ không xem xét tình trạng giao thông. Đường đẳng thời sẽ dựa trên mạng lưới đường bộ và thời gian di chuyển tĩnh. Điều này phù hợp cho mục đích lập kế hoạch khi giao thông không phải là yếu tố cần cân nhắc.
TRAFFIC_AWARE Phép tính sẽ tính đến các điều kiện giao thông thực tế.

TravelDirection

Chỉ định hướng di chuyển để tính toán đường đẳng thời.

Enum
TRAVEL_DIRECTION_UNSPECIFIED Không chỉ định hướng di chuyển.
FROM Tính toán khu vực có thể tiếp cận được từ điểm xuất phát. Ví dụ: "Tôi có thể giao hàng ở đâu trong vòng 30 phút từ kho của mình?"
TO Tính toán khu vực mà bạn có thể di chuyển đến điểm xuất phát. Ví dụ: "Nhân viên của tôi có thể đi làm từ đâu để đến văn phòng trong vòng 30 phút?"

TravelMode

Xác định phương thức di chuyển để tính toán đường đẳng thời.

Enum
TRAVEL_MODE_UNSPECIFIED Không chỉ định phương thức di chuyển.
DRIVE Di chuyển bằng xe chở khách.
BICYCLE Di chuyển bằng xe đạp.
WALK Di chuyển bằng cách đi bộ.

GenerateIsochroneResponse

Phản hồi chứa dữ liệu đường đẳng thời được tạo.

Trường
isochrone

Isochrone

Chỉ có đầu ra. Đường đẳng thời được tạo.

Isochrone

Kết quả của phép tính đường đẳng thời, biểu thị một khu vực có phạm vi có thể đến được từ một điểm xuất phát trong một khoảng thời gian di chuyển cụ thể.

Trường
Trường nhóm geometry. Biểu diễn hình học của đường đẳng thời. geometry chỉ có thể là một trong những giá trị sau:
geo_json

Struct

Hình học đường đẳng thời ở định dạng GeoJSON, sử dụng định dạng RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.