REST Resource: places

리소스: Place

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

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)
  },
  "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)
  }
}
필드
name

string

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

id

string

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

displayName

object (LocalizedText)

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

types[]

string

이 결과의 유형 태그 집합입니다. 예: 'political' '지역'으로 설정할 수 있습니다 가능한 값의 전체 목록은 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에 포함된 항목 외에 주소가 포함된 모든 행정 독립체를 반드시 포함하지는 않습니다. 특정 주소가 포함된 모든 행정 독립체를 검색하려면 역 지오코딩을 사용하여 주소의 위도/경도를 매개변수로 요청에 전달해야 합니다. - 응답의 형식이 요청 간에 동일하게 유지되지 않을 수도 있습니다. 특히 addressComponent의 수는 요청된 주소에 따라 다르며 동일한 주소에 대해서도 시간이 지남에 따라 변경될 수 있습니다. 배열에서 구성요소의 위치가 변경될 수 있습니다. 구성요소의 유형이 변경될 수 있습니다. 특정 구성 요소가 이후 응답에서 누락될 수 있습니다.

plusCode

object (PlusCode)

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

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)

정상 운영 시간입니다.

photos[]

object (Photo)

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

adrFormatAddress

string

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

businessStatus

enum (BusinessStatus)

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

priceLevel

enum (PriceLevel)

장소의 가격 수준입니다.

attributions[]

object (Attribution)

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

iconMaskBaseUri

string

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

iconBackgroundColor

string

16진수 형식의 icon_mask의 배경 색상(예: #909CE1을 사용하세요.

currentOpeningHours

object (OpeningHours)

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

currentSecondaryOpeningHours[]

object (OpeningHours)

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

regularSecondaryOpeningHours[]

object (OpeningHours)

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

editorialSummary

object (LocalizedText)

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

paymentOptions

object (PaymentOptions)

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

parkingOptions

object (ParkingOptions)

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

subDestinations[]

object (SubDestination)

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

fuelOptions

object (FuelOptions)

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

evChargeOptions

object (EVChargeOptions)

EV 충전 옵션에 관한 정보입니다.

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 생성 요약

utcOffsetMinutes

integer

이 장소의 시간대는 현재 UTC 기준 시간(분)입니다. 1시간의 분수로 오프셋되는 시간대를 지원하기 위해 분 단위로 표시됩니다(예: X시간 15분입니다.

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)

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

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

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

shortText

string

주소 구성요소의 텍스트 약칭입니다(사용 가능한 경우). 예를 들어 오스트레일리아 국가의 주소 구성요소에는 '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/8000x1/8000도 영역 (~14x14미터)을 나타냅니다.

compoundCode

string

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

LatLng

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

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

number

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

longitude

number

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

표시 영역

대각선 반대쪽에 있는 두 개의 lowhigh 지점으로 표시되는 위도-경도 표시 영역입니다. 표시 영역은 경계가 포함된 닫힌 영역으로 간주됩니다. 위도 경계는 -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, 위도 범위가 비어 있습니다.

lowhigh를 모두 채워야 하며, 표시된 상자는 (위 정의에 명시된 대로) 비워둘 수 없습니다. 표시 영역이 비어 있으면 오류가 발생합니다.

예를 들어 이 표시 영역은 뉴욕시를 완전히 둘러쌉니다.

{ "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
}
필드
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"입니다.

AuthorAttribution

UGC 데이터의 저자에 관한 정보 PhotoReview에서 사용됩니다.

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)
    }
  ],
  "openNow": boolean
}
필드
periods[]

object (Period)

이 장소가 주중에 영업하는 기간입니다. 기간은 장소의 현지 시간대를 기준으로 일요일부터 시간순으로 표시됩니다. 비어 있지만 없는 값은 비어 있지 않은 장소를 나타냅니다. 예를 들어 개조를 위해 일시적으로 휴업합니다.

weekdayDescriptions[]

string

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

secondaryHoursType

enum (SecondaryHoursType)

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

specialDays[]

object (SpecialDay)

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

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

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

minute

integer

분(2자리) 범위는 00~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)
    }
  ]
}
필드
name

string

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

widthPx

integer

픽셀 단위로 사용할 수 있는 최대 너비입니다.

heightPx

integer

픽셀 단위로 사용할 수 있는 최대 높이입니다.

authorAttributions[]

object (AuthorAttribution)

이 사진의 작성자입니다.

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 프리미엄.
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

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

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

integer

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

connectorAggregation[]

object (ConnectorAggregation)

유형과 충전율이 동일한 커넥터가 포함된 전기자동차 충전 커넥터 집계 목록입니다.

ConnectorAggregation

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

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

enum (EVConnectorType)

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

maxChargeRateKw

number

집계에 있는 각 커넥터의 고정 최대 충전 속도(K)입니다.

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 Type 2 커넥터 보통 MENNEKES라고 합니다.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO 유형 커넥터입니다.
EV_CONNECTOR_TYPE_CCS_COMBO_1 통합 충전 시스템 (AC 및 DC) SAE 기준입니다. Type-1 J-1772 커넥터
EV_CONNECTOR_TYPE_CCS_COMBO_2 통합 충전 시스템 (AC 및 DC) Type-2 Mennekes 커넥터 기반
EV_CONNECTOR_TYPE_TESLA 일반 TESLA 커넥터 북미에서는 NACS이지만 다른 지역에서는 NACS가 아닐 수 있습니다 (예: CCS Combo 2 (CCS2) 또는 GB/T). 이 값은 실제 커넥터 유형을 나타내지는 않으며 테슬라 소유 충전소에서 테슬라 브랜드 차량을 충전하는 기능을 나타냅니다.
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)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
필드
overview

object (LocalizedText)

장소의 개요입니다.

description

object (LocalizedText)

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

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)
    }
  ]
}
필드
contentBlocks[]

object (ContentBlock)

영역 요약을 구성하는 콘텐츠 블록 각 블록에는 지역과 관련된 별도의 주제가 있습니다.

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를 참고하세요.

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

메서드

autocomplete

지정된 입력에 대한 예측을 반환합니다.

get

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

searchNearby

위치 주변 장소 검색

searchText

텍스트 쿼리 기반 장소 검색