SDK 버전 선택

앱에서 사용할 수 있는 iOS용 Places SDK 기능은 패키지 종속 항목에 지정된 SDK 버전 번호 (예: 9.0.0)와 API 키에 사용 설정된 API의 조합에 따라 결정됩니다. 이 가이드에서는 버전 간의 차이점과 앱에서 사용 설정할 버전을 선택하는 방법을 설명합니다.

SDK 버전 번호

패키지 종속 항목에 지정하는 SDK의 버전 번호에 따라 앱이 특정 출시에서 추가된 기능에 액세스할 수 있는지 여부가 결정됩니다. 예를 들어 자동 완성 (신규)은 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 기능을 선택하려면 다음 단계를 따르세요.

  1. Google Cloud 프로젝트에서 Places API, Places API (신규) 또는 둘 다를 사용 설정합니다. 자세한 내용은 API 사용 설정을 참고하세요.
  2. API 키 제한사항에서 Places API, Places API (신규) 또는 둘 다를 사용 설정합니다. 자세한 내용은 API 키 제한을 참고하세요.
  3. SDK를 설치할 때 버전 번호를 지정합니다. 자세한 내용은 Xcode 프로젝트 설정을 참고하세요.

Places API 서비스를 선택하는 방법에 관한 자세한 내용은 Google Cloud 프로젝트 설정을 참고하세요.

각 버전에서 사용할 수 있는 SDK 기능

다음 표에는 각 SDK 기능에 필요한 SDK 및 API 버전이 나와 있습니다.

iOS용 Places SDK (신규) 최소 SDK 버전 iOS용 Places SDK 최소 SDK 버전
장소 세부정보 (신규) 9.0.0 장소 세부정보 3.0.0
장소 사진 (신규) 9.0.0 장소 사진 3.0.0
텍스트 검색 (신규) 8.5.0
주변 지역 검색 (신규) 9.0.0
자동 완성 (신규) 9.0.0 자동 완성 3.0.0
Current Place 3.0.0

사용 설정할 버전을 선택할 때 고려해야 할 사항

  • iOS용 Places SDK를 처음 사용하는 신규 고객인 경우 Places API (신규) 및 새 SDK로 시작합니다.
  • 기존 고객은 기존 SDK를 계속 사용할 수 있습니다. 하지만 iOS용 Places SDK (신규)의 성능 개선 및 기능 향상을 활용하려면 Places API(신규)를 사용 설정하고 새 SDK를 사용해야 합니다. 새 SDK로 이전할 때는 이전이 필요하지 않습니다. SDK 버전 및 API 서비스 선택의 단계를 따르세요.
  • Places API (신규)는 현재 장소, GMSPlace.isOpen, GMSPlace.isOpenAtDate와 같은 일부 기존 기능을 사용 설정하지 않습니다.

iOS용 Places Swift SDK 사용 (미리보기)

iOS용 Places Swift SDK (미리보기)를 사용하려면 다음 단계를 따르세요.

  1. Places API(신규)를 사용 설정합니다.
  2. 종속 항목에 iOS용 Places Swift SDK (미리보기)를 추가합니다.
  3. PlacesClient로 Places 클라이언트를 초기화합니다.

iOS용 Places Swift SDK (미리보기)에 대해 자세히 알아보려면 개요 또는 이전 가이드를 검토하세요.

새 API로 이전

기존 API를 사용 중이며 새 API로 이전하려면 각 API의 다음 마이그레이션 가이드를 참고하세요.

iOS용 Places SDK 개선사항 (신규)

이 섹션에서는 iOS용 Places SDK(신규)에 추가된 주요 기능을 설명합니다.

Google Cloud 표준 플랫폼에 구현됨

iOS용 Places SDK (신규)는 Google Cloud의 서비스 인프라에 구현됩니다. 이 구현을 통해 더 안전하고 신뢰할 수 있는 플랫폼을 제공합니다. 이 표준 설계는 iOS용 Places SDK(신규)를 사용한 개발 효율성을 개선하는 SDK 전반에서 일관된 수준을 제공합니다.

성능 향상

iOS용 Places SDK (신규)는 향상된 성능을 제공하므로 기존 SDK를 사용하는 앱을 대체하는 것이 좋습니다.

새로운 기능

iOS용 Places SDK (신규)에는 다음과 같은 모든 SDK 기능의 최신 버전이 포함되어 있습니다.

간소화된 가격 책정

iOS용 Places SDK (신규)를 사용하면 가격이 간소화되어 사용한 데이터에 대해서만 비용을 지불할 수 있습니다. 간소화된 가격 책정은 필드 마스크라고도 하는 필드 목록을 사용하여 구현됩니다.

iOS용 Places SDK 및 Text Search를 사용하면 필드 목록을 사용하여 응답에서 반환할 필드 목록을 제어할 수 있습니다. 그러면 요청된 데이터에 대해서만 요금이 청구됩니다. 필드 목록을 사용하면 불필요한 데이터의 요청을 방지하여 불필요한 처리에 드는 시간과 요금을 막을 수 있습니다.

두 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
컨설턴트 헬리콥터 발착장 놀이터 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로 이동했습니다. 즉, 이제 다음 유형을 검색의 일부로 사용할 수 있습니다.

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality