텍스트 쿼리 기반 장소 검색
HTTP 요청
POST https://places.googleapis.com/v1/places:searchText
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "textQuery": string, "languageCode": string, "regionCode": string, "rankPreference": enum ( |
입력란 | |
---|---|
textQuery |
필수 항목입니다. 텍스트 검색을 위한 텍스트 쿼리입니다. |
languageCode |
장소 세부정보가 기본 언어와 함께 표시됩니다(사용 가능한 경우). 언어 코드가 지정되지 않거나 인식할 수 없는 경우 언어의 장소 세부정보가 반환될 수 있으며 세부정보가 있는 경우 영어가 선호됩니다. 현재 지원되는 언어 목록은 https://developers.google.com/maps/faq#languagesupport에서 확인하세요. |
regionCode |
요청이 발생한 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 사용 가능한 경우 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다. 매개변수는 관련 법률에 따라 결과에 영향을 줄 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참조하세요. 현재 3자리 지역 코드는 지원되지 않습니다. |
rankPreference |
응답에서 결과의 순위가 지정되는 방식입니다. |
includedType |
요청된 장소 유형입니다. 지원되는 유형의 전체 목록: https://developers.google.com/maps/documentation/places/web-service/place-types 포함된 유형 1개만 지원합니다. |
openNow |
현재 열려 있는 장소로 검색을 제한하는 데 사용됩니다. 기본값은 false입니다. |
minRating |
평균 사용자 평점이 이 한도보다 낮은 결과를 필터링합니다. 유효한 값은 0.5 케이던스([0, 0.5, 1.0, ... , 5.0] 포함)로 0과 5 사이의 부동 소수점이어야 합니다. 입력 평점은 가장 가까운 0.5(최대)로 반올림됩니다. 예를 들어 평점이 0.6이면 평점이 1.0 미만인 모든 결과가 제외됩니다. |
maxResultCount |
반환할 결과의 최대 수입니다. 1 이상 20 이하여야 합니다. 기본값은 20입니다. 숫자를 설정하지 않으면 상한으로 대체됩니다. 숫자가 음수로 설정되거나 상한을 초과하면 INVALID_ARGUMENT 오류가 반환됩니다. |
priceLevels[] |
특정 가격 수준으로 표시된 장소로 검색을 제한하는 데 사용됩니다. 사용자는 가격 수준의 조합을 선택할 수 있습니다. 기본적으로 모든 가격 수준을 선택합니다. |
strictTypeFiltering |
includeType에 엄격한 유형 필터링을 설정하는 데 사용됩니다. true로 설정하면 같은 유형의 결과만 반환됩니다. 기본값은 false입니다. |
locationBias |
검색할 지역입니다. 이 위치는 지정된 위치를 둘러싼 결과가 반환될 수 있다는 의미로 바이어스 역할을 합니다. locationRestriction과 함께 설정할 수 없습니다. |
locationRestriction |
검색할 지역입니다. 이 위치는 제한 역할을 하므로 지정된 위치를 벗어난 결과는 반환되지 않습니다. locationBias와 함께 설정할 수 없습니다. |
evOptions |
선택사항입니다. 장소 검색 요청의 검색 가능한 EV 옵션을 설정합니다. |
응답 본문
places.searchText의 응답 프로토콜입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"places": [
{
object ( |
입력란 | |
---|---|
places[] |
사용자의 텍스트 검색 기준에 맞는 장소의 목록입니다. |
RankPreference
응답에서 결과의 순위가 지정되는 방식입니다.
열거형 | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
'뉴욕의 식당'과 같은 범주형 쿼리의 경우 RELEVANCE는 기본값입니다. '캘리포니아 마운틴뷰'와 같이 카테고리가 없는 쿼리의 경우 rankPreference를 설정하지 않은 상태로 두는 것이 좋습니다. |
DISTANCE |
거리를 기준으로 결과의 순위를 매깁니다. |
RELEVANCE |
관련성을 기준으로 결과의 순위를 매깁니다. 일반 순위 스택에 따라 결정된 정렬 순서입니다. |
LocationBias
검색할 지역입니다. 이 위치는 지정된 위치를 둘러싼 결과가 반환될 수 있다는 의미로 바이어스 역할을 합니다.
JSON 표현 |
---|
{ // Union field |
입력란 | |
---|---|
통합 필드
|
|
rectangle |
북동쪽과 남서쪽 모서리로 정의된 직사각형 상자. |
circle |
중심점과 반지름으로 정의되는 원입니다. |
LocationRestriction
검색할 지역입니다. 이 위치는 제한 역할을 하므로 지정된 위치를 벗어난 결과는 반환되지 않습니다.
JSON 표현 |
---|
{ // Union field |
입력란 | |
---|---|
통합 필드
|
|
rectangle |
북동쪽과 남서쪽 모서리로 정의된 직사각형 상자. |
EVOptions
장소 검색 요청의 검색 가능한 EV 옵션입니다.
JSON 표현 |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
입력란 | |
---|---|
minimumChargingRateKw |
선택사항입니다. 필요한 최소 충전 속도(킬로와트 단위) 충전율이 지정된 요금보다 낮은 장소가 필터링됩니다. |
connectorTypes[] |
선택사항입니다. 기본 EV 커넥터 유형의 목록입니다. 나열된 커넥터 유형을 지원하지 않는 장소는 필터링됩니다. |