flutter_naver_map 1.0.0-dev.7 flutter_naver_map: ^1.0.0-dev.7 copied to clipboard
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.7)
플러터 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.7
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 작성 (작성중)
- 예제 작성
- 테스트 작성
- 클러스터링 구현 (추가 패키지로 제공될 예정입니다)