Computer >> 컴퓨터 >  >> 프로그래밍 >> Android

안드로이드 구글 지도에 현재 위치 표시하는 방법 완벽 가이드

이 튜토리얼에서는 안드로이드 앱에서 구글 지도(Google Maps)에 사용자의 현재 위치를 표시하는 방법을 단계별로 알아봅니다. FusedLocationProviderClient를 활용해 위치 정보를 가져오고, 지도 위에 마커를 추가하는 전체 과정을 다룹니다.

1단계: 새 프로젝트 생성

Android Studio에서 File → New Project를 선택하고, 필요한 모든 세부 정보를 입력하여 새 프로젝트를 생성합니다.

2단계: 레이아웃 파일 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가하여 지도 프래그먼트를 배치합니다.

<?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/myMap"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity" />

3단계: 의존성(Dependency) 추가

build.gradle(Module: app) 파일에 구글 플레이 서비스 관련 라이브러리를 추가합니다.

implementation 'com.google.android.gms:play-services-maps:17.0.0'
implementation 'com.google.android.gms:play-services-location:17.0.0'

4단계: MainActivity 코드 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다. 이 코드는 위치 권한을 확인하고, 마지막으로 알려진 위치를 가져온 후 지도에 마커를 표시하는 로직을 포함합니다.

import android.Manifest;
import android.content.pm.PackageManager;
import android.location.Location;
import android.os.Bundle;
import android.widget.Toast;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.location.FusedLocationProviderClient;
import com.google.android.gms.location.LocationServices;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;
import com.google.android.gms.tasks.OnSuccessListener;
import com.google.android.gms.tasks.Task;
import androidx.annotation.NonNull;
import androidx.core.app.ActivityCompat;
import androidx.fragment.app.FragmentActivity;
public class MainActivity extends FragmentActivity implements OnMapReadyCallback {
    Location currentLocation;
    FusedLocationProviderClient fusedLocationProviderClient;
    private static final int REQUEST_CODE = 101
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        fusedLocationProviderClient = LocationServices.getFusedLocationProviderClient(this);
        fetchLocation();
    }
    private void fetchLocation() {
        if (ActivityCompat.checkSelfPermission(
            this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(
            this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, REQUEST_CODE);
            return;
        }
        Task<Location> task = fusedLocationProviderClient.getLastLocation();
        task.addOnSuccessListener(new OnSuccessListener<Location>() {
            @Override
            public void onSuccess(Location location) {
                if (location != null) {
                    currentLocation = location;
                    Toast.makeText(getApplicationContext(), currentLocation.getLatitude() + "" + currentLocation.getLongitude(), Toast.LENGTH_SHORT).show();
                    SupportMapFragment supportMapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.myMap);
                    assert supportMapFragment != null;
                    supportMapFragment.getMapAsync(MainActivity.this);
                }
            }
        });
    }
    @Override
    public void onMapReady(GoogleMap googleMap) {
        LatLng latLng = new LatLng(currentLocation.getLatitude(), currentLocation.getLongitude());
        MarkerOptions markerOptions = new MarkerOptions().position(latLng).title("I am here!");
        googleMap.animateCamera(CameraUpdateFactory.newLatLng(latLng));
        googleMap.animateCamera(CameraUpdateFactory.newLatLngZoom(latLng, 5));
        googleMap.addMarker(markerOptions);
    }
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        switch (requestCode) {
            case REQUEST_CODE:
                if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    fetchLocation();
            }
            break;
        }
    }
}

주요 코드 설명

  • fetchLocation(): 위치 권한(ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION)이 부여되었는지 확인하고, 권한이 없으면 사용자에게 요청합니다.
  • getLastLocation(): FusedLocationProviderClient를 통해 기기의 마지막 위치를 비동기적으로 가져옵니다.
  • onMapReady(): 지도가 준비되면 현재 좌표에 마커를 추가하고 카메라를 해당 위치로 이동시킵니다.

5단계: strings.xml 설정

strings.xml 파일을 열고 아래 코드를 추가합니다. 여기서 map_key 값은 나중에 발급받은 구글 API 키로 대체됩니다.

<resources>
    <string name="app_name">Sample</string>
    <string name="map_key" translatable="false">Enter your google API key here</string>
</resources>

6단계: 구글 API 키 발급 받기

구글 지도를 사용하려면 API 키(map_key)가 필요합니다. 다음 절차에 따라 발급받으세요.

  • Google Cloud Platform Console에 접속합니다.
  • 상단의 프로젝트 드롭다운 메뉴를 클릭하여 API 키를 추가할 프로젝트를 선택하거나 새로 생성합니다.
  • 메뉴 버튼을 클릭한 후 APIs & Services → Credentials(사용자 인증 정보)를 선택합니다.
  • Credentials 페이지에서 Create credentials → API key를 클릭합니다. 생성된 API 키가 대화상자에 표시됩니다.
  • Close를 클릭하여 창을 닫습니다.
  • 새로 만든 API 키는 Credentials 페이지의 API keys 목록에서 확인할 수 있습니다. 참고: 실제 서비스 배포 전에는 반드시 API 키에 사용 제한(Restriction)을 설정해야 합니다.

7단계: AndroidManifest.xml 수정

androidManifest.xml 파일에 인터넷 및 위치 권한과 함께 API 키 메타데이터를 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <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">
        <meta-data android:name="com.google.android.geo.API_KEY" android:value="@string/map_key"/>
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 스마트폰을 컴퓨터에 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 아이콘을 클릭하세요. 실행 옵션에서 본인의 모바일 기기를 선택하면, 앱이 실행되며 현재 위치 좌표가 토스트 메시지로 표시되고 지도에는 해당 위치에 마커가 나타납니다.