管理航点

本文档介绍了如何使用以下两项功能管理应用的航点偏好设置：

  • 路线偏好设置 - 道路侧
  • 经停

设置路线偏好设置中的道路侧

默认情况下，适用于 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 度内）。

设置经停点偏好设置

在某些地方，用户无法安全停车（例如高架区域、渡轮、地下位置和其他限行区域）。如果航点的位置不适合用户停车，中途停留功能会将航点重新定位到附近的地点。将 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){...}];