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,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "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)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "consumerAlert": {
    object (ConsumerAlert)
  },
  "movedPlace": string,
  "movedPlaceId": string,
  "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

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

string

주어진 결과의 기본 유형입니다. 이 유형은 Places API 지원 유형 중 하나여야 합니다. 예를 들어 'restaurant', 'cafe', 'airport' 등이 있습니다. 장소에는 하나의 기본 유형만 있을 수 있습니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A와 표 B를 참고하세요. 장소의 기본 유형이 지원되는 유형이 아닌 경우 기본 유형이 누락될 수 있습니다. 기본 유형이 있으면 항상 types 필드의 유형 중 하나입니다.
primaryTypeDisplayName

object (LocalizedText)

기본 유형의 표시 이름입니다. 요청 언어로 현지화됩니다(해당하는 경우). 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A와 표 B를 참고하세요. 장소의 기본 유형이 지원되는 유형이 아닌 경우 기본 유형이 누락될 수 있습니다.
nationalPhoneNumber

string

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

string

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

string

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

string

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

object (PostalAddress)

우편 주소 형식의 주소입니다.
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, 값이 0인 hour, 값이 0인 minute를 포함하는 open 기간으로 표시된다고 가정할 수 있습니다.
timeZone

object (TimeZone)

IANA 시간대 데이터베이스 시간대입니다. 예를 들면 "America/New_York"입니다.
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의 배경색입니다(16진수 형식, 예: #909CE1).
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)

장소에 대한 AI 생성 요약입니다.
containingPlaces[]

object (ContainingPlace)

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

object (AddressDescriptor)

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

object (PriceRange)

장소와 관련된 가격대입니다.
reviewSummary

object (ReviewSummary)

사용자 리뷰를 사용한 장소의 AI 생성 요약입니다.
evChargeAmenitySummary

object (EvChargeAmenitySummary)

전기자동차 충전소 주변 편의시설의 요약입니다.
neighborhoodSummary

object (NeighborhoodSummary)

장소 근처의 관심 장소 요약입니다.
consumerAlert

object (ConsumerAlert)

비즈니스에서 의심스러운 리뷰 활동이 감지되거나 비즈니스가 Google 정책을 위반하는 경우 장소에 표시되는 소비자 알림 메시지입니다.
movedPlace

string

이 장소가 영구적으로 폐쇄되어 새 장소로 이전된 경우 이 필드에는 새 장소의 리소스 이름이 places/{placeId} 형식으로 포함됩니다. 이 장소가 여러 번 이동한 경우 이 필드는 처음 이동한 장소를 나타냅니다. 이 장소가 이동하지 않은 경우 이 필드는 채워지지 않습니다.
movedPlaceId

string

이 장소가 영구적으로 폐쇄되었고 새 장소로 이전된 경우 이 필드에는 새 장소의 장소 ID가 포함됩니다. 이 장소가 여러 번 이동한 경우 이 필드는 처음 이동한 장소를 나타냅니다. 이 장소가 이동하지 않은 경우 이 필드는 채워지지 않습니다.
utcOffsetMinutes

integer

이 장소의 시간대가 현재 UTC에서 오프셋된 시간(분)입니다. 시간의 일부로 오프셋되는 표준 시간대(예: 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)

장소에서 제공하는 접근성 옵션에 관한 정보입니다.
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를 참조하세요.

PostalAddress

우편 배달 주소나 수취인 주소와 같은 우편 주소를 나타냅니다. 우편 주소가 있으면 우체국이 사업장, 사서함 또는 이와 유사한 주소로 물건을 배달할 수 있습니다. 우편 주소는 도로, 마을, 산과 같은 지리적 위치를 모델링하기 위한 것이 아닙니다.

일반적인 경우 주소는 프로세스 유형에 따라 사용자 입력을 통해 또는 기존 데이터를 가져와 생성됩니다.

주소 입력 또는 수정에 관한 도움말:

  • https://github.com/google/libaddressinput과 같은 국제화 지원 주소 위젯을 사용하세요.
  • 필드가 사용되는 국가 밖에서 해당 필드를 입력 또는 수정할 수 있는 UI 요소가 사용자에게 표시되어서는 안 됩니다.

