地点の管理

このドキュメントでは、次の 2 つの機能を使用してアプリの経由地設定を管理する方法について説明します。

  • 道路のどちら側を走行するかを設定する
  • ストップオーバー

道路のどちら側を優先するかを設定する

デフォルトでは、iOS 向け Navigation SDK は経由地への最短ルートを検索しますが、このルートでは、ユーザーが希望する道路の側（たとえば、ライドシェアのドライバーの顧客が待っている道路の側）に到着するとは限りません。道路のどちら側を優先するか機能を使用すると、車両が道路の正しい側に到着するようにできます。

仕組み

道路の特定の側に到着する設定は、その停車地の経由地を作成するときに行います。設定は次の 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){...}];