iOS용 Places SDK (신규)는 성능이 개선되었으며 새로운 가격 모델을 제공하므로 iOS용 Places SDK (기존)를 사용하는 앱을 업데이트하는 것이 좋습니다. 기능 비교에 관한 자세한 내용은 SDK 선택을 참고하세요.
이 가이드를 통해 iOS용 Places SDK(신규)와 iOS용 Places SDK (기존)의 주요 차이점을 파악하고 필요한 변경사항을 처리하는 방법을 알아보세요.
마이그레이션 결제 권장사항
warning_amber
이 안내는 API 사용량이 2단계 요금으로 전환될 만큼 많은 경우에 적용됩니다. API의 최신 버전으로 이전하면 다른 SKU에 대한 요금도 청구됩니다. 전환하는 달에 비용이 증가하지 않도록 하려면 가능한 한 달 초에 프로덕션에서 새 API로 전환하는 것이 좋습니다. 이렇게 하면 이전 달에 가장 비용 효율적인 월간 요금 등급에 도달할 수 있습니다. 가격 등급에 대한 자세한 내용은 가격 페이지 및 가격 FAQ를 참고하세요.
오류: kGMSPlacesRateLimitExceeded
iOS용 Places SDK (신규) 사용 설정
iOS용 Places SDK는 Places API 서비스를 사용합니다. iOS용 Places SDK (신규)의 기능을 사용하려면 먼저 Google Cloud 프로젝트에서 Places API (신규)를 사용 설정해야 합니다. 자세한 내용은 Google Cloud 프로젝트 설정을 참고하세요.
그런 다음 앱에서 사용하는 API 키에 Places API(신규)를 추가했는지 확인해야 합니다. 자세한 내용은 API 키 사용을 참고하세요.
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[],[],null,["# Migration overview\n\nThe Places SDK for iOS (New) provides improved performance and a new\npricing model, making it worthwhile to update apps that use\nPlaces SDK for iOS (Legacy). For more details on comparing features, see\n[Choose your SDK](/maps/documentation/places/ios-sdk/choose-sdk).\n\nUse this guide to understand key differences in Places SDK for iOS\n(New) compared to Places SDK for iOS (Legacy), along with how to\nhandle necessary changes.\n\n\nBilling best practices for migration\n------------------------------------\n\nwarning_amber\n\nThis guidance applies if your API usage is high enough to\nmove into second-tier pricing. When migrating to a newer version of an API,\nyou're also being billed for a different SKU. To avoid increased costs during the month of\nyour transition, we recommend switching to the new APIs in production as close to the\nbeginning of the month as possible. This will ensure that you reach the most cost-effective\nmonthly pricing tiers during the migration month. For information about pricing tiers,\nsee the [pricing page](/maps/billing-and-pricing/pricing)\nand the [pricing FAQ](/maps/billing-and-pricing/faq).\n\n\u003cbr /\u003e\n\n#### Error: `kGMSPlacesRateLimitExceeded`\n\n| **Notice:** If your iOS app is experiencing `kGMSPlacesRateLimitExceeded`\n| errors, you may be using a deprecated version of the Places API.\n| Version 2.7.0 of the Places API was deprecated as of January 29,\n| 2019, and was turned off on **July 29, 2019** . A new version of the Places API\n| is now available. We recommend updating to the new version as soon as possible.\n| For details, see the [migration\n| guide](/maps/documentation/places/ios-sdk/client-migration).\n\nEnable Places SDK for iOS (New)\n-------------------------------\n\nPlaces SDK for iOS relies on the\n**Places API** service. To use the features of\nPlaces SDK for iOS (New), you must first enable\n**Places API (New)** in your Google Cloud project. For more\ninformation, see [Set up your Google Cloud\nproject](/maps/documentation/places/ios-sdk/cloud-setup).\n\nYou then must verify that you have added **Places API\n(New)** to the API key used by your app. For more information, see [Use API\nKeys](/maps/documentation/places/ios-sdk/get-api-key).\n\nGeneral changes\n---------------\n\nSome general changes that apply to multiple APIs include:\n\n- Uses a new pricing model. For pricing information for all APIs, see [Pricing\n for the Places SDK for iOS\n (New)](/maps/billing-and-pricing/pricing#places-pricing).\n\n- [Place Details\n (New)](/maps/documentation/places/ios-sdk/place-details), [Nearby Search\n (New)](/maps/documentation/places/ios-sdk/nearby-search), and [Text Search\n (New)](/maps/documentation/places/ios-sdk/text-search) require field masks\n to specify which fields you want returned in the response.\n\n- [`GMSPlacesClient`](/maps/documentation/places/ios-sdk/reference/objc/Classes/GMSPlacesClient)\n contains new methods to call these new APIs.\n\n- New classes have been added to define the request to each of the new APIs.\n\n- The response `GMSPlace` instance contains the new [`reviews`](/maps/documentation/places/ios-sdk/reference/objc/Classes/GMSPlace#reviews)\n property of type\n [`GMSPlaceReview`](/maps/documentation/places/ios-sdk/reference/objc/Classes/GMSPlaceReview).\n When your app displays information obtained from the `GMSPlace` instance,\n such as photos and reviews, the app must also display the required\n attributions.\n\n For more information, see the documentation on\n [attributions](/maps/documentation/places/ios-sdk/policies#other_attribution_requirements).\n\n| **Note:** Because Text Search (New) and Nearby Search (New) were added to Places SDK for iOS and did not replace any existing APIs, there is no migration required to use them.\n\nAPI-specific changes\n--------------------\n\nThis section includes the following migration guides for each API:\n\n- [Migrate to Place Details (New)](/maps/documentation/places/ios-sdk/migrate-details)\n- [Migrate to Place Photo (New)](/maps/documentation/places/ios-sdk/migrate-photo)\n- [Migrate to Autocomplete (New)](/maps/documentation/places/ios-sdk/migrate-autocomplete)"]]
