Quản lý điểm tham chiếu

Tài liệu này mô tả cách bạn có thể quản lý các lựa chọn ưu tiên về điểm tham chiếu cho ứng dụng của mình bằng cách sử dụng 2 tính năng:

• Tùy chọn định tuyến bên cạnh
• Điểm dừng chân

Đặt bên của tuỳ chọn định tuyến đường

Theo mặc định, SDK Điều hướng dành cho iOS sẽ tìm tuyến đường nhanh nhất đến một điểm tham chiếu, tuy nhiên, điều này không đảm bảo rằng xe sẽ đến bên đường mà người tiêu dùng đang chờ. Tính năng Lựa chọn ưu tiên về việc định tuyến đường cho phép bạn đảm bảo rằng xe đến ở đúng phía đường.

Cách thức hoạt động

Bạn đặt lựa chọn ưu tiên để đến một phía cụ thể của đường khi tạo điểm tham chiếu cho điểm dừng đó. Bạn có thể chỉ định lựa chọn ưu tiên theo một trong 2 cách.

Ưu tiên phía cùng đường

Bạn cung cấp toạ độ địa lý của điểm tham chiếu, sau đó đặt một cờ preferSameSideOfRoad cho biết rằng bạn muốn đến cùng phía đường với điểm tham chiếu — được gắn với vỉa hè gần nhất.

(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
                                  title:(NSString *)title
                   preferSameSideOfRoad:(BOOL)preferSameSideOfRoad;

Lưu ý quan trọng: Trong một số tình huống, khi điểm tham chiếu được gắn vào bên của con đường gần nhất, đường gần nhất có thể không phải là đường phù hợp. Ví dụ: đó có thể là một con đường xung quanh người tiêu dùng đang chờ. Bạn có thể ngăn điều này xảy ra bằng cách sử dụng preferredSegmentHeading thay vì preferSameSideOfRoad (xem phần tiếp theo để biết thông tin chi tiết).

Tiêu đề phân đoạn ưu tiên

Bạn cung cấp toạ độ địa lý của điểm tham chiếu, sau đó cung cấp tiêu đề đến preferredSegmentHeading khớp với hướng của luồng giao thông ở cùng phía đường với người tiêu dùng đang chờ.

(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
                                  title:(NSString *)title
                preferredSegmentHeading:(int32_t)preferredSegmentHeading;

SDK Điều hướng sẽ chọn đoạn đường gần điểm tham chiếu nhất — có hướng làn đường căn chỉnh (trong phạm vi +/- 55 độ) với cạnh đường có điểm tham chiếu đang ở đó.

Đặt tùy chọn điểm dừng

Ở một số địa điểm, người lái xe không thể dừng xe an toàn (ví dụ: tại các khu vực trên cao, phà, địa điểm dưới lòng đất và các khu vực khác bị hạn chế đi lại). Tính năng Dừng di chuyển điểm tham chiếu đến một địa điểm lân cận nếu vị trí đó không phù hợp để xe dừng dừng. Khi bạn đặt vehicleStopover thành YES, điểm tham chiếu sẽ tự động được chuyển vị trí khi tính toán tuyến đường, nếu có vị trí thay thế.

Cách thức hoạt động

Bạn đặt tuỳ chọn cho điểm dừng khi tạo điểm tham chiếu cho điểm dừng đó. Để thực hiện việc này, hãy đặt lựa chọn ưu tiên cho một điểm dừng trên GMSNavigationMutableWaypoint như trong ví dụ sau:

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint = GMSNavigationMutableWaypoint(location: location, title: "waypoint from location")!
waypoint.vehicleStopover = true
mapView.navigator?.setDestinations([waypoint], routingOptions: routingOptions, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationMutableWaypoint *waypoint =
    [[GMSNavigationMutableWaypoint alloc] initWithLocation:location
                                                     title:@"waypoint from location"];
waypoint.vehicleStopover = YES;
[_mapView.navigator setDestinations:@[waypoint1]
                     routingOptions:routingOptions
                           callback:^(GMSRouteStatus routeStatus){...}];