routo Developers

시작하기

routo Android SDK 시작하기

1단계	Activity 선택
관련 화면	앱 개발을 위해 Android Studio 에서 새로운 프로젝트를 생성합니다. (Menu > File > New > New Project) 원하는 Activity 선택 후 Next를 클릭합니다.

1단계

Activity 선택

관련 화면

앱 개발을 위해 Android Studio 에서 새로운 프로젝트를 생성합니다. (Menu > File > New > New Project)
원하는 Activity 선택 후 Next를 클릭합니다.

2단계	신규 프로젝트 생성
관련 화면	개발하려는 앱의 프로젝트 명칭을 기입하고 Next를 클릭합니다.

2단계

신규 프로젝트 생성

관련 화면

개발하려는 앱의 프로젝트 명칭을 기입하고 Next를 클릭합니다.

3단계	프로젝트 생성 완료
관련 화면

4단계	라이브러리 추가
관련 화면	libs 폴더에 라이브러리(.aar) 파일을 복사해서 붙여 넣습니다. Build.gradle 파일을 실행합니다. app 수준 gradle 에 다음과 같이 추가한다. 이후, Sync Now 클릭

4단계

라이브러리 추가

관련 화면

libs 폴더에 라이브러리(.aar) 파일을 복사해서 붙여 넣습니다.

Build.gradle 파일을 실행합니다.

app 수준 gradle 에 다음과 같이 추가한다. 이후, Sync Now 클릭

5단계	AndroidManifest 권한 추가
관련 화면	"AndroidManifest.xml" 파일에 아래 내용을 추가합니다. <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

5단계

AndroidManifest 권한 추가

관련 화면

"AndroidManifest.xml" 파일에 아래 내용을 추가합니다.
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

6단계	Key 설정
관련 화면	SDK 에서 appKey 로 인증하는 방법입니다. `PlayMapRestApi mapRestApi = new PlayMapRestApi(mContext); mapRestApi.setPlayMapApiKey("[발급받은 appKey]");`

좌표계

WGS84를 사용합니다.
예) 경도 : 126.952, 위도 : 37.5323

지도 화면 표시(지도생성)

구분 소스코드

관련 화면

구분	소스코드
관련 화면	// import import com.hmns.playmap.PlayMapView; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); //GPS 권한 획득 if (Build.VERSION.SDK_INT >= 23 && ContextCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{android.Manifest.permission.ACCESS_FINE_LOCATION}, 0); } // 지도 생성 PlayMapView mapView; mapView = new PlayMapView(this); mapView = findViewById(R.id.mapView); mapView.onCreate(savedInstanceState); // 지도 생성시 중심점 좌표 설정 mapView.initMap(37.56640, 126.97851, 17); }

// import
import com.hmns.playmap.PlayMapView;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    //GPS 권한 획득
    if (Build.VERSION.SDK_INT >= 23 &&
            ContextCompat.checkSelfPermission(this, android.Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, new String[]{android.Manifest.permission.ACCESS_FINE_LOCATION},
                0);
    }

    // 지도 생성
    PlayMapView mapView;
    mapView = new PlayMapView(this);
    mapView = findViewById(R.id.mapView);
    mapView.onCreate(savedInstanceState);

    // 지도 생성시 중심점 좌표 설정
    mapView.initMap(37.56640, 126.97851, 17);
}

초기화

구분 소스코드

관련 화면

구분	소스코드
관련 화면	`private void initMap() { m_bTrackingMode = true; mapView.removeAllPolyLine(); mapView.removeAllPolygon(); mapView.removeAllCircle(); mapView.removeAllMarkerItem(); mapView.removeAllRectangle(); reverseGeocoding(false); removeMapPath(); reverseLabel(true); m_nCurrentZoomLevel = -1; m_nCurrentMapType = 2; m_bSightVisible = false; totalDistance = null; totalTime = null; totalFare = null; taxiFares = null; items = null; oldBAddress = null; newAddress = null; }`

private void initMap() {

  m_bTrackingMode = true;
  mapView.removeAllPolyLine();
  mapView.removeAllPolygon();
  mapView.removeAllCircle();
  mapView.removeAllMarkerItem();
  mapView.removeAllRectangle();

  reverseGeocoding(false);

  removeMapPath();

  reverseLabel(true);

  m_nCurrentZoomLevel = -1;
  m_nCurrentMapType = 2;
  m_bSightVisible = false;

  totalDistance = null;
  totalTime = null;
  totalFare = null;
  taxiFares = null;

  items = null;
  oldBAddress = null;
  newAddress = null;
}

블랙테마 설정

구분 소스코드

관련 화면

구분	소스코드
관련 화면	지도 타일 테마를 블랙테마로 설정합니다. `mapView.setBlackTheme(true);` `void setMapBlackTheme(boolean enabled)`

지도 타일 테마를 블랙테마로 설정합니다.

mapView.setBlackTheme(true);

void setMapBlackTheme(boolean enabled)