REST Resource: places

리소스: 장소

장소를 나타내는 모든 정보입니다.

JSON 표현 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
필드
name

string

이 장소의 리소스 이름으로, places/{placeId} 형식입니다. 장소를 조회하는 데 사용할 수 있습니다.
id

string

장소의 고유 식별자입니다.
displayName

object (LocalizedText)

사람이 읽을 수 있는 짧은 설명으로 적합한 장소의 현지화된 이름입니다. 예를 들어 'Google 시드니', '스타벅스', '피어몬트' 등이 있습니다.
types[]

string

이 결과의 유형 태그 집합입니다. 예를 들면 '정치적', '지역'입니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A 및 표 B를 참고하세요.
primaryType

string

주어진 결과의 기본 유형입니다. 이 유형은 Places API에서 지원하는 유형 중 하나여야 합니다. 예를 들어 '식당', '카페', '공항' 등이 있습니다. 장소에는 기본 유형이 하나만 있을 수 있습니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A 및 표 B를 참고하세요.
primaryTypeDisplayName

object (LocalizedText)

기본 유형의 표시 이름으로, 해당하는 경우 요청 언어로 현지화됩니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A 및 표 B를 참고하세요.
nationalPhoneNumber

string

사람이 읽을 수 있는 국가 형식의 장소 전화번호입니다.
internationalPhoneNumber

string

사람이 읽을 수 있는 장소의 전화번호(국가 코드 포함 형식)입니다.
formattedAddress

string

사람이 읽을 수 있는 이 장소의 전체 주소입니다.
shortFormattedAddress

string

사람이 읽을 수 있는 짧은 장소 주소입니다.
addressComponents[]

object (AddressComponent)

지역 수준별로 반복되는 구성요소입니다. addressComponents[] 배열에 대한 다음 사실을 참고하세요. - 주소 구성요소 배열에는 formattedAddress보다 더 많은 구성요소가 포함될 수 있습니다. - 배열에는 formattedAddress에 포함된 것 외에 주소가 포함된 모든 정치적 독립체가 포함되는 것은 아닙니다. 특정 주소가 포함된 모든 정치적 독립체를 가져오려면 역 지오코딩을 사용하여 주소의 위도/경도를 매개변수로 요청에 전달해야 합니다. - 응답의 형식이 요청 간에 동일하게 유지되지 않을 수도 있습니다. 특히 addressComponents의 수는 요청된 주소에 따라 다르며 동일한 주소에 대해서도 시간이 지남에 따라 변경될 수 있습니다. 배열에서 구성요소의 위치가 변경될 수 있습니다. 구성요소의 유형이 변경될 수 있습니다. 특정 구성요소가 이후 응답에서 누락될 수 있습니다.
plusCode

object (PlusCode)

장소 위치 위도/경도의 Plus Code입니다.
location

object (LatLng)

이 장소의 위치입니다.
viewport

object (Viewport)

평균 크기의 지도에 장소를 표시하는 데 적합한 뷰포트입니다. 이 뷰포인트는 비즈니스의 실제 경계 또는 서비스 지역으로 사용해서는 안 됩니다.
rating

number

이 장소에 대한 사용자 리뷰를 기반으로 한 1.0~5.0 사이의 평점입니다.
googleMapsUri

string

이 장소에 대한 자세한 정보를 제공하는 URL입니다.
websiteUri

string

이 장소의 공식 웹사이트(예: 비즈니스 홈페이지)입니다. 체인의 일부인 장소 (예: IKEA 매장)의 경우 일반적으로 전체 체인이 아닌 개별 매장의 웹사이트가 표시됩니다.
reviews[]

object (Review)

이 장소에 대한 리뷰 목록으로, 관련성순으로 정렬됩니다. 최대 5개의 리뷰가 반환될 수 있습니다.
regularOpeningHours

object (OpeningHours)

정규 영업시간입니다. 장소가 항상 열려 있는 경우 (24시간) close 필드는 설정되지 않습니다. 고객은 항상 열려 있음 (24시간)을 값이 0인 [day][google.foo.Point.day], 값이 0인 [hour][google.foo.Point.hour], 값이 0인 [minute][google.foo.Point.minute] 를 포함하는 [open][google.foo.OpeningHours.Period.open] 기간으로 표시할 수 있습니다.
photos[]

object (Photo)

이 장소의 사진에 관한 정보 (참조 포함) 최대 10장의 사진을 반환할 수 있습니다.
adrFormatAddress

string

