장소 데이터 필드

장소 데이터 필드는 장소 세부정보를 요청할 때 반환할 장소 데이터의 유형을 정의합니다. 이 페이지에서는 모든 장소 데이터 필드를 나열하고 각 API/SDK에서 이러한 데이터 필드를 지원하는 방식을 설명합니다(장소 필드 지원 방식은 플랫폼 또는 기능에 따라 다름).

장소 세부정보 요청에 대해 요금이 청구되는 방법에 대한 자세한 내용은 사용량 및 결제를 참고하세요.

다음 표에는 지원되는 모든 장소 데이터 필드 값이 가격 등급 및 플랫폼별로 나와 있습니다.

기본 데이터

필드 Places API 장소 라이브러리, Maps JavaScript API Android용 Places SDK iOS용 Places SDK
주소 구성요소 address_component address_component Place.Field.ADDRESS_COMPONENTS GMSPlaceFieldAddressComponents
주소 adr_address adr_address --- ---
비즈니스 상태 business_status business_status Place.Field.BUSINESS_STATUS GMSPlaceFieldBusinessStatus
형식이 지정된 주소 formatted_address formatted_address Place.Field.ADDRESS GMSPlaceFieldFormattedAddress
표시 영역 geometry/viewport geometry.viewport Place.Field.VIEWPORT GMSPlaceFieldViewport
위치 geometry/location geometry.location Place.Field.LAT_LNG GMSPlaceFieldCoordinate
아이콘 icon icon --- ---
아이콘 마스크 기본 URI icon_mask_base_uri icon_mask_base_uri Place.Field.ICON_URL GMSPlaceFieldIconImageURL
아이콘 배경 색상 icon_background_color icon_background_color Place.Field.ICON_BACKGROUND_COLOR GMSPlaceFieldIconBackgroundColor
이름 name name Place.Field.NAME GMSPlaceFieldName
폐업(지원 중단됨) permanently_closed permanently_closed --- ---
사진 photos photos Place.Field.PHOTO_METADATAS GMSPlaceFieldPhotos
장소 ID place_id place_id Place.Field.ID GMSPlaceFieldPlaceID
Plus Code plus_code plus_code Place.Field.PLUS_CODE GMSPlaceFieldPlusCode
유형 type type Place.Field.TYPES GMSPlaceFieldTypes
URL url url --- ---
UTC 오프셋 utc_offset utc_offset_minutes Place.Field.UTC_OFFSET GMSPlaceFieldUTCOffsetMinutes
부근 vicinity vicinity --- ---
휠체어 이용가능 입구 wheelchair_accessible_entrance --- --- ---

연락처 데이터 필드

필드 Places API 장소 라이브러리, Maps JavaScript API Android용 Places SDK iOS용 Places SDK
전화번호 formatted_phone_number formatted_phone_number --- ---
국제 전화번호 international_phone_number international_phone_number Place.Field.PHONE_NUMBER GMSPlaceFieldPhoneNumber
영업시간 opening_hours opening_hours Place.Field.OPENING_HOURS GMSPlaceFieldOpeningHours
현재 영업시간 current_opening_hours --- --- ---
보조 영업시간 secondary_opening_hours --- --- ---
웹사이트 website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

분위기 데이터 필드

필드 Places API 장소 라이브러리, Maps JavaScript API Android용 Places SDK iOS용 Places SDK
매장 밖 수령 curbside_pickup --- Place.Field.CURBSIDE_PICKUP GMSPlaceFieldCurbsidePickup
전송 delivery --- Place.Field.DELIVERY GMSPlaceFieldDelivery
매장 내 식사 dine_in --- Place.Field.DINE_IN GMSPlaceFieldDineIn
편집 요약 editorial_summary --- --- ---
가격 수준 price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
등급 rating rating Place.Field.RATING GMSPlaceFieldRating
예약 가능 reservable --- --- ---
리뷰 reviews reviews --- ---
맥주 판매 serves_beer --- --- ---
아침 식사 메뉴 제공 serves_breakfast --- --- ---
브런치 메뉴 제공 serves_brunch --- --- ---
저녁 식사 메뉴 제공 serves_dinner --- --- ---
점심 식사 메뉴 제공 serves_lunch --- --- ---
채식 메뉴 제공 serves_vegetarian_food --- --- ---
와인 판매 serves_wine --- --- ---
테이크아웃 takeout --- Place.Field.TAKEOUT GMSPlaceFieldTakeout
총 사용자 평점 user_ratings_total user_ratings_total Place.Field.USER_RATINGS_TOTAL GMSPlaceFieldUserRatingsTotal

Places API 필드 지원

장소 검색, 주변 검색, 텍스트 검색 요청은 모두 장소 세부정보 요청에서 반환하는 필드의 하위 집합을 반환합니다. 이러한 메서드는 다음 필드를 반환하지 않습니다.

  • address_component
  • adr_address
  • curbside_pickup
  • current_opening_hours
  • delivery
  • dine_in
  • editorial_summary
  • formatted_phone_number
  • international_phone_number
  • opening_hours.periods
  • opening_hours.special_days
  • opening_hours.type
  • opening_hours.weekday_text
  • reservable
  • secondary_opening_hours
  • reviews
  • serves_beer
  • serves_breakfast
  • serves_brunch
  • serves_dinner
  • serves_lunch
  • serves_vegetarian_food
  • serves_wine
  • takeout
  • type
  • url
  • user_ratings_total
  • utc_offset_minutes
  • vicinity
  • website
  • wheelchair_accessible_entrance

장소에 대해 이러한 데이터 필드를 하나 이상 반환하려면 장소 세부정보 요청을 하고, 장소 ID를 전달하고, 반환할 필드를 지정하세요.