장소 데이터 필드

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

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

장소 세부정보 요청에 대한 자세한 요금 청구 방식은 사용량 및 결제를 참고하세요.

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

기본 데이터

필드 Places API Maps JavaScript API의 장소 라이브러리 Android용 Places SDK iOS용 Places SDK
주소 구성요소 address_components address_components 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 --- Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE GMSPlaceFieldWheelchairAccessibleEntrance

연락처 데이터 필드

필드 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 --- Place.Field.CURRENT_OPENING_HOURS GMSPlaceFieldCurrentOpeningHours
보조 영업시간 secondary_opening_hours --- Place.Field.SECONDARY_OPENING_HOURS GMSPlaceFieldSecondaryOpeningHours
웹사이트 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 --- Place.Field.EDITORIAL_SUMMARY GMSPlaceFieldEditorialSummary
가격 수준 price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
등급 rating rating Place.Field.RATING GMSPlaceFieldRating
예약 가능 reservable --- Place.Field.RESERVABLE GMSPlaceFieldReservable
리뷰 reviews reviews Place.Field.REVIEWS ---
맥주 판매 serves_beer --- Place.Field.SERVES_BEER GMSPlaceFieldServesBeer
아침 식사 메뉴 제공 serves_breakfast --- Place.Field.SERVES_BREAKFAST GMSPlaceFieldServesBreakfast
브런치 메뉴 제공 serves_brunch --- Place.Field.SERVES_BRUNCH GMSPlaceFieldServesBrunch
저녁 식사 메뉴 제공 serves_dinner --- Place.Field.SERVES_DINNER GMSPlaceFieldServesDinner
점심 식사 메뉴 제공 serves_lunch --- Place.Field.SERVES_LUNCH GMSPlaceFieldServesLunch
채식 메뉴 제공 serves_vegetarian_food --- Place.Field.SERVES_VEGETARIAN_FOOD GMSPlaceFieldServesVegetarianFood
와인 판매 serves_wine --- Place.Field.SERVES_WINE GMSPlaceFieldServesWine
테이크아웃 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를 전달하고, 반환할 필드를 지정하세요.