Skip to content
BranchesTags

Repository files navigation

uber

Uber API client in Go

Table of contents

Requirements:

To use client v1, you'll need to set

  • UBER_TOKEN_KEY

API Completion Status

To see the almost one-to-one mapping of this API client to the Uber REST API, see file completion_status.md

SDK usage

Sample usage: You can see file example_test.go

  • Preamble:
import (
"fmt""log""github.com/orijtech/uber/v1"
)
  • Request a ride:
funcrequestARide() {
client, err:=uber.NewClientFromOAuth2File("./testdata/.uber/credentials.json")
iferr!=nil {
log.Fatal(err)
}
ride, err:=client.RequestRide(&uber.RideRequest{
StartLatitude: 37.7752315,
StartLongitude: -122.418075,
EndLatitude: 37.7752415,
EndLongitude: -122.518075,
PromptOnFare: func(fare*uber.UpfrontFare) error {
iffare.Fare.Value>=6.00 {
returnfmt.Errorf("exercise can't hurt instead of $6.00 for that walk!")
}
returnnil
},
})
iferr!=nil {
log.Fatalf("ride request err: %v", err)
}
fmt.Printf("Your ride information: %+v\n", ride)
}
  • List my payment methods
funcallMyPayments() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
listings, err:=client.ListPaymentMethods()
iferr!=nil {
log.Fatal(err)
}
fmt.Printf("LastUsedD: %v\n", listings.LastUsedID)
fori, method:=rangelistings.Methods {
fmt.Printf("#%d: ID: %q PaymentMethod: %q Description: %q\n",
i, method.ID, method.PaymentMethod, method.Description)
}
}
  • List all my history
funcsearchingForFirstEdmontonTrip() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
pagesChan, cancelPaging, err:=client.ListAllMyHistory()
iferr!=nil {
log.Fatal(err)
}
forpage:=rangepagesChan {
ifpage.Err!=nil {
fmt.Printf("Page: #%d err: %v\n", page.PageNumber, page.Err)
continue
}
fmt.Printf("Page: #%d\n\n", page.PageNumber)
fori, trip:=rangepage.Trips {
startCity:=trip.StartCityifstartCity.Name=="Edmonton" {
fmt.Printf("aha found the trip from Edmonton, canceling the rest!: %#v\n", trip)
cancelPaging()
break
}
// Otherwise, continue listingfmt.Printf("Trip: #%d ==> %#v place: %#v\n", i, trip, startCity)
}
}
}
  • Use a promo code for your account
funcapplyPromoCode() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
appliedPromoCode, err:=client.ApplyPromoCode("uberd340ue")
iferr!=nil {
log.Fatal(err)
}
fmt.Printf("AppliedPromoCode: %#v\n", appliedPromoCode)
}
  • Retrieve your profile
funcretrieveMyProfile() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
myProfile, err:=client.RetrieveMyProfile()
iferr!=nil {
log.Fatal(err)
}
fmt.Printf("Here is my profile: %#v\n", myProfile)
}
  • Get price estimates
funcgetPriceEstimates() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
estimatesPageChan, cancelPaging, err:=client.EstimatePrice(&uber.EstimateRequest{
StartLatitude: 37.7752315,
EndLatitude: 37.7752415,
StartLongitude: -122.418075,
EndLongitude: -122.518075,
SeatCount: 2,
})
iferr!=nil {
log.Fatal(err)
}
itemCount:=uint64(0)
forpage:=rangeestimatesPageChan {
ifpage.Err!=nil {
fmt.Printf("PageNumber: #%d err: %v", page.PageNumber, page.Err)
continue
}
fori, estimate:=rangepage.Estimates {
itemCount+=1fmt.Printf("Estimate: #%d ==> %#v\n", i, estimate)
}
ifitemCount>=23 {
cancelPaging()
}
}
}
  • Get time estimates
funcgetTimeEstimates() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
estimatesPageChan, cancelPaging, err:=client.EstimateTime(&uber.EstimateRequest{
StartLatitude: 37.7752315,
EndLatitude: 37.7752415,
StartLongitude: -122.418075,
EndLongitude: -122.518075,
// Comment out to search only for estimates for: uberXL// ProductID: "821415d8-3bd5-4e27-9604-194e4359a449",
})
iferr!=nil {
log.Fatal(err)
}
itemCount:=uint64(0)
forpage:=rangeestimatesPageChan {
ifpage.Err!=nil {
fmt.Printf("PageNumber: #%d err: %v", page.PageNumber, page.Err)
continue
}
fori, estimate:=rangepage.Estimates {
itemCount+=1fmt.Printf("Estimate: #%d ==> %#v\n", i, estimate)
}
ifitemCount>=23 {
cancelPaging()
}
}
}
  • Retrieve a receipt
