ナビゲーション イベントをリッスンする

このガイドを使用して、アプリがさまざまなイベントをリッスンして応答できるようにします。 ユーザーがルートを移動すると変化します。このガイドは、 ルートを定義します。ルート上のイベントにのみ応答します。

概要

Navigation SDK for iOS には、App Engine や Pub/Sub、 ユーザーの場所と経路上の条件に関連付けて 時間や距離に関する重要なデータです地図のビュー コントローラで、アプリが 次のリスナーにプロトコルを採用する必要があります。 GMSRoadSnappedLocationProviderListener および GMSNavigatorListener

ナビゲーション イベントで利用可能なリスナー メソッドの一覧を次に示します。

で確認できます。

コードの確認

必要なプロトコルへの適合宣言

ナビゲーション メソッドを実装する前に、ビュー コントローラで 機能:

Swift

class ViewController: UIViewController, GMSNavigatorListener,
GMSRoadSnappedLocationProviderListener {

Objective-C

@interface ViewController () <GMSNavigatorListener,
GMSRoadSnappedLocationProviderListener>

@end

ナビゲーション プロトコルを導入したら、リスナーをビューに設定する 表示されます。たとえば、次のコードを viewDidLoad() に追加します。 メソッドを呼び出します。

Swift

mapView.navigator?.add(self) mapView.roadSnappedLocationProvider?.add(self)

Objective-C

[_mapView.navigator addListener:self]; [_mapView.roadSnappedLocationProvider
addListener:self];

位置情報の更新を受信または停止する

ユーザーの進捗状況を地図に表示するためには、位置情報の更新が必要です。

location インスタンスは、次のプロパティを公開します。

Location プロパティ 説明
標高 現在の標高。
coordinate.latitude 道路スナップされた現在の緯度座標。
coordinate.longitude 道路スナップされた現在の経度座標。
コース 現在の方角(度単位)。
速度 現在の速度。
timestamp 現在の測定値の日付/時刻。

最新の位置情報を継続的に受け取るには、 mapView.roadSnappedLocationProvider.startUpdatingLocation を使用し、 GMSRoadSnappedLocationProviderListenerdidUpdateLocation を処理するため) イベントです。

次の例では、startUpdatingLocation を呼び出しています。

Swift

mapView.roadSnappedLocationProvider.startUpdatingLocation()

Objective-C

[_mapView.roadSnappedLocationProvider startUpdatingLocation];

次のコードは、GMSRoadSnappedLocationProviderListener を作成し、 didUpdateLocation イベントを処理します。

Swift

func locationProvider(_ locationProvider: GMSRoadSnappedLocationProvider,
didUpdate location: CLLocation) { print("Location: \(location.description)") }

Objective-C

-   (void)locationProvider:(GMSRoadSnappedLocationProvider *)locationProvider
    didUpdateLocation:(CLLocation *)location { NSLog(@"Location: %@",
    location.description); }

アプリがバックグラウンドで動作しているときに位置情報の更新を受信するには、 allowsBackgroundLocationUpdates を true に設定します。

Swift

mapView.roadSnappedLocationProvider.allowsBackgroundLocationUpdates = true

Objective-C

 _mapView.roadSnappedLocationProvider.allowsBackgroundLocationUpdates = YES;

到着イベントの検出

アプリは didArriveAtWaypoint イベントを使用して、デスティネーションが なります。案内を再開して次のウェイポイントに進むことができます。 continueToNextDestination() を呼び出してから、ガイダンスを再度有効にします。アプリ continueToNextDestination() を呼び出した後にガイダンスを再度有効にする必要があります。

アプリが continueToNextDestination を呼び出すと、ナビゲータが 前のデスティネーションに関するデータを 返すことができます特定のイベントに関する情報を をナビゲータから取得する必要があります。 continueToNextDestination()

次のコード例は、didArriveAtWaypoint を処理するメソッドを示しています。 event:

Swift

func navigator(_ navigator: GMSNavigator, didArriveAt waypoint:
GMSNavigationWaypoint) { print("You have arrived at: \(waypoint.title)")
mapView.navigator?.continueToNextDestination()
mapView.navigator?.isGuidanceActive = true }

Objective-C

-   (void)navigator:(GMSNavigator *)navigator
    didArriveAtWaypoint:(GMSNavigationWaypoint *)waypoint { NSLog(@"You have
    arrived at: %@", waypoint.title); [_mapView.navigator
    continueToNextDestination]; _mapView.navigator.guidanceActive = YES; }

ルート変更の更新を受信しています

ルートが変更されるたびに通知を受け取るには、 navigatorDidChangeRoute イベントを処理します。新しいルートには次の方法でアクセスできます GMSNavigatorrouteLegs プロパティと currentRouteLeg プロパティを使用します。

Swift

