Places SDK를 사용하면 텍스트 문자열을 사용하거나 근접성을 기준으로 다양한 장소 유형에 대한 정보를 검색하고 가져올 수 있습니다. Places SDK는 Places SDK (신규)의 기존 버전입니다.
이 가이드를 사용하여 Places SDK 버전 간의 주요 차이점을 이해하고 Places SDK (신규)로 이전하세요.
각 버전에서 사용할 수 있는 SDK 기능
다음 표에는 각 SDK 기능에 필요한 SDK 및 API 버전이 나와 있습니다.
| 기능 | API 키에 Places API가 사용 설정됨 | 초기화 방법 | 최소 SDK 버전 |
|---|---|---|---|
| 자동 완성 (신규) | Places API(신규) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| 장소 세부정보 (신규) | 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() |
|
| 장소 세부정보 | Places API | initialize() |
|
| 장소 사진 | Places API | initialize() |
새 API로 이전
새 API로 이전하려면 다음 이전 가이드를 참고하세요.
Android용 Places SDK 개선사항 (신규)
이 섹션에서는 Android용 Places SDK (신규)에 추가된 주요 기능을 설명합니다.
Google Cloud 표준 플랫폼에 구현됨
Android용 Places SDK (신규)는 Google Cloud의 서비스 인프라에 구현됩니다. 이 구현을 통해 더 안전하고 신뢰할 수 있는 플랫폼을 제공합니다. 이 표준 설계는 Android용 Places SDK(신규)를 사용한 개발 효율성을 개선하는 SDK 전반에 일관된 수준을 제공합니다.
성능 향상
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 (신규)를 사용하면 가격이 간소화되어 사용하는 데이터에 대해서만 비용을 지불할 수 있습니다. 단순화된 가격 책정은 필드 마스크라고도 하는 필드 목록을 사용하여 구현됩니다.
장소 세부정보 및 텍스트 검색을 사용하면 필드 목록을 사용하여 응답에서 반환할 필드 목록을 제어할 수 있습니다. 그러면 요청된 데이터에 대해서만 요금이 청구됩니다. 필드 목록을 사용하면 불필요한 데이터의 요청을 방지하여 불필요한 처리에 드는 시간과 요금을 막을 수 있습니다.
두 SDK의 자세한 가격 정보는 사용 및 결제를 참고하세요.
확장된 장소 유형
새 SDK에는 장소 세부정보 및 텍스트 검색 응답의 일부로 반환되는 새로운 장소 유형이 포함되어 있습니다. 텍스트 검색을 사용하여 이러한 새 유형과 기존 유형을 검색에 사용할 수도 있습니다. 새 유형은 표 A에 포함되어 있습니다.