React Native Naver Map

Bring Naver Map to Your React Fingertips

• Documentation
• Tutorial 1 - 설치, 키 발급
• Tutorial 2 - 카메라, 위치 이동

Important

2.4.x 버전부터 AI NAVER API에서 제공되던 지도 API가 아닌 새롭게 출시된 Maps 단독 상품이 지원됩니다.

Usage

Permission

기본적으로 앱에서 권한은 직접 관리가 되어야 합니다.

이를 관리하기 위해 react-native-permissions라이브러리를 사용하는 예시를 알아보겠습니다.

Tip

Expo 사용자라면 expo-location를 참고해서 권한을 사용할 예정이다 라고 명시할 수 있습니다. 따라서 아래 내용들 중 대부분은 필요하지 않고, 필요한 권한이 무엇인지, 어떻게 명시해야 하는지를 살펴보신 다음 expo-location에서의 사용법을 따르셔야 합니다.

우선 패키지를 설치하고 설정합니다.

pnpm add react-native-permissions

react-native-permission의 각 플랫폼별 설정 방법은 사용법을 직접 참고해 Podfile(iOS), AndroidManifest.xml(Android) 를 적절히 변경해주시길 바랍니다.

iOS

iOS는 다음과 같은 세 가지의 권한이 연관되어있습니다.

• NSLocationAlwaysAndWhenInUseUsageDescription(>= iOS 11)
  • 앱이 foreground와 background 모두에서 위치 정보에 액세스하는 것을 허용합니다.
  • iOS 11 이상에서는 NSLocationAlwaysUsageDescription 대신 이 키를 사용해야 합니다.
• NSLocationWhenInUseUsageDescription
  • 앱이 foreground에 있을 때 (즉, 사용자가 actively하게 앱을 사용 중일 때) 위치 정보에 액세스하는 것을 허용합니다.
• NSLocationTemporaryUsageDescriptionDictionary(>= iOS 14)
  • 앱이 임시로 정확한 위치 정보에 액세스할 수 있도록 허용합니다. 이는 앱이 특정 작업을 수행하는 동안에만 정확한 위치가 필요한 경우 사용됩니다.

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT