Androidの設定

Androidは以下を使用します Google Maps SDK。API キーをマニフェストのメタデータとして追加します android/app/src/main/AndroidManifest.xml 既存の <application>:

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${GOOGLE_MAPS_API_KEY}" />

内 android { defaultConfig { ... } } における android/app/build.gradleで、プレースホルダーを環境変数またはローカルシークレットにマッピングします:

android {
    defaultConfig {
        manifestPlaceholders = [
            GOOGLE_MAPS_API_KEY: System.getenv("GOOGLE_MAPS_API_KEY") ?: "REPLACE_WITH_YOUR_GOOGLE_MAPS_API_KEY"
        ]
    }
}

書き出す GOOGLE_MAPS_API_KEY ビルド前に設定してください。設定しないと Gradle がフォールバック文字列を注入し、Maps SDK が実行時に失敗します。

有効にする Android 用 Maps SDK Google Cloud Console のキーに。同じキーをに渡します NativeMap.create({ apiKey }) Web ビルドとの整合性を保つため。

WebView の背後にマップを表示

〜中 create、プラグインはをアタッチします MapView を Capacitor WebView の下に配置し、を呼び出します bringToFront() WebView に、そしてを設定します webView.setBackgroundColor(Color.TRANSPARENT) これにより、HTML UI がマップの上に表示されます。

埋め込みマップの場合、コンテナ要素をに渡します NativeMap.create({ element })。プラグインは要素を測定し、リサイズやスクロール時にネイティブマップフレームを同期させます。

以下の バックグラウンドモード、pass toBack: true 設定してください config.x, config.y, config.widthや config.height （省略時はビューポートのデフォルトが適用されます）。呼び出してください updateLayout ウィンドウサイズや向きが変わったときに、 MapView がWebViewと整列するように保ちます。