uber php 2021

優步 PHP 用戶端

透過作曲家

$ composer require stevenmaguire/uber-php

用法

創建客戶端

 $ client = new Stevenmaguire  Uber  Client ( array (
    ' access_token ' => ' YOUR ACCESS TOKEN ' ,
    ' server_token ' => ' YOUR SERVER TOKEN ' ,
    ' use_sandbox '  => true , // optional , default false
    ' version '      => ' v1.2 ' , // optional , default 'v1.2'
    ' locale '       => ' en_US ' , // optional , default 'en_US'
));

獲取產品

按地點：

 $ products = $ client -> getProducts ( array (
    ' latitude ' => ' 41.85582993 ' ,
    ' longitude ' => ' -87.62730337 '
));

按 ID：

 $ product = $ client -> getProduct ( $ productId );

取得預估價格

 $ estimates = $ client -> getPriceEstimates ( array (
    ' start_latitude ' => ' 41.85582993 ' ,
    ' start_longitude ' => ' -87.62730337 ' ,
    ' end_latitude ' => ' 41.87499492 ' ,
    ' end_longitude ' => ' -87.67126465 '
));

取得時間估計

 $ estimates = $ client -> getTimeEstimates ( array (
    ' start_latitude ' => ' 41.85582993 ' ,
    ' start_longitude ' => ' -87.62730337 '
));

獲取促銷訊息

 $ promotions = $ client -> getPromotions ( array (
    ' start_latitude ' => ' 41.85582993 ' ,
    ' start_longitude ' => ' -87.62730337 ' ,
    ' end_latitude ' => ' 41.87499492 ' ,
    ' end_longitude ' => ' -87.67126465 '
));

取得用戶活動

此功能僅從1.1版本開始可用。

 $ client -> setVersion ( ' v1.2 ' ); // or v1 .1
$ history = $ client -> getHistory ( array (
    ' limit ' => 50 , // optional
    ' offset ' => 0 // optional
));

取得用戶資料

 $ profile = $ client -> getProfile ();

更新使用者資料

 $ attributes = array ( ' applied_promotion_codes ' => ' PROMO_CODE ' );
$ profileResponse = $ client -> setProfile ( $ attributes );

取得付款方式

 $ paymentMethods = $ client -> getPaymentMethods ();

獲得位置

 $ placeId = ' home ' ;
$ place = $ client -> getPlace ( $ placeId );

更新地點

 $ placeId = ' home ' ;
$ attributes = array ( ' address ' => ' 685 Market St, San Francisco, CA 94103, USA ' );
$ place = $ client -> setPlace ( $ placeId , $ attributes );

叫車

 $ request = $ client -> requestRide ( array (
    ' start_latitude ' => ' 41.85582993 ' ,
    ' start_longitude ' => ' -87.62730337 ' ,
    ' end_latitude ' => ' 41.87499492 ' ,
    ' end_longitude ' => ' -87.67126465 ' ,
    ' product_id ' => ' 4bfc6c57-98c0-424f-a72e-c1e2a1d49939 ' , // Optional
    ' surge_confirmation_id ' => ' e100a670 ' ,                  // Optional
    ' payment_method_id ' => ' a1111c8c-c720-46c3-8534-2fcd '   // Optional
));

預付費用

突波確認流程

 try {
    $ request = $ client -> requestRide ( array (
        ' product_id ' => ' 4bfc6c57-98c0-424f-a72e-c1e2a1d49939 ' ,
        ' start_latitude ' => ' 41.85582993 ' ,
        ' start_longitude ' => ' -87.62730337 ' ,
        ' end_latitude ' => ' 41.87499492 ' ,
        ' end_longitude ' => ' -87.67126465 '
    ));
} catch ( Stevenmaguire  Uber  Exception $ e ) {
    $ body = $ e -> getBody ();
    $ surgeConfirmationId = $ body [ ' meta ' ][ ' surge_confirmation ' ][ ' surge_confirmation_id ' ];
}

取得目前行程詳情

 $ request = $ client -> getCurrentRequest ();

取得乘車詳情

 $ request = $ client -> getRequest ( $ requestId );

更新目前行程詳情

 $ requestDetails = array (
    ' end_address ' => ' 685 Market St, San Francisco, CA 94103, USA ' ,
    ' end_nickname ' => ' da crib ' ,
    ' end_place_id ' => ' home ' ,
    ' end_latitude ' => ' 41.87499492 ' ,
    ' end_longitude ' => ' -87.67126465 '
);

$ updateRequest = $ client -> setCurrentRequest ( $ requestDetails );

更新乘車詳情

 $ requestId = ' 4bfc6c57-98c0-424f-a72e-c1e2a1d49939 '
