Method: providers.deliveryVehicles.list

지정된 필터링 기준을 충족하는 모든 DeliveryVehicle를 가져옵니다.

HTTP 요청

GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/deliveryVehicles

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. providers/{provider} 형식이어야 합니다. provider는 Google Cloud 프로젝트 ID여야 합니다. sample-cloud-project를 예로 들 수 있습니다.

쿼리 매개변수

매개변수
header

object (DeliveryRequestHeader)

선택사항입니다. 표준 Delivery API 요청 헤더입니다.
pageSize

integer

선택사항입니다. 반환할 최대 차량 수입니다. 서비스가 이 수보다 더 적게 반환할 수 있습니다. 이 숫자를 지정하지 않으면 서버에서 반환할 결과 수를 결정합니다.
pageToken

string

선택사항입니다. 이전 deliveryVehicles.list 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 제공해야 합니다.

페이지를 매길 때 deliveryVehicles.list에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.
filter

string

선택사항입니다. 배송 차량을 나열할 때 적용할 필터 쿼리입니다. 필터 문법의 예는 http://aip.dev/160을 참고하세요. 값을 지정하지 않거나 필터에 빈 문자열을 지정하면 모든 전송 수단이 반환됩니다.

deliveryVehicles.list에 지원되는 유일한 쿼리는 차량 속성(예: attributes.<key> = <value> 또는 attributes.<key1> = <value1> AND attributes.<key2> = <value2>)에 관한 쿼리입니다. 또한 모든 속성은 문자열로 저장되므로 속성에 대해 지원되는 유일한 비교는 문자열 비교입니다. 숫자 또는 불리언 값과 비교하려면 값을 명시적으로 따옴표로 묶어 문자열로 처리해야 합니다 (예: attributes.<key> = "10" 또는 attributes.<key> = "true").

필터 쿼리에 허용되는 최대 제한 수는 50개입니다. 제한은 attribute.<KEY> <COMPARATOR> <VALUE> 형식의 쿼리의 일부입니다. 예를 들어 attributes.foo = bar은 1개의 제한입니다.
viewport

object (Viewport)

선택사항입니다. 마지막으로 알려진 위치가 표시 영역에 정의된 직사각형 영역에 있는 차량으로 반환되는 차량을 제한하는 필터입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

deliveryVehicles.list 응답 메시지

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

JSON 표현 
{
  "deliveryVehicles": [
    {
      object (DeliveryVehicle)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
필드
deliveryVehicles[]

object (DeliveryVehicle)

요청된 필터링 기준을 충족하는 게재 수단 집합입니다. 필터를 지정하지 않으면 요청에서 모든 배송 차량을 반환합니다. 성공적인 응답이 비어 있을 수도 있습니다. 빈 응답은 요청된 필터 기준을 충족하는 배송 차량이 없음을 나타냅니다.
nextPageToken

string

ListDeliveryVehiclesRequest에 이 토큰을 전달하여 결과를 계속 나열할 수 있습니다. 모든 결과가 반환되면 이 필드는 응답에 없거나 빈 문자열이 됩니다.
totalSize

string (int64 format)

모든 페이지에서 요청 기준과 일치하는 총 배송 차량 수입니다.

표시 영역

대각선으로 반대되는 두 개의 low 및 high 지점으로 표시되는 위도-경도 뷰포트입니다. 표시 영역은 폐쇄된 영역으로 간주됩니다. 즉, 경계가 포함됩니다. 위도 경계는 -90도에서 90도(양 끝값 포함) 사이여야 하며 경도 경계는 -180도에서 180도(양 끝값 포함) 사이여야 합니다. 다양한 사례는 다음과 같습니다.

  • low = high이면 뷰포트는 단일 지점으로 구성됩니다.

  • low.longitude > high.longitude인 경우 경도 범위가 반전됩니다(뷰포트가 180도 경도 선을 교차함).

  • low.longitude = -180도이고 high.longitude = 180도인 경우 뷰포트에 모든 경도가 포함됩니다.

  • low.longitude = 180도이고 high.longitude = -180도인 경우 경도 범위는 비어 있습니다.

  • low.latitude가 high.latitude보다 크면 위도 범위가 비어 있습니다.

low 및 high 모두 채워야 하며, 위에 정의된 대로 표현된 상자는 비워 둘 수 없습니다. 표시 영역이 비어 있으면 오류가 발생합니다.

예를 들어 이 표시 영역은 뉴욕시를 완전히 둘러쌉니다.

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 표현 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
필드
low

object (LatLng)

필수 항목입니다. 뷰포트의 하단 지점입니다.
high

object (LatLng)

필수 항목입니다. 표시 영역의 높은 지점입니다.