이 스키마를 사용하는 방법에 대한 자세한 내용은 https://support.google.com/business/answer/6397478을 참고하세요.

JSON 표현 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
필드
revision

integer

PostalAddress의 스키마 버전입니다. 최신 버전을 나타내는 0으로 설정해야 합니다.

모든 새 버전은 이전 버전과 반드시 호환되어야 합니다.
regionCode

string

필수 항목입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다. 이 코드는 추론되지 않으며, 값의 정확성은 사용자의 책임입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'.
languageCode

string

선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (알려진 경우). 종종 입력 양식의 UI 언어이거나 주소의 국가/지역에서 사용되는 언어 중 하나 또는 음역된 언어와 일치해야 합니다. 일부 국가에서 형식을 갖추는 데 영향을 줄 수 있지만 데이터의 정확성에는 중요하지 않으며, 유효성 검사 작업이나 형식을 갖추는 것과 관련 없는 기타 작업에는 영향이 없습니다.

이 값을 알 수 없다면 잘못될 가능성이 있는 기본값을 지정하는 대신 이 값을 생략해야 합니다.

예: 'zh-Hant', 'ja', 'ja-Latn', 'en'.
postalCode

string

선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 우편번호가 있어야 하는 것은 아니지만 사용되는 경우 주소 다른 부분의 추가 유효성 검사 (예: 미국의 주 또는 우편번호 유효성 검사)가 트리거될 수 있습니다.
sortingCode

string

선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 지역에서 사용되지 않습니다. 사용되는 경우 값은 'CEDEX'와 같은 문자열이며, 선택적으로 숫자 (예: 'CEDEX 7')가 뒤에 오거나 '섹터 코드' (자메이카), '배송 지역 표시기' (말라위) 또는 '우체국 표시기' (코트디부아르)를 나타내는 숫자만 있습니다.
administrativeArea

string

선택사항입니다. 국가 또는 지역의 우편 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 미국의 주, 캐나다의 주, 구소련의 주 또는 프랑스의 도가 될 수 있습니다. 스페인의 경우 광역 자치주가 아니라 주(province)입니다(예: '카탈로니아'가 아니라 '바르셀로나'). 많은 국가에서는 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다.
locality

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, 이탈리아 코무네, 영국 포스트타운. 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 locality를 비워 두고 addressLines를 사용합니다.
sublocality

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 구일 수 있습니다.
addressLines[]

string

주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다.

addressLines의 값에는 유형 정보가 없고 경우에 따라 하나의 필드에 여러 값이 포함될 수 있으므로 (예: 'Austin, TX') 행 순서가 명확해야 합니다. 주소 입력란 순서는 주소의 국가 또는 지역의 '봉투 순서'여야 합니다. 이것이 달라질 수 있는 곳 (예: 일본)에서는 address_language를 사용하여 명시적으로 만듭니다 (예: 큰 단위에서 작은 단위 순서는 'ja', 작은 단위에서 큰 단위 순서는 'ja-Latn' 또는 'en'). 이렇게 하면 언어를 기준으로 가장 구체적인 주소 입력란을 선택할 수 있습니다.

주소에 허용되는 최소 구조 표시는 나머지 모든 정보가 addressLines에 배치된 regionCode로 구성됩니다. 이러한 주소를 지오코딩 없이 상당히 비슷하게 형식을 갖출 수도 있지만 최소한 부분적으로 확인될 때까지는 어떤 주소 구성요소에 대해서도 의미 추론을 할 수 없습니다.

주소 중 지역에 해당하는 부분과 행정 구역에 해당하는 부분을 추측하는 대신 regionCode 및 addressLines만 포함된 주소를 만든 다음 지오코딩하는 것이 전혀 구조화되지 않은 주소를 처리하는 방법으로 좋습니다.
recipients[]

string

선택사항입니다. 주소의 수신자입니다. 경우에 따라 이 필드에 여러 줄로 구성된 정보가 포함될 수 있습니다. 예를 들어 '전교' 정보가 포함될 수 있습니다.
organization

string

선택사항입니다. 주소에 있는 조직의 이름입니다.

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 x 1/8000도 영역(~14x14미터)을 나타냅니다.
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,
  "visitDate": {
    object (Date)
  }
}
필드
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)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
flagContentUri