adr 마이크로포맷(http://microformats.org/wiki/adr)의 장소 주소입니다.
businessStatus

enum (BusinessStatus)

장소의 비즈니스 상태입니다.
priceLevel

enum (PriceLevel)

장소의 가격 수준입니다.
attributions[]

object (Attribution)

이 결과와 함께 표시되어야 하는 데이터 제공자 세트입니다.
iconMaskBaseUri

string

아이콘 마스크의 URL로, 일부가 잘립니다. 사용자는 유형 접미사를 끝에 추가하여 다양한 아이콘 유형에 액세스할 수 있습니다 (예: '.svg' 또는 '.png').
iconBackgroundColor

string

icon_mask의 배경 색상입니다(예: #909CE1). 16진수 형식입니다.
currentOpeningHours

object (OpeningHours)

다음 7일 (오늘 포함)의 영업시간입니다. 기간은 요청 날짜의 자정부터 6일 후 오후 11시 59분까지입니다. 이 필드에는 예외적인 시간이 있는 날짜에 설정된 모든 시간의 specialDays 하위 필드가 포함됩니다.
currentSecondaryOpeningHours[]

object (OpeningHours)

비즈니스의 보조 영업시간에 관한 정보를 포함하여 다음 7일 동안의 항목 배열을 포함합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점은 드라이브 스루 시간 또는 배달 시간을 보조 시간으로 지정할 수 있습니다. 이 필드는 유형 하위 필드를 채웁니다. 이 하위 필드는 장소 유형에 따라 사전 정의된 영업시간 유형 목록 (예: DRIVE_THROUGH, PICKUP, TAKEOUT)에서 가져옵니다. 이 필드에는 예외적인 시간이 있는 날짜에 설정된 모든 시간의 specialDays 하위 필드가 포함됩니다.
regularSecondaryOpeningHours[]

object (OpeningHours)

비즈니스의 정규 보조 영업시간에 관한 정보의 항목 배열을 포함합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점은 드라이브 스루 시간 또는 배달 시간을 보조 시간으로 지정할 수 있습니다. 이 필드는 유형 하위 필드를 채웁니다. 이 하위 필드는 장소 유형에 따라 사전 정의된 영업시간 유형 목록 (예: DRIVE_THROUGH, PICKUP, TAKEOUT)에서 가져옵니다.
editorialSummary

object (LocalizedText)

장소의 요약을 포함합니다. 요약은 텍스트 개요로 구성되며 해당하는 경우 언어 코드도 포함됩니다. 요약 텍스트는 있는 그대로 표시되어야 하며 수정하거나 변경할 수 없습니다.
paymentOptions

object (PaymentOptions)

장소에서 허용하는 결제 옵션입니다. 결제 옵션 데이터를 사용할 수 없는 경우 결제 옵션 필드가 설정되지 않습니다.
parkingOptions

object (ParkingOptions)

장소에서 제공하는 주차 옵션입니다.
subDestinations[]

object (SubDestination)

장소와 관련된 하위 대상 목록입니다.
fuelOptions

object (FuelOptions)

주유소의 연료 옵션에 관한 최신 정보입니다. 이 정보는 정기적으로 업데이트됩니다.
evChargeOptions

object (EVChargeOptions)

전기자동차 충전 옵션에 관한 정보입니다.
generativeSummary

object (GenerativeSummary)

실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.

장소에 대한 AI 생성 요약
areaSummary

object (AreaSummary)

실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.

장소가 있는 지역의 AI 생성 요약입니다.
containingPlaces[]

object (ContainingPlace)

현재 장소가 있는 장소 목록입니다.
addressDescriptor

object (AddressDescriptor)

장소의 주소 설명자입니다. 주소 설명자에는 명소와 지역을 사용하여 위치를 설명하는 데 도움이 되는 추가 정보가 포함됩니다. https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage에서 주소 설명자 지역별 노출 범위를 참고하세요.
priceRange

object (PriceRange)

장소와 연결된 가격 범위입니다.
utcOffsetMinutes

integer

이 장소의 시간대가 현재 UTC와 얼마나 차이가 나는지 분 단위로 나타냅니다. 시간의 일부로 오프셋된 시간대(예: X시간 15분)를 지원하기 위해 분 단위로 표시됩니다.
userRatingCount

integer

이 장소에 대한 총 리뷰 수 (텍스트 유무와 관계없음)입니다.
takeout

boolean

비즈니스에서 테이크아웃을 지원하는지 지정합니다.
delivery

boolean

비즈니스에서 배송을 지원하는지 지정합니다.
dineIn

boolean

비즈니스에서 실내 또는 야외 좌석 옵션을 지원하는지 지정합니다.
curbsidePickup

boolean

비즈니스에서 curbside pickup(노상 수령)을 지원하는지 지정합니다.
reservable

boolean

장소에서 예약을 지원하는지 지정합니다.
servesBreakfast

boolean

장소에서 아침식사를 제공하는지 지정합니다.
servesLunch

boolean

장소에서 점심식사를 제공하는지 여부를 지정합니다.
servesDinner

boolean

장소에서 저녁 식사를 제공하는지 지정합니다.
servesBeer

boolean

장소에서 맥주를 제공하는지 지정합니다.
servesWine

boolean

장소에서 와인을 제공하는지 여부를 지정합니다.
servesBrunch

boolean

장소에서 브런치를 제공하는지 지정합니다.
servesVegetarianFood

boolean

장소에서 채식 음식을 제공하는지 지정합니다.
outdoorSeating

boolean

야외 좌석이 마련된 장소입니다.
liveMusic

boolean

라이브 음악이 제공되는 장소입니다.
menuForChildren

boolean

어린이 메뉴가 있습니다.
servesCocktails

boolean

칵테일을 제공하는 장소입니다.
servesDessert

boolean

디저트를 제공하는 장소입니다.
servesCoffee

boolean

커피를 제공하는 장소입니다.
goodForChildren

boolean

어린이에게 좋은 장소입니다.
allowsDogs

boolean

반려견 동반이 허용되는 장소입니다.
restroom

boolean

장소에 화장실이 있습니다.
goodForGroups

boolean

장소에서 그룹을 수용할 수 있습니다.
goodForWatchingSports

boolean

스포츠 경기를 시청하기에 적합한 장소입니다.
accessibilityOptions

object (AccessibilityOptions)

장소에서 제공하는 접근성 옵션에 관한 정보입니다.
pureServiceAreaBusiness

boolean

장소가 순수 방문 서비스 업체인지 여부를 나타냅니다. 순수 방문 서비스 업체는 고객을 방문하거나 고객에게 직접 서비스를 제공하지만 비즈니스 주소지에서는 고객에게 서비스를 제공하지 않는 비즈니스입니다. 청소 서비스 또는 배관공 등의 비즈니스가 있습니다. 이러한 비즈니스는 Google 지도에 실제 주소나 위치가 없을 수 있습니다.

LocalizedText

특정 언어로 현지화된 텍스트의 변형입니다.

JSON 표현 
{
  "text": string,
  "languageCode": string
}
필드
text

string

아래 languageCode에 해당하는 언어로 현지화된 문자열입니다.
languageCode

string

텍스트의 BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn')입니다.

자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요.

AddressComponent

형식이 지정된 주소를 구성하는 구조화된 구성요소(이 정보를 사용할 수 있는 경우)

JSON 표현 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
필드
longText

string

주소 구성요소의 전체 텍스트 설명 또는 이름입니다. 예를 들어 오스트레일리아 국가의 주소 구성요소는 long_name이 'Australia'일 수 있습니다.
shortText

string

주소 구성요소의 텍스트 약칭입니다(해당하는 경우). 예를 들어 오스트레일리아 국가의 주소 구성요소는 short_name이 'AU'일 수 있습니다.
types[]

string

주소 구성요소의 유형을 나타내는 배열입니다.
languageCode

string

이 구성요소의 형식을 지정하는 데 사용되는 언어(CLDR 표기법)입니다.

PlusCode

Plus Code (http://plus.codes)는 14mx14m (1/8000도) 이하의 직사각형을 정의하는 글로벌 코드와 접두사를 참조 위치로 대체하는 복합 코드라는 두 가지 형식의 위치 참조입니다.

JSON 표현 
{
  "globalCode": string,
  "compoundCode": string
}
필드
globalCode

string

장소의 전 세계(전체) 코드(예: '9FWM33GV+HQ')로, 1/8000도x1/8000도(약 14mx14m) 영역을 나타냅니다.
compoundCode

string

장소의 복합 코드(예: '33GV+HQ, Ramberg, Norway')로, 글로벌 코드의 접미사를 포함하고 접두사를 참조 항목의 형식이 지정된 이름으로 대체합니다.

LatLng

위도/경도 쌍을 나타내는 객체로 위도와 경도를 나타내는 복식 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.

JSON 표현 
{
  "latitude": number,
  "longitude": number
}
필드
latitude

number

위도입니다. 범위는 [-90.0, +90.0]입니다.
longitude

number

경도입니다. 범위는 [-180.0, +180.0]입니다.

표시 영역

대각선으로 반대되는 두 개의 low 및 high 지점으로 표시되는 위도-경도 뷰포트입니다. 표시 영역은 폐쇄된 영역으로 간주됩니다. 즉, 경계가 포함됩니다. 위도 경계는 -90도에서 90도(양 끝값 포함) 사이여야 하며 경도 경계는 -180도에서 180도(양 끝값 포함) 사이여야 합니다. 다양한 케이스에는 다음이 포함됩니다.

  • low = high이면 뷰포트는 단일 지점으로 구성됩니다.

  • low.longitude > high.longitude인 경우 경도 범위가 반전됩니다 (뷰포트가 180도 경도 선을 교차함).

  • low.longitude = -180도이고 high.longitude = 180도인 경우 뷰포트에 모든 경도가 포함됩니다.

  • low.longitude = 180도이고 high.longitude = -180도인 경우 경도 범위는 비어 있습니다.

  • low.latitude가 high.latitude보다 크면 위도 범위가 비어 있습니다.

low 및 high 모두 채워야 하며, 위에 정의된 대로 표현된 상자는 비워 둘 수 없습니다. 뷰포트가 비어 있으면 오류가 발생합니다.

예를 들어 이 뷰포트는 뉴욕시를 완전히 포함합니다.

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 표현 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
필드
low

object (LatLng)

필수 항목입니다. 뷰포트의 하단 지점입니다.
high

object (LatLng)

필수 항목입니다. 뷰포트의 최고점입니다.

검토

장소 리뷰에 대한 정보입니다.

JSON 표현 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string
}
필드
name

string

이 장소 리뷰를 다시 조회하는 데 사용할 수 있는 이 장소 리뷰를 나타내는 참조입니다 (API '리소스' 이름: places/{placeId}/reviews/{review}이라고도 함).
relativePublishTimeDescription

string

언어 및 국가에 적합한 형식으로 현재 시간과 관련된 리뷰 시간을 나타내는 형식 지정된 최근 시간 문자열입니다.
text

object (LocalizedText)

리뷰의 현지화된 텍스트입니다.
originalText

object (LocalizedText)

원래 언어로 된 리뷰 텍스트입니다.
rating

number

별점이라고도 하는 1.0~5.0 사이의 숫자입니다.
authorAttribution

object (AuthorAttribution)

이 리뷰의 작성자입니다.
publishTime

string (Timestamp format)

리뷰의 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
flagContentUri

string

사용자가 리뷰 관련 문제를 신고할 수 있는 링크입니다.
googleMapsUri

string

Google 지도에 리뷰를 표시하는 링크입니다.

AuthorAttribution

UGC 데이터 작성자에 관한 정보입니다. Photo 및 Review에서 사용됩니다.

JSON 표현 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
필드
displayName

string

Photo 또는 Review의 작성자 이름입니다.
uri

string

Photo 또는 Review 작성자의 URI입니다.
photoUri

string

Photo 또는 Review 작성자의 프로필 사진 URI입니다.

OpeningHours

장소의 영업시간에 관한 정보입니다.

JSON 표현 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
필드
periods[]

object (Period)

주중에 영업하는 기간입니다. 기간은 일요일부터 시작하여 시간순으로 지정되며, 위치의 현지 시간대를 기준으로 합니다. 비어 있지만 없는 것은 아닌 값은 장소가 영업하지 않음을 나타냅니다 (예: 리노베이션으로 인해 임시로 폐쇄된 경우).
weekdayDescriptions[]

string

이 장소의 영업시간을 설명하는 현지화된 문자열로, 요일별로 하나씩 문자열이 지정됩니다. 시간이 알 수 없거나 현지화된 텍스트로 변환할 수 없는 경우 비어 있습니다. 예: '일: 18:00~06:00'
secondaryHoursType

enum (SecondaryHoursType)

보조 시간 유형을 식별하는 데 사용되는 유형 문자열입니다.
specialDays[]

object (SpecialDay)

반환된 영업시간이 적용되는 기간에 해당하는 특별한 날에 대한 구조화된 정보입니다. 특별한 날은 장소의 영업시간에 영향을 줄 수 있는 날(예: 크리스마스)입니다. 예외적인 시간이 있는 경우 currentOpeningHours 및 currentSecondaryOpeningHours에 설정합니다.
nextOpenTime

string (Timestamp format)

현재 영업 시간이 시작되는 다음 날짜(최대 7일 후)입니다. 이 필드는 요청을 게재할 때 영업 시간이 활성 상태가 아닌 경우에만 채워집니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
nextCloseTime

string (Timestamp format)

현재 영업 시간이 종료되는 다음 날짜(최대 7일 후)입니다. 이 필드는 요청을 게재할 때 영업 시간이 활성화된 경우에만 채워집니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
openNow

boolean

영업시간 기간이 현재 활성 상태인지 여부입니다. 정규 영업시간 및 현재 영업시간의 경우 이 필드는 장소의 영업 여부를 나타냅니다. 보조 영업시간 및 현재 보조 영업시간의 경우 이 필드는 이 장소의 보조 영업시간이 활성 상태인지 여부를 나타냅니다.

기간

장소가 openNow 상태로 유지되는 기간입니다.

JSON 표현 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
필드
open

object (Point)

장소가 영업을 시작하는 시간입니다.
close

object (Point)

장소가 폐쇄되기 시작하는 시간입니다.

점

상태 변경 지점

JSON 표현 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
필드
date

object (Date)

장소의 현지 시간대 날짜입니다.
truncated

boolean

이 엔드포인트가 잘렸는지 여부입니다. 실제 시간이 시간 간격을 반환하려는 시간 범위를 벗어나면 시간은 잘리므로 이러한 경계로 다시 잘립니다. 이렇게 하면 요청 당일 자정부터 최대 24 * 7시간이 반환됩니다.
day

integer

요일(0~6 범위의 정수)입니다. 0은 일요일, 1은 월요일입니다.
hour

integer

24시간 형식의 시간입니다. 범위는 0~23입니다.
minute

integer

분 범위는 0~59입니다.

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현 
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

SecondaryHoursType

보조 시간 유형을 식별하는 데 사용되는 유형입니다.

열거형
SECONDARY_HOURS_TYPE_UNSPECIFIED 보조 시간 유형이 지정되지 않은 경우의 기본값입니다.
DRIVE_THROUGH 은행, 음식점, 약국의 드라이브 스루 시간입니다.
HAPPY_HOUR 해피아워
DELIVERY 배송 시간입니다.
TAKEOUT 테이크아웃 시간입니다.
KITCHEN 주방 영업시간입니다.
BREAKFAST 아침 식사 시간입니다.
LUNCH 점심 시간입니다.
DINNER 저녁 식사 시간입니다.
BRUNCH 브런치 시간입니다.
PICKUP 수령 시간입니다.
ACCESS 창고 위치의 액세스 시간입니다.
SENIOR_HOURS 노인을 위한 특별 영업시간입니다.
ONLINE_SERVICE_HOURS 온라인 서비스 지원 시간

SpecialDay

반환된 영업시간이 적용되는 기간에 해당하는 특별한 날에 대한 구조화된 정보입니다. 특별한 날은 장소의 영업시간에 영향을 줄 수 있는 날(예: 크리스마스)입니다.

JSON 표현 
{
  "date": {
    object (Date)
  }
}
필드
date

object (Date)

특별한 날의 날짜입니다.

사진

장소 사진에 대한 정보입니다.

JSON 표현 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
필드
name

string

식별자. 이 장소 사진을 다시 조회하는 데 사용할 수 있는 이 장소 사진을 나타내는 참조입니다 (API '리소스' 이름: places/{placeId}/photos/{photo}라고도 함).
widthPx

integer

사용 가능한 최대 너비(픽셀)입니다.
heightPx

integer

사용 가능한 최대 높이(픽셀)입니다.
authorAttributions[]

object (AuthorAttribution)

이 사진의 저자입니다.
flagContentUri

string

사용자가 사진의 문제를 신고할 수 있는 링크입니다.
googleMapsUri

string

Google 지도에 사진을 표시하는 링크입니다.

BusinessStatus

장소의 비즈니스 상태입니다.

열거형
BUSINESS_STATUS_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
OPERATIONAL 영업 중이지만 지금은 영업하지 않고 있을 수 있습니다.
CLOSED_TEMPORARILY 시설이 임시 휴업 중입니다.
CLOSED_PERMANENTLY 시설이 영구적으로 폐쇄되었습니다.

PriceLevel

장소의 가격 수준입니다.

열거형
PRICE_LEVEL_UNSPECIFIED 장소 가격 수준이 지정되지 않았거나 알 수 없습니다.
PRICE_LEVEL_FREE 장소에서 무료 서비스를 제공합니다.
PRICE_LEVEL_INEXPENSIVE 저렴한 서비스를 제공하는 장소입니다.
PRICE_LEVEL_MODERATE 장소에서 적당한 가격의 서비스를 제공합니다.
PRICE_LEVEL_EXPENSIVE 비용이 비싼 서비스를 제공하는 장소입니다.
PRICE_LEVEL_VERY_EXPENSIVE 장소에서 매우 비싼 서비스를 제공합니다.

기여 분석

이 장소의 데이터 제공업체에 관한 정보입니다.

JSON 표현 
{
  "provider": string,
  "providerUri": string
}
필드
provider

string

장소의 데이터 제공업체 이름입니다.
providerUri

string

장소 데이터 제공업체의 URI입니다.

PaymentOptions

장소에서 허용하는 결제 옵션입니다.

JSON 표현 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
필드
acceptsCreditCards

boolean

신용카드로 결제가 가능한 장소입니다.
acceptsDebitCards

boolean

체크카드로 결제가 가능한 장소입니다.
acceptsCashOnly

boolean

현금만 결제 수단으로 허용되는 장소입니다. 이 속성이 있는 장소에서도 다른 결제 수단을 사용할 수 있습니다.
acceptsNfc

boolean

NFC 결제가 가능한 장소입니다.

ParkingOptions

장소의 주차 옵션에 대한 정보입니다. 주차장은 동시에 두 개 이상의 옵션을 지원할 수 있습니다.

JSON 표현 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
필드
freeParkingLot

boolean

장소에 무료 주차장이 있습니다.
paidParkingLot

boolean

장소에 유료 주차장이 있습니다.
freeStreetParking

boolean

무료 노상 주차장이 있습니다.
paidStreetParking

boolean

유료 노상 주차장이 있습니다.
valetParking

boolean

발레파킹 서비스를 이용할 수 있습니다.
freeGarageParking

boolean

무료 주차장도 이용할 수 있습니다.
paidGarageParking

boolean

유료 차고 주차장이 있습니다.

SubDestination

장소와 관련된 하위 대상의 장소 리소스 이름 및 ID입니다. 예를 들어 공항의 터미널은 서로 다른 도착 지점입니다.

JSON 표현 
{
  "name": string,
  "id": string
}
필드
name

string

하위 대상의 리소스 이름입니다.
id

string

하위 도착지의 장소 ID입니다.

AccessibilityOptions

장소에서 제공하는 접근성 옵션에 관한 정보입니다.

JSON 표현 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
필드
wheelchairAccessibleParking

boolean

휠체어 이용 가능 주차장이 마련되어 있습니다.
wheelchairAccessibleEntrance

boolean

장소에 휠체어 이용 가능 입구가 있습니다.
wheelchairAccessibleRestroom

boolean

장소에 휠체어 이용 가능 화장실이 있습니다.
wheelchairAccessibleSeating

boolean

장소에 휠체어 이용 가능 좌석이 있습니다.

FuelOptions

주유소의 연료 옵션에 관한 최신 정보입니다. 이 정보는 정기적으로 업데이트됩니다.

JSON 표현 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
필드
fuelPrices[]

object (FuelPrice)

이 충전소에 있는 각 유형의 연료에 대해 알려진 마지막 연료 가격입니다. 이 충전소에 있는 연료 유형당 하나의 항목이 있습니다. 순서는 중요하지 않습니다.

FuelPrice

지정된 유형의 휘발유 가격 정보입니다.

JSON 표현 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
필드
type

enum (FuelType)

연료 유형입니다.
price

object (Money)

연료 가격입니다.
updateTime

string (Timestamp format)

주유소 가격이 마지막으로 업데이트된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

FuelType

연료 유형입니다.

열거형
FUEL_TYPE_UNSPECIFIED 지정되지 않은 연료 유형입니다.
DIESEL 디젤 연료
REGULAR_UNLEADED 일반 휘발유
MIDGRADE 중급
PREMIUM Premium
SP91 SP 91.
SP91_E10 SP 91 E10
SP92 SP 92
SP95 SP 95.
SP95_E10 SP95 E10
SP98 SP 98
SP99 SP 99.
SP100 SP 100
LPG LPG
E80 E 80.
E85 E 85.
METHANE 메탄
BIO_DIESEL 바이오디젤
TRUCK_DIESEL 트럭 디젤

Money

금액과 통화 유형을 나타냅니다.

JSON 표현 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
필드
currencyCode

string

ISO 4217에 정의된 3자리 통화 코드입니다.
units

string (int64 format)

금액의 전체 단위입니다. 예를 들어 currencyCode가 "USD"이면 1단위는 1달러(USD)입니다.
nanos

integer

금액의 나노 (10^-9) 단위 숫자입니다. 이 값은 -999,999,999~+999,999,999(끝값 포함) 사이여야 합니다. units가 양수이면 nanos는 양수 또는 0이어야 합니다. units가 0이면 nanos는 양수, 0 또는 음수일 수 있습니다. units가 음수이면 nanos는 음수 또는 0이어야 합니다. 예를 들어 $-1.75는 units=-1 및 nanos=-750,000,000으로 나타냅니다.

EVChargeOptions

장소에 호스팅된 전기자동차 충전소에 대한 정보입니다. 용어는 https://afdc.energy.gov/fuels/electricity_infrastructure.html을 따릅니다. 한 포트에서 한 번에 차량 한 대만 충전할 수 있습니다. 하나의 포트에는 하나 이상의 커넥터가 있습니다. 충전소에는 하나 이상의 포트가 있습니다.

JSON 표현 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
필드
connectorCount

integer

이 충전소의 커넥터 수입니다. 하지만 일부 포트에는 커넥터가 여러 개 있지만 한 번에 한 대의 자동차만 충전할 수 있으므로 (예:) 커넥터 수가 동시에 충전할 수 있는 총 자동차 수보다 많을 수 있습니다.
connectorAggregation[]

object (ConnectorAggregation)

동일한 유형 및 동일한 충전 속도의 커넥터가 포함된 전기자동차 충전소 커넥터 집계 목록입니다.

ConnectorAggregation

[type, maxChargeRateKw]별로 그룹화된 전기자동차 충전 정보입니다. 유형과 최대 충전 속도가 동일한 커넥터의 EV 충전 집계를 kw로 표시합니다.

JSON 표현 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
필드
type

enum (EVConnectorType)

이 집계의 커넥터 유형입니다.
maxChargeRateKw

number

집계의 각 커넥터의 정적 최대 충전 속도(kW)입니다.
count

integer

이 집계의 커넥터 수입니다.
availabilityLastUpdateTime

string (Timestamp format)

이 집계의 커넥터 사용 가능 여부 정보가 마지막으로 업데이트된 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
availableCount

integer

현재 이 집계에서 사용할 수 있는 커넥터 수입니다.
outOfServiceCount

integer

현재 서비스가 중단된 이 집계의 커넥터 수입니다.

EVConnectorType

전기자동차 충전 커넥터 유형에 관한 추가 정보/맥락은 http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107을 참고하세요.

열거형
EV_CONNECTOR_TYPE_UNSPECIFIED 지정되지 않은 커넥터입니다.
EV_CONNECTOR_TYPE_OTHER 기타 커넥터 유형
EV_CONNECTOR_TYPE_J1772 J1772 유형 1 커넥터
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 유형 2 커넥터 MENNEKES라고도 합니다.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO 유형 커넥터
EV_CONNECTOR_TYPE_CCS_COMBO_1 결합형 충전 시스템(AC 및 DC) SAE 기준 유형 1 J-1772 커넥터
EV_CONNECTOR_TYPE_CCS_COMBO_2 결합형 충전 시스템(AC 및 DC) Type-2 Mennekes 커넥터 기반
EV_CONNECTOR_TYPE_TESLA 일반 TESLA 커넥터입니다. 북미에서는 NACS이지만 다른 지역에서는 NACS가 아닐 수 있습니다 (예: CCS 콤보 2 (CCS2) 또는 GB/T). 이 값은 실제 커넥터 유형을 나타내는 것보다 Tesla 소유 충전소에서 Tesla 브랜드 차량을 충전할 수 있는 기능을 나타냅니다.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T 유형은 중국의 GB/T 표준에 해당합니다. 이 유형은 모든 GB_T 유형을 다룹니다.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET 지정되지 않은 전원 콘센트

GenerativeSummary

실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.

장소에 대한 AI 생성 요약

JSON 표현 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "description": {
    object (LocalizedText)
  },
  "descriptionFlagContentUri": string,
  "references": {
    object (References)
  }
}
필드
overview

object (LocalizedText)

장소의 개요입니다.
overviewFlagContentUri

string

사용자가 개요 요약의 문제를 신고할 수 있는 링크입니다.
description

object (LocalizedText)

장소에 대한 자세한 설명입니다.
descriptionFlagContentUri

string

사용자가 설명 요약과 함께 문제를 신고할 수 있는 링크입니다.
references

object (References)

요약 설명을 생성하는 데 사용되는 참조입니다.

참조

실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.

생성형 콘텐츠와 관련된 참조입니다.

JSON 표현 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
필드
reviews[]

object (Review)

참고용 리뷰
places[]

string

참조된 장소의 리소스 이름 목록입니다. 이 이름은 장소 리소스 이름을 허용하는 다른 API에서 사용할 수 있습니다.

AreaSummary

실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.

장소가 있는 지역의 AI 생성 요약입니다.

JSON 표현 
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ],
  "flagContentUri": string
}
필드
contentBlocks[]

