On-demand Rides and Deliveries Solution is currently available only to select partners. Contact sales to learn more.

Method: archive.providers.trips.list

Stay organized with collections Save and categorize content based on your preferences.

Lists all trips within a given area and a given time window. Only trips with any activity during the time window will be returned.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters



Required. Must be in the format providers/{provider}. The provider must be the Project ID (for example, sample-cloud-project) of the Google Cloud Project of which the service account making this call is a member.

Query parameters


object (RequestHeader)

Optional. The standard Fleet Engine request header.



Optional. Name of the Cloud Logging sink dataset.


object (TimeWindow)

Required. The time window for which to list trips. Only trips that had at least one update performed during the time window will be returned.


object (Viewport)

Required. The viewport for which to list trips. Only trips that had at least one update performed within the viewport will be returned.



Optional. The maximum number of trips to return. The service may return fewer than this value. If unspecified, the server will decide the number of results to return.



Optional. A page token, received from a previous ListTrips call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListTrips must match the call that provided the page token.



Optional. A filter query to apply when listing trips. See http://aip.dev/160 for examples of the filter syntax. If you don't specify a value, or if you specify an empty string for the filter, then all trips will be returned.


string (FieldMask format)

Optional. A field mask that indicates which updates to Trip fields to list. Note that this may result in multiple instances for the same Trip to be included in the response, one for each time a field from the mask was changed in the instance. If a mask is not specified then only the latest instance of a Trip will be included in the response.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".


string (Int64Value format)

Optional. This parameter is used to limit BigQuery costs. Limits the bytes billed for this request. Requests with bytes billed above this limit will fail (without incurring a charge). If the parameter is not specified, the system uses the default project limit set by BigQuery. This is either unlimited, or whatever you have specified as your project default with BigQuery. See BigQuery documentation for details.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

trips.list response message. Next id: 3

JSON representation
  "trips": [
      object (Trip)
  "nextPageToken": string

object (Trip)

The list of trips for the requested time window and area. The trip entities represent the latest state within the time window.



Pass this token in the ListTripsRequest to continue to list results. If all results have been returned, this field is an empty string or not present in the response.