string

사용자가 리뷰 문제를 신고할 수 있는 링크
googleMapsUri

string

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

object (Date)

작성자가 장소를 방문한 날짜입니다. 방문 연도와 월로 잘립니다.

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입니다.

날짜

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

  • 연도, 월, 일 값이 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이어야 합니다.

OpeningHours

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

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

object (Period)

이 장소가 주중에 영업하는 기간입니다. 기간은 장소의 현지 시간대를 기준으로 시간순으로 표시됩니다. 비어 있지만 누락되지 않은 값은 리모델링으로 인해 일시적으로 폐쇄되는 등 절대 열리지 않는 장소를 나타냅니다.

periods의 시작일은 고정되어 있지 않으며 일요일이라고 가정해서는 안 됩니다. API는 다양한 요인을 기반으로 시작일을 결정합니다. 예를 들어 24시간 연중무휴 비즈니스의 경우 첫 번째 기간이 요청 당일에 시작될 수 있습니다. 다른 비즈니스의 경우 영업하는 첫 번째 요일일 수 있습니다.

참고: periods 배열의 순서는 weekdayDescriptions 배열의 순서와 무관합니다. 두 캠페인이 같은 날에 시작된다고 가정하지 마세요.
weekdayDescriptions[]

string

이 장소의 영업시간을 설명하는 현지화된 문자열입니다. 요일별로 하나의 문자열이 있습니다.

참고: 요일 순서와 주 시작일은 언어 및 지역에 따라 결정됩니다. periods 배열의 순서는 weekdayDescriptions 배열의 순서와 무관합니다. 두 캠페인이 같은 날에 시작된다고 가정하지 마세요.

시간을 알 수 없거나 현지화된 텍스트로 변환할 수 없는 경우 비어 있습니다. 예: '일: 18:00~06:00'
secondaryHoursType

enum (SecondaryHoursType)

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

object (SpecialDay)

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

string (Timestamp format)

현재 영업시간 기간이 시작되는 다음 시간(최대 7일 후) 이 필드는 요청이 처리되는 시점에 영업시간 기간이 활성 상태가 아닌 경우에만 채워집니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
nextCloseTime

string (Timestamp format)

현재 영업시간 기간이 최대 7일 후에 종료되는 다음 시간입니다. 이 필드는 요청이 처리되는 시점에 영업시간 기간이 활성 상태인 경우에만 채워집니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
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입니다.

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)

이 특별한 날의 날짜입니다.

TimeZone

IANA 시간대 데이터베이스에서 가져온 시간대를 나타냅니다.

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

string

IANA 시간대 데이터베이스 시간대입니다. 예를 들면 "America/New_York"입니다.
version

string

선택사항. IANA 시간대 데이터베이스 버전 번호입니다. 예를 들면 "2019a"입니다.

사진

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

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)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

FuelType

연료 유형입니다.

열거형
FUEL_TYPE_UNSPECIFIED 지정되지 않은 연료 유형입니다.
DIESEL 디젤 연료
DIESEL_PLUS 디젤 플러스 연료
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 액화 석유 가스
E80 E 80.
E85 E 85.
E100 E 100.
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)

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

ConnectorAggregation

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

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)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
availableCount

integer

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

integer

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

EVConnectorType

EV 충전 커넥터 유형에 관한 추가 정보/맥락은 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 Combined Charging System (AC 및 DC) SAE를 기반으로 합니다. 타입 1 J-1772 커넥터
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System (AC 및 DC) Type-2 Mennekes 커넥터 기반
EV_CONNECTOR_TYPE_TESLA 일반 TESLA 커넥터입니다. 북미에서는 NACS이지만 세계 다른 지역에서는 NACS가 아닐 수 있습니다 (예: CCS Combo 2 (CCS2) 또는 GB/T). 이 값은 실제 커넥터 유형을 나타내기보다는 Tesla 소유 충전소에서 Tesla 브랜드 차량을 충전할 수 있는 기능을 나타냅니다.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T 유형은 중국의 GB/T 표준에 해당합니다. 이 유형은 모든 GB_T 유형을 포함합니다.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET 지정되지 않은 전원 콘센트입니다.
EV_CONNECTOR_TYPE_NACS 북미 충전 시스템 (NACS), SAE J3400으로 표준화됨

