🗺️ 네이버지도 API 문서 읽어보기

프로젝트를 시작하기 전 api 문서를 미리 읽어보았다.

Application 등록

네이버 클라우드 플랫폼에서 application 을 등록하는 과정은 어렵지 않았다. 필요한 서비스를 선택해서 안드로이드의 경우 app package name 을 통해서 어플을 등록할 수 있었다.

의존성 추가

네이버 지도 sdk 는 maven 저장소에서 배포된다.

allprojects {
    repositories {
        google()
        mavenCentral()
        maven("https://naver.jfrog.io/artifactory/maven/")
    }
}

공식 문서에는 위의 의존성을 루트 프로젝트의 build.gradle 에 추가하도록 안내하고 있는데, 계속 빌드가 되지 않는 문제가 발생했다. 해당 부분을 구글링 해보니 settings.gradle 의 dependencyResolutionManagement 하위 repositories{ } 에 추가하여 해결했다는 내용을 발견하여 그 방법을 시도해보니 성공적으로 빌드를 할 수 있었다.

dependencies {
    // 네이버 지도 SDK
    implementation("com.naver.maps:map-sdk:3.17.0")
}

앱 모듈의 build.gradle에 네이버 지도 SDK에 대한 의존성을 위와 같이 선언하는 것으로 의존성 추가는 끝이 난다.

Client ID 지정

네이버 클라우드 플랫폼에서 application 을 등록하고 발급받은 client ID 를 두 가지 방식으로 지정할 수 있다.

AndroidManifest.xml 에 지정

<manifest>
  <application>
      <meta-data
          android:name="com.naver.maps.map.CLIENT_ID"
          android:value="YOUR_CLIENT_ID_HERE" />
  </application>
</manifest>

API 를 호출해 지정

class App : Application() {
  fun onCreate() {
      super.onCreate()
      NaverMapSdk.getInstance(this).client =
              NaverMapSdk.NaverCloudPlatformClient("YOUR_CLIENT_ID_HERE")
  }
}

지도 표시하기

지도는 위의 설정을 모두 마친 후 어플의 레이아웃에 mapFragment 를 추가하여 간단하게 나타낼 수 있다. 기본적으로 가장 권장하는 방법은 <FragmentContainerView> 로 XML 레이아웃에 추가하는 것이다.

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/map_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:name="com.naver.maps.map.MapFragment" />

val fm = supportFragmentManager
val mapFragment = fm.findFragmentById(R.id.map) as MapFragment?
        ?: MapFragment.newInstance().also {
            fm.beginTransaction().add(R.id.map, it).commit()
        }

하지만 MapFragment 를 다른 Fragment 내에 배치할 경우 추가로 작업을 해줘야 한다. 이 부분에 대해서는 구현하면서 더 학습할 예정이다.

지도에서 현재 위치 표시하기

NaverMap 객체 얻어오기
- 지도를 보여주는 역할 이외에 API 를 호출하기 위해서는 객체가 필요하다. OnMapReadyCallback 을 상속받아 구현 가능하다.

현재 위치 추적하기
- 네이버 지도 sdk 에서는 위치 추적과 지도에 나타내는 기능을 제공하고 있다. 이를 사용하기 위해서는 AndroidManifest.xml 에 권한을 명시해야 한다. 해당 권한은 최대한 정확한 기기 위치 추정치를 제공하도록 한다.
```
<manifest>
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>
```

네이버 지도 sdk 는 Google Play 서비스의 Fused Location Provider를 사용하는 LocationSource 구현체인 FusedLocationSource를 제공한다. 이를 사용하기 위해서는 아래의 의존성을 추가해야 한다.
```
dependencies {
   // 21.0.1 이상 버전에 대한 의존성 추가해야함.
   implementation("com.google.android.gms:play-services-location:21.0.1")
}
```

아래와 같이 NaverMap 객체를 얻어와서 현재 위치를 설정하는 코드를 작성할 수 있다. 테스트를 위한 코드로 런타임 권한 요청 처리는 구현하지 않는 코드이다.

class MainActivity : AppCompatActivity(), OnMapReadyCallback {
  private lateinit var map: NaverMap
  private lateinit var location: FusedLocationSource

  override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
      setContentView(R.layout.activity_main)
      val fm = supportFragmentManager
      val mapFragment = fm.findFragmentById(R.id.fcv_map) as MapFragment?
          ?: MapFragment.newInstance().also {
              fm.beginTransaction().add(R.id.fcv_map, it).commit()
          }

      mapFragment.getMapAsync(this)
      location = FusedLocationSource(this, 1000)
  }

  override fun onMapReady(naverMap: NaverMap) {
      map = naverMap
      naverMap.locationSource = location
  }

}

locationSource 를 지정하고 난 후 위치 추적 기능을 사용할 수 있다.
- None : 위치를 추적하지 않는다.
- NoFollow : 위치 추적이 활성화되고, 현 위치 표시가 변경되는 위치에 따라 움직이며 지도는 움직이지 않는다.
- Follow : 위치 추적이 활성화되고, 현 위치 표시가 사용자 위치에 따라 움직인다.
- Face : 위치 추적이 활성화되고, 사용자의 위치 및 방향을 따라 모든 표시 요소가 따라 움직인다.
```
override fun onMapReady(naverMap: NaverMap) {
      map = naverMap
      naverMap.locationSource = location
      naverMap.locationTrackingMode = LocationTrackingMode.Follow
}
```