모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps Android API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps Android API 활성화
  3. 적합한 키 생성
계속

시작하기

Android 앱에 지도를 추가하기 위한 빠른 시작 가이드입니다. Android Studio는 Google Maps Android API로 앱을 제작하기 위한 개발 환경으로 권장됩니다.

1단계. Android Studio 다운로드

안내에 따라 Android Studio를 다운로드하고 설치합니다.

2단계. Google Play 서비스 SDK 설치

Google Play 서비스 패키지를 Android Studio에 추가합니다.

3단계. Google Maps 프로젝트 생성

다음 단계에 따라 지도 액티비티를 포함한 새로운 앱 프로젝트를 생성합니다.

  1. Android Studio를 시작합니다.
  2. 다음과 같이 새 프로젝트를 생성합니다.

    • Welcome to Android Studio 대화상자가 보이면, Start a new Android Studio project를 선택합니다. 이 옵션은 대화상자 오른쪽의 'Quick Start' 아래에 있습니다.
    • 그렇지 않은 경우, Android Studio 메뉴 막대에서 File을 클릭한 다음, New, New Project를 차례로 클릭합니다.
  3. 화면 안내에 따라 앱 이름과 회사 도메인, 프로젝트 위치를 입력합니다. 이어서 Next를 클릭합니다.

  4. 앱에 필요한 폼 팩터를 선택합니다. 무엇이 필요한지 모를 경우 Phone and Tablet을 선택합니다. 이어서 Next를 클릭합니다. 1.'Add an activity to Mobile' 대화상자에서 Google Maps 액티비티를 선택합니다. 이어서 Next**를 클릭합니다.
  5. 화면 안내에 따라 액티비티 이름과 레이아웃 이름, 제목을 입력합니다. 기본값은 fine입니다. 이어서 Finish를 클릭합니다.

Android Studio가 Gradle을 시작하고 프로젝트를 빌드합니다. 이 과정은 몇 초 정도 걸릴 수 있습니다. Android Studio에서 프로젝트를 생성하는 방법에 대한 자세한 내용은 Android Studio 문서를 참조하세요.

빌드가 완료되면 Android Studio가 편집기에서 google_maps_api.xmlMapsActivity.java 파일을 엽니다. (액티비티는 이름이 다를 수 있으나 설정에서 구성한 액티비티여야 합니다.) google_maps_api.xml 파일에는 애플리케이션을 실행하기 전에 Google Maps API 키를 가져오는 방법에 대한 안내가 포함되어 있습니다. 다음 섹션에서는 API 키를 가져오는 방법에 대해 자세히 설명합니다.

4단계. Google Maps API 키 가져오기

Google 지도 서버에 액세스하려면 애플리케이션에 API 키가 필요합니다. 필요한 키 유형은 Android 앱에 제한된 API 키입니다. 이 키는 무료입니다. 이 키는 Google Maps Android API를 호출하는 모든 애플리케이션에서 사용할 수 있으며,무제한의 사용자를 지원합니다.

다음 중 하나를 선택하여 Android Studio에서 API 키를 가져옵니다.

  • 빠르고 쉬운 방법: Android Studio가 생성한 google_maps_api.xml 파일에 있는 링크를 사용합니다.
    1. google_maps_api.xml 파일에 있는 링크를 복사하여 브라우저에 붙여넣습니다. 링크를 누르면 Google API Console로 이동하고, URL 매개변수를 통해 필수 정보를 Google API Console에 제공하므로, 개발자가 수동으로 입력해야 하는 항목이 줄어듭니다.
    2. 지침에 따라 Google API Console에서 새 프로젝트를 생성하거나 기존 프로젝트를 선택합니다.
    3. 프로젝트의 Android 제한 API 키를 생성합니다.
    4. 생성된 API 키를 복사하고 Android Studio로 돌아간 다음, google_maps_api.xml 파일의 <string> 요소에 API 키를 붙여넣습니다.
  • 약간 덜 빠른 방법: Android Studio가 생성한 google_maps_api.xml 파일에 있는 자격 증명을 사용합니다.
    1. google_maps_api.xml 파일에서 제공하는 자격 증명을 복사합니다.
    2. 브라우저에서 Google API Console로 이동합니다.
    3. 복사한 자격 증명을 사용하여 기존 API 키에 앱을 추가하거나 새 API 키를 생성합니다.
  • API 키를 가져오는 전체 프로세스: 위 두 가지 중 어느 옵션도 선택할 수 없는 상황이라면 전체 프로세스를 따릅니다.

