Method: places.searchText

텍스트 쿼리 기반 장소 검색

HTTP 요청

POST https://places.googleapis.com/v1/places:searchText

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "rankPreference": enum (RankPreference),
  "includedType": string,
  "openNow": boolean,
  "minRating": number,
  "maxResultCount": integer,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
입력란
textQuery

string

필수 항목입니다. 텍스트 검색을 위한 텍스트 쿼리입니다.

languageCode

string

장소 세부정보가 기본 언어와 함께 표시됩니다(사용 가능한 경우). 언어 코드가 지정되지 않거나 인식할 수 없는 경우 언어의 장소 세부정보가 반환될 수 있으며 세부정보가 있는 경우 영어가 선호됩니다.

현재 지원되는 언어 목록은 https://developers.google.com/maps/faq#languagesupport에서 확인하세요.

regionCode

string

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

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

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

rankPreference

enum (RankPreference)

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

includedType

string

요청된 장소 유형입니다. 지원되는 유형의 전체 목록: https://developers.google.com/maps/documentation/places/web-service/place-types 포함된 유형 1개만 지원합니다.

openNow

boolean

현재 열려 있는 장소로 검색을 제한하는 데 사용됩니다. 기본값은 false입니다.

minRating

number

평균 사용자 평점이 이 한도보다 낮은 결과를 필터링합니다. 유효한 값은 0.5 케이던스([0, 0.5, 1.0, ... , 5.0] 포함)로 0과 5 사이의 부동 소수점이어야 합니다. 입력 평점은 가장 가까운 0.5(최대)로 반올림됩니다. 예를 들어 평점이 0.6이면 평점이 1.0 미만인 모든 결과가 제외됩니다.

maxResultCount

integer

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

priceLevels[]

enum (PriceLevel)

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

strictTypeFiltering

boolean

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

locationBias

object (LocationBias)

검색할 지역입니다. 이 위치는 지정된 위치를 둘러싼 결과가 반환될 수 있다는 의미로 바이어스 역할을 합니다. locationRestriction과 함께 설정할 수 없습니다.

locationRestriction

object (LocationRestriction)

검색할 지역입니다. 이 위치는 제한 역할을 하므로 지정된 위치를 벗어난 결과는 반환되지 않습니다. locationBias와 함께 설정할 수 없습니다.

evOptions

object (EVOptions)

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

응답 본문

places.searchText의 응답 프로토콜입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "places": [
    {
      object (Place)
    }
  ]
}
입력란
places[]

object (Place)

사용자의 텍스트 검색 기준에 맞는 장소의 목록입니다.

RankPreference

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

열거형
RANK_PREFERENCE_UNSPECIFIED RankPreference 값이 설정되지 않았습니다. 기본값은 DISTANCE입니다.
DISTANCE 거리를 기준으로 결과의 순위를 매깁니다.
RELEVANCE 관련성을 기준으로 결과의 순위를 매깁니다. 일반 순위 스택에 따라 결정된 정렬 순서입니다.

LocationBias

검색할 지역입니다. 이 위치는 지정된 위치를 둘러싼 결과가 반환될 수 있다는 의미로 바이어스 역할을 합니다.

JSON 표현
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
입력란

통합 필드 type.

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

rectangle

object (Viewport)

북동쪽과 남서쪽 모서리로 정의된 직사각형 상자. rectangle.high()은 직사각형 표시 영역의 북동쪽 지점이어야 합니다. rectangle.low()은 직사각형 표시 영역의 남서쪽 지점이어야 합니다. rectangle.low().latitude()은(는) rectangle.high().latitude() 이하여야 합니다. 이 경우 위도 범위가 비어 있게 됩니다. 직사각형 표시 영역의 너비는 180도 이하여야 합니다.

circle

object (Circle)

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

LocationRestriction

검색할 지역입니다. 이 위치는 제한 역할을 하므로 지정된 위치를 벗어난 결과는 반환되지 않습니다.

JSON 표현
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
입력란

통합 필드 type.

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

rectangle

object (Viewport)

북동쪽과 남서쪽 모서리로 정의된 직사각형 상자. rectangle.high()은 직사각형 표시 영역의 북동쪽 지점이어야 합니다. rectangle.low()은 직사각형 표시 영역의 남서쪽 지점이어야 합니다. rectangle.low().latitude()은(는) rectangle.high().latitude() 이하여야 합니다. 이 경우 위도 범위가 비어 있게 됩니다. 직사각형 표시 영역의 너비는 180도 이하여야 합니다.

EVOptions

장소 검색 요청의 검색 가능한 EV 옵션입니다.

JSON 표현
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
입력란
minimumChargingRateKw

number

선택사항입니다. 최소 충전 속도에 따라 장소 필터링 최소 충전 속도보다 낮은 요금을 부과하는 장소는 필터링됩니다.

connectorTypes[]

enum (EVConnectorType)

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