このガイドでは、Navigation SDK for iOS を使用して、アプリ内で単一の目的地までのルートを作成する方法について説明します。
概要
- プロジェクトを設定するセクションの説明に従って、Navigation SDK をアプリに統合します。
GMSMapView
を設定します。- 利用規約に同意し、位置情報サービスとバックグラウンド通知を許可するようユーザーに求める。
- 1 つ以上のデスティネーションを含む配列を作成します。
GMSNavigator
を定義して、ターンバイターン ナビゲーションを制御します。setDestinations
を使用してデスティネーションを追加します。isGuidanceActive
をtrue
に設定してナビを開始します。simulateLocationsAlongExistingRoute
を使用して、アプリのテスト、デバッグ、デモのために、ルート上の車両の進行状況をシミュレートします。
コードの確認
必要な認可をユーザーに求める
Navigation SDK を使用する前に、ユーザーは利用規約に同意し、ナビゲーションに必要な位置情報サービスの使用を許可する必要があります。アプリがバックグラウンドで実行される場合は、ガイダンス アラート通知を承認するようユーザーに求めるプロンプトも表示する必要があります。このセクションでは、必要な認可プロンプトを表示する方法について説明します。
位置情報サービスを許可する
Navigation SDK は位置情報サービスを使用するため、ユーザーの許可が必要です。位置情報サービスを有効にして、承認ダイアログを表示する手順は次のとおりです。
NSLocationAlwaysUsageDescription
キーをInfo.plist
に追加します。値には、アプリが位置情報サービスを必要とする理由を簡単に説明します。たとえば、「このアプリは、ターンバイターン ナビゲーションに位置情報サービスを使用するための権限が必要です」などです。
許可ダイアログを表示するには、位置情報マネージャー インスタンスの
requestAlwaysAuthorization()
を呼び出します。
Swift
self.locationManager.requestAlwaysAuthorization()
Objective-C
[_locationManager requestAlwaysAuthorization];
バックグラウンド ガイダンスのアラート通知を許可する
Navigation SDK は、アプリがバックグラウンドで実行されているときにアラート通知を表示するために、ユーザーの権限が必要です。次のコードを追加して、これらの通知を表示するための権限をユーザーに求めるメッセージを表示します。
Swift
UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
granted, error in
// Handle denied authorization to display notifications.
if !granted || error != nil {
print("User rejected request to display notifications.")
}
}
Objective-C
// Request authorization for alert notifications.
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
UNAuthorizationOptions options = UNAuthorizationOptionAlert;
[center requestAuthorizationWithOptions:options
completionHandler:
^(
BOOL granted,
NSError *_Nullable error) {
if (!error && granted) {
NSLog(@"iOS Notification Permission: newly Granted");
} else {
NSLog(@"iOS Notification Permission: Failed or Denied");
}
}];
利用規約に同意する
次のコードを使用して利用規約ダイアログを表示し、ユーザーが利用規約に同意したときにナビゲーションを有効にします。この例には、位置情報サービスとガイダンス アラート通知のコード(前述)が含まれています。
Swift
let termsAndConditionsOptions = GMSNavigationTermsAndConditionsOptions(companyName: "Ride Sharing Co.")
GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(
with: termsAndConditionsOptions) { termsAccepted in
if termsAccepted {
// Enable navigation if the user accepts the terms.
self.mapView.isNavigationEnabled = true
self.mapView.settings.compassButton = true
// Request authorization to use location services.
self.locationManager.requestAlwaysAuthorization()
// Request authorization for alert notifications which deliver guidance instructions
// in the background.
UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
granted, error in
// Handle rejection of notification authorization.
if !granted || error != nil {
print("Authorization to deliver notifications was rejected.")
}
}
} else {
// Handle rejection of terms and conditions.
}
}
Objective-C
GMSNavigationTermsAndConditionsOptions *termsAndConditionsOptions = [[GMSNavigationTermsAndConditionsOptions alloc] initWithCompanyName:@"Ride Sharing Co."];
[GMSNavigationServices
showTermsAndConditionsDialogIfNeededWithOptions:termsAndConditionsOptions
callback:^(BOOL termsAccepted) {
if (termsAccepted) {
// Enable navigation if the user accepts the terms.
_mapView.navigationEnabled = YES;
_mapView.settings.compassButton = YES;
// Request authorization to use the current device location.
[_locationManager requestAlwaysAuthorization];
// Request authorization for alert notifications which deliver guidance instructions
// in the background.
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
UNAuthorizationOptions options = UNAuthorizationOptionAlert;
[center requestAuthorizationWithOptions:options
completionHandler:
^(
BOOL granted,
NSError *_Nullable error) {
if (!error && granted) {
NSLog(@"iOS Notification Permission: newly Granted");
} else {
NSLog(@"iOS Notification Permission: Failed or Denied");
}
}];
} else {
// Handle rejection of the terms and conditions.
}
}];
ルートを作成してガイダンスを開始する
ルートをプロットするには、訪問する 1 つ以上のデスティネーション(GMSNavigationWaypoint
)を含む配列を指定して、ナビゲータの setDestinations()
メソッドを呼び出します。計算が正常に完了すると、地図上にルートが示されます。ルート沿いのガイダンスを開始するには、最初の目的地から、コールバックで isGuidanceActive
を true
に設定します。
次の例は、以下の条件に従って表示します。
- 2 つの目的地を持つ新しいルートを作成する。
- 開始ガイダンス。
- バックグラウンド ガイダンス通知を有効にする。
- ルート沿いの移動をシミュレートする(省略可)。
- カメラモードを [追尾] に設定する(省略可)。
Swift
func startNav() {
var destinations = [GMSNavigationWaypoint]()
destinations.append(GMSNavigationWaypoint.init(placeID: "ChIJnUYTpNASkFQR_gSty5kyoUk",
title: "PCC Natural Market")!)
destinations.append(GMSNavigationWaypoint.init(placeID:"ChIJJ326ROcSkFQRBfUzOL2DSbo",
title:"Marina Park")!)
mapView.navigator?.setDestinations(destinations) { routeStatus in
self.mapView.navigator?.isGuidanceActive = true
self.mapView.locationSimulator?.simulateLocationsAlongExistingRoute()
self.mapView.cameraMode = .following
}
}
Objective-C
- (void)startNav {
NSArray<GMSNavigationWaypoint *> *destinations =
@[[[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJnUYTpNASkFQR_gSty5kyoUk"
title:@"PCC Natural Market"],
[[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJJ326ROcSkFQRBfUzOL2DSbo"
title:@"Marina Park"]];
[_mapView.navigator setDestinations:destinations
callback:^(GMSRouteStatus routeStatus){
[_mapView.locationSimulator simulateLocationsAlongExistingRoute];
_mapView.navigator.guidanceActive = YES;
_mapView.cameraMode = GMSNavigationCameraModeFollowing;
}];
}
プレイス ID について詳しくは、プレイス ID をご覧ください。
移動手段を設定
移動モードによって、取得されるルートの種類と、ユーザーのコースが決定される方法が決まります。ルートには、車、自転車、徒歩、タクシーの 4 つの移動モードのいずれかを設定できます。運転モードとタクシー モードでは、ユーザーのコースはその移動方向に基づいて示されます。自転車モードと徒歩モードでは、コースはデバイスの向きによって示されます。
次の例に示すように、地図ビューの travelMode
プロパティを設定します。
Swift
self.mapView.travelMode = .cycling
Objective-C
_mapView.travelMode = GMSNavigationTravelModeCycling;
通行禁止道路を設定する
avoidsHighways
プロパティと avoidsTolls
BOOL
プロパティを使用して、ルート上の高速道路や有料道路を避けることができます。
Swift
self.mapView.navigator?.avoidsTolls = true
Objective-C
_mapView.navigator.avoidsTolls = YES;
PlaceID 検索ツール
PlaceID Finder を使用して、ルートの目的地に使用するプレイス ID を見つけることができます。GMSNavigationWaypoint
を使用して、placeID
からデスティネーションを追加します。
フローティング テキスト
Google アトリビューションが覆われなければ、アプリのどこにでもフローティング テキストを追加できます。Navigation SDK では、地図上の緯度/経度やラベルにテキストを固定することはできません。詳細については、情報ウィンドウをご覧ください。