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

このレシピに従って、フローにインタラクティブなマップを組み込みましょう。マップには、パートナーのフィットネスセンターなど、ユーザーの半径2km以内にある場所が表示されます。アプリはMapLibreを使って、カスタム要素としてマップをネイティブビューでレンダリングします。フロースクリーンで位置情報へのアクセス許可をリクエストします。

始める前に

  • アプリを Adapty Android SDK 4.4 以降にアップデートしてください。それより古い SDK バージョンでは、すべてのカスタム要素にフォールバックコンテンツが表示されます。
  • アプリにフローの取得と表示を設定してください。
  • ユーザーに位置情報へのアクセスを求めるには、AppCompatActivity などの ComponentActivity を継承したアクティビティでフローを表示してください。
  • Gradle を使って org.maplibre.gl:android-sdk-opengl から MapLibre をアプリに追加してください。このアーティファクトを使用すると、デフォルトの android-sdk アーティファクトが必要とする Vulkan 非対応デバイスにも Google Play がアプリを提供できます。
  • MapLibre の要件に合わせて minSdk を 23 以上に設定してください。

アプリをおおよその位置情報のみに制限するには、AndroidManifest.xml の <manifest> 要素内に以下を追加します。<manifest> 要素に xmlns:tools="http://schemas.android.com/tools" が宣言されていることを確認してください。

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- removes precise location, which MapLibre declares -->
<uses-permission
    android:name="android.permission.ACCESS_FINE_LOCATION"
    tools:node="remove" />

1. カスタム要素をスクリーンに追加する

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

  • Type:map
  • ID:fitness_centers
  • Height:デフォルトの Fixed 高さのまま。マップがカスタム要素を埋めます。

カルーセルなど、タッチに反応するコンテナにカスタム要素を配置しないようにしてください。マップへのドラッグ操作はマップのみが処理するようにします。

カスタム要素の中に、地図の画像を Image として追加します。これは次の場合にフォールバックとして表示されます:

  • ユーザーのアプリバージョンが地図を表示できない場合。
  • スクリーンが開く前に位置情報のアクセスを拒否した場合。

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

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

場所の型と、位置情報アクセス用のモデルを作成します。

マップ付きのビューを作成します。このビューは位置情報へのアクセスを要求し、ユーザーの半径2km以内にある各プレイスのマーカーを表示します:

ユーザーが画面で位置情報へのアクセスを拒否した場合、ビューはマップの代わりに、設定でアクセスを許可する方法についてのメッセージを表示します。

3. マップをカスタム要素にマッチさせる

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

SDKは、画面が開いたときとカスタム要素が再描画されるたびにリゾルバーを呼び出します。位置情報へのアクセス状態によって、各呼び出し時にリゾルバーが返す内容が変わります:

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

リゾルバーをプレースごとに作成し、アプリ全体のリゾルバーとして設定します。AdaptyUI.setCustomElementsResolver はアプリ起動時など、一度だけ呼び出してください。

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

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

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

フォールバックをテストするには、設定アプリでアプリの位置情報アクセスをオフにします。画面を開いて許可を求めるプロンプトが表示されたら、拒否してください。マップビューに設定に関するメッセージが表示されます。もう一度画面を開いて、フォールバックが表示されることを確認してください。

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