- 리소스: Place
- LocalizedText
- AddressComponent
- PlusCode
- LatLng
- 표시 영역
- 검토
- AuthorAttribution
- OpeningHours
- 마침표
- 포인트
- 날짜
- SecondaryHoursType
- SpecialDay
- 사진
- BusinessStatus
- PriceLevel
- 기여 분석
- PaymentOptions
- ParkingOptions
- SubDestination
- AccessibilityOptions
- FuelOptions
- FuelPrice
- FuelType
- 금액
- EVChargeOptions
- ConnectorAggregation
- EVConnectorType
- GenerativeSummary
- 참조
- AreaSummary
- ContentBlock
- 메서드
리소스: Place
장소를 나타내는 모든 정보입니다.
JSON 표현 |
---|
{ "name": string, "id": string, "displayName": { object ( |
입력란 | |
---|---|
name |
|
id |
장소의 고유 식별자입니다. |
displayName |
장소의 현지화된 이름으로, 사람이 읽을 수 있는 짧은 설명으로 적합합니다. 예: 'Google 시드니', '스타벅스', 'Pyrmont' 등 |
types[] |
이 결과에 대한 유형 태그 집합입니다. 예: 'political' 및 'locality' 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types에서 표 A와 표 B를 참고하세요. |
primaryType |
지정된 결과의 기본 유형입니다. 이 유형은 Places API에서 지원되는 유형 중 하나여야 합니다. 예를 들어 '레스토랑', '카페', '공항' 등이 있습니다. 하나의 장소에는 하나의 기본 유형만 포함될 수 있습니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types에서 표 A와 표 B를 참고하세요. |
primaryTypeDisplayName |
기본 유형의 표시 이름으로, 해당하는 경우 요청 언어로 현지화된 이름입니다. 가능한 값의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types에서 표 A와 표 B를 참고하세요. |
nationalPhoneNumber |
사람이 읽을 수 있는 국가 형식의 전화번호입니다. |
internationalPhoneNumber |
사람이 읽을 수 있는 국제 형식의 장소 전화번호입니다. |
formattedAddress |
이 장소에 대한 사람이 읽을 수 있는 전체 주소입니다. |
shortFormattedAddress |
사람이 읽을 수 있는 이 장소의 짧은 주소입니다. |
addressComponents[] |
각 지역 수준에 반복되는 구성요소 addressComponents[] 배열에 대한 다음 사항을 참고하세요. - 주소 구성요소의 배열에는 formattedAddress보다 더 많은 구성요소가 포함될 수 있습니다. - 배열에 formattedAddress에 포함된 항목을 제외하고 주소가 포함된 모든 정치적 항목을 포함하는 것은 아닙니다. 특정 주소가 포함된 모든 정치적 독립체를 검색하려면 역 지오코딩을 사용하여 주소의 위도/경도를 매개변수로 요청에 전달해야 합니다. - 응답 형식이 요청 간에 동일하게 유지되지 않을 수 있습니다. 특히 addressComponent의 수는 요청된 주소에 따라 다르며 동일한 주소에 대해 시간이 지남에 따라 변경될 수 있습니다. 배열에서 구성요소의 위치가 변경될 수 있습니다. 구성요소의 유형이 변경될 수 있습니다. 특정 구성요소가 이후 응답에서 누락될 수 있습니다. |
plusCode |
장소 위치 위도/경도의 플러스 코드입니다. |
location |
이 장소의 위치입니다. |
viewport |
평균 크기의 지도에 장소를 표시하는 데 적합한 뷰포트입니다. |
rating |
이 장소에 대한 사용자 리뷰를 기반으로 한 평점은 1.0~5.0입니다. |
googleMapsUri |
이 장소에 대한 추가 정보를 제공하는 URL입니다. |
websiteUri |
이 장소의 신뢰할 수 있는 웹사이트입니다(예: 업체 홈페이지). 체인점 (예: IKEA 매장)에 속한 장소의 경우 일반적으로 전체 체인점이 아닌 개별 매장의 웹사이트입니다. |
reviews[] |
이 장소에 대한 리뷰 목록으로, 관련순으로 정렬됩니다. 최대 5개의 리뷰가 반환될 수 있습니다. |
regularOpeningHours |
정규 영업시간입니다. |
photos[] |
이 장소의 사진에 대한 정보 (참조 포함)입니다. 최대 10장의 사진을 반환할 수 있습니다. |
adrFormatAddress |
adr microformat으로 된 장소의 주소: http://microformats.org/wiki/adr. |
businessStatus |
장소의 비즈니스 상태입니다. |
priceLevel |
장소의 가격 수준입니다. |
attributions[] |
이 결과와 함께 표시되어야 하는 데이터 제공자 집합입니다. |
iconMaskBaseUri |
아이콘 마스크의 잘린 URL입니다. 사용자는 끝에 유형 접미사를 추가하여 다양한 아이콘 유형에 액세스할 수 있습니다 (예: '.svg' 또는 '.png'). |
iconBackgroundColor |
16진수 형식 icon_mask의 배경 색상입니다(예: #909CE1). |
currentOpeningHours |
앞으로 7일간의 운영 시간입니다 (오늘 포함). 기간은 요청 날짜의 자정에 시작되어 6일 후 오후 11시 59분에 종료됩니다. 이 입력란에는 전체 영업시간의 specialDays 하위 필드가 포함되며 영업시간이 예외적인 날짜에 대해 설정됩니다. |
currentSecondaryOpeningHours[] |
비즈니스의 보조 영업시간에 대한 정보를 비롯하여 다음 7일 동안의 항목의 배열을 포함합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점의 경우 드라이브스루 시간 또는 배달 시간을 보조 영업시간으로 지정할 수 있습니다. 이 필드는 장소 유형에 따라 사전 정의된 영업시간 유형 (예: DRIVE_THROUGH, PICKUP, TAKEOUT) 목록에서 가져온 유형 하위 필드를 채웁니다. 이 입력란에는 전체 영업시간의 specialDays 하위 필드가 포함되며 영업시간이 예외적인 날짜에 대해 설정됩니다. |
regularSecondaryOpeningHours[] |
비즈니스의 정규 영업시간에 대한 항목의 배열을 포함합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점의 경우 드라이브스루 시간 또는 배달 시간을 보조 영업시간으로 지정할 수 있습니다. 이 필드는 장소 유형에 따라 사전 정의된 영업시간 유형 (예: DRIVE_THROUGH, PICKUP, TAKEOUT) 목록에서 가져온 유형 하위 필드를 채웁니다. |
editorialSummary |
장소에 대한 요약을 포함합니다. 요약은 텍스트 개요로 구성되며 해당하는 경우 관련 언어 코드도 포함합니다. 요약 텍스트는 있는 그대로 표시되어야 하며 수정하거나 변경할 수 없습니다. |
paymentOptions |
장소에서 사용할 수 있는 결제 옵션입니다. 결제 옵션 데이터를 사용할 수 없는 경우 결제 옵션 필드가 설정 해제됩니다. |
parkingOptions |
장소에서 제공하는 주차 옵션입니다. |
subDestinations[] |
장소와 관련된 하위 목적지 목록입니다. |
fuelOptions |
주유소의 연료 옵션에 관한 최신 정보입니다. 이 정보는 정기적으로 업데이트됩니다. |
evChargeOptions |
EV 충전 옵션 정보 |
generativeSummary |
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. 장소에 대한 AI 생성 요약입니다. |
areaSummary |
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. 장소가 위치한 지역에 대한 AI 생성 요약입니다. |
utcOffsetMinutes |
현재 이 장소의 시간대가 UTC에서 차이 나는 시간(분)입니다. 분 단위로 표현되어 1시간의 분수로 오프셋되는 시간대를 지원합니다(예: X시간 15분). |
userRatingCount |
이 장소에 대한 총 리뷰 수 (텍스트 유무와 관계없음)입니다. |
takeout |
비즈니스에서 테이크아웃을 지원하는지 여부를 지정합니다. |
delivery |
비즈니스에서 배송을 지원하는지 여부를 지정합니다. |
dineIn |
비즈니스에서 실내 또는 실외 좌석 옵션을 지원하는지 여부를 지정합니다. |
curbsidePickup |
비즈니스에서 매장 밖 수령을 지원하는지 여부를 지정합니다. |
reservable |
장소에서 예약을 지원하는지 여부를 지정합니다. |
servesBreakfast |
장소에서 아침 식사를 제공하는지 지정합니다. |
servesLunch |
장소에서 점심 식사를 제공하는지 지정합니다. |
servesDinner |
저녁 식사 제공 여부를 지정합니다. |
servesBeer |
장소에서 맥주를 제공하는지 여부를 지정합니다. |
servesWine |
장소에서 와인을 제공하는지 명시합니다. |
servesBrunch |
장소에서 브런치를 제공하는지 지정합니다. |
servesVegetarianFood |
채식 요리를 제공하는지 여부를 지정합니다. |
outdoorSeating |
야외 좌석이 마련된 장소입니다. |
liveMusic |
라이브 음악을 즐길 수 있는 장소입니다. |
menuForChildren |
어린이 메뉴가 있는 장소입니다. |
servesCocktails |
칵테일을 제공합니다. |
servesDessert |
디저트를 판매합니다. |
servesCoffee |
커피숍에서 커피를 즐길 수 있습니다. |
goodForChildren |
아이들에게 좋은 장소입니다. |
allowsDogs |
반려견 동반이 가능한 장소입니다. |
restroom |
화장실이 있는 장소입니다. |
goodForGroups |
단체가 수용 가능한 장소입니다. |
goodForWatchingSports |
스포츠 경기를 관람하기에 적합한 장소입니다. |
accessibilityOptions |
장소에서 제공하는 접근성 옵션에 대한 정보입니다. |
LocalizedText
특정 언어로 된 텍스트의 현지화된 변형입니다.
JSON 표현 |
---|
{ "text": string, "languageCode": string } |
입력란 | |
---|---|
text |
아래의 |
languageCode |
텍스트의 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 |
주소 구성요소의 전체 텍스트 설명 또는 이름입니다. 예를 들어 오스트레일리아에 대한 주소 구성요소의 경우 long_name이 'Australia'일 수 있습니다. |
shortText |
주소 구성요소의 텍스트 약칭입니다(사용 가능한 경우). 예를 들어 오스트레일리아 국가의 주소 구성요소에는 'AU'라는 short_name이 포함될 수 있습니다. |
types[] |
주소 구성요소의 유형을 나타내는 배열입니다. |
languageCode |
이 구성요소의 형식을 지정하는 데 사용된 언어(CLDR 표기법)입니다. |
PlusCode
플러스 코드 (http://plus.codes)는 두 가지 형식으로 위치 참조입니다. 하나는 14mx14m (1/8000의 1/8000) 또는 작은 직사각형을 정의하는 글로벌 코드이고 다른 하나는 복합 코드로 접두어를 참조 위치로 대체합니다.
JSON 표현 |
---|
{ "globalCode": string, "compoundCode": string } |
입력란 | |
---|---|
globalCode |
장소의 전역(전체) 코드(예: '9FWM33GV+HQ')로, 1/8000x1/8000도 영역(약 14x14미터)을 나타냅니다. |
compoundCode |
장소의 복합 코드(예: '33GV+HQ, Ramberg, Korean')입니다. 전역 코드의 접미사가 포함되며 접두사를 참조 항목의 형식이 지정된 이름으로 대체합니다. |
LatLng
위도/경도 쌍을 나타내는 객체로 위도(도)와 경도(도)를 나타내는 double의 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.
JSON 표현 |
---|
{ "latitude": number, "longitude": number } |
입력란 | |
---|---|
latitude |
위도입니다. 범위는 [-90.0, +90.0]입니다. |
longitude |
경도입니다. 범위는 [-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 ( |
입력란 | |
---|---|
low |
필수 항목입니다. 표시 영역의 최저점입니다. |
high |
필수 항목입니다. 표시 영역의 최고점입니다. |
복습
장소의 리뷰에 대한 정보입니다.
JSON 표현 |
---|
{ "name": string, "relativePublishTimeDescription": string, "text": { object ( |
입력란 | |
---|---|
name |
이 장소 리뷰를 다시 검색하는 데 사용할 수 있는 이 장소 리뷰를 나타내는 참조입니다 (API '리소스' 이름: |
relativePublishTimeDescription |
형식이 지정된 최근 시간의 문자열로, 현재 시간을 기준으로 한 리뷰 시간을 언어 및 국가에 적합한 형식으로 표현합니다. |
text |
리뷰의 현지화된 텍스트입니다. |
originalText |
원래 언어로 된 리뷰 텍스트입니다. |
rating |
1.0과 5.0 사이의 숫자이며 별 수라고도 합니다. |
authorAttribution |
이 리뷰의 작성자입니다. |
publishTime |
리뷰의 타임스탬프입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
AuthorAttribution
JSON 표현 |
---|
{ "displayName": string, "uri": string, "photoUri": string } |
입력란 | |
---|---|
displayName |
|
uri |
|
photoUri |
|
OpeningHours
장소의 영업시간에 대한 정보입니다.
JSON 표현 |
---|
{ "periods": [ { object ( |
입력란 | |
---|---|
periods[] |
이 장소가 주중에 영업하는 기간입니다. 기간은 장소 현지 시간대의 일요일부터 시작하여 시간 순서대로 표시됩니다. 비어 있지만 없는 값은 없는 장소 (예: 리노베이션을 위해 임시 휴업)를 나타냅니다. |
weekdayDescriptions[] |
이 장소의 영업시간을 설명하는 현지화된 문자열로, 각 요일에 해당하는 문자열입니다. 시간을 알 수 없거나 현지화된 텍스트로 변환할 수 없는 경우 비어 있습니다. 예: '일: 18:00~06:00' |
secondaryHoursType |
보조 영업시간 유형을 식별하는 데 사용되는 유형 문자열입니다. |
specialDays[] |
반환된 영업시간에 해당하는 특별한 날에 대해 구조화된 정보입니다. 특별한 날은 장소의 영업시간에 영향을 줄 수 있는 날짜(예: 크리스마스)입니다. 예외적인 시간이 있는 경우 currentOpeningHours 및 currentSecondaryOpeningHours에 대해 설정합니다. |
openNow |
이 장소가 현재 영업 중인가요? 영업시간에 대한 시간 또는 시간대 데이터가 없는 경우 항상 표시됩니다. |
기간
장소가 openNow 상태로 남아 있는 기간입니다.
JSON 표현 |
---|
{ "open": { object ( |
입력란 | |
---|---|
open |
장소가 영업을 시작하기 시작하는 시간입니다. |
close |
장소의 영업이 종료되기 시작하는 시간입니다. |
지점
상태 변경 지점
JSON 표현 |
---|
{
"date": {
object ( |
입력란 | |
---|---|
date |
장소의 현지 시간대로 된 날짜입니다. |
truncated |
이 엔드포인트가 잘렸는지 여부입니다. 실제 시간과 그 사이의 시간 반환 시간이 이렇게 하면 요청 당일 자정으로부터 최대 24 * 7시간이 반환됩니다. |
day |
요일로, 0~6 범위의 정수로 표시됩니다. 0은 일요일, 1은 월요일 등입니다. |
hour |
시간을 2자리로 표시합니다. 범위는 00~23입니다. |
minute |
분을 2자리로 표시합니다. 범위는 00~59입니다. |
날짜
생일과 같이 캘린더 날짜 전체 또는 일부를 나타냅니다. 하루 중 시간과 시간대가 다른 곳에서 지정되어 있거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 0년을 사용한 월과 일 (예: 기념일)
- 0개월과 0일로 구성된 1년입니다.
- 연도와 월을 0일로 지정 (예: 신용카드 만료일)
관련 유형:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON 표현 |
---|
{ "year": integer, "month": integer, "day": integer } |
입력란 | |
---|---|
year |
날짜의 연도입니다. 1에서 9999 사이의 값이어야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다. |
month |
월입니다. 1~12 사이의 값이어야 합니다. 월과 일 없이 연도를 지정하려면 0이어야 합니다. |
day |
일(일)입니다. 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 |
특별한 날의 날짜입니다. |
사진
장소 사진에 대한 정보입니다.
JSON 표현 |
---|
{
"name": string,
"widthPx": integer,
"heightPx": integer,
"authorAttributions": [
{
object ( |
입력란 | |
---|---|
name |
식별자. 이 장소 사진을 다시 검색하는 데 사용할 수 있는 이 장소 사진을 나타내는 참조입니다 (API '리소스' 이름: |
widthPx |
사용 가능한 최대 너비(픽셀)입니다. |
heightPx |
사용 가능한 최대 높이(픽셀)입니다. |
authorAttributions[] |
이 사진의 작성자입니다. |
BusinessStatus
장소의 비즈니스 상태입니다.
열거형 | |
---|---|
BUSINESS_STATUS_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
OPERATIONAL |
시설은 운영 중이며 지금 영업 중이 아닐 수도 있습니다. |
CLOSED_TEMPORARILY |
시설이 임시 휴업 상태입니다. |
CLOSED_PERMANENTLY |
시설이 폐업했습니다. |
PriceLevel
장소의 가격 수준입니다.
열거형 | |
---|---|
PRICE_LEVEL_UNSPECIFIED |
장소 가격 수준이 지정되지 않았거나 알 수 없습니다. |
PRICE_LEVEL_FREE |
Place는 무료 서비스를 제공합니다. |
PRICE_LEVEL_INEXPENSIVE |
장소는 저렴한 서비스를 제공합니다. |
PRICE_LEVEL_MODERATE |
합리적인 가격의 서비스를 제공합니다. |
PRICE_LEVEL_EXPENSIVE |
장소는 비싼 서비스를 제공합니다. |
PRICE_LEVEL_VERY_EXPENSIVE |
장소는 매우 비싼 서비스를 제공합니다. |
기여 분석
이 장소의 데이터 제공자에 관한 정보입니다.
JSON 표현 |
---|
{ "provider": string, "providerUri": string } |
입력란 | |
---|---|
provider |
장소의 데이터 제공자 이름입니다. |
providerUri |
장소의 데이터 제공자에 대한 URI입니다. |
PaymentOptions
장소에서 사용할 수 있는 결제 옵션입니다.
JSON 표현 |
---|
{ "acceptsCreditCards": boolean, "acceptsDebitCards": boolean, "acceptsCashOnly": boolean, "acceptsNfc": boolean } |
입력란 | |
---|---|
acceptsCreditCards |
장소에서 신용카드로 결제할 수 있습니다. |
acceptsDebitCards |
장소에서 체크카드를 사용할 수 있습니다. |
acceptsCashOnly |
장소에서는 현금으로만 결제 가능합니다. 이 속성이 있는 장소에서는 다른 결제 수단을 계속 허용할 수 있습니다. |
acceptsNfc |
NFC 결제가 가능한 장소입니다. |
ParkingOptions
장소의 주차 옵션에 대한 정보입니다. 주차장은 동시에 두 개 이상의 옵션을 지원할 수 있습니다.
JSON 표현 |
---|
{ "freeParkingLot": boolean, "paidParkingLot": boolean, "freeStreetParking": boolean, "paidStreetParking": boolean, "valetParking": boolean, "freeGarageParking": boolean, "paidGarageParking": boolean } |
입력란 | |
---|---|
freeParkingLot |
무료 주차장이 있습니다. |
paidParkingLot |
유료 주차장이 있습니다. |
freeStreetParking |
노상 주차는 무료입니다. |
paidStreetParking |
유료 노상 주차가 가능합니다. |
valetParking |
발레파킹 서비스가 제공됩니다. |
freeGarageParking |
주차장을 무료로 이용할 수 있습니다. |
paidGarageParking |
주차장은 유료로 이용할 수 있습니다. |
SubDestination
장소와 관련된 하위 대상의 장소 리소스 이름 및 ID입니다. 예를 들어 터미널마다 공항의 목적지가 다릅니다.
JSON 표현 |
---|
{ "name": string, "id": string } |
입력란 | |
---|---|
name |
하위 대상의 리소스 이름입니다. |
id |
하위 목적지의 장소 ID입니다. |
AccessibilityOptions
장소에서 제공하는 접근성 옵션에 대한 정보입니다.
JSON 표현 |
---|
{ "wheelchairAccessibleParking": boolean, "wheelchairAccessibleEntrance": boolean, "wheelchairAccessibleRestroom": boolean, "wheelchairAccessibleSeating": boolean } |
입력란 | |
---|---|
wheelchairAccessibleParking |
휠체어 이용가능 주차장이 있습니다. |
wheelchairAccessibleEntrance |
휠체어 이용가능 입구가 있습니다. |
wheelchairAccessibleRestroom |
휠체어 이용가능 화장실이 있습니다. |
wheelchairAccessibleSeating |
휠체어 이용가능 좌석이 마련되어 있습니다. |
FuelOptions
주유소의 연료 옵션에 관한 최신 정보입니다. 이 정보는 정기적으로 업데이트됩니다.
JSON 표현 |
---|
{
"fuelPrices": [
{
object ( |
입력란 | |
---|---|
fuelPrices[] |
이 충전소의 각 연료 유형에 대해 알려진 마지막 연료 가격입니다. 이 충전소의 연료 유형당 항목이 하나씩 있습니다. 순서가 중요하지 않습니다. |
FuelPrice
지정된 유형의 연료 가격 정보입니다.
JSON 표현 |
---|
{ "type": enum ( |
입력란 | |
---|---|
type |
연료 유형입니다. |
price |
연료 가격입니다. |
updateTime |
연료 가격이 마지막으로 업데이트된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
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 |
트럭 디젤. |
돈
해당 통화 유형의 금액을 나타냅니다.
JSON 표현 |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
입력란 | |
---|---|
currencyCode |
ISO 4217에 정의된 3자리 통화 코드입니다. |
units |
금액의 전체 단위입니다. 예를 들어 |
nanos |
금액의 나노 (10^-9) 단위 수입니다. 값은 -999,999,999 ~ +999,999,999(포함) 사이여야 합니다. |
EVChargeOptions
해당 장소에서 호스팅되는 전기자동차 충전소에 대한 정보입니다. 용어는 https://afdc.energy.gov/fuels/electricity_infrastructure.html을 따릅니다. 포트 1개로 한 번에 차량 1대를 충전할 수 있습니다. 포트 하나에 하나 이상의 커넥터가 있습니다. 스테이션 하나에는 하나 이상의 포트가 있습니다.
JSON 표현 |
---|
{
"connectorCount": integer,
"connectorAggregation": [
{
object ( |
입력란 | |
---|---|
connectorCount |
이 역의 커넥터 수입니다. 그러나 일부 포트에는 여러 개의 커넥터가 있을 수 있지만 한 번에 하나의 자동차만 충전할 수 있으므로 (예:) 커넥터 수는 동시에 충전할 수 있는 총 자동차 수보다 많을 수 있습니다. |
connectorAggregation[] |
유형이 동일하고 충전 속도가 동일한 커넥터가 포함된 EV 충전 커넥터 집계 목록입니다. |
ConnectorAggregation
[유형, maxChargeRateKw]별로 그룹화된 전기자동차 충전 정보입니다. 유형과 최대 충전 속도가 동일한 커넥터의 EV 충전 집계를 키워드 단위로 표시합니다.
JSON 표현 |
---|
{
"type": enum ( |
입력란 | |
---|---|
type |
이 집계의 커넥터 유형입니다. |
maxChargeRateKw |
집계에 포함된 각 커넥터의 정적 최대 충전 속도(kw)입니다. |
count |
이 집계의 커넥터 수입니다. |
availabilityLastUpdateTime |
이 집계의 커넥터 가용성 정보가 마지막으로 업데이트된 시점의 타임스탬프입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
availableCount |
이 집계에서 현재 사용 가능한 커넥터 수입니다. |
outOfServiceCount |
이 집계에서 현재 서비스가 중지된 커넥터 수입니다. |
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 기준입니다. Type-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). 이 값은 실제 커넥터 유형을 나타내지는 않으며, 테슬라 소유 충전소에서 테슬라 브랜드 차량을 충전하는 기능을 나타냅니다. |
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 ( |
입력란 | |
---|---|
overview |
장소의 개요입니다. |
description |
장소에 대한 자세한 설명입니다. |
references |
요약 설명을 생성하는 데 사용되는 참조입니다. |
참조
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.
생성형 콘텐츠와 관련된 참조입니다.
JSON 표현 |
---|
{
"reviews": [
{
object ( |
입력란 | |
---|---|
reviews[] |
참조로 사용되는 리뷰입니다. |
places[] |
참조된 장소의 리소스 이름 목록입니다. 이 이름은 장소 리소스 이름을 허용하는 다른 API에서 사용할 수 있습니다. |
AreaSummary
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요.
장소가 위치한 지역에 대한 AI 생성 요약입니다.
JSON 표현 |
---|
{
"contentBlocks": [
{
object ( |
입력란 | |
---|---|
contentBlocks[] |
영역 요약을 구성하는 콘텐츠 블록입니다. 각 블록에는 해당 지역에 대한 별도의 주제가 있습니다. |
ContentBlock
개별적으로 게재할 수 있는 콘텐츠 블록입니다.
JSON 표현 |
---|
{ "topic": string, "content": { object ( |
입력란 | |
---|---|
topic |
콘텐츠의 주제입니다(예: '개요' 또는 '음식점'). |
content |
주제와 관련된 콘텐츠입니다. |
references |
실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. 이 콘텐츠 블록과 관련된 참조입니다. |
메서드 |
|
---|---|
|
지정된 입력에 대한 예측을 반환합니다. |
|
리소스 이름(places/{place_id} 형식의 문자열)을 기반으로 장소의 세부정보를 가져옵니다. |
|
위치 주변의 장소를 검색합니다. |
|
텍스트 쿼리 기반 장소 검색 |