Places SDK (기존) 개요

Places SDK를 사용하면 텍스트 문자열을 사용하거나 근접성을 기준으로 다양한 장소 유형의 정보를 검색하고 가져올 수 있습니다. Places SDK는 Places SDK (New)의 기존 버전입니다.

이 가이드를 사용하여 Places SDK 버전 간의 주요 차이점을 파악하고 Places SDK (신규)로 이전하세요.

각 버전에서 사용할 수 있는 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
Place Photos (신규) Places API(신규) initializeWithNewPlacesApiEnabled() 3.4.0
텍스트 검색 (신규) Places API(신규) initializeWithNewPlacesApiEnabled() 3.3.0
Place Autocomplete Places API initialize()
Current Place Places API initialize()
Place Details Places API initialize()
Place Photos Places API initialize()

새 API로 이전

새 API로 이전하려면 다음 이전 가이드를 참고하세요.

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

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

Google Cloud 표준 플랫폼에서 구현

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

성능 향상

Android용 Places SDK (신규)는 성능이 개선되어 기존 SDK를 사용하는 앱을 대체할 가치가 있습니다.

새로운 기능

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

새 텍스트 검색 서비스

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

장소 세부정보 (신규) 및 장소 사진 (신규)에 새로운 응답 데이터 추가

  • 장소 세부정보(신규)에는 이제 응답 Place 객체에 새로운 리뷰 클래스가 포함됩니다. 장소 클래스에는 이 필드를 지원하는 새로운 getReviews() 메서드가 포함되어 있습니다. getReviews()를 호출하여 장소의 리뷰를 최대 5개까지 반환합니다.

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

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

이제 Place Photo(신규)를 사용하여 이미지 비트맵의 URI를 반환할 수 있습니다. 이전에는 이미지 비트맵 자체만 반환할 수 있었습니다.

간소화된 가격 책정

Android용 Places SDK (신규)를 사용하면 사용하는 데이터에 대해서만 요금을 지불하도록 가격이 간소화됩니다. 간소화된 가격은 필드 마스크라고도 하는 필드 목록을 사용하여 구현됩니다.

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

두 SDK의 자세한 가격 정보는 사용량 및 결제를 참고하세요.

확장된 장소 유형

새 SDK에는 장소 세부정보 및 텍스트 검색 응답의 일부로 반환되는 새로운 장소 유형이 포함되어 있습니다. 텍스트 검색으로 검색할 때 이러한 새 유형과 기존 유형을 함께 사용할 수도 있습니다. 새 유형은 표 A에 포함됩니다.