특정 시설이나 상점에 대한 추가 세부정보를 요청할 수 있습니다. 광고의 위치와 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);
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);