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,
  "pageSize": integer,
  "pageToken": string,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  },
  "routingParameters": {
    object (RoutingParameters)
  },
  "searchAlongRouteParameters": {
    object (SearchAlongRouteParameters)
  },
  "includePureServiceAreaBusinesses": boolean
}
필드
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 포함된 유형은 하나만 지원됩니다.
openNow

boolean

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

number

평균 사용자 평가가 이 한도보다 엄격하게 낮은 결과를 필터링합니다. 유효한 값은 0.5 주기로 0~5(포함) 사이의 부동 소수점이어야 합니다(예: [0, 0.5, 1.0, ... , 5.0] 포함). 입력된 평점은 가장 가까운 0.5(올림)로 반올림됩니다. 예를 들어 등급이 0.6이면 등급이 1.0 미만인 결과가 모두 삭제됩니다.
maxResultCount
(deprecated)

integer

지원 중단됨: 대신 pageSize을 사용하세요.

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

maxResultCount과 pageSize이 모두 지정된 경우 maxResultCount이 무시됩니다.
pageSize

integer

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

maxResultCount과 pageSize이 모두 지정된 경우 maxResultCount이 무시됩니다.
pageToken

string

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

페이지로 나누는 경우 TextSearch에 제공된 pageToken, pageSize, maxResultCount 이외의 모든 매개변수는 페이지 토큰을 제공한 초기 호출과 일치해야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
priceLevels[]

enum (PriceLevel)

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

boolean

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

object (LocationBias)

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

object (LocationRestriction)

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

object (EVOptions)

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

object (RoutingParameters)

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

object (SearchAlongRouteParameters)

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

boolean

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

응답 본문

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

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "places": [
    {
      object (Place)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ],
  "contextualContents": [
    {
      object (ContextualContent)
    }
  ],
  "nextPageToken": string,
  "searchUri": string
}
필드
places[]

object (Place)

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

object (RoutingSummary)

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

object (ContextualContent)

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

각 항목이 places 필드의 동일한 색인에 있는 해당 장소와 연결되는 맥락 콘텐츠 목록입니다. 요청의 textQuery와 관련된 콘텐츠가 선호됩니다. 한 장소에 문맥 콘텐츠가 제공되지 않으면 문맥이 없는 콘텐츠가 반환됩니다. 이 장소에서 콘텐츠를 사용할 수 없는 경우에만 비어 있습니다. 이 목록에는 요청된 경우 장소 목록만큼 많은 항목이 있습니다.
nextPageToken

string

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

string

링크를 통해 사용자는 요청에 지정된 것과 동일한 텍스트 쿼리로 Google 지도에서 검색할 수 있습니다.

승인 범위

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

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

RankPreference

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

열거형
RANK_PREFERENCE_UNSPECIFIED '뉴욕시의 레스토랑'과 같은 카테고리 쿼리의 경우 RELEVANCE가 기본값입니다. '캘리포니아 마운틴뷰'와 같은 비카테고리 쿼리의 경우 rankPreference를 설정하지 않은 상태로 두는 것이 좋습니다.
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

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

JSON 표현 
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
필드
minimumChargingRateKw

number

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

enum (EVConnectorType)

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

SearchAlongRouteParameters

검색할 경로를 정의하는 Routes API의 사전 계산된 폴리라인을 지정합니다. 경로를 따라 검색하는 것은 locationBias 또는 locationRestriction 요청 옵션을 사용하여 검색 결과에 편향을 주는 것과 유사합니다. locationBias 및 locationRestriction 옵션을 사용하면 검색 결과에 편향을 줄 지역을 지정할 수 있지만 이 옵션을 사용하면 여행 경로를 따라 결과에 편향을 줄 수 있습니다.

결과는 제공된 경로를 따라 표시되지 않으며, 폴리라인과 선택적으로 locationBias 또는 locationRestriction로 정의된 검색 영역 내에서 출발지에서 목적지까지의 최소 우회 시간을 기준으로 순위가 지정됩니다. 특히 제공된 폴리라인이 출발지에서 목적지까지의 최적 경로를 정의하지 않는 경우 결과가 대체 경로를 따라 표시될 수 있습니다.

JSON 표현 
{
  "polyline": {
    object (Polyline)
  }
}
필드
polyline

object (Polyline)

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

폴리라인

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

JSON 표현 
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string
  // End of list of possible types for union field polyline_type.
}
필드
통합 필드 polyline_type. 폴리라인의 유형을 캡슐화합니다. Routes API 출력은 기본적으로 encoded_polyline입니다. polyline_type은 다음 중 하나일 수 있습니다.
encodedPolyline

string

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

ContextualContent

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

장소 쿼리와 관련된 콘텐츠입니다.

JSON 표현 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "justifications": [
    {
      object (Justification)
    }
  ]
}
필드
reviews[]

object (Review)

이 장소에 대한 리뷰 목록으로, 장소 쿼리와 관련이 있습니다.
photos[]

object (Photo)

이 장소의 사진에 관한 정보 (참조 포함)로, 장소 쿼리와 관련이 있습니다.
justifications[]

object (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를 참고하세요.

장소에 대한 근거입니다. 근거는 장소가 최종 사용자에게 흥미로울 수 있는 이유에 대한 질문에 답합니다.

JSON 표현 
{

  // Union field justification can be only one of the following:
  "reviewJustification": {
    object (ReviewJustification)
  },
  "businessAvailabilityAttributesJustification": {
    object (BusinessAvailabilityAttributesJustification)
  }
  // End of list of possible types for union field justification.
}
필드

통합 필드 justification.

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

object (ReviewJustification)

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

object (BusinessAvailabilityAttributesJustification)

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

ReviewJustification

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

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

JSON 표현 
{
  "highlightedText": {
    object (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
필드
highlightedText

object (HighlightedText)
review

object (Review)

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

HighlightedText

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

JSON 표현 
{
  "text": string,
  "highlightedTextRanges": [
    {
      object (HighlightedTextRange)
    }
  ]
}
필드
text

string
highlightedTextRanges[]

object (HighlightedTextRange)

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

HighlightedTextRange

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

JSON 표현 
{
  "startIndex": integer,
  "endIndex": integer
}
필드
startIndex

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

실험 단계: 자세한 내용은 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative를 참고하세요. BusinessAvailabilityAttributes 근거입니다. 비즈니스에 최종 사용자가 관심을 가질 만한 속성이 표시됩니다.

JSON 표현 
{
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean
}
필드
takeout

boolean

장소에서 테이크아웃을 제공하는지 여부입니다.
delivery

boolean

장소에서 배달을 제공하는 경우
dineIn

boolean

장소에서 매장 내 식사를 제공하는지 여부입니다.