Mapbox SDK 설치하기

MS Bing의 지도는 하나의 Object 안에 맵 데이터를 그리는 방식이다. 중심 좌표를 바꿀 때마다 Shader로 지도를 그린다.

 

Mapbox는 여러 개의 Tile Object를 생성하는 방식이다. 중심 좌표나 맵 크기를 바꾸면 타일 데이터를 새롭게 생성한다. 

 

맵을 가져오는 방식을 바꿀 수 있는 지는 확인을 안 해봤는데, 일단 기본적으로 위와 같이 가져온다.

 

프로젝트에는 Mapbox 방식이 적합하여 이걸로 변경함.

 

 

 

---

설치 방법

Install the Maps SDK for Unity

 

1. Mapbox SDK Import하기

지도만 사용할 것이라면 Mapbox만 받아도 된다.

 

 ERROR 

AR 관련 Namespace를 찾지 못하는 문제

1. SpatialTracking

Assets\GoogleARCore\SDK\InstantPreview\Scripts\InstantPreviewManager.cs(32,23): error CS0234: The type or namespace name 'SpatialTracking' does not exist in the namespace 'UnityEngine' (are you missing an assembly reference?)

-> AR Foundation 패키지 설치하기

Window - Package Manager - Unity Registry에서 필요한 패키지를 설치하면 된다.

 

2. ARBackgroundRenderer

Assets\UnityARInterface\Scripts\ARCoreInterface.cs(51,17): error CS0246: The type or namespace name 'ARBackgroundRenderer' could not be found (are you missing a using directive or an assembly reference?)

Assets\UnityARInterface\ARRemote\Scripts\ARRemoteEditorInterface.cs(40,17): error CS0246: The type or namespace name 'ARBackgroundRenderer' could not be found (are you missing a using directive or an assembly reference?)

Assets\UnityARInterface\Scripts\ARKitInterface.cs(26,17): error CS0246: The type or namespace name 'ARBackgroundRenderer' could not be found (are you missing a using directive or an assembly reference?)

 

Assets\GoogleARCore\SDK\Scripts\ARCoreBackgroundRenderer.cs(43,17): error CS0246: The type or namespace name 'ARBackgroundRenderer' could not be found (are you missing a using directive or an assembly reference?)

 

UnityARInterface와 GoogleARCore와 관련된 에러가 뜬다. AR을 사용하지 않고 맵만 사용하고자 한다면 Package Import 시 Mapbox만 받으면 되기 때문에 굳이 신경 쓰지 않아도 되긴 함

 

AR 관련 클래스를 찾지 못해서 발생하는 에러인데, 구글링한 결과 Unity 버전에 따른 패키지/라이브러리 종속성 변경을 Mapbox가 반영하지 않은 탓이다. 참고(Mapbox-Github-Issue) 꼭 사용하고 싶다면 Unity Editor를 2018 혹은 그 이하로 다운그레이드하고 관련 패키지 버전을 이리저리 조정하는 방법밖에 없는 듯하다.

AR 기능을 수정할 예정이 아직은 없으므로 AR 관련 폴더를 삭제하고, 필요한 경우 독자적으로 AR 솔루션을 만들어서 사용하라는 답변 (2021.11.03)

 

 

DeviceLocationProvider.cs의 UTF-8 인코딩 문제

Assets\Mapbox\Unity\Location\DeviceLocationProvider.cs(321,12): error CS0103: The name 'heading' does not exist in the current context

참고 (Mapbox-Github-Issue)

 

DeviceLocationProvider.cs 스크립트 파일 내 인코딩 문제로 아래와 같이  ° 기호가 깨져서 생기는 문제이다. 

//fix heading to have 0� for north, 90� for east, 180� for south and 270� for west

깨진 녀석들을 모두 찾아서 지워주면 되는데 귀찮으면 여기에 있는 코드를 DeviceLocationProviders.cs에 그냥 붙여 넣어도 됨.

 

 

 

 

2. 토큰 설정하기

Import가 제대로 되었다면, 에디터에 Mapbox메뉴가 생성되고 Setup 설정창이 열린다.

 

Mapbox에 가입하여 발급받은 토큰은 계정 창이나 설치 가이드에서 확인할 수 있다.

설정창에 발급받은 토큰을 입력하고 Submit 한다. 유효성 검증과 동시에 이 프로젝트에서 사용될 토큰으로 저장됨.

 

 

 

 

3. Sample Map 확인하기

해당 토큰을 사용하여 가장 기본적인 Map Prefab을 제대로 불러오는지 확인해보기

- Assets/Mapbox/Prefabs에 있는 Map.prefab을 Hierarchy에 추가한다.

- Location 값을 입력하고, Enable Preview를 활성화하면 Scene에서 지도 데이터를 확인할 수 있다.

 

 

 

4. 주요 구성

 

Mapbox의 Map은 타일 제공자와 타일 오브젝트로 구성된다. 

 

 

타일 오브젝트는 Terrain이 아니고 Mesh Renderer를 가지며 Tile 스크립트를 포함한다.

 

 

맵 설정은 가장 최상단의 Map 오브젝트의 Abstract Map 스크립트에서 관리한다.

 

 

Tile 속성 변경

 

 

Map Material의 Texture

 

 

 

---