장소 데이터 필드

플랫폼 선택: 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

Maps JavaScript API의 장소 라이브러리 필드 지원

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

  • address_component
  • adr_address
  • formatted_phone_number
  • international_phone_number
  • opening_hours(장소 검색의 경우 반환되지 않음. 주변 검색 및 텍스트 검색의 경우 openNow 요청 매개변수를 사용해야 함)
  • reviews
  • takeout
  • type
  • url
  • utc_offset_minutes
  • vicinity
  • website

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