本文說明如何使用下列兩項功能,管理應用程式的路線控點偏好設定:
- 道路單側/兩側路線偏好設定
- 中途停留
設定道路側邊路線偏好設定

根據預設,iOS 適用的 Navigation SDK 會找出前往路線控點的最快路線,但這不保證使用者會抵達道路的指定側,例如共乘司機的顧客等待的那一側。道路一側路線偏好設定功能可確保車輛抵達道路正確的一側。
運作方式
為停靠站建立路線控點時,您可以設定偏好在道路的哪一側抵達。您可以透過下列兩種方式之一指定偏好設定。
偏好道路同側
您提供路線控點的地理座標,然後設定 preferSameSideOfRoad 標記,表示您希望抵達路線控點所在道路的同一側 (貼齊最近的人行道)。
(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
title:(NSString *)title
preferSameSideOfRoad:(BOOL)preferSameSideOfRoad;
設定抵達航向
您需要提供路線控點的地理座標,以及與目的地同側道路車流方向一致的抵達方向 preferredSegmentHeading。
(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
title:(NSString *)title
preferredSegmentHeading:(int32_t)preferredSegmentHeading;
Navigation SDK 會選擇最靠近路線控點的道路路段,且該路段的車道方向與路線控點所在道路側邊一致 (在 +/- 55 度內)。
設定中途停留偏好
在某些地方,使用者無法安全停車 (例如高架區域、渡輪、地下位置和其他管制區域)。如果路線控點的位置不適合使用者停留,Stopover 功能會將路線控點移至附近地點。如果將 vehicleStopover 設為 YES,且有替代位置可用,系統會在計算路線時自動重新定位路線控點。
運作方式
建立中途點的路線控點時,可以設定中途點偏好設定。方法是在 GMSNavigationMutableWaypoint 上設定中途停留偏好設定,如以下範例所示:
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){...}];