장소 세부정보 (신규)

플랫폼 선택: Android iOS JavaScript 웹 서비스

특정 시설이나 상점에 대한 추가 세부정보를 요청할 수 있습니다. 광고의 위치와 ID를 입력하고 Place Details (New) 요청. Place Details (New)는 더 포괄적인 정보를 제공합니다. 전체 주소, 전화번호, 전화번호 등 지정된 장소에 대한 숫자, 사용자 평점 및 리뷰입니다.

장소 ID를 가져오는 방법에는 여러 가지가 있습니다. 이 옵션은 다음과 같습니다.

• 텍스트 검색 (신규)
• 주변 검색 (신규)
• 자동 완성 (신규)

참고: Places SDK에서 Place Details (신규)를 사용할 수 있습니다. (Android 버전 3.3.0 이상) 자세한 내용은 SDK 선택 버전

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);

참고: PlacesClient 초기화에 관한 자세한 내용은 다음을 참고하세요. Places API 클라이언트 초기화

CancellationToken을 사용하여 (예: FetchPlaceRequest). 취소는 최선의 방식으로 이루어집니다. 취소 요청이 전송되면 더 이상 응답하지 않습니다. 취소 토큰을 발급한다고 해서 특정 요청이 취소되며, 청구되지 않은 경우에도 요청에 대해 요금이 청구될 수 있습니다. 반환됩니다.

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);