Package google.maps.places.v1

색인

장소

Places API의 서비스 정의입니다. 참고: 자동 완성 요청을 제외한 모든 요청에는 요청 프로토(all/*, 가정되지 않음) 외부에 설정된 필드 마스크가 필요합니다. 필드 마스크는 HTTP 헤더 X-Goog-FieldMask를 통해 설정할 수 있습니다. https://developers.google.com/maps/documentation/places/web-service/choose-fields를 참고하세요.

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

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

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

사진 참조 문자열이 포함된 사진 미디어를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

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

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

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

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

텍스트 쿼리 기반 장소 검색

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

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

필드
landmarks[]

Landmark

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

Area

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

지역

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

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

필드
name

string

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

string

지역의 장소 ID입니다.
display_name

LocalizedText

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

Containment

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

격리

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

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

명소

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

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

필드
name

string

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

string

명소의 장소 ID입니다.
display_name

LocalizedText

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

string

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

SpatialRelationship

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

float

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

float

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

SpatialRelationship

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

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

AuthorAttribution

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

필드
display_name

string

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

string

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

string

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

AutocompletePlacesRequest

AutocompletePlaces의 요청 proto입니다.

필드
input

string

필수입니다. 검색할 텍스트 문자열입니다.
location_bias

LocationBias

선택사항입니다. 지정된 위치에 편중된 결과

location_bias 또는 location_restriction 중 최대 하나만 설정해야 합니다. 둘 다 설정되지 않은 경우 결과가 IP 주소에 따라 편향됩니다. 즉, IP 주소가 부정확한 위치에 매핑되고 편향 신호로 사용됩니다.
location_restriction

LocationRestriction

선택사항입니다. 결과를 지정된 위치로 제한합니다.

location_bias 또는 location_restriction 중 최대 하나만 설정해야 합니다. 둘 다 설정되지 않은 경우 결과가 IP 주소에 따라 편향됩니다. 즉, IP 주소가 부정확한 위치에 매핑되고 편향 신호로 사용됩니다.
included_primary_types[]

string

선택사항입니다. 장소 유형 (https://developers.google.com/maps/documentation/places/web-service/place-types)에 기본 장소 유형 (예: 'restaurant' 또는 'gas_station')이 포함되어 있거나 (regions)만 포함되어 있거나 (cities)만 포함되어 있습니다. 장소는 기본 유형이 이 목록에 포함된 경우에만 반환됩니다. 값을 최대 5개까지 지정할 수 있습니다. 유형을 지정하지 않으면 모든 장소 유형이 반환됩니다.
included_region_codes[]

string

선택사항입니다. 최대 15개의 CLDR 2자리 지역 코드로 지정된 지정된 지역의 결과만 포함합니다. 빈 세트는 결과를 제한하지 않습니다. location_restriction와 included_region_codes가 모두 설정된 경우 결과는 교차 영역에 표시됩니다.
language_code

string

선택사항입니다. 결과를 반환할 언어입니다. 기본값은 en-US입니다. input에 사용된 언어가 language_code과 다르거나 반환된 장소에 현지 언어에서 language_code로의 번역이 없는 경우 결과가 혼합된 언어로 표시될 수 있습니다.
region_code

string

선택사항입니다. CLDR 2자리 지역 코드로 지정된 지역 코드입니다. 이는 주소 형식, 결과 순위에 영향을 미치며 반환되는 결과에 영향을 줄 수 있습니다. 이렇게 해도 결과가 지정된 지역으로 제한되지는 않습니다. 결과를 리전으로 제한하려면 region_code_restriction를 사용합니다.
origin

LatLng

선택사항입니다. 대상까지의 지오데시적 거리를 계산할 출발점입니다 (distance_meters로 반환됨). 이 값을 생략하면 지오데시적 거리가 반환되지 않습니다.
input_offset

int32

선택사항입니다. input의 커서 위치를 나타내는 0부터 시작하는 유니코드 문자 오프셋 input입니다. 커서 위치에 따라 반환되는 예측이 달라질 수 있습니다.

비어 있으면 기본값은 input 길이입니다.
include_query_predictions

bool

선택사항입니다. 이 값이 true이면 응답에 장소 및 검색어 예측이 모두 포함됩니다. 그렇지 않으면 응답은 장소 예상 검색어만 반환합니다.
session_token

string

선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. URL 및 파일 이름에 안전한 base64 문자열이어야 하며 길이는 최대 36자(영문 기준)여야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 장소를 선택하고 장소 세부정보 또는 주소 유효성 검사를 호출하면 종료됩니다. 세션마다 여러 개의 쿼리가 포함될 수 있으며 하나의 장소 세부정보 또는 주소 유효성 검사 요청이 뒤따릅니다. 세션 내 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 각 세션에 대해 새 토큰을 생성해야 합니다. session_token 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 세션에 대해 요금이 청구됩니다 (각 요청에 대해 별도로 요금이 청구됨).

다음 가이드라인이 권장됩니다.

  • 모든 Place Autocomplete 호출에 세션 토큰을 사용합니다.
  • 각 세션에 대해 새 토큰을 생성합니다. 버전 4 UUID를 사용하는 것이 좋습니다.
  • 세션 내의 모든 Place Autocomplete, Place Details, Address Validation 요청에 사용되는 사용자 인증 정보가 동일한 Cloud 콘솔 프로젝트에 속하는지 확인합니다.
  • 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 두 개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.
include_pure_service_area_businesses

bool

선택사항입니다. 이 필드가 true로 설정된 경우 순수 방문 서비스 업체를 포함합니다. 순수 방문 서비스 업체는 고객을 방문하거나 고객에게 직접 서비스를 제공하지만 비즈니스 주소지에서는 고객에게 서비스를 제공하지 않는 비즈니스입니다. 청소 서비스 또는 배관공 등의 비즈니스가 있습니다. 이러한 비즈니스는 Google 지도에 실제 주소나 위치가 없습니다. 장소에서는 이러한 비즈니스의 location, plus_code 및 기타 위치 관련 필드를 반환하지 않습니다.

LocationBias

검색할 지역입니다. 결과는 지정된 지역을 중심으로 편향될 수 있습니다.

필드

통합 필드 type.

type는 다음 중 하나여야 합니다.
rectangle

Viewport

북동쪽과 남서쪽 모서리로 정의된 뷰포트입니다.
circle

Circle

중심점과 반지름으로 정의된 원입니다.

LocationRestriction

검색할 지역입니다. 결과는 지정된 지역으로 제한됩니다.

필드

통합 필드 type.

type는 다음 중 하나여야 합니다.
rectangle

Viewport

북동쪽과 남서쪽 모서리로 정의된 뷰포트입니다.
circle

Circle

중심점과 반지름으로 정의된 원입니다.

AutocompletePlacesResponse

AutocompletePlaces의 응답 프로토입니다.

필드
suggestions[]

Suggestion

관련성의 내림차순으로 정렬된 추천 목록을 포함합니다.

추천

자동 완성 추천 결과

필드

통합 필드 kind.

kind는 다음 중 하나여야 합니다.
place_prediction

PlacePrediction

장소에 대한 예측입니다.
query_prediction

QueryPrediction

쿼리의 예측입니다.

FormattableText

장소 또는 검색어 예측을 나타내는 텍스트입니다. 텍스트는 그대로 사용하거나 서식을 지정할 수 있습니다.

필드
text

string

그대로 사용하거나 matches로 형식을 지정할 수 있는 텍스트입니다.
matches[]

StringRange

입력 요청이 text에서 일치한 위치를 식별하는 문자열 범위 목록입니다. 이 범위는 text의 특정 부분의 형식을 지정하는 데 사용할 수 있습니다. 문자열 일치 이외의 기준 (예: 맞춤법 수정 또는 음역)에 따라 일치가 결정된 경우 하위 문자열이 input과 정확하게 일치하지 않을 수 있습니다.

이 값은 text의 유니코드 문자 오프셋입니다. 범위는 오프셋 값이 증가하는 순서로 정렬됩니다.

PlacePrediction

Place Autocomplete 예상 검색어의 예측 결과입니다.

필드
place

string

추천 장소의 리소스 이름입니다. 이 이름은 장소 이름을 허용하는 다른 API에서 사용할 수 있습니다.
place_id

string

추천 장소의 고유 식별자입니다. 이 식별자는 장소 ID를 허용하는 다른 API에서 사용할 수 있습니다.
text

FormattableText

반환된 결과의 사람이 읽을 수 있는 이름을 포함합니다. 시설 결과의 경우 일반적으로 비즈니스 이름 및 주소입니다.

text는 단일 UI 요소를 표시하려는 개발자에게 권장됩니다. 서로 별개이지만 관련된 두 UI 요소를 표시하려는 개발자는 structured_format를 대신 사용하는 것이 좋습니다. 장소 예측을 나타내는 두 가지 방법입니다. 사용자는 structured_format를 text로 파싱하거나 그 반대로 파싱하려고 해서는 안 됩니다.

이 텍스트는 GetPlace에서 반환한 display_name와 다를 수 있습니다.

요청 input와 language_code가 다른 언어로 되어 있거나 장소에 현지 언어에서 language_code로의 번역이 없는 경우 혼합된 언어로 표시될 수 있습니다.
structured_format

StructuredFormat

장소 예측을 장소 이름이 포함된 기본 텍스트와 추가적인 구분 기능 (예: 도시 또는 지역)이 포함된 보조 텍스트로 분류합니다.

structured_format는 서로 관련이 있지만 별개의 두 UI 요소를 표시하려는 개발자에게 권장됩니다. 단일 UI 요소를 표시하려는 개발자는 text를 대신 사용하는 것이 좋습니다. 장소 예측을 나타내는 두 가지 방법입니다. 사용자는 structured_format를 text로 파싱하거나 그 반대로 파싱하려고 해서는 안 됩니다.
types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A 또는 표 B에서 이 장소에 적용되는 유형 목록입니다.

유형은 장소의 분류입니다. 유형이 공유되는 장소는 유사한 특성을 공유합니다.
distance_meters

int32

origin가 지정된 경우 origin에서 최단 거리의 길이(미터)입니다. 경로와 같은 특정 예측은 이 필드를 채우지 않을 수 있습니다.

QueryPrediction

쿼리 자동 완성 예상 검색어의 예측 결과입니다.

필드
text

FormattableText

예측된 텍스트입니다. 이 텍스트는 장소가 아니라 검색 엔드포인트 (예: 텍스트 검색)에서 사용할 수 있는 텍스트 검색어를 나타냅니다.

text는 단일 UI 요소를 표시하려는 개발자에게 권장됩니다. 서로 별개이지만 관련된 두 UI 요소를 표시하려는 개발자는 structured_format를 대신 사용하는 것이 좋습니다. 쿼리 예측을 나타내는 두 가지 방법입니다. 사용자는 structured_format를 text로 파싱하거나 그 반대로 파싱하려고 해서는 안 됩니다.

요청 input와 language_code가 다른 언어로 되어 있거나 검색어의 일부에 현지 언어에서 language_code로의 번역이 없는 경우 혼합된 언어일 수 있습니다.
structured_format

StructuredFormat

쿼리 예측을 쿼리가 포함된 기본 텍스트와 추가적인 구분 기능 (예: 도시 또는 지역)이 포함된 보조 텍스트로 분류합니다.

structured_format는 서로 관련이 있지만 별개의 두 UI 요소를 표시하려는 개발자에게 권장됩니다. 단일 UI 요소를 표시하려는 개발자는 text를 대신 사용하는 것이 좋습니다. 쿼리 예측을 나타내는 두 가지 방법입니다. 사용자는 structured_format를 text로 파싱하거나 그 반대로 파싱하려고 해서는 안 됩니다.

StringRange

지정된 텍스트 내에서 하위 문자열을 식별합니다.

필드
start_offset

int32

문자열의 첫 번째 유니코드 문자의 0 기반 오프셋입니다 (해당 값 포함).
end_offset

int32

마지막 유니코드 문자의 0부터 시작하는 오프셋입니다 (제외).

StructuredFormat

장소 또는 검색어 예측을 기본 텍스트와 보조 텍스트로 분류한 내용이 포함됩니다.

장소 예측의 경우 기본 텍스트에 장소의 구체적인 이름이 포함됩니다. 쿼리 예측의 경우 기본 텍스트에 쿼리가 포함됩니다.

보조 텍스트에는 장소를 더 정확하게 식별하거나 검색어를 세분화하기 위한 추가적인 구분 기능 (예: 도시 또는 지역)이 포함됩니다.

필드
main_text

FormattableText

장소 또는 검색어의 이름을 나타냅니다.
secondary_text

FormattableText

장소를 더 식별하거나 검색어를 세분화하기 위한 추가적인 구분 기능 (예: 도시 또는 지역)을 나타냅니다.

원

LatLng를 중심으로 하고 반경이 LatLng인 원

필드
center

LatLng

필수입니다. 위도 및 경도 중앙에 배치합니다.

위도 범위는 [-90.0, 90.0] 이내여야 합니다. 경도 범위는 [-180.0, 180.0] 이내여야 합니다.
radius

double

필수입니다. 반지름(단위: 미터) 반경은 [0.0, 50000.0] 이내여야 합니다.

ContentBlock

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

필드
topic

string

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

LocalizedText

주제와 관련된 콘텐츠
references

References

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

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

ContextualContent

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

장소 검색어와 관련된 콘텐츠입니다.

필드
reviews[]

Review

장소 검색어와 관련된 이 장소에 대한 리뷰 목록입니다.
photos[]

Photo

장소 검색어와 관련된 이 장소의 사진에 관한 정보 (참조 포함)입니다.
justifications[]

Justification

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

장소에 대한 근거

근거

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

장소에 대한 근거 근거는 장소가 최종 사용자의 관심을 끌 수 있는 이유에 대한 질문에 답변합니다.

필드

통합 필드 justification.

justification는 다음 중 하나여야 합니다.
review_justification

ReviewJustification

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

BusinessAvailabilityAttributesJustification

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

BusinessAvailabilityAttributesJustification

실험용: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. BusinessAvailabilityAttributes의 근거입니다. 비즈니스에 있는 최종 사용자의 관심을 끌 수 있는 일부 속성을 보여줍니다.

필드
takeout

bool

테이크아웃을 제공하는 장소인 경우
delivery

bool

장소에서 배달 서비스를 제공하는 경우
dine_in

bool

매장 내 식사가 가능한 경우

ReviewJustification

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

사용자 리뷰 사유 최종 사용자의 관심을 끌 만한 사용자 리뷰 섹션을 강조 표시합니다. 예를 들어 검색어가 'firewood pizza'인 경우 리뷰 근거에서 검색어와 관련된 텍스트가 강조 표시됩니다.

필드
highlighted_text

HighlightedText
review

Review

강조 표시된 텍스트가 생성된 리뷰입니다.

HighlightedText

정렬로 강조 표시된 텍스트입니다. 리뷰 자체의 하위 집합입니다. 강조 표시할 정확한 단어는 HighlightedTextRange로 표시됩니다. 텍스트에 강조 표시된 단어가 여러 개 있을 수 있습니다.

필드
text

string
highlighted_text_ranges[]

HighlightedTextRange

강조 표시된 텍스트의 범위 목록입니다.

HighlightedTextRange

강조 표시된 텍스트의 범위입니다.

필드
start_index

int32
end_index

int32

EVChargeOptions

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

필드
connector_count

int32

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

ConnectorAggregation

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

ConnectorAggregation

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

필드
type

EVConnectorType

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

double

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

int32

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

Timestamp

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

int32

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

int32

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

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 지정되지 않은 전원 콘센트
EV_CONNECTOR_TYPE_NACS SAE J3400으로 표준화된 북미 충전 시스템 (NACS)

FuelOptions

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

필드
fuel_prices[]

FuelPrice

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

FuelPrice

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

필드
type

FuelType

연료 유형입니다.
price

Money

연료 가격입니다.
update_time

Timestamp

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

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 트럭 디젤

GetPhotoMediaRequest

사진 리소스 이름을 사용하여 장소의 사진을 가져오는 요청입니다.

필드
name

string

필수입니다. 사진 미디어의 리소스 이름으로, places/{place_id}/photos/{photo_reference}/media 형식입니다.

장소 객체의 photos.name 필드에 반환된 사진의 리소스 이름은 places/{place_id}/photos/{photo_reference} 형식입니다. 사진 미디어 리소스 이름을 가져오려면 사진 리소스 끝에 /media를 추가해야 합니다.
max_width_px

int32

선택사항입니다. 원하는 최대 이미지 너비(단위: 픽셀)를 지정합니다. 이미지가 지정된 값보다 작으면 원본 이미지가 반환됩니다. 이미지의 한 측정기준이 더 큰 경우 두 측정기준 중 더 작은 값에 맞게 크기가 조정되며 원래 가로세로 비율로 제한됩니다. max_height_px 및 max_width_px 속성은 모두 1~4800 사이의 정수를 허용합니다(양 끝값 포함). 값이 허용된 범위에 해당하지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

max_height_px 또는 max_width_px 중 하나 이상을 지정해야 합니다. max_height_px 또는 max_width_px가 지정되지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
max_height_px

int32

선택사항입니다. 원하는 최대 이미지 높이(픽셀)를 지정합니다. 이미지가 지정된 값보다 작으면 원본 이미지가 반환됩니다. 이미지의 한 측정기준이 더 큰 경우 두 측정기준 중 더 작은 값에 맞게 크기가 조정되며 원래 가로세로 비율로 제한됩니다. max_height_px 및 max_width_px 속성은 모두 1~4800 사이의 정수를 허용합니다(양 끝값 포함). 값이 허용된 범위에 해당하지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

max_height_px 또는 max_width_px 중 하나 이상을 지정해야 합니다. max_height_px 또는 max_width_px가 지정되지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
skip_http_redirect

bool

선택사항입니다. 이 속성을 설정하면 기본 HTTP 리디렉션 동작을 건너뛰고 텍스트 형식 (예: HTTP 사용 사례의 경우 JSON 형식) 응답을 렌더링합니다. 설정하지 않으면 HTTP 리디렉션이 실행되어 호출을 이미지 미디어로 리디렉션합니다. HTTP가 아닌 요청의 경우 이 옵션은 무시됩니다.

GetPlaceRequest

places/{place_id} 형식의 문자열인 리소스 이름을 기반으로 장소 가져오기 요청

필드
name

string

필수입니다. 장소의 리소스 이름으로, places/{place_id} 형식입니다.
language_code

string

선택사항입니다. 장소 세부정보는 기본 언어(있는 경우)로 표시됩니다.

현재 지원되는 언어 목록: https://developers.google.com/maps/faq#languagesupport
region_code

string

선택사항입니다. 요청이 발생한 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다(해당하는 경우). 이 매개변수는 관련 법규에 따라 결과에 영향을 미칠 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참고하세요.

현재 3자리 지역 코드는 지원되지 않습니다.
session_token

string

선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. URL 및 파일 이름에 안전한 base64 문자열이어야 하며 길이는 최대 36자(영문 기준)여야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 장소를 선택하고 장소 세부정보 또는 주소 유효성 검사를 호출하면 종료됩니다. 세션마다 여러 개의 쿼리가 포함될 수 있으며 하나의 장소 세부정보 또는 주소 유효성 검사 요청이 뒤따릅니다. 세션 내 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 각 세션에 대해 새 토큰을 생성해야 합니다. session_token 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 세션에 대해 요금이 청구됩니다 (각 요청에 대해 별도로 요금이 청구됨).

다음 가이드라인이 권장됩니다.

  • 모든 Place Autocomplete 호출에 세션 토큰을 사용합니다.
  • 각 세션에 대해 새 토큰을 생성합니다. 버전 4 UUID를 사용하는 것이 좋습니다.
  • 세션 내의 모든 Place Autocomplete, Place Details, Address Validation 요청에 사용되는 사용자 인증 정보가 동일한 Cloud 콘솔 프로젝트에 속하는지 확인합니다.
  • 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 두 개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.

사진

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

필드
name

string

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

int32

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

int32

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

AuthorAttribution

이 사진의 저자입니다.
flag_content_uri

string

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

string

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

PhotoMedia

Places API의 사진 미디어입니다.

필드
name

string

사진 미디어의 리소스 이름으로, places/{place_id}/photos/{photo_reference}/media 형식입니다.
photo_uri

string

사진을 렌더링하는 데 사용할 수 있는 짧은 기간의 URI입니다.

장소

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

필드
name

string

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

string

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

LocalizedText

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

string

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

string

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

LocalizedText

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

string

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

string

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

string

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

string

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

AddressComponent

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

PlusCode

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

LatLng

이 장소의 위치입니다.
viewport

Viewport

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

double

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

string

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

string

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

Review

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

OpeningHours

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

TimeZone

IANA 시간대 데이터베이스의 시간대입니다. 예: 'America/New_York'
photos[]

Photo

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

string

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

BusinessStatus

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

PriceLevel

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

Attribution

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

string

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

string

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

OpeningHours

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

OpeningHours

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

OpeningHours

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

LocalizedText

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

PaymentOptions

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

ParkingOptions

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

SubDestination

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

FuelOptions

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

EVChargeOptions

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

GenerativeSummary

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

장소에 대한 AI 생성 요약
area_summary

AreaSummary

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

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

ContainingPlace

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

AddressDescriptor

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

PriceRange

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

int32

이 장소의 시간대가 현재 UTC와의 오프셋(분)입니다. 시간의 일부로 오프셋된 시간대(예: X시간 15분)를 지원하기 위해 분 단위로 표시됩니다.
user_rating_count

int32

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

AccessibilityOptions

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

bool

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

AccessibilityOptions

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

필드
wheelchair_accessible_parking

bool

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

bool

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

bool

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

bool

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

AddressComponent

형식이 지정된 주소를 구성하는 구조화된 구성요소(이 정보가 제공되는 경우)입니다.

필드
long_text

string

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

string

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

string

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

string

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

AreaSummary

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

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

필드
content_blocks[]

ContentBlock

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

string

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

기여 분석

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

필드
provider

string

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

string

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

BusinessStatus

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

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

ContainingPlace

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

필드
name

string

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

string

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

GenerativeSummary

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

장소에 대한 AI 생성 요약

필드
overview

LocalizedText

장소의 개요입니다.
overview_flag_content_uri

string

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

LocalizedText

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

string

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

References

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

OpeningHours

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

필드
periods[]

Period

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

string

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

SecondaryHoursType

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

SpecialDay

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

Timestamp

현재 영업 시간이 시작되는 다음 시간으로 최대 7일 후까지 설정할 수 있습니다. 이 필드는 요청을 게재할 때 영업 시간이 활성화되지 않은 경우에만 채워집니다.
next_close_time

Timestamp

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

bool

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

기간

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

필드
open

Point

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

Point

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

점

상태 변경 지점

필드
date

Date

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

bool

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

int32

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

int32

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

int32

분 범위는 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

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

필드
date

Date

특별한 날의 날짜입니다.

ParkingOptions

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

필드
free_parking_lot

bool

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

bool

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

bool

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

bool

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

bool

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

bool

무료로 이용 가능한 주차장이 있습니다.
paid_garage_parking

bool

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

PaymentOptions

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

필드
accepts_credit_cards

bool

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

bool

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

bool

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

bool

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

PlusCode

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

필드
global_code

string

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

string

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

SubDestination

하위 대상은 기본 장소와 연결된 특정 장소입니다. 공항, 국립공원, 대학, 경기장과 같이 크거나 복잡한 장소를 검색하는 사용자에게 더 구체적인 도착지를 제공합니다. 예를 들어 공항의 하위 도착지에 연결된 터미널과 주차장이 포함될 수 있습니다. 하위 대상은 장소 ID 및 장소 리소스 이름을 반환합니다. 이 정보는 후속 장소 세부정보 (신규) 요청에서 하위 대상의 표시 이름 및 위치를 비롯한 더 풍부한 세부정보를 가져오는 데 사용할 수 있습니다.

필드
name

string

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

string

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

폴리라인

경로 폴리라인 문자열로 전달할 수 있고 최소한의 손실이 있는 압축을 포함하는 인코딩된 다중선만 지원합니다. Routes API 기본 출력입니다.

필드
통합 필드 polyline_type. 폴리라인 유형을 캡슐화합니다. Routes API 출력은 기본적으로 encoded_polyline입니다. polyline_type은 다음 중 하나일 수 있습니다.
encoded_polyline

string

Routes API에서 기본적으로 반환하는 인코딩된 폴리라인입니다. 인코더 및 디코더 도구를 참고하세요.

PriceLevel

장소의 가격 수준입니다.

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

PriceRange

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

필드
start_price

Money

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

Money

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

참조

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

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

필드
reviews[]

Review

참고용 리뷰
places[]

string

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

검토

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

필드
name

string

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

string

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

LocalizedText

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

LocalizedText

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

double

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

AuthorAttribution

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

Timestamp

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

string

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

string

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

RouteModifiers

경로를 계산할 때 충족해야 하는 선택적 조건 집합을 캡슐화합니다.

필드
avoid_tolls

bool

선택사항입니다. true로 설정하면 합리적인 경우 유료 도로를 피하고 유료 도로가 포함되지 않은 경로를 우선합니다. DRIVE 및 TWO_WHEELER TravelMode에만 적용됩니다.
avoid_highways

bool

선택사항입니다. true로 설정하면 합리적인 경우 고속도로를 피하고 고속도로가 포함되지 않은 경로를 우선합니다. DRIVE 및 TWO_WHEELER TravelMode에만 적용됩니다.
avoid_ferries

bool

선택사항입니다. true로 설정하면 합리적인 경우 페리를 피하고 페리가 포함되지 않은 경로를 우선합니다. DRIVE 및 TWO_WHEELER TravelMode에만 적용됩니다.
avoid_indoor

bool

선택사항입니다. true로 설정하면 합리적인 경우 실내에서 탐색하지 않고 실내 탐색이 포함되지 않은 경로를 우선합니다. WALK TravelMode에만 적용됩니다.

RoutingParameters

경로 (결과 순위에 영향을 미침)를 따라 응답의 장소로 라우팅 계산을 구성하고 결과의 이동 시간을 계산하는 매개변수입니다.

필드
origin

LatLng

선택사항입니다. 다중선에 정의된 출발지를 재정의하는 명시적 라우팅 출발지입니다. 기본적으로 다중선 원점이 사용됩니다.
travel_mode

TravelMode

선택사항입니다. 이동 수단입니다.
route_modifiers

RouteModifiers

선택사항입니다. 경로 수정자
routing_preference

RoutingPreference

선택사항입니다. 라우팅 요약을 계산하는 방법을 지정합니다. 서버는 선택한 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 트래픽 인식 라우팅 환경설정은 DRIVE 또는 TWO_WHEELER travelMode에만 사용할 수 있습니다.

RoutingPreference

경로를 계산할 때 고려할 요소를 지정하는 값 집합입니다.

열거형
ROUTING_PREFERENCE_UNSPECIFIED 지정된 라우팅 환경설정이 없습니다. 기본값은 TRAFFIC_UNAWARE입니다.
TRAFFIC_UNAWARE 실시간 교통 상황을 고려하지 않고 경로를 계산합니다. 트래픽 상황이 중요하지 않거나 적용되지 않는 경우에 적합합니다. 이 값을 사용하면 지연 시간이 가장 짧습니다. 참고: TravelMode, DRIVE, TWO_WHEELER의 경우 현재 도로 상황이 아닌 도로망 및 평균 시간과 무관한 교통상황을 기반으로 경로 및 소요 시간이 선택됩니다. 따라서 경로에 일시적으로 폐쇄된 도로가 포함될 수 있습니다. 지정된 요청의 결과는 도로망의 변화, 평균 교통상황의 업데이트 및 분산된 서비스 특성으로 인해 시간이 지남에 따라 달라질 수도 있습니다. 거의 동일한 경로 간에도 언제든지 또는 수시로 결과가 다를 수도 있습니다.
TRAFFIC_AWARE 실시간 교통상황을 고려하여 경로를 계산합니다. TRAFFIC_AWARE_OPTIMAL와 달리 지연 시간을 크게 줄이기 위해 일부 최적화가 적용됩니다.
TRAFFIC_AWARE_OPTIMAL 대부분의 성능 최적화를 적용하지 않고 실시간 트래픽 상태를 고려하여 경로를 계산합니다. 이 값을 사용하면 지연 시간이 가장 길어집니다.

RoutingSummary

응답의 경로 출발지에서 장소까지의 시간 및 거리와 요청된 경우 해당 장소에서 목적지까지의 두 번째 구간입니다. 참고: 요청에 routingParameters.origin 매개변수 또는 searchAlongRouteParameters.polyline.encodedPolyline 매개변수를 포함하지 않고 필드 마스크에 routingSummaries를 추가하면 오류가 발생합니다.

필드
legs[]

Leg

여행 구간입니다.

설정된 출발지에서 이동 시간과 거리를 계산할 때 legs에는 출발지에서 목적지까지의 시간과 거리가 포함된 단일 구간이 포함됩니다. 경로를 따라 검색하면 legs에는 출발지에서 장소까지의 구간과 장소에서 목적지까지의 구간이 각각 하나씩 포함됩니다.
directions_uri

string

지정된 경로 요약의 중간 지점을 사용하여 Google 지도에 경로를 표시하는 링크입니다. 이 링크에서 생성된 경로는 라우팅 요약을 생성하는 데 사용된 경로와 동일하지 않을 수 있습니다. 링크는 요청에 제공된 정보(해당하는 경우 routingParameters 및 searchAlongRouteParameters 필드 포함)를 사용하여 경로 링크를 생성합니다.

다리

구간은 한 위치에서 다른 위치로 이동하는 여정의 한 부분입니다.

필드
duration

Duration

이 구간의 이동을 완료하는 데 걸리는 시간입니다.
distance_meters

int32

이 여행 구간의 거리입니다.

SearchNearbyRequest

주변 검색을 위한 요청 proto입니다.

필드
language_code

string

장소 세부정보는 기본 언어(있는 경우)로 표시됩니다. 언어 코드가 지정되지 않았거나 인식되지 않는 경우, 언어의 장소 세부정보가 반환될 수 있으며, 이러한 세부정보가 있는 경우 영어가 우선적으로 반환됩니다.

현재 지원되는 언어 목록: https://developers.google.com/maps/faq#languagesupport
region_code

string

요청이 발생한 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다(해당하는 경우). 이 매개변수는 관련 법규에 따라 결과에 영향을 미칠 수 있습니다.

자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참고하세요.

현재 3자리 지역 코드는 지원되지 않습니다.
included_types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types의 장소 유형 (예: 'restaurant' 또는 'gas_station')을 포함했습니다.

표 A의 유형을 최대 50개까지 지정할 수 있습니다.

충돌하는 유형이 있는 경우(즉, 유형이 included_types와 excluded_types에 모두 표시되는 경우) INVALID_ARGUMENT 오류가 반환됩니다.

장소 유형이 여러 유형 제한사항으로 지정된 경우 모든 제한사항을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}인 경우 반환된 장소는 '식당' 관련 서비스를 제공하지만 주로 '식당'으로 운영되지는 않습니다.
excluded_types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types에서 제외된 장소 유형 (예: 'restaurant' 또는 'gas_station')

표 A의 유형을 최대 50개까지 지정할 수 있습니다.

클라이언트가 included_types (예: 레스토랑) 및 excluded_types (예: 카페)를 모두 제공하는 경우 응답에는 레스토랑이지만 카페는 아닌 장소가 포함되어야 합니다. 응답에는 included_types 중 하나 이상과 일치하고 excluded_types 중 하나도 일치하지 않는 장소가 포함됩니다.

충돌하는 유형이 있는 경우(즉, 유형이 included_types와 excluded_types에 모두 표시되는 경우) INVALID_ARGUMENT 오류가 반환됩니다.

장소 유형이 여러 유형 제한사항으로 지정된 경우 모든 제한사항을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}인 경우 반환된 장소는 '식당' 관련 서비스를 제공하지만 주로 '식당'으로 운영되지는 않습니다.
included_primary_types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types의 기본 장소 유형 (예: 'restaurant' 또는 'gas_station')을 포함했습니다. 장소에는 지원되는 유형 테이블에서 연결된 기본 유형이 하나만 있을 수 있습니다.

표 A의 유형을 최대 50개까지 지정할 수 있습니다.

충돌하는 기본 유형이 있는 경우(즉, 유형이 included_primary_types 및 excluded_primary_types에 모두 표시되는 경우) INVALID_ARGUMENT 오류가 반환됩니다.

장소 유형이 여러 유형 제한사항으로 지정된 경우 모든 제한사항을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}인 경우 반환된 장소는 '식당' 관련 서비스를 제공하지만 주로 '식당'으로 운영되지는 않습니다.
excluded_primary_types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types에서 기본 장소 유형 (예: 'restaurant' 또는 'gas_station')을 제외했습니다.

표 A의 유형을 최대 50개까지 지정할 수 있습니다.

충돌하는 기본 유형이 있는 경우(즉, 유형이 included_primary_types 및 excluded_primary_types에 모두 표시되는 경우) INVALID_ARGUMENT 오류가 반환됩니다.

장소 유형이 여러 유형 제한사항으로 지정된 경우 모든 제한사항을 충족하는 장소만 반환됩니다. 예를 들어 {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}인 경우 반환된 장소는 '식당' 관련 서비스를 제공하지만 주로 '식당'으로 운영되지는 않습니다.
max_result_count

int32

반환할 결과의 최대 수입니다. 1~20 (기본값) 사이여야 합니다. 숫자가 설정되지 않으면 상한으로 대체됩니다. 숫자가 음수로 설정되거나 상한을 초과하면 INVALID_ARGUMENT 오류가 반환됩니다.
location_restriction

LocationRestriction

필수입니다. 검색할 지역입니다.
rank_preference

RankPreference

응답에서 결과의 순위가 결정되는 방식입니다.
routing_parameters

RoutingParameters

선택사항입니다. 검색 결과 라우팅에 영향을 미치는 매개변수입니다.

LocationRestriction

검색할 지역입니다.

필드

통합 필드 type.

type는 다음 중 하나여야 합니다.
circle

Circle

중심점과 반지름으로 정의된 원입니다.

RankPreference

응답에서 결과의 순위가 결정되는 방식입니다.

열거형
RANK_PREFERENCE_UNSPECIFIED RankPreference 값이 설정되지 않았습니다. 기본적으로 인기도 순으로 순위가 지정됩니다.
DISTANCE 거리를 기준으로 결과를 순위 지정합니다.
POPULARITY 인기도별로 검색 결과를 순위 지정합니다.

SearchNearbyResponse

주변 검색의 응답 프로토입니다.

필드
places[]

Place

장소 유형, 장소 수, 특정 위치 제한과 같은 사용자 요구사항을 충족하는 장소 목록입니다.
routing_summaries[]

RoutingSummary

각 항목이 places 필드의 동일한 색인에 있는 해당 장소에 연결되는 라우팅 요약 목록입니다. 장소 중 하나에 대한 라우팅 요약을 사용할 수 없는 경우 빈 항목이 포함됩니다. 이 목록에는 요청된 경우 장소 목록만큼 항목이 있어야 합니다.

SearchTextRequest

SearchText에 대한 요청 프로토콜입니다.

필드
text_query

string

필수입니다. 텍스트 검색을 위한 텍스트 검색어입니다.
language_code

string

장소 세부정보는 기본 언어(있는 경우)로 표시됩니다. 언어 코드가 지정되지 않았거나 인식되지 않는 경우, 언어의 장소 세부정보가 반환될 수 있으며, 이러한 세부정보가 있는 경우 영어가 우선적으로 반환됩니다.

현재 지원되는 언어 목록: https://developers.google.com/maps/faq#languagesupport
region_code

string

요청이 발생한 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다(해당하는 경우). 이 매개변수는 관련 법규에 따라 결과에 영향을 미칠 수 있습니다.

자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참고하세요.

현재 3자리 지역 코드는 지원되지 않습니다.
rank_preference

RankPreference

응답에서 결과의 순위가 결정되는 방식입니다.
included_type

string

요청된 장소 유형입니다. 지원되는 유형의 전체 목록은 https://developers.google.com/maps/documentation/places/web-service/place-types를 참고하세요. 포함된 유형은 하나만 지원합니다.
open_now

bool

현재 영업 중인 장소로 검색을 제한하는 데 사용됩니다. 기본값은 false입니다.
min_rating

double

평균 사용자 평점이 이 한도보다 낮은 결과를 필터링합니다. 유효한 값은 0.5 주기당 0~5 사이의 부동 소수점 수여야 합니다 (0, 0.5, 1.0, ... , 5.0 포함). 입력 평점은 가장 가까운 0.5(상한선)로 반올림됩니다. 예를 들어 평점이 0.6이면 평점이 1.0 미만인 모든 결과가 삭제됩니다.
max_result_count
(deprecated)

int32

지원 중단됨: 대신 page_size를 사용하세요.

반환할 수 있는 페이지당 최대 결과 수입니다. 사용 가능한 결과 수가 max_result_count보다 크면 page_token에 전달하여 후속 요청에서 결과의 다음 페이지를 가져올 수 있는 next_page_token이 반환됩니다. 0 또는 값이 제공되지 않은 경우 기본값 20이 사용됩니다. 최댓값은 20이며, 20을 초과하는 값은 20으로 변환됩니다. 음수 값은 INVALID_ARGUMENT 오류를 반환합니다.

max_result_count와 page_size가 모두 지정되면 max_result_count가 무시됩니다.
page_size

int32

선택사항입니다. 반환할 수 있는 페이지당 최대 결과 수입니다. 사용 가능한 결과 수가 page_size보다 크면 page_token에 전달하여 후속 요청에서 결과의 다음 페이지를 가져올 수 있는 next_page_token이 반환됩니다. 0 또는 값이 제공되지 않은 경우 기본값 20이 사용됩니다. 최댓값은 20이며, 20을 초과하는 값은 20으로 설정됩니다. 음수 값은 INVALID_ARGUMENT 오류를 반환합니다.

max_result_count와 page_size가 모두 지정되면 max_result_count가 무시됩니다.
page_token

string

선택사항입니다. 이전 TextSearch 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 TextSearch에 제공된 page_token, page_size, max_result_count를 제외한 모든 매개변수는 페이지 토큰을 제공한 최초 호출과 일치해야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
price_levels[]

PriceLevel

특정 가격 수준으로 표시된 장소로 검색을 제한하는 데 사용됩니다. 사용자는 가격 등급 조합을 자유롭게 선택할 수 있습니다. 기본적으로 모든 가격 등급이 선택됩니다.
strict_type_filtering

bool

included_type에 엄격한 유형 필터링을 설정하는 데 사용됩니다. true로 설정하면 동일한 유형의 결과만 반환됩니다. 기본값은 false입니다.
location_bias

LocationBias

검색할 지역입니다. 이 위치는 편향으로 작용하므로 지정된 위치 주변의 결과가 반환될 수 있습니다. location_restriction과 함께 설정할 수 없습니다.
location_restriction

LocationRestriction

검색할 지역입니다. 이 위치는 제한으로 작용하므로 지정된 위치 외부의 결과는 반환되지 않습니다. location_bias와 함께 설정할 수 없습니다.
ev_options

EVOptions

선택사항입니다. 장소 검색 요청의 검색 가능한 EV 옵션을 설정합니다.
routing_parameters

RoutingParameters

선택사항입니다. 결과로 라우팅하기 위한 추가 매개변수입니다.
search_along_route_parameters

SearchAlongRouteParameters

선택사항입니다. 경로를 따라 검색하기 위한 추가 매개변수 프로토입니다.
include_pure_service_area_businesses

bool

선택사항입니다. 이 필드가 true로 설정된 경우 순수 방문 서비스 업체를 포함합니다. 순수 방문 서비스 업체는 고객을 방문하거나 고객에게 직접 서비스를 제공하지만 비즈니스 주소지에서는 고객에게 서비스를 제공하지 않는 비즈니스입니다. 청소 서비스 또는 배관공 등의 비즈니스가 있습니다. 이러한 비즈니스는 Google 지도에 실제 주소나 위치가 없습니다. 장소에서는 이러한 비즈니스의 location, plus_code 및 기타 위치 관련 필드를 반환하지 않습니다.

EVOptions

장소 검색 요청의 검색 가능한 전기자동차 옵션입니다.

필드
minimum_charging_rate_kw

double

선택사항입니다. 필요한 최소 충전 속도(킬로와트)입니다. 충전 요금이 지정된 요금보다 낮은 장소는 필터링됩니다.
connector_types[]

EVConnectorType

선택사항입니다. 선호하는 EV 커넥터 유형 목록입니다. 나열된 커넥터 유형을 지원하지 않는 장소는 필터링됩니다.

LocationBias

검색할 지역입니다. 이 위치는 편향으로 작용하므로 지정된 위치 주변의 결과가 반환될 수 있습니다.

필드

통합 필드 type.

type는 다음 중 하나여야 합니다.
rectangle

Viewport

북동쪽과 남서쪽 모서리로 정의된 직사각형 상자입니다. rectangle.high()는 직사각형 뷰포트의 북동쪽 지점이어야 합니다. rectangle.low()는 직사각형 뷰포트의 남서쪽 지점이어야 합니다. rectangle.low().latitude()은(는) rectangle.high().latitude()보다 클 수 없습니다. 이 경우 위도 범위가 비워집니다. 직사각형 뷰포트의 너비는 180도보다 클 수 없습니다.
circle

Circle

중심점과 반지름으로 정의된 원입니다.

LocationRestriction

검색할 지역입니다. 이 위치는 제한으로 작용하므로 지정된 위치 외부의 결과는 반환되지 않습니다.

필드

통합 필드 type.

type는 다음 중 하나여야 합니다.
rectangle

Viewport

북동쪽과 남서쪽 모서리로 정의된 직사각형 상자입니다. rectangle.high()는 직사각형 뷰포트의 북동쪽 지점이어야 합니다. rectangle.low()는 직사각형 뷰포트의 남서쪽 지점이어야 합니다. rectangle.low().latitude()은(는) rectangle.high().latitude()보다 클 수 없습니다. 이 경우 위도 범위가 비워집니다. 직사각형 뷰포트의 너비는 180도보다 클 수 없습니다.

RankPreference

응답에서 결과의 순위가 결정되는 방식입니다.

열거형
RANK_PREFERENCE_UNSPECIFIED '뉴욕시의 음식점'과 같은 카테고리 검색어의 경우 기본값은 관련성입니다. '캘리포니아 마운틴뷰'와 같이 카테고리가 아닌 검색어의 경우 rankPreference를 설정하지 않는 것이 좋습니다.
DISTANCE 거리를 기준으로 결과를 순위 지정합니다.
RELEVANCE 관련성을 기준으로 검색 결과를 순위 지정합니다. 정렬 순서는 일반 순위 스택에 따라 결정됩니다.

SearchAlongRouteParameters

검색할 경로를 정의하는 Routes API의 사전 계산된 다중선입니다. 경로를 따라 검색하는 것은 locationBias 또는 locationRestriction 요청 옵션을 사용하여 검색 결과에 편향성을 적용하는 것과 유사합니다. 그러나 locationBias 및 locationRestriction 옵션을 사용하면 검색 결과에 편향이 적용될 지역을 지정할 수 있지만 이 옵션을 사용하면 이동 경로를 따라 결과에 편향이 적용될 수 있습니다.

결과가 제공된 경로를 따라 반드시 표시되는 것은 아니며, 대신 다중선으로 정의된 검색 영역 내에서 순위가 매겨지며, 원하는 경우 출발지에서 목적지까지의 최소 우회 시간을 기준으로 locationBias 또는 locationRestriction에 따라 순위가 매겨집니다. 특히 제공된 다중선이 출발지에서 목적지로의 최적 경로를 정의하지 않는 경우 결과가 대체 경로를 따라 표시될 수 있습니다.

필드
polyline

Polyline

필수입니다. 경로 폴리라인

SearchTextResponse

SearchText의 응답 프로토입니다.

필드
places[]

Place

사용자의 텍스트 검색 기준을 충족하는 장소 목록입니다.
routing_summaries[]

RoutingSummary

각 항목이 places 필드의 동일한 색인에 있는 해당 장소에 연결되는 라우팅 요약 목록입니다. 장소 중 하나에 대한 라우팅 요약을 사용할 수 없는 경우 빈 항목이 포함됩니다. 이 목록에는 요청된 경우 장소 목록만큼 항목이 포함됩니다.
contextual_contents[]

ContextualContent

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

각 항목이 장소 필드의 동일한 색인에 있는 해당 장소와 연결되는 문맥 콘텐츠 목록입니다. 요청의 text_query와 관련된 콘텐츠가 선호됩니다. 장소 중 하나에서 문맥 콘텐츠를 사용할 수 없는 경우 문맥 외 콘텐츠가 반환됩니다. 이 장소에서 콘텐츠를 사용할 수 없는 경우에만 비어 있습니다. 이 목록에는 요청된 경우 장소 목록만큼 항목이 포함됩니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드가 생략되거나 비어 있는 경우 다음 페이지가 표시되지 않습니다.
search_uri

string

링크를 사용하면 사용자가 Google 지도의 요청에 지정된 것과 동일한 텍스트 검색어로 검색할 수 있습니다.

TravelMode

이동 수단 옵션 이러한 옵션은 Routes API에서 제공하는 항목에 매핑됩니다.

열거형
TRAVEL_MODE_UNSPECIFIED 지정된 이동 수단이 없습니다. 기본값은 DRIVE입니다.
DRIVE 승용차로 이동합니다.
BICYCLE 자전거로 이동합니다. search_along_route_parameters에서는 지원되지 않습니다.
WALK 걷기 search_along_route_parameters에서는 지원되지 않습니다.
TWO_WHEELER 스쿠터, 오토바이 등 모든 종류의 이륜차 이는 사람이 직접 이동하는 수단을 다루는 BICYCLE 이동 수단과는 다릅니다. search_along_route_parameters에서는 지원되지 않습니다. 오토바이 경로가 지원되는 국가 및 지역에 나열된 국가에서만 지원됩니다.