SDK 버전 선택

iOS용 Places SDK 버전 8.5.0은 두 가지 SDK 버전을 지원합니다. iOS용 Places SDK는 기존의 iOS용 Places SDK (신규)이며 차세대 SDK입니다.

iOS용 Places SDK 버전 8.5.0이 출시됨에 따라 첫 번째 작업은 사용할 SDK를 결정하는 것입니다. 이는 SDK를 이미 사용 중인 신규 고객 또는 기존 고객인 경우에 해당합니다. 이 가이드를 사용하여 두 SDK의 주요 차이점을 파악하세요.

SDK 버전 선택 방법

iOS용 Places SDKPlaces API 서비스를 사용합니다. iOS용 Places SDK를 사용하려면 먼저 Google Cloud 프로젝트에서 Places API 서비스를 사용 설정해야 합니다.

사용 설정한 Places API 서비스의 버전에 따라 앱에서 사용되는 SDK 버전이 결정됩니다.

  • Places API: 기존 iOS용 Places SDK를 사용 설정합니다. 앱에 사용된 API 키와 연결된 프로젝트에 Places API만 사용 설정된 경우 앱은 iOS용 Places SDK 버전 8.5.0 이상에 추가된 새 기능에 액세스할 수 없습니다.

  • Places API (신규): iOS용 Places SDK에 추가된 주요 기능 (신규)에 설명된 텍스트 검색 및 모든 새로운 기능을 포함한 iOS용 Places SDK(신규)를 사용 설정합니다. Place Details, Place Photos, Current Place, Place Autocomplete와 같은 기존 기능은 사용 설정되지 않습니다.

  • 둘 다: iOS용 Places SDK (신규)iOS용 Places SDK의 모든 기능을 사용 설정합니다.

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

어떤 SDK를 선택해야 할까요?

버전을 결정하는 데 도움이 되는 방법은 다음과 같습니다.

  1. iOS용 Places SDK를 이제 막 시작한 신규 고객인 경우 Places API (신규) 및 Places API를 모두 사용하여 모든 기능에 액세스할 수 있습니다.

  2. 기존 고객인 경우 기존 SDK를 계속 사용할 수 있습니다. 그러나 iOS용 Places SDK (신규)의 성능 개선사항 및 기능 개선사항을 활용하려면 새 SDK를 사용하면 됩니다.

    새 SDK로 이전할 때는 이전할 필요가 없습니다. 앱에서 사용하는 API 키에서 iOS용 Places SDK (신규)만 사용 설정하면 됩니다. 기존 iOS용 Places SDKiOS용 Places SDK (신규)를 모두 사용하는 경우 API 키에 두 버전을 모두 사용 설정합니다. 자세한 내용은 API 키 사용을 참고하세요.

iOS용 Places SDK에 추가된 주요 기능 (신규)

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

Google Cloud 표준 플랫폼에서 구현됨

iOS용 Places SDK (신규)는 Google Cloud의 서비스 인프라에서 구현됩니다. 이 구현은 더 안전하고 신뢰할 수 있는 플랫폼을 제공합니다. 이러한 표준 디자인은 SDK 전체에서 일정 수준의 일관성을 제공하여 iOS용 Places SDK(신규)를 통해 개발 효율성을 높입니다.

성능 개선

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

텍스트 검색은 문자열(예: '뉴욕의 피자', '오타와 근처의 신발 가게' 또는 '중앙로 123')을 기반으로 장소 집합에 대한 정보를 반환합니다. 이 서비스는 사전에 설정된 텍스트 문자열 및 특정 위치와 일치하는 장소의 목록을 반환합니다.

간소화된 가격 책정

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 (신규)는 이러한 새로운 유형과 함께 다음 유형을 표 B에서 표 A로 이동했습니다. 즉, 이제 이러한 유형을 검색의 일부로 사용할 수 있습니다.
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality