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는 각 호출에서 여행 목록을 반환하며 더 이상 결과가 남아 있지 않으면 여행 목록은 비어 있습니다.