이 제품 또는 기능은 기존 상태입니다. 기존 상태에 대한 자세한 내용은
기존 제품 및 기능을 참고하세요. iOS용 Places API(신규)로 이전하려면
이전 가이드를 참고하세요.
Places SDK (기존) 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Places SDK를 사용하면 텍스트 문자열을 사용하거나 근접성을 기준으로 다양한 장소 유형의 정보를 검색하고 가져올 수 있습니다. Places SDK는 Places SDK (New)의 기존 버전입니다.
이 가이드를 사용하여 Places SDK 버전 간의 주요 차이점을 파악하고 Places SDK (신규)로 이전하세요.
각 버전에서 사용할 수 있는 SDK 기능
다음 표에는 각 SDK 기능에 필요한 SDK 및 API 버전이 나와 있습니다.
새 API로 이전
새 API로 이전하려면 다음 이전 가이드를 참고하세요.
iOS용 Places SDK 개선사항 (신규)
이 섹션에서는 iOS용 Places SDK(신규)에 추가된 주요 기능을 다룹니다.
Places SDK for iOS (신규)는 Google Cloud의 서비스 인프라에 구현됩니다. 이 구현을 통해 더 안전하고 신뢰할 수 있는 플랫폼을 제공할 수 있습니다.
이 표준 설계는 SDK 전반에 일관성을 제공하여 iOS용 Places SDK(신규)를 사용한 개발 효율성을 개선합니다.
iOS용 Places SDK (신규)는 성능이 개선되어 기존 SDK를 사용하는 앱을 대체할 가치가 있습니다.
새로운 기능
iOS용 Places SDK (신규)에는 모든 SDK 기능의 최신 버전이 포함되어 있습니다.
간소화된 가격 책정
iOS용 Places SDK (신규)를 사용하면 사용하는 데이터에 대해서만 비용을 지불하도록 가격이 간소화됩니다. 간소화된 가격 책정은 필드 마스크라고도 하는 필드 목록을 사용하여 구현됩니다.
iOS용 Places SDK 및 Text Search를 사용하면 필드 목록을 사용하여 응답에서 반환할 필드의 목록을 제어할 수 있습니다. 그러면 요청된 데이터에 대해서만 요금이 청구됩니다. 필드 목록을 사용하면 불필요한 데이터의 요청을 방지하여 불필요한 처리에 드는 시간과 요금을 막을 수 있습니다.
두 SDK의 자세한 가격 정보는 사용량 및 결제를 참고하세요.
확장된 장소 유형
새 SDK에는 장소 세부정보 및 텍스트 검색 응답의 일부로 반환되는 새로운 장소 유형이 포함되어 있습니다. 텍스트 검색으로 검색할 때 이러한 새 유형과 기존 유형을 함께 사용할 수도 있습니다. 새 유형은 표 A에 포함됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[],[],null,["The Places SDK lets you search for and retrieve information for a variety of\nplace types using a text string or by proximity. Places SDK is the legacy\nversion of Places SDK (New).\n\nUse this guide to understand the key differences between the Places SDK versions\nand migrate to Places SDK (New).\n\nSDK features available in each version\n\nThe following table shows which SDK and API versions are required for each SDK\nfeature:\n\n| Places SDK for iOS (New) | Minimum SDK Version | Places SDK for iOS | Minimum SDK Version |\n|-----------------------------------------------------------------------------|---------------------|-------------------------------------------------------------------|---------------------|\n| [Place Details (New)](/maps/documentation/places/ios-sdk/details-place) | 9.0.0 | [Place Details](/maps/documentation/places/ios-sdk/place-details) | 3.0.0 |\n| [Place Photo (New)](/maps/documentation/places/ios-sdk/place-photos) | 9.0.0 | [Place Photo](/maps/documentation/places/ios-sdk/photos) | 3.0.0 |\n| [Text Search (New)](/maps/documentation/places/ios-sdk/text-search) | 8.5.0 | | |\n| [Nearby Search (New)](/maps/documentation/places/ios-sdk/nearby-search) | 9.0.0 | | |\n| [Autocomplete (New)](/maps/documentation/places/ios-sdk/place-autocomplete) | 9.0.0 | [Autocomplete](/maps/documentation/places/ios-sdk/autocomplete) | 3.0.0 |\n| | | [Current Place](/maps/documentation/places/ios-sdk/current-place) | 3.0.0 |\n\nMigrate to the new APIs\n\nTo migrate to the new APIs, see the following migration guides:\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)\n\nEnhancements in Places SDK for iOS (New)\n\nThis section covers key features added to Places SDK for iOS\n(New).\n\nImplemented on the Google Cloud standard platform\n\nPlaces SDK for iOS (New) is implemented on the [service\ninfrastructure](https://cloud.google.com/service-infrastructure/docs/overview)\non Google Cloud. This implementation brings a more secure and trusted platform.\nThis standard design brings a level of consistency across the SDKs that improve\nthe efficiency of development with Places SDK for iOS\n(New).\n\nImproved performance\n\nPlaces SDK for iOS (New) provides improved performance, making\nit worthwhile to replace apps that use the existing SDK.\n\nNew features\n\nThe Places SDK for iOS (New) includes the latest versions of\nall of the SDK features:\n\n- [Autocomplete (New)](/maps/documentation/places/ios-sdk/place-autocomplete)\n- [Place Details (New)](/maps/documentation/places/ios-sdk/details-place)\n- [Nearby Search (New)](/maps/documentation/places/ios-sdk/nearby-search)\n- [Place Photos (New)](/maps/documentation/places/ios-sdk/place-photos)\n- [Text Search (New)](/maps/documentation/places/ios-sdk/text-search)\n\nSimplified pricing\n\nPricing is simplified with Places SDK for iOS (New) so that\nyou only pay for the data you use. Simplified pricing is implemented using field\nlists, also called *field masks*.\n\nWith Places SDK for iOS and\nText Search you use field lists to control the list of\nfields to return in the response. You are then only billed for the data\nrequested. Using a field list is a good design practice so that you don't\nrequest unnecessary data, which helps to avoid unnecessary processing time and\nbilling charges.\n\nFor detailed pricing information for both SDKs, see [Usage and\nBilling](/maps/documentation/places/ios-sdk/usage-and-billing).\n\nExpanded place types\n\nThe new SDK includes new place types, which are returned as part of the\nPlace Details and Text Search\nresponse. You can also use these new types, and the existing types, in a search\nwith Text Search. The new types are included in [Table\nA](/maps/documentation/places/ios-sdk/place-types#table-a)."]]