모든 준비를 마쳤습니다!

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

Google Places API for Android 활성화

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

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

시작하기

이 가이드에서는 Google Places API for Android의 기능을 소개하고 API 사용을 위한 앱 구성 방법을 보여줍니다.

  1. 소개 및 개념
  2. API 개요
  3. 지원되는 Android 플랫폼 버전
  4. 앱 구성
    1. Google Play 서비스 설정
    2. API 키 추가
    3. 사용 제한 상향 요청
  5. Places API에 연결

소개 및 개념

Google Places API for Android의 주요 진입점은 PlacePicker UI 위젯, Autocomplete UI 위젯, GeoDataApiPlaceDetectionApi입니다.

Google Places API for Android를 사용하면 상황에 맞게 기기 근처의 지역 사업체와 다른 장소에 응답하는 위치 인식 앱을 구축할 수 있습니다. 즉, 사용자에게 의미가 있는 장소를 기반으로 앱을 구축하고, Android 위치 서비스가 제공하는 지리 기반 서비스를 쉽게 보완할 수 있습니다.

장소는 이름을 지닌 물리적 공간으로 정의됩니다. 달리 생각하면 장소는 지도에서 찾을 수 있는 모든 것입니다. 이러한 예로는 지역 사업체, 관심 지점 및 지리적 위치가 포함됩니다. API에서 장소는 Place 인터페이스로 나타냅니다. 여기에는 장소 이름 및 주소, 지리적 위치, 장소 ID, 전화번호, 장소 유형, 웹사이트 URL 등과 같은 정보가 포함됩니다.

API 개요

고객이 어디에 있고 고객 주변에 무엇이 있는지 탐색하도록 도와줍니다.

  • 내장 장소 선택기 UI 위젯을 사용하여 사용자가 대화형 지도에서 장소를 선택할 수 있습니다.
  • 가장 최근에 기기가 있었던 장소인 현재 장소를 가져옵니다. API는 예상 장소 목록과 각 장소에 대한 상대적 유사도 표시를 반환합니다.
  • 사용자가 쿼리를 입력할 때 자동완성을 통해 장소 이름과 주소를 쉽게 입력할 수 있습니다. Autocomplete UI 위젯을 사용하거나 장소를 예측하는 API를 호출합니다.
  • 풍부한 장소에 대한 정보를 검색하고 표시합니다.
  • 고화질 장소 사진에 액세스합니다.

최신 지역 정보를 제공하여 여러분의 앱을 차별화하세요.

  • Google Places 데이터베이스에 장소를 추가하여 수정 후에 자신의 앱 내에서 즉시 검색하고 다른 앱에 표시할 수 있습니다.
  • 장소를 보고하여 기기가 현재 특정 장소에 있음을 알려줍니다.
  • 하나 이상의 장소에 대해 고유한 장소 ID를 저장하고 필요에 따라 이 ID를 사용하여 장소 정보를 검색합니다.

다음은 API의 몇 가지 기타 주요 사항입니다.

  • WiFi 검색시 낮은 성능에서도 정확한 장소 탐지.
  • 기기에 캐싱: 대부분의 Google Places API for Android 요청은 Google 서버로의 왕복이 포함되지만, 30일 동안 로컬로 데이터를 캐싱할 수 있습니다.

지원되는 Android 플랫폼 버전

Google Places API for Android는 Google Play 서비스에서 지원하는 모든 Android 버전에서 사용할 수 있습니다. 다양한 플랫폼 버전 지원에 대한 Android 가이드를 참조하세요.

앱 구성

Google Places API for Android를 사용하는 모든 앱에 대해 다음 구성 단계가 필요합니다.

Google Play 서비스 설정

Google Places API for Android에 액세스하려면 앱의 개발 프로젝트에 Google Play 서비스를 포함해야 합니다. SDK Manager를 통해 Google Play 서비스 구성 요소를 다운로드 및 설치하고 프로젝트에 라이브러리를 추가합니다. 자세한 내용은 Google Play 서비스 설치에 대한 Android 가이드를 참조하세요.

API 키 추가

아직 API 키를 획득하지 않고 Google Places API for Android를 활성화한 경우, 등록 가이드의 지침에 따라 지금 획득하세요.

다음 코드 샘플에 나오는 것처럼 API 키를 앱 매니페스트에 추가하고 YOUR_API_KEY를 자신의 API 키로 대체합니다.

<application>
  ...
  <meta-data
      android:name="com.google.android.geo.API_KEY"
      android:value="YOUR_API_KEY"/>
</application>

사용 제한 상향 요청

모든 앱에서 Google Places API for Android 사용은 무료이고 제한이 없습니다. 그러나 모든 앱에서 공평하게 사용할 수 있도록, 일부 메서드에 대해 계층화된 쿼리 제한이 있습니다.

Google Places API for Android는 24시간당 1,000개의 요청을 기본 제한으로 설정합니다. 앱이 한도를 초과하면 실패하기 시작합니다.

앱이 24시간당 150,000개의 요청에 도달하면 추가 검사 기준이 있습니다. 앱이 한도를 초과하면 다시 실패하기 시작합니다.

허용된 기본 요청 수를 초과할 것으로 예상되면 미리 한도를 높이기 위한 조치를 취하세요. 사용 제한 가이드를 참조하세요.

Places API에 연결

다음 인터페이스는 Google Places API for Android에 대한 기본 진입점을 제공합니다.

  • GeoDataApi는 Google의 로컬 장소 및 사업체 정보 데이터베이스에 대한 액세스를 제공합니다.
  • PlaceDetectionApi는 기기의 현재 장소에 대한 빠른 액세스를 제공하고, 특정 장소에서 기기의 위치를 보고하는 기회를 제공합니다.

API에 연결하려면 Google Play 서비스 API 클라이언트의 인스턴스를 생성해야 합니다. 프래그먼트나 액티비티의 onCreate() 메서드에서 GoogleApiClient.Builder를 사용하여 Google API 클라이언트의 인스턴스를 생성합니다. 다음 코드 샘플에 나오는 것처럼 빌더를 사용하여 필요한 API를 추가합니다.

import com.google.android.gms.common.api.GoogleApiClient;
import com.google.android.gms.common.api.GoogleApiClient.OnConnectionFailedListener;
import android.support.v4.app.FragmentActivity;

public class MyActivity extends FragmentActivity 
        implements OnConnectionFailedListener {
    private GoogleApiClient mGoogleApiClient;

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

        mGoogleApiClient = new GoogleApiClient
                .Builder(this)
                .addApi(Places.GEO_DATA_API)
                .addApi(Places.PLACE_DETECTION_API)
                .enableAutoManage(this, this)
                .build();
    }

    // TODO: Please implement GoogleApiClient.OnConnectionFailedListener to
    // handle connection failures.
}

코드 샘플에 나오는 것처럼, Places 클래스는 GoogleApiClient.Builder로 전달되어GeoDataApiPlaceDetectionApi를 활성화할 수 있는 토큰을 제공합니다.

클라이언트 사용에 대한 자세한 내용은 Google API 액세스에 대한 Android 가이드를 참조하세요. 특히 addConnectionCallbacks()addOnConnectionFailedListener()에 대한 자세한 내용은 가이드의 연결 시작연결 실패 처리를 참조하세요.

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

location_on
Google Places API for Android