iOS 설정

iOS는 Apple MapKit을 사용합니다. iOS에서는 하지 마세요 Google Maps API 키가 필요하지 않습니다.

만약 enableCurrentLocation를 호출한다면, ios/App/App/Info.plist:

<key>NSLocationWhenInUseUsageDescription</key>
<string>We use your location to show you on the map.</string>

플러그인이 keepAlive 어떤 enableCurrentLocation 를 통해 위치 권한을 요청하며, 권한이 허용되면 안정적으로 작동합니다.

WebView 뒤에 지도 배치하기

네이티브 뷰가 MKMapView Capacitor WKWebView 계층 구조에 마운트되어 연결된 DOM 요소를 onResize 및 onDisplay추적합니다. Ionic 페이지에 다시 진입할 때, WebKit이 스크롤 뷰를 재구축하면 플러그인의 호출 경로를 통해 지도를 다시 마운트합니다.

지도가 HTML 레이어 위로 비쳐 보여야 하는 경우, 투명한 WebView나 페이지 배경을 사용하세요.

다음에서 toBack 모드에서, data-map-overlay README 오버레이 CSS가 탭을 허용할 수 있도록 HUD 래퍼에 적용하세요. 네이티브 터치 라우터는 히트 타겟이 투명하고 상호작용 요소 아래에 있지 않을 때 지도로 제스처를 전달합니다.

iOS 전용 플러그인 메서드

iOS 네이티브 브릿지에서도 다음 항목들을 제공합니다: takeSnapshot, searchAutocomplete, searchPlaces, searchResolve, geocode, 그리고 reverseGeocode. 이 기능들은 아직 NativeMap 클래스 래퍼에 포함되지 않았습니다. iOS에서 MapKit 검색이나 지오코딩이 필요한 경우, 로우레벨 플러그인 핸들을 통해 직접 호출하세요:

import { registerPlugin } from '@capacitor/core';

type NativeMapBridge = {
  takeSnapshot(options: { id: string }): Promise<{ image: string }>;
  geocode(options: { address: string }): Promise<Record<string, unknown>>;
};

const NativeMapBridge = registerPlugin<NativeMapBridge>('NativeMap');