maree / elm-wasl
用于使用 elm wasl API 注册和跟踪车辆和司机的包 与沙特交通部科学服务公司服务连接
dev-main
2023-07-05 21:19 UTC
This package is auto-updated.
Last update: 2024-09-05 23:38:47 UTC
README
- 注意:使用 wasl IG 为派遣公司创建的 v2.18 包件可能在将来需要一些更新。
安装
您可以通过 Composer 安装此包。
composer require maree/elm-wasl
使用以下命令发布您的短信配置文件
php artisan vendor:publish --provider="maree\elmWasl\ElmWaslServiceProvider" --tag="elm-wasl"
然后从 config/elm-wasl.php 文件更改您的 elm-wasl 配置
"client-id" => "",//example ACD7A113-XXXX-4B68-B125-xxxxxxxxxx "app-id" => "", //example xd8e9xxx "app-key" => "", //example xx5784489c7147220924b4abb8xxxxxx
使用方法
waslRegisterDriverAndCar
- 将司机和车辆发送到 elm
use maree\elmWasl\elmWasl; elmWasl::waslRegisterDriverAndCar($identityNumber='',$dateOfBirthGregorian='',$emailAddress='',$mobileNumber='',$sequenceNumber='',$plateLetters='',$plateNumbers='',$plateType='');
- 注意:出生日期格式为 'Y-m-d'
- 注意:添加带有国家代码的手机号,例如:+9665000000000
- 注意:在车牌字母之间留空格,例如:'a b c'
- 注意:车牌类型存在于您收到的 API 文档中
$plateTypes = ['1' => 'خصوصي' ,'2' => 'نقل عام' ,'3' => 'نقل خاص' ,'4' => 'حافلة صغيرة عامة', '5' => 'حافلة صغيرة خاصة', '6' => 'اجرة' ,'7' => 'معدات ثقيلة', '8' => 'تصدير' ,'9' =>'دبلوماسي' ,'10' =>'دراجة نارية', '11' => 'مؤقت'];
waslCheckEligibility
- 检查我发送到 wasl 的司机和车辆信息是否被接受或拒绝或等待
use maree\elmWasl\elmWasl; elmWasl::waslCheckEligibility($identityNumber = '');
- 注意:您可以通过 cron job 每天或每12小时运行此服务以检查司机是否接受或拒绝,并在您的应用程序中更新他的状态
registerTrip
- 将完成的行程发送到 wasl,首先检查您是否已发送该行程
use maree\elmWasl\elmWasl; elmWasl::registerTrip($sequenceNumber ='',$driverId='',$tripId='',$distanceInMeters=0,$durationInSeconds=0,$customerRating=0.0,$customerWaitingTimeInSeconds=0,$originCityNameInArabic='',$destinationCityNameInArabic='',$originLatitude=0.0,$originLongitude=0.0,$destinationLatitude=0.0,$destinationLongitude=0.0,$pickupTimestamp='',$dropoffTimestamp='',$startedWhen='',$tripCost=0.0);
- 注意:$sequenceNumber 是车辆序列号 'الرقم التسلسلي'
registerCaptainsLocations
- 发送移动指挥官的更新位置
use maree\elmWasl\elmWasl; elmWasl::registerCaptainsLocations($driverIdentityNumber='',$vehicleSequenceNumber='',$latitude=0.0,$longitude=0.0,$hasCustomer=true,$updatedWhen='');
- 注意:您可以使用 cron job 每分钟运行该服务,或者您可以在更新司机位置 API '跟踪司机' 内部执行该服务,以每次司机位置更改时运行
注意
如果您有日期问题,您可以将其转换为以下格式
$pickupTimestamp = new DateTime($trip->pickupTimestamp, new DateTimeZone('Asia/Riyadh')); $pickupTimestamp = $pickupTimestamp->format(DateTime::ISO8601);
当前 elm wasl 服务
- waslRegisterDriverAndCar
- waslCheckEligibility
- registerTrip
- registerCaptainsLocations