5단계. Hello Map! 코드 살펴보기

템플릿에서 제공되는 코드를 살펴봅니다. 특히 Android Studio 프로젝트에서 다음 파일을 살펴봅니다.

XML 레이아웃 파일

기본적으로, 앱 레이아웃을 정의하는 XML 파일은 res/layout/activity_maps.xml입니다. 여기에는 다음 코드가 포함되어 있습니다.

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/map"
    tools:context=".MapsActivity"
    android:name="com.google.android.gms.maps.SupportMapFragment" />

지도 액티비티 Java 파일

기본적으로, 지도 액티비티를 정의하는 Java 파일은 MapsActivity.java입니다. 패키지 이름 뒤에 다음 코드가 포함되어야 합니다.

import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
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 {

    private 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;

        // Add a marker in Sydney, Australia, and move the camera.
        LatLng sydney = new LatLng(-34, 151);
        mMap.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
        mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney));
    }
}

지도 액티비티 파일에 위의 코드가 포함되지 않았다면, 패키지 이름 뒤의 파일 콘텐츠를 위의 코드로 교체하세요.

6단계. Android 기기 연결

앱이 작동하는 것을 볼 수 있는 가장 간단한 방법은 Android 기기를 컴퓨터에 연결하는 것입니다. 안내에 따라 Android 기기에서 개발자 옵션을 활성화하고 애플리케이션과 시스템이 기기를 인식하도록 구성합니다.

또는, Android Emulator를 사용하여 앱을 실행할 수 있습니다. Android Virtual Device (AVD) Manager를 사용하여 하나 이상의 가상 기기를 구성합니다. 이 가상 기기는 Android Emulator에서 앱을 빌드하고 실행할 때 사용할 수 있습니다. 에뮬레이터를 선택할 때는Android 4.2.2 이상을 사용하는지 확인하고 Google API를 포함한 이미지를 선택하도록 주의하십시오. 그렇지 않으면 애플리케이션이 실행에 필요한 필수 런타임 API를 갖지 못하게 됩니다. 또한, 가상 머신 가속 구성에 대한 지침을 살펴보세요. 지침에 설명된 것처럼 x86 대상 AVD에서 사용해야 합니다. 그러면 에뮬레이터의 사용자 경험이 개선됩니다.

7단계. 앱 빌드 및 실행

Android Studio에서 Run 메뉴 옵션(또는 재생 버튼 아이콘)을 클릭하고 앱을 실행합니다.

기기를 선택하라는 메시지가 나타나면 다음 옵션 중 하나를 선택합니다.

  • 컴퓨터에 연결된 Android 기기를 선택합니다.
  • 또는 Launch emulator 라디오 버튼을 선택하고 이전에 구성한 가상 기기를 선택합니다.

OK를 클릭합니다. Android Studio가 Gradle을 호출하여 앱을 빌드하고 기기나 에뮬레이터에 그 결과를 표시합니다. 앱이 열리기까지 몇 분 정도 걸릴 수 있습니다.

오스트레일리아 시드니 위에 마커가 있는 지도가 나타나야 합니다. 지도가 보이지 않으면, 이 페이지에서 설명하는 모든 단계를 완료했는지 확인하세요. 특히 에 설명된 것처럼 API 키를 추가했는지 확인하세요.

다음 단계

일부 샘플 코드를 살펴볼 수도 있습니다.

개발자 가이드에서 지도 객체에 대한 자세한 내용을 찾을 수 있습니다.

다음에 대한 의견 보내기...

Google Maps Android API
Google Maps Android API
도움이 필요하시나요? 지원 페이지를 방문하세요.