flutter_naver_map 1.0.0-dev.6

Naver Map plugin for Flutter, which provides map service of Korea.

flutter_naver_map 1.0 Dev Preview

NaverMap SDK for Flutter (1.0-dev.6)

플러터 3.0 이상, dart 2.18.4 이상을 사용하셔야 합니다. android는 5.1 이상, iOS는 11.0 이상을 지원합니다.

필독 (iOS)

1.0.0-dev.3 버전을 사용하셨거나, 이전버전(0.10)을 사용하셨던 분들은, iOS에서 네이버맵 구버전으로 빌드될 수 있습니다.

현재 라이브러리에서 사용하는 버전은 3.16.2로, 다음과 같은 명령어 실행이 필요합니다.

cd ios # ios 폴더로 이동
pod update NMapsMap

간단 시작 가이드

Naver Cloud Platform 에서 앱을 등록하고, Android / iOS 플랫폼을 등록합니다.

그리고, pubspec.yaml에 다음처럼 종속성을 선언합니다.

dependencies:
  flutter_naver_map: ^1.0.0-dev.6

iOS에서는, 대용량 파일을 받기 위해 git-lfs 설치가 필요합니다.

터미널을 열고, 다음 커맨드를 실행해주세요.

$ brew install git-lfs

그리고 git-lfs을 사용하기 위해 다음의 커맨드를 실행해주세요.

lfs 사용 설정이 안될 경우 Pod를 통한 dependency가 다운로드 되지않습니다.

$ git lfs install

사용하기 전, NaverMapSdk.instance.initialize() 를 호출하여 초기화를 해주셔야 합니다. (필수) clientId는 필수가 아니며, 기존처럼 clientId를 AndroidManifest.xml이나, Info.plist에 넣어주셔도 됩니다.

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await NaverMapSdk.instance.initialize(clientId: 'your client id');
  runApp(MyApp());
}

지도 위젯은 다음처럼 사용하실 수 있습니다.

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: NaverMap(
      options: const NaverMapViewOptions(),
      onMapReady: (controller) {},
      onMapTapped: (point, latLng) {},
      onSymbolTapped: (symbol) {},
      onCameraChange: (reason, animated) {},
      onCameraIdle: () {},
      onSelectedIndoorChanged: (selectedIndoor) {},
    ),
  );
}

내장 위치 추적 기능

내장 위치 추적 기능의 경우, 따로 권한을 요청하는 기능이 존재하지 않습니다.

따라서, 외부 패키지(geolocator , permission_handler 등)를 이용하여 권한을 요청하시기 바랍니다.

참고사항

이전 버전 (0.10)과 하위 호환성이 보장되지 않습니다.

완전히 새로 작성된 라이브러리이기 때문입니다. 이슈도 공유하지 않습니다.

1.0.0이 Stable으로 업데이트 되면, 구버전(0.x)의 지원이 중단될 예정입니다. 참고 바랍니다.

이슈

이슈탭에서 Label = 1.0을 이용해서 이슈를 확인 / 등록 하실 수 있습니다. 바로가기

TODO

• API DOCS 작성 (작성중)
• 예제 작성
• 테스트 작성
• 클러스터링 구현 (추가 패키지로 제공될 예정입니다)