$ requestDetails = array (
    ' end_address ' => ' 685 Market St, San Francisco, CA 94103, USA ' ,
    ' end_nickname ' => ' da crib ' ,
    ' end_place_id ' => ' home ' ,
    ' end_latitude ' => ' 41.87499492 ' ,
    ' end_longitude ' => ' -87.67126465 '
);

$ updateRequest = $ client -> setRequest ( $ requestId , $ requestDetails );

取得行程預估

 $ requestEstimate = $ client -> getRequestEstimate ( array (
    ' product_id ' => ' 4bfc6c57-98c0-424f-a72e-c1e2a1d49939 ' ,
    ' start_latitude ' => ' 41.85582993 ' ,
    ' start_longitude ' => ' -87.62730337 ' ,
    ' end_latitude ' => ' 41.87499492 ' , // optional
    ' end_longitude ' => ' -87.67126465 ' , // optional
));

取得乘車地圖

 $ map = $ client -> getRequestMap ( $ requestId );

取得乘車收據

 $ receipt = $ client -> getRequestReceipt ( $ requestId );

取消目前行程

 $ request = $ client -> cancelCurrentRequest ();

取消乘車

 $ request = $ client -> cancelRequest ( $ requestId );

建立提醒

 $ attributes = array (
    ' reminder_time ' => ' 1429294463 ' ,
    ' phone_number ' => ' 555-555-5555 ' ,
    ' event ' => array (
        ' time ' => ' 1429294463 ' ,
        ' name ' => ' Frisbee with friends ' ,
        ' location ' => ' Dolores Park ' ,
        ' latitude ' => ' 37.759773 ' ,
        ' longitude ' => ' -122.427063 ' ,
    ),
    ' product_id ' => ' a1111c8c-c720-46c3-8534-2fcdd730040d ' ,
    ' trip_branding ' => array (
        ' link_text ' => ' View team roster ' ,
        ' partner_deeplink ' => ' partner://team/9383 ' ,
    )
);
$ reminder = $ client -> createReminder ( $ attributes );

取得提醒

 $ reminderId = ' 4bfc6c57-98c0-424f-a72e-c1e2a1d49939 ' ;
$ reminder = $ client -> getReminder ( $ reminderId );

更新提醒

 $ reminderId = ' 4bfc6c57-98c0-424f-a72e-c1e2a1d49939 ' ;
$ attributes = array (
    ' reminder_time ' => ' 1429294463 ' ,
    ' phone_number ' => ' 555-555-5555 ' ,
    ' event ' => array (
        ' time ' => ' 1429294463 ' ,
        ' name ' => ' Frisbee with friends ' ,
        ' location ' => ' Dolores Park ' ,
        ' latitude ' => ' 37.759773 ' ,
        ' longitude ' => ' -122.427063 ' ,
    ),
    ' product_id ' => ' a1111c8c-c720-46c3-8534-2fcdd730040d ' ,
    ' trip_branding ' => array (
        ' link_text ' => ' View team roster ' ,
        ' partner_deeplink ' => ' partner://team/9383 ' ,
    )
);
$ reminder = $ client -> setReminder ( $ reminderId , $ attributes );

取消提醒

 $ reminderId = ' 4bfc6c57-98c0-424f-a72e-c1e2a1d49939 ' ;
$ reminder = $ client -> cancelReminder ( $ reminderId );

取得駕駛員資料

 $ profile = $ client -> getDriverProfile ();

獲取司機付款

 $ profile = $ client -> getDriverPayments ( array (
    ' limit ' => 50 , // optional
    ' offset ' => 0 // optional
));

取得司機行程

 $ profile = $ client -> getDriverTrips ( array (
    ' limit ' => 50 , // optional
    ' offset ' => 0 // optional
));

速率限制

 $ product = $ client -> getProduct ( $ productId );

$ rateLimit = $ client -> getRateLimit ();

$ rateLimit -> getLimit ();        // Rate limit capacity per period
$ rateLimit -> getRemaining ();    // Requests remaining in current period
$ rateLimit -> getReset ();        // Timestamp in UTC time when the next period will begin

使用沙箱

 $ request = $ client -> requestRide ( array (
    ' product_id ' => ' 4bfc6c57-98c0-424f-a72e-c1e2a1d49939 ' ,
    ' start_latitude ' => ' 41.85582993 ' ,
    ' start_longitude ' => ' -87.62730337 ' ,
    ' end_latitude ' => ' 41.87499492 ' ,
    ' end_longitude ' => ' -87.67126465 '
));

$ updateRequest = $ client -> setSandboxRequest ( $ request -> request_id , array ( ' status ' => ' accepted ' ));

 $ product = $ client -> getProduct ( $ productId );

$ updateProduct = $ client -> setSandboxProduct ( $ productId , array ( ' surge_multiplier ' => 2.2 , ' drivers_available ' => false ));

測試

$ ./vendor/bin/phpunit