Android용 Places SDK는 기존 장소 세부정보를 지원합니다. 기존 Android용 Places SDK에 익숙한 경우 새 버전의 장소 세부정보에서는 다음과 같이 변경됩니다.
새로운 가격 책정 모델을 사용합니다. 모든 API의 가격 정보는 Android용 Places SDK(신규)를 참고하세요.
Places.initializeWithNewPlacesApiEnabled()메서드를 호출하여 앱을 초기화해야 합니다. Places API 서비스를 선택하는 방법에 관한 자세한 내용은 Google Cloud 프로젝트 설정을 참고하세요.필드 마스킹이 필요합니다. 응답에서 반환할 필드를 지정해야 합니다. 반환되는 필드의 기본 목록은 없습니다. 이 목록을 생략하면 메서드에서 오류를 반환합니다.
다음 섹션에서는 추가 변경사항을 설명합니다.
새로운 장소 유형에 액세스
각 장소에는 하나 이상의 유형 값이 연결될 수 있습니다. Android용 Places SDK 버전 3.3.0 이상에는 많은 새로운 유형 값이 추가됩니다. 전체 목록은 확장된 장소 유형을 참고하세요.
Place.getPlaceTypes() 메서드는 유형 값을 문자열 값 목록으로 반환합니다. 반환되는 값은 Android용 Places SDK 버전에 따라 다릅니다.
Android용 Places SDK (신규): 버전 3.3.0에 추가된 모든 장소 유형을 포함하여 장소 유형 (신규)에 표시된 표 A 및 표 B에 정의된 문자열을 반환합니다.
Android용 Places SDK:
Place.Types에 의해 정의된 enum을 반환합니다. 여기에는 버전 3.3.0 이상에 추가된 새 유형이 포함되지 않습니다.
장소 리뷰 액세스
Android용 Places SDK (신규)에는 장소 리뷰가 포함된 Review 클래스가 추가되었습니다. Place 객체는 최대 5개의 리뷰를 포함할 수 있습니다.
Review 클래스에는 저작자 표시와 저자 저작자 표시도 포함될 수 있습니다. 앱에 리뷰를 표시하는 경우 저작자 표시 또는 작성자 저작자 표시도 표시해야 합니다. 자세한 내용은 리뷰 표시를 참고하세요.
자세한 내용은 저작자 표시 문서를 참고하세요.
장소 이름 언어 코드 액세스
기존 Place.getName() 메서드는 장소 이름이 포함된 텍스트 문자열을 반환합니다. Place 객체를 장소 이름으로 채우려면 장소 세부정보 요청의 필드 목록에 Place.Field.DISPLAY_NAME를 포함해야 합니다.
이제 Place 객체에 이름 문자열의 언어 코드가 포함됩니다. Place 객체를 언어 코드로 채우려면 다음을 실행해야 합니다.
요청의 필드 목록에
Place.Field.DISPLAY_NAME을 포함합니다. 이 값은Place객체에 장소 이름과 언어 코드가 모두 포함되도록 응답을 구성합니다.PlacesClient.fetchPlace()를 호출합니다.PlacesClient.findCurrentPlace()는 언어 코드 필드를 지원하지 않습니다.Place.getNameLanguageCode()메서드를 사용하여Place객체의 언어 코드 필드에 액세스합니다.
지역 코드 설정
Android용 Places SDK (신규)는 장소 세부정보에 지역 코드 요청 매개변수를 추가합니다. 지역 코드는 응답 형식을 지정하는 데 사용되며 2자리 CLDR 코드 값으로 지정됩니다. 이 매개변수는 검색 결과에 편향 효과를 줄 수도 있습니다. 기본값은 없습니다. 지역 코드를 설정하려면 새 SDK를 사용 설정해야 합니다.
응답의 주소 필드에 있는 국가 이름이 지역 코드와 일치하면 주소에서 국가 코드가 생략됩니다.
대부분의 CLDR 코드는 ISO 3166-1 코드와 동일하지만 일부 주목할 만한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (.co.uk)이지만 ISO 3166-1 코드는 'gb'입니다(기술적으로 '영국'의 법적 명칭은 '영국 및 북아일랜드 합중국'). 이 매개변수는 관련 법규에 따라 결과에 영향을 미칠 수 있습니다.
요청 예시
전체 예시는 장소 세부정보(신규)를 참고하세요.