このドキュメントでは、次の 2 つの機能を使用して、アプリのウェイポイント設定を管理する方法について説明します。
- 道路のどちら側を走行するかの設定
- 途中降機
道路のどちら側を走行するかの設定

デフォルトでは、Navigation SDK for iOS はウェイポイントへの最速ルートを検索しますが、ユーザーが目的の道路側(たとえば、ライドシェアのドライバーの顧客が待っている道路側)に到着するとは限りません。道路のどちら側を優先するかを指定するルーティング機能を使用すると、車両が道路の正しい側に到着するようにできます。
仕組み
道路の特定の側に到着する設定は、その停車地のウェイポイントを作成するときに設定します。この設定は、次の 2 つの方法のいずれかで指定できます。
道路の同じ側を優先する
ウェイポイントの地理座標を指定し、ウェイポイントと同じ側の道路(最寄りの歩道にスナップ)に到着することを指定するフラグ 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){...}];