object (ContentBlock)

지역 요약을 구성하는 콘텐츠 블록입니다. 각 블록에는 해당 영역에 관한 별도의 주제가 있습니다.
flagContentUri

string

사용자가 요약에 문제가 있다고 신고할 수 있는 링크입니다.

ContentBlock

개별적으로 게재할 수 있는 콘텐츠 블록입니다.

JSON 표현 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
필드
topic

string

콘텐츠의 주제입니다(예: '개요' 또는 '식당').
content

object (LocalizedText)

주제와 관련된 콘텐츠
references

object (References)

실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.

이 콘텐츠 블록과 관련된 참조입니다.

ContainingPlace

이 장소가 위치한 장소에 대한 정보입니다.

JSON 표현 
{
  "name": string,
  "id": string
}
필드
name

string

이 장소가 위치한 장소의 리소스 이름입니다.
id

string

이 장소가 위치한 장소의 장소 ID입니다.

AddressDescriptor

위치에 관한 관계형 설명입니다. 주변 명소 및 정확한 포함 영역의 순위 지정된 집합과 대상 위치와의 관계를 포함합니다.

JSON 표현 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
필드
landmarks[]

object (Landmark)

주변 명소의 순위 목록입니다. 가장 눈에 잘 띄고 근처에 있는 랜드마크가 먼저 표시됩니다.
areas[]

