SearchVehiclesLog

Details on SearchVehicles request and response.

Note: This log is subject to splitting on the matches field if the total log size exceeds 256 KB. See Split Logs / for more details.

JSON representation
{
  "request": {
    object (SearchVehiclesRequestLog)
  },
  "response": {
    object (SearchVehiclesResponseLog)
  },
  "errorResponse": {
    object (ErrorResponseLog)
  }
}
Fields
request

object (SearchVehiclesRequestLog)

The request sent to Fleet Engine.

response

object (SearchVehiclesResponseLog)

The response returned to the client. If the RPC call results in an error the response is not set.

errorResponse

object (ErrorResponseLog)

The error response returned to the client. It will be unset if the RPC call succeeded.

SearchVehiclesRequestLog

Details on the SearchVehicles request.

JSON representation
{
  "header": {
    object (RequestHeaderLog)
  },
  "pickupPoint": {
    object (TerminalLocationLog)
  },
  "dropoffPoint": {
    object (TerminalLocationLog)
  },
  "pickupRadiusMeters": integer,
  "count": integer,
  "minimumCapacity": integer,
  "searchTripTypes": [
    enum (TripTypeLog)
  ],
  "maximumStaleness": string,
  "vehicleTypes": [
    {
      object (VehicleTypeLog)
    }
  ],
  "requiredAttributes": [
    {
      object (VehicleAttributeLog)
    }
  ],
  "requiredOneOfAttributes": [
    {
      object (VehicleAttributeListLog)
    }
  ],
  "requiredOneOfAttributeSets": [
    {
      object (VehicleAttributeListLog)
    }
  ],
  "matchOrderBy": enum (VehicleMatchOrderLog),
  "includeBackToBack": boolean,
  "tripId": string,
  "filter": string
}
Fields
header

object (RequestHeaderLog)

Request header.

pickupPoint

object (TerminalLocationLog)

The pickup point to search near.

dropoffPoint

object (TerminalLocationLog)

The customer's intended dropoff location.

pickupRadiusMeters

integer

Specifies the vehicle search radius around the pickup point.

count

integer

Specifies the maximum number of vehicles to return.

minimumCapacity

integer

Specifies the required minimum capacity of the vehicle.

searchTripTypes[]

enum (TripTypeLog)

Restricts the search to only those vehicles that support at least one of the specified trip types.

maximumStaleness

string (Duration format)

Restricts the search to only those vehicles that have updated their locations within the specified duration back from now.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".

vehicleTypes[]

object (VehicleTypeLog)

The types of vehicle searching for.

requiredAttributes[]

object (VehicleAttributeLog)

Restricts the search to only those vehicles with the specified attributes.

requiredOneOfAttributes[]

object (VehicleAttributeListLog)

Restricts the search to only those vehicles with at least one of the specified attributes applied to each VehicleAttributeList.

requiredOneOfAttributeSets[]

object (VehicleAttributeListLog)

Restricts the search to only those vehicles with at least one set of the specified attributes in the VehicleAttributeList.

matchOrderBy

enum (VehicleMatchOrderLog)

Sort order of the search result.

includeBackToBack

boolean

Indicates if a vehicle with an active trip is eligible for another match.

tripId

string

ID of the trip associated with the searchVehiclesRequest.

filter

string

An AIP-160 query that limits vehicles returned based on vehicle attributes.

VehicleAttributeListLog

A list-of-list datatype for VehicleAttributeLog.

JSON representation
{
  "attributes": [
    {
      object (VehicleAttributeLog)
    }
  ]
}
Fields
attributes[]

object (VehicleAttributeLog)

A list of attributes in this collection.

SearchVehiclesResponseLog

Details on the SearchVehicles response.

JSON representation
{
  "matchIds": [
    string
  ],
  "matches": [
    {
      object (VehicleMatchLog)
    }
  ]
}
Fields
matchIds[]
(deprecated)

string

Deprecated: List of the vehicle IDs for the returned vehicles. Please use matches.vehicle.name to derive this ID.

matches[]

object (VehicleMatchLog)

List of VehicleMatches for the returned vehicles.

VehicleMatchLog

The log of a SearchVehicles VehicleMatch result.

JSON representation
{
  "vehicle": {
    object (VehicleLog)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripTypeLog),
  "vehicleMatchType": enum (VehicleMatchTypeLog),
  "requestedOrderedBy": enum (VehicleMatchOrderLog),
  "orderedBy": enum (VehicleMatchOrderLog)
}
Fields
vehicle

object (VehicleLog)

A vehicle that matches the request.

vehiclePickupEta

string (Timestamp format)

The vehicle's driving ETA to the pickup point specified in the request. An empty value indicates a failure in calculating ETA for the vehicle.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

vehiclePickupDistanceMeters

integer

The vehicle's driving distance to the pickup point specified in the request, including any intermediate pickup or dropoff points for an existing ride. An empty value indicates a failure in calculating distance for the vehicle.

vehiclePickupStraightLineDistanceMeters

integer

The straight-line distance between the vehicle and the pickup point specified in the request, including intermediate waypoints for existing trips.

vehicleDropoffEta

string (Timestamp format)

The complete vehicle's driving ETA to the drop off point specified in the request. The ETA includes any required visits for active trips that must be completed before the vehicle arrives at the dropoff point specified in the request. The value will only be populated when a dropoff point is specified in the request. An empty value indicates a failure in calculating the ETA for the vehicle to reach the dropoff point.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

vehiclePickupToDropoffDistanceMeters

integer

The vehicle's driving distance (in meters) from the pickup point to the dropoff point specified in the request. The distance is only between the two points and does not include the vehicle location or any other waypoints before the vehicle arrives at the pickup point or dropoff point. The value will only be populated when a dropoff point is specified in the request. An empty value indicates a failure in calculating the distance from the pickup to dropoff points specified in the request.

tripType

enum (TripTypeLog)

The trip type of the request that was used to calculate the ETA to the pickup point.

vehicleMatchType

enum (VehicleMatchTypeLog)

Type of the vehicle match.

requestedOrderedBy

enum (VehicleMatchOrderLog)

The method the caller requested for sorting vehicle matches.

orderedBy

enum (VehicleMatchOrderLog)

The actual method that is used to order this vehicle. Normally, this will match the 'order_by' field from the request. However, in certain circumstances such as a failure of Google Maps backends, a different method may be used (such as PICKUP_POINT_STRAIGHT_DISTANCE).