Method: searchAlongRoute

이동 경로를 따라 장소를 검색합니다.

HTTP 요청

POST https://mapstools.googleapis.com/v1alpha:searchAlongRoute

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

요청 본문

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

JSON 표현
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "routingPreference": enum (RoutingPreference),
  "includeExtendedDetails": boolean,
  "travelMode": enum (RouteTravelMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "retrievalToken": string,
  "routeEndpoints": {
    object (RouteEndpoints)
  }
  // End of mutually exclusive fields.
}
필드
textQuery

string

필수 항목입니다. 자연어 검색어(예: 'EV 충전기', '커피')입니다.

languageCode

string

선택사항입니다. 요약 및 장소 세부정보의 언어입니다. 기본값은 'en-US'입니다.

regionCode

string

선택사항입니다. 위치의 국가/지역 코드(CLDR)입니다(예: 'US').

routingPreference

enum (RoutingPreference)

선택사항입니다. 교통정보 데이터가 사용되는 방식을 지정하는 선택적 경로 환경설정입니다. 기본값은 TRAFFIC_UNAWARE입니다.

includeExtendedDetails

boolean

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

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

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

이 필드를 사용 설정하면 지연 시간이 길어질 수 있습니다.

travelMode

enum (RouteTravelMode)

선택사항입니다. 경로 및 우회 경로를 계산하는 데 사용되는 이동 수단을 지정합니다. 기본값은 DRIVE입니다. WALK 및 BICYCLE는 routeEndpoints에서만 지원됩니다. TRANSIT는 지원되지 않습니다.

경로 사양: 기존 경로, 경로 토큰 또는 출발지/목적지 엔드포인트입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
encodedPolyline

string

경로를 나타내는 인코딩된 다중선 문자열입니다. https://developers.google.com/maps/documentation/utilities/polylinealgorithm을 참고하세요.

retrievalToken

string

경로를 나타내는 이전 v1alpha.computeRoutes 호출에서 반환된 검색 토큰입니다.

routeEndpoints

object (RouteEndpoints)

명시적 경로 엔드포인트(출발지 및 목적지)

상호 배타적 필드의 끝입니다.

응답 본문

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

승인 범위

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

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