object (Area)

포함된 지역 또는 인접 지역의 순위 목록입니다. 가장 잘 인식되고 정확한 영역이 먼저 표시됩니다.

명소

기본적인 랜드마크 정보와 랜드마크와 대상 위치의 관계입니다.

랜드마크는 위치를 설명하는 데 사용할 수 있는 눈에 띄는 장소입니다.

JSON 표현 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
필드
name

string

랜드마크의 리소스 이름입니다.
placeId

string

명소의 장소 ID입니다.
displayName

object (LocalizedText)

랜드마크의 표시 이름입니다.
types[]

string

이 랜드마크의 유형 태그 집합입니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types를 참고하세요.
spatialRelationship

enum (SpatialRelationship)

대상 위치와 랜드마크 간의 공간적 관계를 정의합니다.
straightLineDistanceMeters

number

타겟의 중심점과 랜드마크의 중심점 간의 직선 거리(단위: 미터)입니다. 경우에 따라 이 값이 travelDistanceMeters보다 길 수 있습니다.
travelDistanceMeters

number

대상에서 랜드마크까지 도로망을 따라 이동한 거리(미터, 알려진 경우)입니다. 이 값에는 도보, 운전, 자전거 등 이동 수단이 고려되지 않습니다.

SpatialRelationship

대상 위치와 랜드마크 간의 공간적 관계를 정의합니다.

