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"입니다.

응답 본문

trip.search 응답 메시지입니다.

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

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

object (Trip)

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

string

목록 결과를 페이징하려면 SearchTripsRequest에 이 토큰을 전달합니다. API는 각 호출에서 경로 목록을 반환하며 더 이상 결과가 남아 있지 않으면 경로 목록이 비어 있습니다.