GET /estimates/time
¶ Time Estimates
The Time Estimates endpoint returns ETAs for all products currently available at a given location, with the ETA for each product expressed as integers in seconds. If a product returned from GET /v1.2/products is not returned from this endpoint for a given latitude/longitude pair then there are currently none of that product available to request. We recommend that this endpoint be called every minute to provide the most accurate, up-to-date ETAs.
In some markets, the list of products returned from this endpoint may vary by the time of day due to time restrictions on when that product may be utilized.
¶ Resource
GET /v1.2/estimates/time
¶ Authorization
OAuth 2.0 user access token with any valid scope.
¶ Query Parameters
Name | Type | Description |
---|---|---|
start_latitude |
float |
Latitude component. |
start_longitude |
float |
Longitude component. |
product_id (optional) |
string |
Unique identifier representing a specific product for a given latitude & longitude. |
¶ Example Request
To use a bearer token:
curl -H 'Authorization: Bearer <TOKEN>' \
-H 'Accept-Language: en_US' \
-H 'Content-Type: application/json' \
'https://api.uber.com/v1.2/estimates/time?start_latitude=37.7752315&start_longitude=-122.418075'
¶ Response
Status-Code: 200 OK
{
"times": [
{
"localized_display_name": "POOL",
"estimate": 60,
"display_name": "POOL",
"product_id": "26546650-e557-4a7b-86e7-6a3942445247"
},
{
"localized_display_name": "uberX",
"estimate": 60,
"display_name": "uberX",
"product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d"
},
{
"localized_display_name": "uberXL",
"estimate": 240,
"display_name": "uberXL",
"product_id": "821415d8-3bd5-4e27-9604-194e4359a449"
},
{
"localized_display_name": "SELECT",
"estimate": 240,
"display_name": "SELECT",
"product_id": "57c0ff4e-1493-4ef9-a4df-6b961525cf92"
},
{
"localized_display_name": "BLACK",
"estimate": 240,
"display_name": "BLACK",
"product_id": "d4abaae7-f4d6-4152-91cc-77523e8165a4"
},
{
"localized_display_name": "SUV",
"estimate": 240,
"display_name": "SUV",
"product_id": "8920cb5e-51a4-4fa4-acdf-dd86c5e18ae0"
},
{
"localized_display_name": "ASSIST",
"estimate": 300,
"display_name": "ASSIST",
"product_id": "ff5ed8fe-6585-4803-be13-3ca541235de3"
},
{
"localized_display_name": "TAXI",
"estimate": 480,
"display_name": "TAXI",
"product_id": "3ab64887-4842-4c8e-9780-ccecd3a0391d"
}
]
}
Name | Type | Description |
---|---|---|
product_id |
string |
Unique identifier representing a specific product for a given latitude & longitude. For example, uberX in San Francisco will have a different product_id than uberX in Los Angeles. |
localized_display_name |
string |
Localized display name of product. |
display_name |
string |
Display name of product. |
estimate |
int |
ETA for the product (in seconds). Always show estimate in minutes. |
¶ Error Responses
Status-Code: 422 Unprocessable Entity
{
"fields": {
"start_longitude": "Required",
"start_latitude": "Required"
},
"message": "Invalid request",
"code": "validation_failed"
}