열거형
NEAR 아래에 더 구체적인 내용이 적용되지 않는 경우 기본 관계입니다.
WITHIN 랜드마크에 공간 도형이 있고 타겟이 도형의 경계 내에 있습니다.
BESIDE 타겟이 랜드마크와 바로 인접해 있습니다.
ACROSS_THE_ROAD 타겟이 도로 반대편의 랜드마크와 정면으로 마주합니다.
DOWN_THE_ROAD 랜드마크와 동일한 경로에 있지만 그 옆이나 건너편에 있지는 않습니다.
AROUND_THE_CORNER 랜드마크와 동일한 경로에 있지는 않지만 한 번만 돌아가면 됩니다.
BEHIND 랜드마크 건물에 가까우나 도로 입구에서 멀리 떨어져 있습니다.

지역

지역 정보 및 해당 지역과 대상 위치의 관계입니다.

지역에는 위치를 설명하는 데 유용한 정확한 하위 지역, 동네, 대규모 단지가 포함됩니다.

JSON 표현 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
필드
name

string

지역의 리소스 이름입니다.
placeId

string

지역의 장소 ID입니다.
displayName

object (LocalizedText)

지역의 표시 이름입니다.
containment

enum (Containment)

대상 위치와 영역 간의 공간적 관계를 정의합니다.

격리

대상 위치와 영역 간의 공간적 관계를 정의합니다.

열거형
CONTAINMENT_UNSPECIFIED 포함이 지정되지 않았습니다.
WITHIN 대상 위치가 중심에 가까운 지역 영역 내에 있습니다.
OUTSKIRTS 대상 위치가 영역 내에서 가장자리에 가깝습니다.
NEAR 대상 위치가 지역 외부이지만 근처에 있습니다.

PriceRange

장소와 연결된 가격 범위입니다. endPrice는 설정되지 않을 수 있으며, 이는 상한이 없는 범위 (예: '100달러 초과')를 나타냅니다.

JSON 표현 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
필드
startPrice

object (Money)

가격 범위의 하한선입니다 (해당 값 포함). 가격은 이 금액 이상이어야 합니다.
endPrice

object (Money)

가격대의 상한선 (해당 값 제외)입니다. 가격이 이 금액보다 낮아야 합니다.

메서드

autocomplete

 지정된 입력의 예측을 반환합니다.

get

 places/{place_id} 형식의 문자열인 리소스 이름을 기반으로 장소의 세부정보를 가져옵니다.

searchNearby

 위치 근처의 장소를 검색합니다.

searchText

 텍스트 쿼리 기반 장소 검색