이 튜토리얼에서는 Android에서 Location API를 활용해 현재 위치를 추적하고, Google Maps 지도 위에 해당 위치를 마커로 표시하는 방법을 단계별로 알아봅니다. 각 단계마다 필요한 코드와 설정 파일을 함께 다루므로, 처음 위치 기반 앱을 개발하는 분도 쉽게 따라 할 수 있습니다.
1단계 – 새 프로젝트 생성 및 의존성 추가
Android Studio에서 File → New Project를 선택한 후, 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다.
그다음 build.gradle(Module: app) 파일에 Google Play Services Maps 라이브러리 의존성을 추가합니다. 이 라이브러리가 있어야 지도 기능을 사용할 수 있습니다.
implementation 'com.google.android.gms:play-services-maps:17.0.0'
2단계 – 레이아웃 파일(activity_main.xml) 작성
지도를 화면 전체에 표시하기 위해 res/layout/activity_main.xml에 아래와 같이 SupportMapFragment를 배치합니다.
<?xml version="1.0" encoding="utf-8"?> <fragment xmlns:android="https://schemas.android.com/apk/res/android" xmlns:tools="https://schemas.android.com/tools" android:id="@+id/map" android:name="com.google.android.gms.maps.SupportMapFragment" android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".MapsActivity" />
3단계 – MainActivity.java에서 지도 초기화 및 마커 표시
src/MainActivity.java에 아래 코드를 작성합니다. 핵심 흐름은 다음과 같습니다.
SupportMapFragment를 가져온 뒤getMapAsync()를 호출해 지도 로딩을 요청합니다.- 지도가 준비되면
onMapReady()콜백이 실행됩니다. - 현재 위치의 위도·경도(
LatLng)를 지정하고, 그 좌표에 마커를 추가합니다. moveCamera()로 카메라를 해당 위치로 이동시켜 화면에 표시합니다.
import androidx.fragment.app.FragmentActivity;
import android.os.Bundle;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;
public class MapsActivity extends FragmentActivity implements
OnMapReadyCallback {
GoogleMap mMap;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_maps);
SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
mapFragment.getMapAsync(this);
}
@Override
public void onMapReady(GoogleMap googleMap) {
mMap = googleMap;
LatLng myCurrentLocation = new LatLng(13.0827, 80.2707);
mMap.addMarker(new MarkerOptions().position(myCurrentLocation).title("This is My current Location"));
mMap.moveCamera(CameraUpdateFactory.newLatLng(myCurrentLocation));
}
}위 예제에서는 설명을 위해 고정 좌표(13.0827, 80.2707)를 사용했습니다. 실제 기기의 실시간 위치를 가져오려면 이 값을 FusedLocationProviderClient 등으로 조회한 좌표로 대체하면 됩니다.
4단계 – strings.xml에 Google Maps API 키 등록
res/strings.xml을 열고 아래처럼 앱 이름과 Google Maps API 키를 추가합니다. API 키는 Google Cloud Console에서 발급받은 본인의 키를 사용해야 합니다.
<resources> <string name="app_name">Sample</string> <string name="title_activity_maps">Map</string> <string name="google_maps_key" templateMergeStrategy="preserve" translatable="false">AIzaSyC19gZFIlF5OVySzG9iMAeDFzOmUuCHZ5Q</string> </resources>
5단계 – AndroidManifest.xml 설정
마지막으로 androidManifest.xml에 지도 Activity와 메타 데이터(API 키 참조), 그리고 위치 권한을 선언합니다. 특히 ACCESS_FINE_LOCATION 권한이 있어야 정확한 위치 정보를 사용할 수 있습니다.
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample"> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="true" android:theme="@style/AppTheme"> <activity android:name=".MapsActivity" android:label="@string/title_activity_maps"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <meta-data android:name="com.google.android.geo.API_KEY" android:value="@string/google_maps_key" /> </application> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> </manifest>
앱 실행 및 결과 확인
모든 설정이 끝났다면 앱을 실행해 결과를 확인해 보겠습니다. 실제 Android 스마트폰을 컴퓨터에 연결한 상태라고 가정합니다. Android Studio에서 프로젝트의 Activity 파일 중 하나를 연 뒤, 툴바의 Run(실행) 아이콘을 클릭하세요. 실행 대상으로 자신의 모바일 기기를 선택하면, 기기 화면에 지도가 나타나고 현재 위치에 마커가 표시되는 것을 확인할 수 있습니다.
