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