GenerativeSummary

장소에 대한 AI 생성 요약입니다.

JSON 표현 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
필드
overview

object (LocalizedText)

장소의 개요입니다.
overviewFlagContentUri

string

사용자가 개요 요약의 문제를 신고할 수 있는 링크
disclosureText

object (LocalizedText)

'Gemini로 요약됨'이라는 AI 공개 메시지(및 현지화된 변형) 사용 가능한 경우 요청에 지정된 언어로 표시됩니다.

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)

포함된 영역 또는 인접한 영역의 순위가 지정된 목록입니다. 가장 인식하기 쉽고 정확한 영역이 1위로 표시됩니다.

명소

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

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

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)

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

ReviewSummary

사용자 리뷰를 사용한 장소의 AI 생성 요약입니다.

JSON 표현 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  },
  "reviewsUri": string
}
필드
text

object (LocalizedText)

사용자 리뷰 요약입니다.
flagContentUri

string

사용자가 요약의 문제를 신고할 수 있는 링크
disclosureText

object (LocalizedText)

'Gemini로 요약됨'이라는 AI 공개 메시지(및 현지화된 변형) 사용 가능한 경우 요청에 지정된 언어로 표시됩니다.
reviewsUri

string

Google 지도에서 이 장소의 리뷰를 표시하는 링크입니다.

EvChargeAmenitySummary

전기자동차 충전소 주변 편의시설의 요약입니다. electric_vehicle_charging_station 유형의 장소에만 적용됩니다. overview 필드는 제공되지만 다른 필드는 선택사항입니다.

JSON 표현 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
필드
overview

object (ContentBlock)

이용 가능한 편의시설의 개요입니다. 이 값은 항상 제공됩니다.
coffee

object (ContentBlock)

근처 카페 옵션의 요약
restaurant

object (ContentBlock)

근처 음식점의 요약입니다.
store

object (ContentBlock)

근처 매장의 요약입니다.
flagContentUri

string

사용자가 요약의 문제를 신고할 수 있는 링크
disclosureText

object (LocalizedText)

'Gemini로 요약됨'이라는 AI 공개 메시지(및 현지화된 변형) 사용 가능한 경우 요청에 지정된 언어로 표시됩니다.

ContentBlock

개별적으로 제공될 수 있는 콘텐츠 블록입니다.

JSON 표현 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
필드
content

object (LocalizedText)

주제와 관련된 콘텐츠
referencedPlaces[]

string

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

NeighborhoodSummary

장소 근처의 관심 장소 요약입니다.

JSON 표현 
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
필드
overview

object (ContentBlock)

동네의 개요 요약입니다.
description

object (ContentBlock)

인근 지역에 대한 자세한 설명입니다.
flagContentUri

string

사용자가 요약의 문제를 신고할 수 있는 링크
disclosureText

object (LocalizedText)

'Gemini로 요약됨'이라는 AI 공개 메시지(및 현지화된 변형) 사용 가능한 경우 요청에 지정된 언어로 표시됩니다.

ConsumerAlert

비즈니스에서 의심스러운 리뷰 활동이 감지되거나 비즈니스가 Google 정책을 위반하는 경우 장소에 표시되는 소비자 알림 메시지입니다.

JSON 표현 
{
  "overview": string,
  "details": {
    object (Details)
  },
  "languageCode": string
}
필드
overview

string

소비자 알림 메시지의 개요입니다.
details

object (Details)

소비자 알림 메시지의 세부정보입니다.
languageCode

string

소비자 알림 메시지의 언어 코드입니다. BCP 47 언어 코드입니다.

세부정보

소비자 알림 메시지의 세부정보입니다.

JSON 표현 
{
  "title": string,
  "description": string,
  "aboutLink": {
    object (Link)
  }
}
필드
title

string

설명과 함께 표시할 제목입니다.
description

string

소비자 알림 메시지에 대한 설명입니다.

메서드

autocomplete

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

get

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

searchNearby

 위치 주변의 장소를 검색합니다.

searchText

 텍스트 쿼리 기반 장소 검색입니다.