Method: searchText

텍스트 쿼리로 장소를 검색합니다.

HTTP 요청

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

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

요청 본문

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

JSON 표현 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
필드
textQuery

string

필수 항목입니다. 텍스트 쿼리입니다.
languageCode

string

선택사항입니다. 요약이 반환되는 언어입니다. 언어 코드가 지정되지 않거나 인식되지 않으면 영어가 우선 적용된 요약이 반환됩니다.

예를 들어 영어의 경우 'en'입니다.

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

string

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

예를 들어 미국의 경우 'US'입니다.

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

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

integer

선택사항입니다. 반환할 최대 장소 수(최대 10개)입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 기본값은 5입니다.

장소를 5개 넘게 요청하면 Pro 등급이 트리거되어 청구 비용과 지연 시간이 늘어납니다.
includeExtendedDetails

boolean

선택사항입니다. 응답에 확장된 장소 세부정보를 포함합니다.

사용자 요청에 풍부한 정성적 인사이트, 실시간 역학 또는 전문 항목 속성이 필요한 경우 이 필드를 true로 설정합니다. - 정성적 리뷰, 고객 감정, 의견 - 메뉴 항목, 요리, 특산품, 음료 또는 비즈니스 하이라이트와 같은 특정 제품 또는 서비스 - 정성적 분위기, 인테리어 장식, 미적 요소, 분위기 또는 무드 - 실시간 데이터 및 전문 시설 사양, 방문자 정책/팁, 대기 시간

표준 탐색 검색(예: 요리, 매장 유형), 위치/주소 조회, 연락처 정보, 영업시간, 표준 메타데이터/편의시설의 경우 false(기본값)로 둡니다.

이 필드를 사용 설정하면 Pro 등급이 트리거되고 청구 비용과 지연 시간이 늘어납니다.
locationBias

object (LocationBias)

검색 결과에 편향을 적용할 선택적 지역입니다. 명시적 위치가 textQuery에 있는 경우 이 필드 대신 검색 결과에 편향을 적용하는 데 사용됩니다.

응답 본문

성공한 경우 응답 본문에 SearchTextResponse의 인스턴스가 포함됩니다.

승인 범위

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

  • https://www.googleapis.com/auth/maps-platform.mapstools