funcretrieveReceipt() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
receipt, err:=client.RequestReceipt("b5512127-a134-4bf4-b1ba-fe9f48f56d9d")
iferr!=nil {
log.Fatal(err)
}
fmt.Printf("That receipt: %#v\n", receipt)
}
  • Retrieve your home address
funcretrieveMyHomeAddress() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
place, err:=client.Place(uber.PlaceHome)
iferr!=nil {
log.Fatal(err)
}
fmt.Printf("My home address: %#v\n", place.Address)
}
  • Retrieve your work address
funcretrieveMyWorkAddress() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
place, err:=client.Place(uber.PlaceWork)
iferr!=nil {
log.Fatal(err)
}
fmt.Printf("My work address: %#v\n", place.Address)
}
  • Update your home address
funcupdateMyHomeAddress() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
updatedHome, err:=client.UpdatePlace(&uber.PlaceParams{
Place: uber.PlaceHome,
Address: "685 Market St, San Francisco, CA 94103, USA",
})
iferr!=nil {
log.Fatal(err)
}
fmt.Printf("My updated home address: %#v\n", updatedHome)
}
  • Update your work address
funcupdateMyWorkAddress() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
updatedWork, err:=client.UpdatePlace(&uber.PlaceParams{
Place: uber.PlaceWork,
Address: "685 Market St, San Francisco, CA 94103, USA",
})
iferr!=nil {
log.Fatalf("work failed; %v", err)
}
fmt.Printf("My updated work address: %#v\n", updatedWork)
}
  • Retrieve the map for a trip
funcrequestMap() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
tripMapInfo, err:=client.RequestMap("b5512127-a134-4bf4-b1ba-fe9f48f56d9d")
iferr!=nil {
log.Fatal(err)
}
fmt.Printf("Visit the URL: %q for more information\n", tripMapInfo.URL)
}
  • Open the map for a trip in your web browser
funcopenTheTripInBrowser() {
client, err:=uber.NewClient()
iferr!=nil {
log.Fatal(err)
}
iferr:=client.OpenMapForTrip("b5512127-a134-4bf4-b1ba-fe9f48f56d9d"); err!=nil {
log.Fatal(err)
}
}
  • Request a delivery
funcrequestDelivery() {
client, err:=uber.NewClientFromOAuth2File("./testdata/.uber/credentials.json")
iferr!=nil {
log.Fatal(err)
}
deliveryConfirmation, err:=client.RequestDelivery(&uber.DeliveryRequest{
Pickup: &uber.Endpoint{
Contact: &uber.Contact{
CompanyName: "orijtech",
Email: "deliveries@orijtech.com",
SendSMSNotifications: true,
},
Location: &uber.Location{
PrimaryAddress: "Empire State Building",
State: "NY",
Country: "US",
},
SpecialInstructions: "Please ask guest services for \"I Man\"",
},
Dropoff: &uber.Endpoint{
Contact: &uber.Contact{
FirstName: "delivery",
LastName: "bot",
CompanyName: "Uber",
SendEmailNotifications: true,
},
Location: &uber.Location{
PrimaryAddress: "530 W 113th Street",
SecondaryAddress: "Floor 2",
Country: "US",
PostalCode: "10025",
State: "NY",
},
},
Items: []*uber.Item{
{
Title: "phone chargers",
Quantity: 10,
},
{
Title: "Blue prints",
Fragile: true,
Quantity: 1,
},
},
})
iferr!=nil {
log.Fatal(err)
}
log.Printf("The confirmation: %+v\n", deliveryConfirmation)
}
  • Cancel a delivery
funccancelDelivery() {
client, err:=uber.NewClientFromOAuth2File("./testdata/.uber/credentials.json")
iferr!=nil {
log.Fatal(err)
}
err:=client.CancelDelivery("71a969ca-5359-4334-a7b7-5a1705869c51")
iferr==nil {
log.Printf("Successfully canceled that delivery!")
} else {
log.Printf("Failed to cancel that delivery, err: %v", err)
}
}

CLI

Installation

$ goget-u-vgithub.com/orijtech/uber/cmd/uber

init

init initializes the context and authorization for your Uber app in the current working directory

