guillaume-gagnaire/georide-api

访问Georide开放API的包装器

v1.1.0 2019-04-02 20:44 UTC

This package is auto-updated.

Last update: 2024-09-29 05:28:19 UTC


README

GeoRide是一款全功能的智能手机应用摩托车GPS追踪器。由于GeoRide有一个开放API,此包的目的是处理对开放API的请求,管理认证并提供一组与GeoRide API交互的类。

安装

composer require guillaume-gagnaire/georide-api

使用

<?php

use GuillaumeGagnaire\Georide\API\Client;
use GuillaumeGagnaire\Georide\API\ApiException;

try {
    // Get an instance of Georide API Client
    $georide = new Client();

    // Create a new session ...
    $georide->user->login('test@example.com', 'passw0rd');
    $authToken = $georide->getAuthToken();

    // or resume an existing session
    $georide->setAuthToken($authToken);

    /**
     * And then, you can call the API freely,
     * ex: get the trips from the first found tracker
     */
    $trackers = $georide->user->getTrackers();
    if (sizeof($trackers) === 0) {
        throw new Exception("No tracker configured.");
    }

    $tracker = $trackers[0];

    // Lock your motorcycle
    $tracker->lock();

    // Unlock your motorcycle
    $tracker->unlock();

    // Toggle the lock of your motorcycle
    $tracker->toggleLock();

    // Get the trips of your motorcycle
    $trips = $tracker->getTrips('2019-02-23', '2019-02-24');

    // Get the GPS positions of your motorcycle
    $positions = $tracker->getPositions('2019-02-23', '2019-02-24');
} catch (ApiException $e) {
    echo $e->getMessage();
} catch (Exception $e) {
    echo $e->getMessage();
}