フローでマップに近くの場所を表示する

このレシピに従って、フローにインタラクティブなマップを組み込みましょう。アプリはカスタム要素内でネイティブの MapKit ビューとしてマップをレンダリングします。フロースクリーンで位置情報へのアクセスをリクエストします。

Tip

このレシピは iOS アプリのみを対象としています。他のフレームワークで構築されたアプリでは、カスタム要素のフォールバックコンテンツのみが表示されます。Android およびクロスプラットフォームフレームワークのサポートは近日対応予定です。

始める前に

  • アプリを Adapty iOS SDK 4.4 以降にアップデートしてください。それより古いバージョンの SDK では、すべてのカスタム要素にフォールバックコンテンツが表示されます。
  • アプリでフローを取得および表示できるよう設定してください。
  • ユーザーに位置情報へのアクセスを許可してもらうには、アプリの Info.plist ファイルに NSLocationWhenInUseUsageDescription キーを追加してください。その値には、「お近くのフィットネスセンターを探しましょう。」などのプロンプトのテキストを設定してください。

1. カスタム要素を画面に追加する

フロー & ペイウォールビルダーで、フロー画面にカスタム要素を追加し、マップ用に設定します。

  • Type: map
  • ID: fitness_centers
  • Height: デフォルトの Fixed 高さを維持します。マップはカスタム要素いっぱいに広がります。

カスタム要素は、カルーセルのようなタッチ操作に反応するコンテナの中には配置しないでください。そうしないと、マップ上のドラッグ操作がカルーセルも動かしてしまいます。

カスタム要素の内部に、地図の画像を使った Image を追加してください。次の場合、ユーザーにはこの画像がフォールバックとして表示されます:

  • ユーザーのアプリバージョンが地図を表示できない場合
  • 画面が開く前に位置情報へのアクセスを拒否していた場合
  • iOS 16 のデバイスを使用している場合

ユーザーがまだ位置情報のアクセス許可プロンプトに回答していない場合、地図が表示されたときに iOS がプロンプトを表示します。アプリが位置情報を必要とする理由をユーザーに伝えるため、カスタム要素の上にテキスト要素(例:「近くのフィットネスセンターを探す」)を追加してください。

2. マップビューを作成する

ロケーションアクセスのモデルと、マップを含む SwiftUI ビューを作成します。このビューはロケーションアクセスをリクエストし、ユーザーから半径 2 km 以内のフィットネスセンターを検索して、それぞれにマーカーを表示します。

マップビューにはiOS 17以降が必要です。iOS 16では、フォールバックが表示されます。ユーザーが画面で位置情報へのアクセスを拒否した場合、マップの代わりにSettingsでアクセスを許可する方法を説明するメッセージが表示されます。

3. カスタム要素にマップを対応付ける

アプリ全体のリゾルバーに、LocationAccess モデルのプロパティを追加します。次に、map タイプと fitness_centers ID に対してマップビューを返すケースを追加します。ハイライトされた行が追加箇所です。アプリにまだアプリ全体のリゾルバーがない場合は、コード全体をコピーしてください:

SDKは、画面が開いたとき、また画面が開いている間(プロダクトの読み込み時など)にリゾルバーを呼び出します。ロケーションへのアクセス状況によって、各呼び出し時にリゾルバーが返す値が決まります。

  • 未回答: マップビュー。ビューがアクセスを要求できるようにするため。
  • 許可済み: マップビュー。ユーザーの近くにあるフィットネスセンターを表示します。
  • 画面が開く前に拒否済み: nil。ユーザーに設定に関するメッセージではなくフォールバックが表示されます。
  • 画面上で拒否済み: マップビュー。ビューが画面に表示されている間は isMapOnScreen を設定するためです。ここでリゾルバーが nil を返した場合、SDK は次の呼び出し時に設定に関するメッセージをフォールバックに置き換えます。

アプリ全体のリゾルバーをまだ設定していない場合は、アプリ起動時などに AdaptyUI.setCustomElementsResolver(_:) を一度呼び出してください。

4. デバイスでテストする

フロー & ペイウォールビルダーはアプリのコードを実行できないため、キャンバスにはフォールバックのみが表示されます。マップをプレビューするには:

  1. フローを公開します。キャッシュされたバージョンではなく最新の公開バージョンを確認するには、デバイスをテストデバイスとして登録してください。
  2. リゾルバーを含むアプリのビルドを iOS 17 以降で実行します。画面を開き、位置情報へのアクセスを許可してください。マップにあなたの現在地と近くのフィットネスセンターのマーカーが表示されることを確認します。

フォールバックをテストするには、位置情報へのアクセスを拒否します。設定アプリで プライバシーとセキュリティ > 位置情報サービス > お使いのアプリ の順に進み、しない を選択してください。その後、画面を再度開いてください。

マップの代わりにフォールバックが表示される理由を調べるには、iOSガイドのデバイスでテストするセクションの手順に従ってください。