안드로이드 T MAP API 설치하기

1. 개발자 등록하기 

https://developers.skplanetx.com/login/?cmtUrl=/ 페이지로 이동. 

회원 가입 하기 -> 이메일 인증 필요

내가 사용할 T map API , 사용 제한이 있긴 하나 프로토 타입으로 개발하고 데모 쇼를 할 예정이라 상관 없을듯.

T map

T map 서비스는 SK planet에서 제공하는 지도 및 텔레매틱스 서비스를 위한 통합 브랜드입니다.

목적지 통합검색 기능, 출/도착시간을 예측하는 타임머신 기능, 실시간 버스 정보를 제공하는 대중교통 기능, 

멀티 터치 기능을 통해 지도를 보는 기능 및 음성으로 목적지를 검색하는 기능을 제공합니다.

<사용량>  
  - POI (장소 명칭/주소 검색)  : 50,000회/일 이하
  - 지도 보기(Map Display) : 50,000회/일 이하
  - 주소검색(Geocoding/Reverse Geocoding) : 50,000회/일 이하
  - T map 연동(T map App Invoke): 50,000회/일 이하
  - 경로안내 : 10,000회/일 이하
  - 다중경로안내 : 1,000회/일 이하
  - 교통정보 : 1,000회/일 이하
  - Geofencing : 1,000회/일 이하

<사용 목적>
  - API를 이용한 서비스가 이용료나 광고 등을 통한 영리를 추구하지 않는 경우
  - 사용자를 특정하지 않고 모든 사용자에게 서비스를 제공하는 경우
  - 기타 SK플래닛이 이용을 제한하거나 금지하지 않는 경우

API 사용 관련 내용은 위와 같고, 경로안내는 두가지 방법이 존재하더라.

KML

이러한 XML에서 파생되어 XML의 문법 규칙을 따르는 KML은 구글어스, 구글맵 및 기타 응용 프로그램에서 쓰이는 XML 기반의 

마크업 언어의 스키마이며, 지형 정보(Annotation)를 모델링하고 표현하는 역할을 합니다.

GeoJSON

GeoJSON은 다양한 지리적 데이터 구조를 표현하기 위한 인코딩 형식이다. GeoJSON객체는 점, 선, 다각형, MultiLineString, multiPolygon등을 표현해낸다.

KML / GEOJson 어느 것을 선택?

URL, 링크, Ajax통신으로 호출했을 때 응답 방법 중 가장 많이 사용되는 것이 XML이다.  현재는 json을 많이 쓰는 추세이지만 

XML은 노드 구조를 정의하고 표준 통용되고 있기 때문에 대부분의 플랫폼 사이에서 복잡한 데이터 구조로 데이터를 주고 받는데 사용된다.

위에서 언급했듯이 현재는 json이 대세이다. json은 javascript에서 사용되는 object와 같은 가지고 있기 때문에 parsing과정에서 부하를 줄이고 

코딩이 쉽다는 장점이 있다. KML은 xml 구조기반이고 GEOJson은 json 구조 기반이다.

결과적으로 가볍고 코딩이 쉬운 GeoJSON을 선택하도록 하자. 

아차! API를 사용하는 앱 개발에 앞서, 앱 등록 및 API 인증키 발급을 진행해야 한다.

https://developers.skplanetx.com/develop/app/

App Key를 받았으니, Adroid 용 SDK 를 다운 받는다. 

https://github.com/skplanetx/planetx-android-sdk

설치하는 방법은 아래에 친절하게 적혀 있으나, Android studio 에서는 어떻게 설치하는 지 알 수 없었다.

포럼 커뮤니티에 친절한 답변을 볼 수 있었다. 

https://developers.skplanetx.com/develop/doc/sdk/open-api/android-tutorial/

안녕하세요 개발자센터 입니다.

Tmap용 Android SDK는
홈페이지 API소개 -> SDK -> 서비스별SDK -> Tmap SDK(Android)
에서 다운받으실수 있습니다.
안드로이드 스튜디오도 이클리스와 똑같이
libs폴더에 해당 jar파일을 넣으시고 설정하신후
같은 소스코드를 사용하시면 됩니다.

감사합니다.

그럼 그냥 그대로 진행해 본다. ADT Plugin과 EGit Plugin이 눈에 거슬리지만 일단 고.

New Android project 생성 > Empty Activity 선택

+ Manifest 파일 수정

안드로이드에서 인터넷 접근 권한 활성화를 위해 AndroidManifest.xml 파일에 아래 항목을 추가합니다.

* uses-permission은 Application 태그 뒤에 위치해야 합니다.

+ PlanetX Android SDK GitHub에서 내려받기

- PlanetX Android SDK GitHub URL : https://github.com/skplanetx/planetx-android-sdk

위 주소 복사 후 안드로이드 스튜디오에서 다운로드 하기.

VCS > Enable Version Control Integration 후 Git를 선택한다

* Mac 맥에서 Git Enable시 오류가 나면 터미널에서 아래와 같이 수행

Agreeing to the Xcode/iOS license requires admin privileges, please re-run as root via sudo cannot run git 문제 발생시 

터미널에서 sudo xcodebuilde -license 입력하고 > enter > space 연타 > agree 입력

프로젝트 선택하고 오른쪽 클릭하면 Git 메뉴가 있고 Add 클릭.

**GitHub에서 다운받고 해보다가 실패... 최신버전의 sample 프로그램이 있어 그걸 사용함