Android 설정

Android는 다음을 사용합니다 Google Maps SDK. API 키를 manifest 메타데이터로 추가하세요 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 }) 웹 빌드와 일관성을 맞추기 위해.

WebView 뒤에 지도 배치하기

동안 create, 플러그인은 다음을 추가합니다: MapView Capacitor WebView 아래에 배치하고, 호출하며 bringToFront() WebView에서 설정하고, webView.setBackgroundColor(Color.TRANSPARENT) HTML UI가 지도 위에 렌더링되도록 합니다.

임베디드 지도의 경우, 컨테이너 요소를 전달하세요 NativeMap.create({ element }). 플러그인은 해당 요소를 측정하고, 리사이즈 및 스크롤 시 네이티브 지도 프레임을 동기화합니다.

대상: 백그라운드 모드, 전달 toBack: true 그리고 설정하세요. config.x, config.y, config.width, 그리고 config.height (생략 시 viewport 기본값이 적용됩니다). 호출하세요 updateLayout 윈도우 크기나 방향이 변경될 때 MapView WebView와 정렬된 상태를 유지합니다.