Configurazione Android

Android utilizza il SDK di Google Maps. Aggiungi la tua chiave API come metadato del manifest in android/app/src/main/AndroidManifest.xml dentro <application>:

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

Dentro android { defaultConfig { ... } } nella android/app/build.gradle, mappa il placeholder a una variabile d'ambiente o a un segreto locale:

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

Esporta GOOGLE_MAPS_API_KEY prima del build, altrimenti Gradle inietta la stringa di fallback e Maps SDK fallisce a runtime.

Abilita Maps SDK per Android per la chiave nella Google Cloud Console. Passa la stessa chiave a NativeMap.create({ apiKey }) per coerenza con le build web.

Mappa dietro la WebView

Durante create, il plugin collega un MapView sotto la Capacitor WebView, chiama bringToFront() sulla WebView e imposta webView.setBackgroundColor(Color.TRANSPARENT) così la tua UI HTML può essere renderizzata sopra la mappa.

Per le mappe embedded, passa un elemento contenitore a NativeMap.create({ element }). Il plugin misura quell'elemento e mantiene sincronizzato il frame della mappa nativa durante resize e scroll.

Per modalità background, passa toBack: true e imposta config.x, config.y, config.width, e config.height (se omesso, si applicano i valori di default del viewport). Chiama updateLayout quando cambia la dimensione o l'orientamento della finestra, in modo che MapView rimanga allineato con la WebView.