func navigatorDidChangeRoute(_ navigator: GMSNavigator) { print("The route has
changed.") }

Objective-C

-   (void)navigatorDidChangeRoute:(GMSNavigator *)navigator { NSLog(@"The route
    has changed."); }

目的地の更新までの所要時間

宛先までの更新時間を継続的に受け取るには、 didUpdateRemainingTime イベント。time パラメータは、 次の目的地に到着するまでの秒数。

Swift

func navigator(_ navigator: GMSNavigator, didUpdateRemainingTime time:
TimeInterval) { print("Time to next destination: \(time)") }

Objective-C

-   (void)navigator:(GMSNavigator *)navigator
    didUpdateRemainingTime:(NSTimeInterval)time { NSLog(@"Time to next
    destination: %f", time); }

次の目的地までの予想時間の最小変化を設定するには、 GMSNavigatortimeUpdateThreshold プロパティ。値は 秒です。このプロパティが設定されていない場合、サービスではデフォルト値の 1 が使用されます。 なります。

Swift

navigator?.timeUpdateThreshold = 10

Objective-C

navigator.timeUpdateThreshold = 10;

目的地までの距離の更新を受信しています

目的地までの距離を継続的に更新するには、 didUpdateRemainingDistance イベント。distance パラメータには、 次の目的地までの推定距離(メートル単位)。

Swift

func navigator(_ navigator: GMSNavigator, didUpdateRemainingDistance distance:
CLLocationDistance) { let miles = distance * 0.00062137 print("Distance to next
destination: \(miles) miles.") }

Objective-C

-   (void)navigator:(GMSNavigator *)navigator
    didUpdateRemainingDistance:(CLLocationDistance)distance { double miles =
    distance * 0.00062137; NSLog(@"%@", [NSString stringWithFormat:@"Distance to
    next destination: %.2f.", miles]); }

次の目的地までの推定距離の最小変化を設定するには、 GMSNavigatordistanceUpdateThreshold プロパティ(値は メートル)。このプロパティが設定されていない場合、サービスではデフォルト値の 1 が使用されます。 メートルです。

Swift

navigator?.distanceUpdateThreshold = 100

Objective-C

navigator.distanceUpdateThreshold = 100;

最新の交通情報を受信しています

残りのルートのトラフィック フローの継続的な更新を受け取るには、 didUpdateDelayCategory イベントを処理するメソッドを作成します。お客様への呼び出し delayCategoryToNextDestinationGMSNavigationDelayCategory を返します。これは、 0 ~ 3 の値を指定します。カテゴリの更新は、現在の アプリユーザーの位置。交通データが利用できない場合は GMSNavigationDelayCategory は 0 を返します。1 ~ 3 の数字は 軽いものから重いものへと流れていきます。

Swift

func navigator(_ navigator: GMSNavigator, didUpdate delayCategory:
GMSNavigationDelayCategory) { print("Traffic flow to next destination:
\(delayCategory)") }

Objective-C

-   (void)navigator:(GMSNavigator *)navigator
    didUpdateDelayCategory:(GMSNavigationDelayCategory)delayCategory {
    NSLog(@"Traffic flow to next destination: %ld", (long)delayCategory); }

GMSNavigationDelayCategory プロパティは、次の遅延レベルを公開します。

遅延カテゴリ 説明
GMSNavigationDelayCategoryNoData 0 - 利用不可、交通状況のデータなし、または :
表示されます。
GMSNavigationDelayCategoryHeavy 1 - 多い。
GMSNavigationDelayCategoryMedium 2 - 中程度です。
GMSNavigationDelayCategoryLight 3 - ライト。

更新速度が遅い場合

ドライバーが速度制限を超えた場合に最新情報を受け取るには、メソッドを作成します。 didUpdateSpeedingPercentage イベントを処理します。

Swift

// Listener to handle speeding events. func navigator( _ navigator:
GMSNavigator, didUpdateSpeedingPercentage percentageAboveLimit: CGFloat ) {
print("Speed is \(percentageAboveLimit) above the limit.") }

Objective-C

// Listener to handle speeding events. - (void)navigator:(GMSNavigator
*)navigator didUpdateSpeedingPercentage:(CGFloat)percentageAboveLimit {
NSLog(@"Speed is %f percent above the limit.", percentageAboveLimit); }

おすすめの照明モードを変更しています

照明の変化の推定に関する最新情報を受け取るには、 didChangeSuggestedLightingMode イベント。

Swift

// Define a listener for suggested changes to lighting mode. func navigator(_
navigator: GMSNavigator, didChangeSuggestedLightingMode lightingMode:
GMSNavigationLightingMode) { print("Suggested lighting mode has changed:
\(String(describing: lightingMode))")

 // Make the suggested change. mapView.lightingMode = lightingMode }

Objective-C

// Define a listener for suggested changes to lighting mode.
-(void)navigator:(GMSNavigator *)navigator didChangeSuggestedLightingMode:
(GMSNavigationLightingMode)lightingMode { NSLog(@"Suggested lighting mode has
changed: %ld", (long)lightingMode);

 // Make the suggested change. _mapView.lightingMode = lightingMode; }