$ go get -u -v github.com/orijtech/uber/cmd/uber
$ uber init
Please visit this URL for the auth dialog: https://login.uber.com/oauth/v2/authorize?access_type=offline&client_id=a_client_id&redirect_uri=https%3A%2F%2Fexample.org/uber&response_type=code&scope=profile+request+history+places+request_receipt+delivery&state=15004223370.604660

which after successful authorization will give you a notice in your browser, to return to your terminal and will save the token to a file on disk, for example:

Successfully saved your OAuth2.0 token to "/Users/orijtech/uber-account/.uber/credentials.json"

From then on, for that Uber account, please go into that directory "/Users/orijtech/uber-account/" in order to use that account

history

history allows you to retrieve and examine your previous trips in a tabular form

$ uber history -h

for all available options.

  • List your last 3 trips
$ uber history --limit-per-page 3 --max-page 1
Page: #1
+--------+---------------+-------------------------+----------+-------+--------------------------------------+
| TRIP # | CITY | DATE | DURATION | MILES | REQUESTID |
+--------+---------------+-------------------------+----------+-------+--------------------------------------+
| 1 | Denver | 2017/07/15 21:47:44 MDT | 7m31s | 3.211 | 8e7f479c-63e2-4ccc-babd-8671771485c3 |
+--------+---------------+-------------------------+----------+-------+--------------------------------------+
| 2 | San Francisco | 2017/07/13 18:11:06 MDT | 14m16s | 3.694 | d521aed9-e9bc-4673-9109-25d9ce5c434c |
+--------+---------------+-------------------------+----------+-------+--------------------------------------+
| 3 | London | 2017/06/25 16:17:43 MDT | 13m35s | 3.318 | 1ce3cccb-2e09-4920-ad80-d00a4645f9ce |
+--------+---------------+-------------------------+----------+-------+--------------------------------------+

order

order allows you to order an Uber to any location and destination

$ uber order
Start Point: Redwood City Cinemark
+--------+--------------------------------+-----------+-----------+-------------+
| CHOICE | NAME | RELEVANCE | LATITUDE | LONGITUDE |
+--------+--------------------------------+-----------+-----------+-------------+
| 0 | Cinemark 20 Redwood City, | 98.70% | 37.485912 | -122.228752 ||| 825 Middlefield Rd, Redwood |||||| City, California 94063, United |||||| States ||||
+--------+--------------------------------+-----------+-----------+-------------+
| 1 | Redwood City, California, | 49.00% | 37.485199 | -122.236397 ||| United States ||||
+--------+--------------------------------+-----------+-----------+-------------+
| 2 | Redwood City Station, 805 | 39.00% | 37.485439 | -122.231796 ||| Veterans Blvd, Redwood City, |||||| California 94063, United |||||| States ||||
+--------+--------------------------------+-----------+-----------+-------------+
| 3 | Cinemark Ave, Markham, Ontario | 39.00% | 43.887989 | -79.225441 ||| L6B 1E3, Canada ||||
+--------+--------------------------------+-----------+-----------+-------------+
| 4 | Cinemark Ct, Mulberry, Florida | 39.00% | 27.934687 | -81.996933 ||| 33860, United States ||||
+--------+--------------------------------+-----------+-----------+-------------+
Please enter your choice by numeric key or (n) to search again: 0
End Point: Palo Alto +--------+--------------------------------+-----------+-----------+-------------+
| CHOICE | NAME | RELEVANCE | LATITUDE | LONGITUDE |
+--------+--------------------------------+-----------+-----------+-------------+
| 0 | Palo Alto, California, United | 99.00% | 37.442200 | -122.163399 ||| States ||||
+--------+--------------------------------+-----------+-----------+-------------+
| 1 | Palo Alto Battlefield National | 99.00% | 26.021400 | -97.480598 ||| Historical Park, 7200 PAREDES |||||| LINE Rd, Los Fresnos, Texas |||||| 78566, United States ||||
+--------+--------------------------------+-----------+-----------+-------------+
| 2 | Palo Alto Baylands Nature | 99.00% | 37.459599 | -122.106003 ||| Preserve, 2500 Embarcadero |||||| Way, East Palo Alto, |||||| California 94303, United |||||| States ||||
+--------+--------------------------------+-----------+-----------+-------------+
| 3 | Palo Alto University, 1791 | 99.00% | 37.382301 | -122.188004 ||| Arastradero Rd, Palo Alto, |||||| California 94304, United |||||| States ||||
+--------+--------------------------------+-----------+-----------+-------------+
| 4 | Palo Alto High School, 50 | 99.00% | 37.437000 | -122.156998 ||| Embarcadero Rd, Palo Alto, |||||| California 94306, United |||||| States ||||
+--------+--------------------------------+-----------+-----------+-------------+
Please enter your choice by numeric key or (n) to search again: 0
Seat count: 1 or 2 (default 2) 1
+--------+--------+----------+----------+----------------------+--------------------+
| CHOICE | NAME | ESTIMATE | CURRENCY | PICKUP ETA (MINUTES) | DURATION (MINUTES) |
+--------+--------+----------+----------+----------------------+--------------------+
| 0 | SELECT |$31-39 | USD | 3.0 | 22.0 |
+--------+--------+----------+----------+----------------------+--------------------+
| 1 | ASSIST |$15-19 | USD | 10.0 | 22.0 |
+--------+--------+----------+----------+----------------------+--------------------+
| 2 | uberXL |$19-24 | USD | 12.0 | 22.0 |
+--------+--------+----------+----------+----------------------+--------------------+
| 3 | BLACK |$40-50 | USD | 5.0 | 22.0 |
+--------+--------+----------+----------+----------------------+--------------------+
| 4 | SUV |$53-65 | USD | 5.0 | 22.0 |
+--------+--------+----------+----------+----------------------+--------------------+
| 5 | WAV |$13-16 | USD | 0.0 | 22.0 |
+--------+--------+----------+----------+----------------------+--------------------+
| 6 | POOL |$6-8 | USD | 9.0 | 22.0 |
+--------+--------+----------+----------+----------------------+--------------------+
| 7 | uberX |$15-19 | USD | 8.0 | 22.0 |
+--------+--------+----------+----------+----------------------+--------------------+
Please enter the choice of your item or n to cancel

