SDK 버전 선택

앱에서 사용할 수 있는 Android용 Places SDK 기능은 다음과 같습니다. 버전 번호 (예: 3.5.0)를 조합하여 API 키에서 사용 설정된 API, API 키를 사용해 앱을 초기화합니다. 이 가이드에서는 버전 간의 차이점을 설명하고 앱에서 사용 설정할 버전을 선택하는 방법

SDK 버전 번호

앱 수준 build.gradle에서 지정하는 SDK의 버전 번호입니다. 파일은 앱에서 추가된 기능에 액세스할 수 있는지 여부를 확인할 수 있습니다 예를 들어 Autocomplete (신규)는 SDK에서만 사용할 수 있습니다. 버전 3.5.0 이상이 필요합니다.

각 SDK 버전에 도입된 변경사항에 대한 자세한 내용은 Places Android용 SDK 출시 참고:

Android용 Places SDK의 Places API 버전

SDK 버전 번호 지정 외에 Places API에서 Places 버전 번호를 SDK가 Google Cloud 콘솔에서 호출하는 API 서비스(Places API 또는 Places API (신규) SDK 버전 번호와 함께 선택은 앱에서 사용할 수 있는 특정 기능의 버전을 결정합니다. 자동 완성 또는 자동 완성 (신규) 등의 기능을 제공합니다. 하나의 SDK만 지정할 수 있지만 Places API와 Places API (신규)를 모두 사용 설정할 수 있습니다. API 키를 동시에 누른 다음, SDK가 호출하는 서비스를 선택할 수 있습니다. 앱에서 SDK를 초기화하는 데 사용하는 메서드를 제공합니다. 그러나 대부분의 경우 Places API(신규)를 사용 설정하고 포함되어 있습니다.

SDK 버전 및 API 서비스 선택

앱에서 사용할 수 있는 SDK 기능을 선택하려면 다음 단계를 따르세요.

  1. Google Cloud 프로젝트에서 Places API, Places API (신규)를 사용 설정합니다. 있습니다 자세한 내용은 사용 설정 API
  2. API 키 제한사항에서 Places API, Places API (신규) 또는 있습니다 자세한 내용은 API 제한하기를 참조하세요. 키를 참조하세요.

  3. 앱 수준 build.gradle 파일에서 버전 번호를 지정합니다. 자세히 알아보기 자세한 내용은 설치.

  4. 다음을 호출하여 앱을 초기화합니다. Places.initializeWithNewPlacesApiEnabled() 또는 Places.initialize() 메서드를 사용하여 축소하도록 요청합니다.

Places API 서비스 선택에 대한 자세한 내용은 도메인 설정 Google Cloud 프로젝트에 할당됩니다.

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

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

기능 API 키에 Places API가 사용 설정됨 초기화 메서드 최소 SDK 버전
자동 완성 (신규) Places API(신규) initializeWithNewPlacesApiEnabled() 3.5.0
Place Details (신규) Places API(신규) initializeWithNewPlacesApiEnabled() 3.3.0
주변 검색 (신규) Places API(신규) initializeWithNewPlacesApiEnabled() 3.5.0
장소 사진 (신규) Places API(신규) initializeWithNewPlacesApiEnabled() 3.4.0
텍스트 검색 (신규) Places API(신규) initializeWithNewPlacesApiEnabled() 3.3.0
Place Autocomplete Places API initialize()
Current Place Places API initialize()
장소 세부정보 Places API initialize()
장소 사진 Places API initialize()

사용 설정할 버전 선택 시 고려사항

어떤 버전을 선택할지 결정하려면 다음 사항을 고려하세요.

  • Android용 Places SDK를 처음 시작하는 신규 고객인 경우 Places API (신규)와 새 SDK로 시작합니다.
  • 기존 고객은 기존 SDK를 계속 사용할 수 있습니다. 하지만 향상된 성능과 새 버전의 기능을 활용하려면 Places SDK for Android (신규)의 향상된 기능을 사용 중인 경우 사용할 수 있습니다. 새 SDK로 이전할 때 이전할 필요가 없습니다. SDK 버전 및 API 선택하기 서비스를 제공합니다.
  • Android용 Places SDK (신규)에서는 버전 3.5.0에서 지원됩니다. 자세한 내용은 세션 토큰을 사용합니다.
  • Place Autocomplete 위젯을 사용하여 호출한 경우 항상 Place 자동 완성(단, 자동 완성은 사용할 수 없음) Place Autocomplete (신규) 위젯 호출은 초기화 메서드를 사용할 수 있습니다.
  • 장소 사진 (신규) 비트맵 이미지에 URI만 반환하는 반면, Place 포토는 비트맵만 반환합니다. 이미지
  • 현재 장소: Android용 Places SDK에서만 사용할 수 있으며 Android용 Places SDK에서는 사용할 수 없음 (신규).

Android용 Places SDK의 향상된 기능 (신규)

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

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

Android용 Places SDK (신규)는 서비스에서 구현됩니다. 인프라 살펴봤습니다 이 구현은 보다 안전하고 신뢰할 수 있는 플랫폼을 제공합니다. 이 표준 설계는 SDK 전반의 일관성을 향상하고 Android용 Places SDK를 사용한 개발 효율성 (신규).

성능 향상

Android용 Places SDK (신규)는 향상된 성능을 제공하여 기존 SDK를 사용하는 앱을 대체할 가치가 있습니다.

새로운 기능

Android용 Places SDK (신규)에는 모든 SDK의 최신 버전이 포함되어 있습니다. 기능:

새로운 텍스트 검색 서비스

텍스트 검색 (신규)은 정보를 반환합니다. 문자열에 기반한 일련의 장소 정보(예: '뉴욕의 피자') 또는 "오타와 인근 신발 가게" 또는 '중앙로 123'. 서비스는 목록으로 응답합니다. 텍스트 문자열 및 설정된 위치 상세 검색과 일치하는 장소의 수

Placed Details (New) 및 Place Photos (New)에 새로운 응답 데이터가 추가되었습니다.

  • 장소 세부정보 (New)에는 이제 검토 클래스를 응답 Place 객체에 입력합니다. 이 Place 클래스 에는 이 필드를 지원하는 새 getReviews() 메서드가 포함되어 있습니다. 전화걸기 getReviews(): 한 장소에 대해 최대 5개의 리뷰를 반환할 수 있습니다.

  • 장소 사진 (신규)는 AuthorAttributions PhotoMetadata 클래스에 추가합니다. AuthorAttributions 포함 List AuthorAttribution 객체입니다.

장소 사진에 새 URI 응답이 추가됨 (신규)

이제 장소 사진 (신규) 이미지 비트맵에 URI를 반환합니다. 이전에는 이미지 비트맵 자체를 생성합니다.

간소화된 가격 책정

Android용 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
컨설턴트 헬기장 놀이터 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