REST Resource: places

{
  "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)
  },
  "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)
  }
}

string

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

string

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

object (LocalizedText)

장소의 현지화된 이름으로, 사람이 읽을 수 있는 짧은 설명으로 적합합니다. 예: 'Google 시드니', '스타벅스', 'Pyrmont' 등

string

이 결과에 대한 유형 태그 집합입니다. 예: 'political' 및 'locality' 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types에서 표 A와 표 B를 참고하세요.

string

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

object (LocalizedText)

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

string

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

string

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

string

이 장소에 대한 사람이 읽을 수 있는 전체 주소입니다.

string

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

object (AddressComponent)

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

object (PlusCode)

장소 위치 위도/경도의 플러스 코드입니다.

object (LatLng)

이 장소의 위치입니다.

object (Viewport)

평균 크기의 지도에 장소를 표시하는 데 적합한 뷰포트입니다.

number

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

string

이 장소에 대한 추가 정보를 제공하는 URL입니다.

string

이 장소의 신뢰할 수 있는 웹사이트입니다(예: 업체 홈페이지). 체인점 (예: IKEA 매장)에 속한 장소의 경우 일반적으로 전체 체인점이 아닌 개별 매장의 웹사이트입니다.

object (Review)

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

object (OpeningHours)

정규 영업시간입니다.

object (Photo)

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

string

adr microformat으로 된 장소의 주소: http://microformats.org/wiki/adr.

enum (BusinessStatus)

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

enum (PriceLevel)

장소의 가격 수준입니다.

object (Attribution)

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

string

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

string

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

object (OpeningHours)

앞으로 7일간의 운영 시간입니다 (오늘 포함). 기간은 요청 날짜의 자정에 시작되어 6일 후 오후 11시 59분에 종료됩니다. 이 입력란에는 전체 영업시간의 specialDays 하위 필드가 포함되며 영업시간이 예외적인 날짜에 대해 설정됩니다.

object (OpeningHours)

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

object (OpeningHours)

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

object (LocalizedText)

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

object (PaymentOptions)

장소에서 사용할 수 있는 결제 옵션입니다. 결제 옵션 데이터를 사용할 수 없는 경우 결제 옵션 필드가 설정 해제됩니다.

object (ParkingOptions)

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

object (SubDestination)

장소와 관련된 하위 목적지 목록입니다.

object (FuelOptions)

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

object (EVChargeOptions)

EV 충전 옵션 정보

integer

현재 이 장소의 시간대가 UTC에서 차이 나는 시간(분)입니다. 분 단위로 표현되어 1시간의 분수로 오프셋되는 시간대를 지원합니다(예: X시간 15분).

integer

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

boolean

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

boolean

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

boolean

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

boolean

비즈니스에서 매장 밖 수령을 지원하는지 여부를 지정합니다.

boolean

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

boolean

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

boolean

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

boolean

저녁 식사 제공 여부를 지정합니다.

boolean

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

boolean

장소에서 와인을 제공하는지 명시합니다.

boolean

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

boolean

채식 요리를 제공하는지 여부를 지정합니다.

boolean

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

boolean

라이브 음악을 즐길 수 있는 장소입니다.

boolean

어린이 메뉴가 있는 장소입니다.

boolean

칵테일을 제공합니다.

boolean

디저트를 판매합니다.

boolean

커피숍에서 커피를 즐길 수 있습니다.

boolean

아이들에게 좋은 장소입니다.

boolean

반려견 동반이 가능한 장소입니다.

boolean

화장실이 있는 장소입니다.

boolean

단체가 수용 가능한 장소입니다.

boolean

스포츠 경기를 관람하기에 적합한 장소입니다.

object (AccessibilityOptions)

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

{
  "text": string,
  "languageCode": string
}

string

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

string

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

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

{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}

string

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

string

주소 구성요소의 텍스트 약칭입니다(사용 가능한 경우). 예를 들어 오스트레일리아 국가의 주소 구성요소에는 'AU'라는 short_name이 포함될 수 있습니다.

string

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

string

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

{
  "globalCode": string,
  "compoundCode": string
}

string

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

string

장소의 복합 코드(예: '33GV+HQ, Ramberg, Korean')입니다. 전역 코드의 접미사가 포함되며 접두사를 참조 항목의 형식이 지정된 이름으로 대체합니다.

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

