특정 시설이나 상점에 대한 추가 세부정보를 요청할 수 있습니다. 광고의 위치와 ID를 입력하고 Place Details (New) 요청. Place Details (New)는 더 포괄적인 정보를 제공합니다. 전체 주소, 전화번호, 전화번호 등 지정된 장소에 대한 숫자, 사용자 평점 및 리뷰입니다.
장소 ID를 가져오는 방법에는 여러 가지가 있습니다. 이 옵션은 다음과 같습니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.Place Details (New) 요청
다음을 호출하여 장소 세부정보를 요청할 수 있습니다.
PlacesClient.fetchPlace()
드림
인코더에 전달하여
FetchPlaceRequest
장소 ID 및 필드 목록이 포함된 객체
선택적 매개변수로 사용할 수 있습니다.
// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";
// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");
// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);
// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);
<ph type="x-smartling-placeholder">
Place Details (New) 응답
Place Details (New)는
Place
드림
객체. 여기에는 필드를 사용하여 요청한 필드만 포함됩니다.
목록을 참조하세요. 장소 데이터 결과는 비워둘 수 없으므로 장소 결과만 있어야 합니다.
반환됩니다 (예를 들어 요청된 장소에 사진이 없는 경우
사진 필드는 결과에 표시되지 않음).
데이터 필드에 액세스하려면 해당하는
메서드를 참조하세요.
예를 들어 장소 이름에 액세스하려면 getName()
를 호출합니다.
필수 매개변수
의 필수 매개변수는
FetchPlaceRequest
드림
다음과 같습니다.
-
장소 ID
장소를 고유하게 식별하는 텍스트 식별자로 텍스트 검색 (신규), 주변 검색 (신규) 또는 자동 완성 (신규). 장소 ID에 대한 자세한 내용은 다음을 참고하세요. 장소 ID 개요
-
필드 목록
장소를 요청할 때 반환할 장소 데이터를 지정해야 합니다. 받는사람
Place.Field
값 목록을 지정할 수 있습니다. 광고 항목의 기본 목록이 없습니다. 응답에서 반환된 필드를 반환합니다.필드 목록은 불필요한 데이터이므로 불필요한 처리 시간과 이 목록은 결제 시스템 사용을 지원하는 각 요청의 비용에 영향을 미치기 때문입니다. 자세한 내용은 사용 및 결제를 참조하세요.
다음 필드 중 하나 이상을 지정합니다.
다음 필드는 Place Details (IDs Only) SKU를 트리거합니다.
Place.Field.ID
,Place.Field.NAME
,Place.Field.PHOTO_METADATAS
다음 필드는 Place Details (Location Only) SKU를 트리거합니다.
Place.Field.ADDRESS_COMPONENTS
,Place.Field.ADDRESS
,Place.Field.LAT_LNG
,Place.Field.PLUS_CODE
,Place.Field.TYPES
,Place.Field.VIEWPORT
다음 필드는 Place Details (Basic) SKU를 트리거합니다.
Place.Field.BUSINESS_STATUS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_URL
,Place.Field.UTC_OFFSET
,Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
다음 필드는 Place Details (Advanced) SKU를 트리거합니다.
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.SECONDARY_OPENING_HOURS
,Place.Field.PHONE_NUMBER
,Place.Field.PRICE_LEVEL
,Place.Field.RATING
,Place.Field.OPENING_HOURS
,Place.Field.USER_RATINGS_TOTAL
,Place.Field.WEBSITE_URI
다음 필드는 Place Details (Preferred) SKU를 트리거합니다:
<ph type="x-smartling-placeholder"></ph>Place.Field.CURBSIDE_PICKUP
,Place.Field.DELIVERY
,Place.Field.DINE_IN
,Place.Field.EDITORIAL_SUMMARY
,Place.Field.RESERVABLE
,Place.Field.REVIEWS
,Place.Field.SERVES_BEER
,Place.Field.SERVES_BREAKFAST
,Place.Field.SERVES_BRUNCH
,Place.Field.SERVES_DINNER
,Place.Field.SERVES_LUNCH
,Place.Field.SERVES_VEGETARIAN_FOOD
,Place.Field.SERVES_WINE
,Place.Field.TAKEOUT
를 참조하세요.
선택적 매개변수
FetchPlaceRequest
드림
다음과 같습니다.
지역 코드
응답 형식을 지정하는 데 사용되는 지역 코드로, <ph type="x-smartling-placeholder"></ph> 2자리 CLDR 코드 값을 제공합니다. 기본값은 없습니다.
응답의
Place.Field.ADDRESS
필드의 국가 이름이regionCode
인 경우 국가 코드가Place.Field.ADDRESS
에서 생략됩니다.대부분의 CLDR 코드는 ISO 3166-1 코드와 동일하지만 몇 가지 주목할 만한 예외가 있습니다 예를 들어 영국의 ccTLD는 'uk' (.co.uk), ISO 3166-1 코드는 'gb'입니다. (기술적으로 '영국 및 북아일랜드'의 법인 소유입니다. 매개변수는 관련 법률에 따라 결과에 영향을 미칠 수 있습니다.
지역 코드 매개변수를 설정하려면
FetchPlaceRequest
객체를 빌드할 때setRegionCode()
메서드를 호출합니다.-
세션 토큰
세션 토큰은 사용자 생성 문자열로, 통화를 '세션'으로 자동 완성 (신규)합니다. 자동 완성 (신규)은 세션 토큰을 사용하여 사용자 자동 완성 검색의 쿼리 및 장소 선택 단계를 개별 세션으로 그룹화 사용할 수 없습니다. 세션 토큰이 장소 세부정보로 전달됨 (신규) 자동 완성 (신규) 호출 이후의 모든 호출 자세한 내용은 세션 토큰.
세션 토큰 매개변수를 설정하려면
FetchPlaceRequest
객체를 빌드할 때setSessionToken()
메서드를 호출합니다.
장소 세부정보 예
다음 예시에서는 ID
, NAME
, ADDRESS
필드를
뉴욕시에 있는 엠파이어 스테이트 빌딩입니다.
// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";
// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS);
// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);
// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);