iOS용 Places SDK와 함께 제공되는 GitHub의 iOS용 Places SDK 데모 앱은 장소 자동 완성, 장소 사진 등 다양한 기능을 보여줍니다. 또한 이 개발자 가이드의 각 페이지에 코드 스니펫이 나와 있습니다.
앱을 가져와 빌드하고, API 키를 추가하고, 데모를 보고, 앱의 시작점으로 제공된 샘플 코드를 사용하세요.
샘플 앱을 실행하면 기기에서 실행할 수 있는 샘플 목록이 표시됩니다. 옵션 중 하나를 선택합니다.
로컬에서 전체 샘플 앱 실행
iOS용 Places SDK 샘플 앱은 GitHub에서 다운로드 보관 파일로 제공됩니다. 다음 단계에 따라 iOS용 Places SDK 샘플 앱을 설치하고 사용해 보세요.
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eThe Places SDK for iOS provides a demo app showcasing features like place autocomplete and place photos, with code snippets and a full sample app for exploration.\u003c/p\u003e\n"],["\u003cp\u003eTo run the sample app, download the archive, navigate to the GooglePlaces directory, install dependencies using CocoaPods, and open the Xcode workspace.\u003c/p\u003e\n"],["\u003cp\u003eBefore building, enable the Places SDK for iOS in your Google Cloud project, obtain an API key (restricting it to the app's bundle identifier for security), and add your API key to the \u003ccode\u003eSDKDemoAPIKey\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eBuild and run the app, granting location access if prompted, to explore the available Places Demos and utilize the provided sample code as a starting point for your own applications.\u003c/p\u003e\n"]]],[],null,["# Places SDK for iOS code samples\n\nSelect platform: [Android](/maps/documentation/places/android-sdk/examples \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/examples \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/examples \"View this page for the JavaScript platform docs.\")\n\nThe Places SDK for iOS demo app on\n[GitHub](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/tree/main/GoogleMaps)\nsupplied with the Places SDK for iOS\ndemonstrate a number of features including place autocomplete, and place photos. In\naddition, you can find code snippets on each page of this developer's guide.\nImport and build the\napp, add your API key, view the demo, and use the sample code supplied as a\nstarting point for your app.\n\nWhen you run the sample app, it displays a list of available samples that you can\nrun on your own device. Select one of the options.\n| **Troubleshooting:** If the sample app runs successfully but you don't see a map, check that you've added your API key to the app's manifest file, as described in [Using API Keys](/maps/documentation/places/ios-sdk/get-api-key).\n\nRun the full sample app locally\n-------------------------------\n\nThe Places SDK for iOS sample app is available as a\n[download archive](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/archive/main.zip)\nfrom [GitHub](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/tree/main/GoogleMaps)\nFollow these steps to install and try the Places SDK for iOS sample app.\n\n1. [Download\n the code sample archive](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/archive/master.zip) from [GitHub](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/tree/master/GooglePlaces) and unpack the archive.\n2. Open a terminal window, navigate to the directory where you expanded the sample files, and\n drill down into the GooglePlaces directory:\n\n ### Swift\n\n cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift\n pod install\n open GooglePlacesDemos.xcworkspace\n\n ### Objective-C\n\n cd maps-sdk-for-ios-samples-master/GooglePlaces\n pod install\n open GooglePlacesDemos.xcworkspace\n\n3. Enable the [Places SDK for iOS](https://console.cloud.google.com/flows/enableapi?apiid=placesios,maps_ios_backend&keyType=CLIENT_SIDE_IOS&reusekey=true) for your Google Cloud console project.\n4. [Get an API key](/maps/documentation/places/ios-sdk/get-api-key) from your project with the [Places API and/or Places API (New) enabled](/maps/documentation/places/ios-sdk/cloud-setup#enabling-apis).\n5. Edit the `SDKDemoAPIKey` file and paste your API key into the appropriate constant. For example: \n\n ### Swift\n\n ```swift\n let placesAPIKey = \"YOUR_API_KEY\"\n ```\n\n ### Objective-C\n\n ```objective-c\n static NSString *const kAPIKey = @\"YOUR_API_KEY\";\n ```\n6. If Xcode prompts you to unlock the `SDKDemoAPIKey` file for editing, choose **Unlock**.\n7. If present, remove the following line, because it's used to register the issue: \n\n ### Swift\n\n ```swift\n #error (Register for API Key and insert here. Then delete this line.)\n ```\n\n ### Objective-C\n\n ```objective-c\n #error Register your API key and insert here, then delete this line.\n ```\n8. [Build the app](https://developer.apple.com/documentation/xcode/building-and-running-an-app).\n9. If the build fails or the app crashes with an error about your API key when you first run it, make sure that you have provided the keys required in the `SDKDemoAPIKey` file.\n10. If you are running the *GooglePlaces* samples, the iOS simulator window will show a list of **Places Demos**.\n11. If prompted to allow **GooglePlacesDemos** to access your location, choose **Allow**.\n12. The sample you chose is now ready to run."]]
