앱에서 사용할 수 있는 iOS용 Places SDK 기능은 패키지 종속 항목에 지정한 SDK 버전 번호 (예: 9.0.0)와 API 키에 사용 설정된 API의 조합에 따라 결정됩니다. 이 가이드에서는 버전 간 차이점과 앱에서 사용 설정할 버전을 선택하는 방법을 설명합니다.
SDK 버전 번호
패키지 종속 항목에 지정하는 SDK의 버전 번호에 따라 앱이 특정 버전에 추가된 기능에 액세스할 수 있는지 여부가 결정됩니다. 예를 들어 Autocomplete (신규)는 SDK 버전 9.0.0 이상에서만 사용할 수 있습니다.
각 SDK 버전에 도입된 변경사항에 대한 자세한 내용은 iOS용 Places SDK 출시 노트를 참고하세요.
iOS용 Places SDK의 Places API 버전
SDK 버전 번호를 지정하는 것 외에 Google Cloud 콘솔에서 SDK가 호출하는 Places API 서비스인 Places API 또는 Places API (신규)도 선택해야 합니다. 선택한 API 서비스는 SDK 버전 번호와 함께 앱에서 사용할 수 있는 특정 기능(예: 자동 완성 또는 자동 완성(신규))의 버전을 결정합니다. SDK 버전 번호는 하나만 지정할 수 있지만 API 키에서 Places API와 Places API (신규)를 동시에 사용 설정할 수 있습니다. 하지만 대부분의 경우 Places API (신규)를 사용 설정하고 앱에서 SDK 기능의 (신규) 버전을 사용하는 것이 좋습니다.
SDK 버전 및 API 서비스 선택
앱에서 사용할 수 있는 SDK 기능을 선택하려면 다음 단계를 따르세요.
- Google Cloud 프로젝트에서 Places API, Places API (신규) 또는 둘 다를 사용 설정합니다. 자세한 내용은 API 사용 설정을 참고하세요.
- API 키 제한사항에서 Places API, Places API (신규) 또는 둘 다를 사용 설정합니다. 자세한 내용은 API 키 제한을 참고하세요.
- SDK를 설치할 때 버전 번호를 지정합니다. 자세한 내용은 Xcode 프로젝트 설정을 참고하세요.
Places API 서비스 선택에 대한 자세한 내용은 Google Cloud 프로젝트 설정을 참고하세요.
각 버전에서 사용할 수 있는 SDK 기능
다음 표에는 각 SDK 기능에 필요한 SDK 및 API 버전이 나와 있습니다.
| 특성 | API 키에 Places API가 사용 설정됨 | 최소 SDK 버전 |
|---|---|---|
| 자동 완성 (신규) | Places API(신규) | 9.0.0 |
| Place Details (신규) | Places API(신규) | 9.0.0 |
| 주변 검색 (신규) | Places API(신규) | 9.0.0 |
| 장소 사진 (신규) | Places API(신규) | 9.0.0 |
| 텍스트 검색 (신규) | Places API(신규) | 8.5.0 |
| Place Autocomplete | Places API | 3.0.0 |
| Current Place | Places API | 3.0.0 |
| 장소 세부정보 | Places API | 3.0.0 |
| 장소 사진 | Places API | 3.0.0 |
사용 설정할 버전 선택 시 고려사항
- iOS용 Places SDK를 막 시작한 신규 고객인 경우 Places API (신규)와 새 SDK로 시작하세요.
- 기존 고객은 기존 SDK를 계속 사용할 수 있습니다. 하지만 iOS용 Places SDK (신규)의 성능 개선 및 기능 개선사항을 활용하려면 Places API(신규)를 사용 설정하고 새 SDK를 사용해야 합니다. 새 SDK로 이동할 때는 이전할 필요가 없습니다. SDK 버전 및 API 서비스 선택의 단계를 따르세요.
- Places API (신규)는 현재 장소,
GMSPlace.isOpen,GMSPlaceisOpenAtDate와 같은 일부 기존 기능을 사용 설정하지 않습니다.
GooglePlacesSwift 미리보기 버전 사용
GooglePlacesSwift 버전 0.1.0의 미리보기 출시 버전을 사용하려면 Places API (신규)를 사용 설정하고 GooglePlacesSwift SDK를 설치하세요.
새 API로 이전
기존 API를 사용 중이고 새 API로 마이그레이션하려면 각 API에 대한 다음 이전 가이드를 참조하세요.
iOS용 Places SDK의 향상된 기능 (신규)
이 섹션에서는 iOS용 Places SDK(신규)에 추가된 주요 기능을 설명합니다.
Google Cloud 표준 플랫폼에서 구현됨
iOS용 Places SDK (신규)는 Google Cloud의 서비스 인프라에 구현됩니다. 이 구현은 보다 안전하고 신뢰할 수 있는 플랫폼을 제공합니다. 이 표준 디자인은 SDK 전반에서 어느 정도의 일관성을 제공하여 iOS용 Places SDK(신규)를 통해 개발 효율성을 개선합니다.
성능 향상
iOS용 Places SDK (신규)는 개선된 성능을 제공하므로 기존 SDK를 사용하는 앱을 교체할 가치가 있습니다.
새로운 기능
iOS용 Places SDK (신규)에는 모든 SDK 기능의 최신 버전이 포함되어 있습니다.
간소화된 가격 책정
iOS용 Places SDK (신규)를 사용하면 사용한 데이터에 대한 요금만 지불하면 되도록 가격 책정이 간소화됩니다. 간소화된 가격 책정은 필드 마스크라고도 하는 필드 목록을 사용하여 구현됩니다.
iOS용 Places SDK 및 텍스트 검색에서는 필드 목록을 사용하여 응답에서 반환할 필드 목록을 제어할 수 있습니다. 그러면 요청된 데이터에 대해서만 요금이 청구됩니다. 불필요한 데이터를 요청하지 않도록 하려면 필드 목록을 사용하는 것이 좋으며, 이렇게 하면 불필요한 처리 시간과 요금이 청구되지 않습니다.
두 SDK의 가격 책정에 관한 자세한 내용은 사용량 및 결제를 참고하세요.
확장된 장소 유형
새 SDK는 다음 표에 표시된 장소 유형을 추가합니다. 이러한 유형은 장소 세부정보 및 텍스트 검색 응답의 일부로 반환됩니다. 텍스트 검색으로 검색할 때 이러한 새 유형과 기존 유형을 사용할 수도 있습니다. 새 유형은 표 A에 포함되어 있습니다.
| 유형 | |||
|---|---|---|---|
| american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
| amusement_center | dog_park | indian_restaurant | school_district |
| athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
| auto_parts_store | event_venue | italian_restaurant | ski_resort |
| banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
| barbecue_restaurant | 농장 | korean_restaurant | sporting_goods_store |
| barber_shop | 팜스테이 | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
| brazilian_restaurant | ferry_terminal | 시장 | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | 맞춤 |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | 모텔 | thai_restaurant |
| child_care_agency | grocery_store | national_park | transit_depot |
| chinese_restaurant | guest_house | park_and_ride | truck_stop |
| coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
| community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
| 컨설턴트 | 헬기장 | playground | vegetarian_restaurant |
| convention_center | hiking_area | 유아 및 미취학 아동 | vietnamese_restaurant |
| 코티지 | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | 호스텔 | resort_hotel | 도매업체 |
| dental_clinic | 호텔 | rest_stop |
이러한 새로운 유형과 함께 Places API (신규)는 다음 유형을 Places API의 표 2에서 Places API의 표 A (신규)로 이동했습니다. 즉, 이제 검색의 일부로 다음 유형을 사용할 수 있습니다.
countryadministrative_area_level_1administrative_area_level_2postal_codelocality