장소 데이터 필드

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

Place Details 요청에 대한 요금 청구에 대한 자세한 내용은 사용량 및 결제를 참조하세요.

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

Basic Data

필드 Places API Places Library, 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 --- ---

연락처 데이터 필드

필드 Places API Places Library, 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
웹사이트 website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

Atmosphere 데이터 필드

필드 Places API Places Library, Maps JavaScript API Android용 Places SDK iOS용 Places SDK
매장 밖 수령 curbside_pickup --- --- ---
게재 delivery --- --- ---
매장 내 식사 dine_in --- --- ---
가격 수준 price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
등급 rating rating Place.Field.RATING GMSPlaceFieldRating
리뷰 reviews reviews --- ---
테이크아웃 takeout --- --- ---
총 사용자 평점 user_ratings_total user_ratings_total Place.Field.USER_RATINGS_TOTAL GMSPlaceFieldUserRatingsTotal

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

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

  • address_component
  • adr_address
  • formatted_phone_number
  • international_phone_number
  • opening_hours
  • reviews
  • type
  • url
  • utc_offset_minutes
  • vicinity
  • website

장소의 데이터 필드를 하나 이상 반환하려면 장소 세부정보 요청을 하고, 장소 ID를 전달하고, 반환할 필드를 지정합니다.