필수 항목입니다. 표시 영역의 최저점입니다.

object (LatLng)

필수 항목입니다. 표시 영역의 최고점입니다.

{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}

string

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

string

형식이 지정된 최근 시간의 문자열로, 현재 시간을 기준으로 한 리뷰 시간을 언어 및 국가에 적합한 형식으로 표현합니다.

object (LocalizedText)

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

object (LocalizedText)

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

number

1.0과 5.0 사이의 숫자이며 별 수라고도 합니다.

object (AuthorAttribution)

이 리뷰의 작성자입니다.

string (Timestamp format)

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

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

{
  "displayName": string,
  "uri": string,
  "photoUri": string
}

string

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

string

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

string

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

{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}

object (Period)

이 장소가 주중에 영업하는 기간입니다. 기간은 장소 현지 시간대의 일요일부터 시작하여 시간 순서대로 표시됩니다. 비어 있지만 없는 값은 없는 장소 (예: 리노베이션을 위해 임시 휴업)를 나타냅니다.

string

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

enum (SecondaryHoursType)

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

object (SpecialDay)

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

boolean

이 장소가 현재 영업 중인가요? 영업시간에 대한 시간 또는 시간대 데이터가 없는 경우 항상 표시됩니다.

{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}

object (Point)

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

object (Point)

장소의 영업이 종료되기 시작하는 시간입니다.

{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}

object (Date)

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

boolean

이 엔드포인트가 잘렸는지 여부입니다. 실제 시간과 그 사이의 시간 반환 시간이 이렇게 하면 요청 당일 자정으로부터 최대 24 * 7시간이 반환됩니다.

integer

요일로, 0~6 범위의 정수로 표시됩니다. 0은 일요일, 1은 월요일 등입니다.

integer

시간을 2자리로 표시합니다. 범위는 00~23입니다.

integer

분을 2자리로 표시합니다. 범위는 00~59입니다.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

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

integer

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

integer

일(일)입니다. 1~31 사이의 값이어야 하며 연도와 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않은 연도와 월을 지정하려면 0이어야 합니다.

{
  "date": {
    object (Date)
  }
}

object (Date)

특별한 날의 날짜입니다.

{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}

string

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

integer

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

integer

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

object (AuthorAttribution)

이 사진의 작성자입니다.

{
  "provider": string,
  "providerUri": string
}

string

장소의 데이터 제공자 이름입니다.

string

장소의 데이터 제공자에 대한 URI입니다.

{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}

boolean

장소에서 신용카드로 결제할 수 있습니다.

boolean

장소에서 체크카드를 사용할 수 있습니다.

boolean

장소에서는 현금으로만 결제 가능합니다. 이 속성이 있는 장소에서는 다른 결제 수단을 계속 허용할 수 있습니다.

boolean

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

{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}

boolean

무료 주차장이 있습니다.

boolean

유료 주차장이 있습니다.

boolean

노상 주차는 무료입니다.

boolean

유료 노상 주차가 가능합니다.

boolean

발레파킹 서비스가 제공됩니다.

boolean

주차장을 무료로 이용할 수 있습니다.

boolean

주차장은 유료로 이용할 수 있습니다.

{
  "name": string,
  "id": string
}

string

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

string

하위 목적지의 장소 ID입니다.

{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}

boolean

휠체어 이용가능 주차장이 있습니다.

boolean

휠체어 이용가능 입구가 있습니다.

boolean

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

boolean

휠체어 이용가능 좌석이 마련되어 있습니다.

{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}

object (FuelPrice)

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

{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}

enum (FuelType)

연료 유형입니다.

object (Money)

연료 가격입니다.

string (Timestamp format)

연료 가격이 마지막으로 업데이트된 시간입니다.

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

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

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

string (int64 format)

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

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으로 나타냅니다.

{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}

integer

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

object (ConnectorAggregation)

유형이 동일하고 충전 속도가 동일한 커넥터가 포함된 EV 충전 커넥터 집계 목록입니다.

{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}

enum (EVConnectorType)

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

number

집계에 포함된 각 커넥터의 정적 최대 충전 속도(kw)입니다.

integer

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

string (Timestamp format)

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

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

integer

이 집계에서 현재 사용 가능한 커넥터 수입니다.

integer

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