GMSNavigationServices クラス リファレンス

静的パブリック メンバー関数 | プロパティ | 関連関数
GMSNavigationServices クラス リファレンス

概要

Google Maps Navigation SDK for iOS へのモバイル アクセスを制御できるサービス。

静的パブリック メンバー関数

(BOOL) + areTermsAndConditionsAccepted
 バージョン 5.5.0 以降の場合は、ユーザーが利用規約を承認したかどうかを示します。
(void) + showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback:
 アプリユーザーが Navigation SDK の利用規約に同意していない場合は、モーダル ダイアログ ボックスが表示されます。
(void) + showTermsAndConditionsDialogIfNeededWithTitle:companyName:callback:
 デフォルトのデザインを使用して、利用規約のダイアログを表示します。
(void) + showTermsAndConditionsDialogIfNeededWithCompanyName:callback:
 デフォルトのタイトルとデザインを使用して、利用規約のダイアログを表示します。
(void) + resetTermsAndConditionsAccepted
 利用規約を承諾しない状態にリセットします。
(void) + setAbnormalTerminationReportingEnabled:
 SDK の実行中にアプリがクラッシュするなど、SDK の異常な終了に関するレポートを有効にします。
（null 許容の GMSNavigationSession *）+ createNavigationSession
 地図表示に関連付けられていない新しいナビゲーション セッションを作成します。
(NSString *) + openSourceLicenseInfo
 Google Navigation SDK for iOS のオープンソース ソフトウェア ライセンス情報を返します。
(NSString *) + navSDKVersion
 Navigation SDK for iOS のこのリリースのバージョンを返します。

プロパティ

BOOL shouldOnlyShowDriverAwarenesssDisclaimer
 showTermsAndConditionsDialogIfNeededWithCompanyName:callback: でドライバーの注意に関する免責条項のみを表示するかどうかを示します。

（これらはメンバー関数ではありません）。