payments

payments allows you to list your payments

$ uber payments
+------------+--------------------------------------+-------------+----------+
| METHOD | ID | DESCRIPTION | LASTUSED |
+------------+--------------------------------------+-------------+----------+
| visa | 9a152688-e81c-4a17-91f4-27bde532b7f1 |***48 | ✔️ |
+------------+--------------------------------------+-------------+----------+
| visa | 83634d20-9036-4797-87e2-fb8dcf574b7b |***39 ||
+------------+--------------------------------------+-------------+----------+
| unknown | 3c4b8f3c-6924-426f-b837-c3aba3a2eecb |||
+------------+--------------------------------------+-------------+----------+
| mastercard | 90b24751-8414-4e72-be33-d245f42f4be1 |***31 ||
+------------+--------------------------------------+-------------+----------+

profile

profile allows you to retrieve information about your profile

$ uber profile
+-----------------+--------------------------------------------------------------------------------------------------------------------------------------+
| KEY | VALUE |
+-----------------+--------------------------------------------------------------------------------------------------------------------------------------+
| email | uberdevelopers@gmail.com |
+-----------------+--------------------------------------------------------------------------------------------------------------------------------------+
| first_name | Uber |
+-----------------+--------------------------------------------------------------------------------------------------------------------------------------+
| last_name | Developer |
+-----------------+--------------------------------------------------------------------------------------------------------------------------------------+
| mobile_verified |true|
+-----------------+--------------------------------------------------------------------------------------------------------------------------------------+
| picture | https://d1w2poirtb3as9.cloudfront.net/f3be498cb0bbf570aa3d.jpeg |
+-----------------+--------------------------------------------------------------------------------------------------------------------------------------+
| promo_code | uberd340ue |
+-----------------+--------------------------------------------------------------------------------------------------------------------------------------+
| rider_id | 8OlTlUG1TyeAQf1JiBZZdkKxuSSOUwu2IkO0Hf9d2HV52Pm25A0NvsbmbnZr85tLVi-s8CckpBK8Eq0Nke4X-no3AcSHfeVh6J5O6LiQt5LsBZDSi4qyVUdSLeYDnTtirw== |
+-----------------+--------------------------------------------------------------------------------------------------------------------------------------+
| uuid | f4a416e3-6016-4623-8ec9-d5ee105a6e27 |
+-----------------+--------------------------------------------------------------------------------------------------------------------------------------+

About

Uber API client

Topics

golangtripuberuber-api

Resources

Readme
Apache-2.0 license
Activity
Custom properties

Stars

27 stars

Watchers

2 watching

Forks

13 forks
Report repository

Releases

Packages

Contributors

Languages