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

안드로이드 구글 지도에서 터치 및 위치 감지하는 방법 (단계별 튜토리얼)

이 튜토리얼에서는 안드로이드 앱에서 구글 지도(Google Maps)의 터치 이벤트와 그 위치를 감지하는 방법을 단계별로 알아봅니다. 카메라 이동 리스너를 활용하면 사용자가 지도를 제스처로 조작했는지, 아니면 앱이 카메라를 이동시켰는지 구분할 수 있습니다.

1단계: 새 프로젝트 생성

Android Studio에서 새 프로젝트를 생성합니다. 상단 메뉴에서 File → New → Google Maps 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/map"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MapsActivity" />

3단계: 메인 액티비티 구현

src/MainActivity.java에 다음 코드를 추가합니다. 핵심은 GoogleMap.OnCameraMoveStartedListener 등 여러 카메라 리스너 인터페이스를 구현하는 것입니다.

import androidx.fragment.app.FragmentActivity;
import android.os.Bundle;
import android.widget.Toast;
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.OnCameraMoveStartedListener,
    GoogleMap.OnCameraMoveListener,
    GoogleMap.OnCameraMoveCanceledListener,
    GoogleMap.OnCameraIdleListener {

    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_maps);
        // SupportMapFragment를 가져오고 지도가 준비되면 알림을 받습니다.
        SupportMapFragment mapFragment = (SupportMapFragment)
            getSupportFragmentManager().findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    @Override
    public void onMapReady(GoogleMap googleMap) {
        mMap = googleMap;
        // 시드니에 마커를 추가하고 카메라를 이동합니다.
        LatLng sydney = new LatLng(-34, 151);
        mMap.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
        mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney));
        mMap.setOnCameraIdleListener(this);
        mMap.setOnCameraMoveStartedListener(this);
        mMap.setOnCameraMoveListener(this);
        mMap.setOnCameraMoveCanceledListener(this);
    }

    @Override
    public void onCameraMoveStarted(int reason) {
        if (reason == GoogleMap.OnCameraMoveStartedListener.REASON_GESTURE) {
            Toast.makeText(this, "사용자가 지도를 제스처로 조작했습니다.", Toast.LENGTH_SHORT).show();
        }
        else if (reason == GoogleMap.OnCameraMoveStartedListener.REASON_API_ANIMATION) {
            Toast.makeText(this, "사용자가 지도의 요소를 탭했습니다.", Toast.LENGTH_SHORT).show();
        }
        else if (reason == GoogleMap.OnCameraMoveStartedListener.REASON_DEVELOPER_ANIMATION) {
            Toast.makeText(this, "앱이 카메라를 이동시켰습니다.", Toast.LENGTH_SHORT).show();
        }
    }

    @Override
    public void onCameraMove() {
        Toast.makeText(this, "카메라가 이동 중입니다.", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onCameraMoveCanceled() {
        Toast.makeText(this, "카메라 이동이 취소되었습니다.", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onCameraIdle() {
        Toast.makeText(this, "카메라 이동이 멈췄습니다.", Toast.LENGTH_SHORT).show();
    }
}

핵심 포인트: 카메라 이동 원인 구분하기

onCameraMoveStarted(int reason) 콜백의 reason 매개변수를 확인하면 지도 조작의 출처를 파악할 수 있습니다.

  • REASON_GESTURE: 사용자가 직접 드래그·핀치 등 제스처로 지도를 움직인 경우
  • REASON_API_ANIMATION: 사용자가 마커나 버튼을 탭해 API 애니메이션이 실행된 경우
  • REASON_DEVELOPER_ANIMATION: 개발자가 작성한 코드가 카메라를 이동시킨 경우

4단계: API 키 등록

google_maps_api.xml 파일에 발급받은 구글 맵 API 키를 입력합니다.

<resources>
    <string name="google_maps_key" templateMergeStrategy="preserve" translatable="false">YOUR MAP KEY</string>
</resources>

5단계: 매니페스트 설정

androidManifest.xml에 아래 코드를 추가합니다. API 키 메타데이터와 위치 권한 선언이 포함되어야 합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.myapplication">
    <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 Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run(실행) 아이콘을 클릭하세요. 실행 옵션 목록에서 본인의 모바일 기기를 선택하면, 기기 화면에 아래와 같은 결과가 표시됩니다.

안드로이드 구글 지도에서 터치 및 위치 감지하는 방법 (단계별 튜토리얼)

지도를 손가락으로 드래그하거나 확대·축소하면 각 상황에 맞는 토스트 메시지가 화면 하단에 나타나며, 카메라 이동이 시작·진행·취소·종료되는 시점을 실시간으로 감지할 수 있습니다.