typedef void(^ GMSTermsResponseCallback）（BOOL termsAccepted）
 ユーザーが利用規約に同意するか拒否したときに呼び出されます。

メンバー関数のドキュメント

+（BOOL）areTermsAndConditionsAccepted

バージョン 5.5.0 以降の場合は、ユーザーが利用規約を承認したかどうかを示します。

それより前のバージョンの場合は、ユーザーが利用規約に同意したかどうかを示します。

false の場合、サービスはナビゲーション インターフェースへのアクセスを無効にします。

+ (void) showTermsAndConditionsDialogIfNeededWithTitle: (nullable NSString *)  title
companyName: (NSString *)  companyName
UIParams: （null 値許容の GMSNavigationTermsDialogUIParams *） UIParams
使用します。 （GMSTermsResponseCallback） callback

アプリユーザーが Navigation SDK の利用規約に同意していない場合は、モーダル ダイアログ ボックスが表示されます。

コールバックは、ユーザーのレスポンスとともにメインキューに送信されます。

ユーザーがすでに利用規約に同意している場合は、ダイアログは表示されず、コールバックには termsAccepted = YES が含まれます。

companyName パラメータを会社に設定します。会社名は利用規約のテキストに表示されます。このテキストは、業務の改善を目的として、位置情報がこの会社と共有される可能性があることをアプリのユーザーに説明しています。

このメソッドはメインスレッドから呼び出します。レスポンスを待たずに複数回呼び出しても効果はありません。

パラメータ:
titleダイアログ ボックスのタイトル。title が nil の場合、ダイアログはデフォルトのタイトルを使用します。
注:
カスタムタイトルの場合、このメソッドの呼び出し元は、このパラメータをローカライズする必要があります。デフォルトのタイトルは、サービスによって自動的にローカライズされます。
パラメータ:
companyNameアプリをリリースしている企業名と、位置情報の共有に関する Google との契約に記載されている企業名。
UIParamsダイアログ ボックスのデザインを定義するパラメータ。nil の場合、ダイアログ ボックスはデフォルトのデザインを使用します。
callbackユーザーの応答とともにメインキューで送信されるブロック。
+ (void) showTermsAndConditionsDialogIfNeededWithTitle: (nullable NSString *)  title
companyName: (NSString *)  companyName
使用します。 （GMSTermsResponseCallback） callback

デフォルトのデザインを使用して、利用規約のダイアログを表示します。

パラメータ companyName と callback の説明などの詳細については、+showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback: をご覧ください。

+ (void) showTermsAndConditionsDialogIfNeededWithCompanyName: (NSString *)  companyName
使用します。 （GMSTermsResponseCallback） callback

デフォルトのタイトルとデザインを使用して、利用規約のダイアログを表示します。

companyName パラメータと callback パラメータの説明などの詳細については、+showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback: をご覧ください。

+ (void) resetTermsAndConditionsAccepted

利用規約を承諾しない状態にリセットします。

このメソッドを呼び出すと、areTermsAndConditionsAccepted は NO を返し、#if SDK_BUILD_CONFIG(EnableNavSDKSkipToSOptions) showTermsAndConditionsDialogIfNeededWithOptions:callback: と #endif showTermsAndConditionsDialogIfNeededWithCompanyName:callback: により利用規約のダイアログが表示されます。既存の GMSMapView インスタンスの navigationEnabled プロパティは、すべて NO にリセットされます。

+ (void) setAbnormalTerminationReportingEnabled: (BOOL)  abnormalTerminationReportingEnabled

SDK の実行中にアプリがクラッシュするなど、SDK の異常な終了に関するレポートを有効にします。

これにより、Google は必要に応じて SDK の安定性を改善できます。デフォルトは YES です。値は、サービス インスタンスを初期化する前に更新する必要があります。

このプロパティはメインスレッドから設定する必要があります。

+ (nullable GMSNavigationSession *) createNavigationSession

地図表示に関連付けられていない新しいナビゲーション セッションを作成します。

これにより、新しいナビゲーション セッションが割り当てられ、返されます。ウェイポイントとオプションをセッションで設定し、リスナーをセッションに追加することができます。

利用規約に同意していない場合、このメソッドは nil を返します。これが、このメソッドから nil が返される唯一の理由です。

GMSMapView メソッド -enableNavigationWithSession を使用して、このセッションを地図と関連付けることができます。セッションは、メモリ、データ、バッテリーを消費する重いオブジェクトであるため、永続的なナビゲーション セッションがアプリの主要な機能である場合にのみ割り当てる必要があります。同じ理由で、アプリでナビゲーション セッションを確立した後にナビゲーション UI を作成する場合は、新しいナビゲーション UI を作成するのではなく、既存のナビゲーション セッションでナビゲーション UI を開始してください。

ナビゲーション セッションの存続期間は、通常の Objective-C セマンティクスに従います。そのため、このルーティンの呼び出し元は、セッションへの参照を保存する必要があります。

+（NSString *）openSourceLicenseInfo

Google Navigation SDK for iOS のオープンソース ソフトウェア ライセンス情報を返します。

この情報はアプリケーション内で使用できる必要があります。

+ (NSString *) navSDKVersion

Navigation SDK for iOS のこのリリースのバージョンを返します。

- (typedef void(^ GMSTermsResponseCallback)(BOOL termsAccepted) [related]

ユーザーが利用規約に同意するか拒否したときに呼び出されます。

バージョン 5.5.0 以降では、termsAccepted は常に YES です。

プロパティのドキュメント

-（BOOL）shouldOnlyShowDriverAwarenesssDisclaimer [read, write, assign]

showTermsAndConditionsDialogIfNeededWithCompanyName:callback: でドライバーの注意に関する免責条項のみを表示するかどうかを示します。

デフォルトは NO で、免責条項は Navigation SDK に用意されているデフォルトの利用規約とサービスに加えて表示されます。YES に設定すると、ドライバーの注意に関する免責条項のみを表示するように指示できます。

プロジェクトで利用規約ダイアログを表示する必要がある場合は、この変数を YES に設定しても効果はありません。また、ゲッター メソッドは常に NO を返します。

このプロパティを設定するか、メインスレッドから読み取る必要があります。