주문형 차량 공유 및 배송 솔루션은 현재 일부 파트너만 이용할 수 있습니다. 자세한 내용은 영업팀에 문의하세요.

Method: providers.trips.search

특정 차량의 모든 이동 경로를 확인합니다.

HTTP 요청

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. providers/{provider} 형식이어야 합니다. 제공업체는 이 호출을 실행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID (예: sample-cloud-project)여야 합니다.

요청 본문

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

JSON 표현
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
필드
header

object (RequestHeader)

표준 Fleet Engine 요청 헤더입니다.

vehicleId

string

요청의 이동과 관련된 차량입니다. 지정하지 않으면 반환된 경로에 다음이 포함되지 않습니다.

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

true로 설정하면 응답에 운전자의 경로에 영향을 미치는 이동이 포함됩니다.

pageSize

integer

정책을 설정하지 않으면 서버에서 반환할 결과 수를 결정합니다.

pageToken

string

이전 결과에서 계속하려면 SearchTripsResponse에서 이전에 반환된 값으로 설정합니다.

minimumStaleness

string (Duration format)

지정된 경우 (current - minimumStaleness) 시간 이후에 업데이트되지 않은 여행을 반환합니다.

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다. 예: "3.5s"

응답 본문

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

trips.search 응답 메시지.

JSON 표현
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
필드
trips[]

object (Trip)

요청된 차량의 이동 목록입니다.

nextPageToken

string

SearchTripsRequest에서 이 토큰을 전달하여 목록 결과를 전달합니다. API는 각 호출에 대해 경로 목록을 반환하고 더 이상 결과가 없으면 경로 목록이 비어 있습니다.