管理路線控點

本文說明如何使用下列兩項功能,管理應用程式的路線控點偏好設定:

  • 道路單側/兩側路線偏好設定
  • 中途停留

設定道路側邊路線偏好設定

根據預設,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){...}];