GMSNavigationServices クラス リファレンス

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

概要

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

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

(BOOL) + areTermsAndConditionsAccepted
 ユーザーが利用規約に同意したかどうかを示します。
(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

ユーザーが利用規約に同意したかどうかを示します。

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

+ (void) showTermsAndConditionsDialogIfNeededWithTitle: (nullable NSString *)  title
companyName: (NSString *)  companyName
UIParams: （null 許容 GMSNavigationTermsDialogUIParams *） UIParams
call （GMSTermsResponseCallback） callback

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

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

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

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

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

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

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

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

+ (void) showTermsAndConditionsDialogIfNeededWithCompanyName: (NSString *)  companyName
call （GMSTermsResponseCallback） callback

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

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

+（void）resetTermsAndConditionsAccepted

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

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

+ (void) setAbnormalTerminationReportingEnabled: (BOOL)  abnormalTerminationReportingEnabled

SDK の実行中にアプリがクラッシュするなど、SDK の異常な終了を報告できるようにします。

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

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

+ (null 許容 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]

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

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

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

showTermsAndConditionsDialogIfNeededWithCompanyName:callback: にドライバーの認識に関する免責条項のみを表示するかどうかを指定します。

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

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

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