이 문서에서는 Android용 Places SDK 사용을 위한 필수 요건, 사용 설정 방법, 인증된 요청을 만드는 방법을 설명합니다.
|
기본 요건을 충족하는지 확인합니다. |
Google Cloud 프로젝트에서 SDK를 사용 설정합니다. |
Android용 Places SDK와 함께 사용할 API 키를 구성합니다. |
Android용 Places SDK 설정
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-22(UTC)
[null,null,["최종 업데이트: 2025-08-22(UTC)"],[[["\u003cp\u003eTo use the Places SDK for Android, you'll need a project with billing enabled and the Places SDK enabled, which can be set up through the Cloud Console.\u003c/p\u003e\n"],["\u003cp\u003eAn API key, a unique identifier for authentication and billing, is required and can be created through the Cloud Console or the Cloud SDK.\u003c/p\u003e\n"],["\u003cp\u003eFor security, Google strongly recommends restricting your API keys by limiting their usage to necessary APIs and applying application restrictions with package names and SHA-1 certificate fingerprints.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API key, configure a project as detailed in the 'Set Up an Android Studio Project' documentation after obtaining the key.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/maps/documentation/places/android-sdk/get-api-key \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/get-api-key \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/get-api-key \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/places/web-service/get-api-key \"View this page for the Web Service platform docs.\") \n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nBefore you begin\n\nBefore you start using the Places SDK for Android, you need a project with a billing account and the\nPlaces SDK for Android enabled. To learn more, see [Set up in Cloud console](/maps/documentation/places/android-sdk/cloud-setup).\n\nCreating API keys **Note:**If you are using both the Places SDK for Android (Legacy) and Places SDK for Android (New), you can enable them both on the same API key.\n\nThe API key is a unique identifier that authenticates requests associated with your project for\nusage and billing purposes. You must have at least one API key associated with your project.\n\nTo create an API key:\n\nConsole \n\n1. Go to the **Google Maps Platform \\\u003e Credentials** page.\n\n [Go to the Credentials page](https://console.cloud.google.com/project/_/google/maps-apis/credentials?utm_source=Docs_CreateAPIKey&utm_content=Docs_places-backend)\n2. On the **Credentials** page, click **Create credentials \\\u003e API key** . \n The **API key created** dialog displays your newly created API key.\n3. Click **Close.** \n The new API key is listed on the **Credentials** page under **API keys** . \n (Remember to [restrict the API](/maps/api-security-best-practices#restricting-api-keys) key before using it in production.)\n\nCloud SDK \n\n```bash\ngcloud services api-keys create \\\n --project \"\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\" \\\n --display-name \"\u003cvar translate=\"no\"\u003eDISPLAY_NAME\u003c/var\u003e\"\n```\n\nRead more about the\n[Google Cloud SDK](https://cloud.google.com/sdk)\n,\n[Cloud SDK installation](https://cloud.google.com/sdk/docs/install)\n, and the following commands:\n\n- [`gcloud services api-keys create`](https://cloud.google.com/sdk/gcloud/reference/services/api-keys/create)\n| **Note:** You can use the same API key for your [Maps SDK for Android](/maps/documentation/android-sdk) and [Places SDK for Android](/maps/documentation/places/android-sdk) apps.\n\nRestricting API keys\n\nGoogle strongly recommends that you restrict your API keys by limiting their usage to those only\nAPIs needed for your application. Restricting API keys adds security to your application by\nprotecting it from unwarranted requests. For more information, see\n[API security best practices](/maps/api-security-best-practices#restrict_apikey).\n\n| When restricting an API key in the Cloud console, **Application restrictions** override any APIs enabled under **API restrictions**. Follow best practices by creating a separate API key for each app, and for each platform on which that app is available.\n\nWhen you restrict your API key, you must provide the SHA-1 certificate fingerprint of the\nsigning key that was used to sign the application. There are two certificate types:\n\n- **Debug certificate**: Only use this certificate type with apps you're testing and other non-production code. Do not attempt to publish an app that's signed with a debug certificate. The Android SDK tools generate this certificate automatically when you run a debug build.\n- **Release certificate**: Use this certificate when you're ready to release your app to an app store. The Android SDK tools generate this certificate when you run a release build.\n\nFor more information about Android application signing and certificates, see the\n[Sign your app](https://developer.android.com/tools/publishing/app-signing.html)\nguide.\n\nFor instructions on how to find your signing certificate fingerprint, see the references below:\n\n\n- If you're using **Play App Signing** , see [Working with API Providers](https://developer.android.com/studio/publish/app-signing#api-providers).\n- If you manage your own signing key, see [Self-signing your application](https://developers.google.com/android/guides/client-auth#self-signing_your_application) or refer to the instructions for your build environment.\n\nTo restrict an API key:\n\nConsole\n\n1. Go to the **Google Maps Platform \\\u003e Credentials** page.\n\n [Go to the Credentials page](https://console.cloud.google.com/project/_/google/maps-apis/credentials?utm_source=Docs_RestrictAPIKey&utm_content=Docs_places-backend)\n2. Select the API key that you want to set a restriction on. The API key property page appears.\n3. Under **Key restrictions**, set the following restrictions:\n - Application restrictions:\n 1. Select **Android apps**.\n 2. Click **+ Add package name and fingerprint**.\n 3. Enter your package name and SHA-1 certificate fingerprint. For example: \n\n ```\n com.example.android.mapexample\n ``` \n\n ```\n BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75\n ```\n - API restrictions:\n 1. Click **Restrict key**.\n 2. Select either **Places API** or **Places API (New)** from **Select APIs** dropdown, but not both. If the Places API is not listed, you need to [enable](/maps/documentation/places/android-sdk/cloud-setup#enabling-apis) it. **Note:**If you are using both the Places API (Legacy) and Places API (New), we recommend that you create a separate API key for each API version.\n4. To finalize your changes, click **Save** . \n\nCloud SDK\n\nPlaces SDK for Android (New)\n\n\nList existing keys. \n\n```bash\ngcloud services api-keys list --project=\"\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\"\n```\n\n\nClear existing restrictions on existing key. \n\n```bash\ngcloud services api-keys update \"projects/\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e/keys/\u003cvar translate=\"no\"\u003eKEY_ID\u003c/var\u003e\" \\\n --clear-restrictions\n```\n\n\nSet new restrictions on existing key. \n\n```bash\ngcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \\\n --api-target=service=places.googleapis.com\n --allowed-application=\"sha1_fingerprint=\u003cvar translate=\"no\"\u003eSHA1_FINGERPRINT\u003c/var\u003e,package_name=\u003cvar translate=\"no\"\u003eANDROID_PACKAGE_NAME\u003c/var\u003e\"\n```\n\nRead more about the\n[Google Cloud SDK](https://cloud.google.com/sdk)\n,\n[Cloud SDK installation](https://cloud.google.com/sdk/docs/install)\n, and the following commands:\n\n- [`gcloud services api-keys update`](https://cloud.google.com/sdk/gcloud/reference/services/api-keys/update)\n- [`gcloud services api-keys lookup`](https://cloud.google.com/sdk/gcloud/reference/services/api-keys/lookup)\n- [`gcloud services api-keys list`](https://cloud.google.com/sdk/gcloud/reference/services/api-keys/list)\n\nPlaces SDK for Android\n\n\nList existing keys. \n\n```bash\ngcloud services api-keys list --project=\"\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\"\n```\n\n\nClear existing restrictions on existing key. \n\n```bash\ngcloud services api-keys update \"projects/\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e/keys/\u003cvar translate=\"no\"\u003eKEY_ID\u003c/var\u003e\" \\\n --clear-restrictions\n```\n\n\nSet new restrictions on existing key. \n\n```bash\ngcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \\\n --api-target=service=places-backend.googleapis.com\n --allowed-application=\"sha1_fingerprint=\u003cvar translate=\"no\"\u003eSHA1_FINGERPRINT\u003c/var\u003e,package_name=\u003cvar translate=\"no\"\u003eANDROID_PACKAGE_NAME\u003c/var\u003e\"\n```\n\nRead more about the\n[Google Cloud SDK](https://cloud.google.com/sdk)\n,\n[Cloud SDK installation](https://cloud.google.com/sdk/docs/install)\n, and the following commands:\n\n- [`gcloud services api-keys update`](https://cloud.google.com/sdk/gcloud/reference/services/api-keys/update)\n- [`gcloud services api-keys lookup`](https://cloud.google.com/sdk/gcloud/reference/services/api-keys/lookup)\n- [`gcloud services api-keys list`](https://cloud.google.com/sdk/gcloud/reference/services/api-keys/list)\n\nWhat's next\n\nNow that you have an API key, create and configure a project as described in\n[Set Up an Android Studio Project](/maps/documentation/places/android-sdk/config)."]]