carlosafonso/emt-sdk-php

Unofficial PHP SDK for Madrid's EMT OpenData API

emt-sdk-php

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

An unofficial PHP SDK for Madrid's municipal bus company (EMT) OpenData API., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require carlosafonso/emt-sdk-php, <sub>(*4)</sub>

## Usage

You'll need a set of authentication credentials issued by the EMT OpenData team. These credentials can be obtained here: http://opendata.emtmadrid.es/Formulario.

Create an instance of the SDK client passing the credentials described above:

```php
$clientId = 'FOO.BAR.BAZ';
$passkey = 'ABCDEFGH-1234-ABCD-1234-ABCDEFGHIJKL'
$client = new Afonso\Emt\BusClient($clientId, $passkey);

Then call any of the available methods:, <sub>(*5)</sub>

$data = $client->getRouteLines([123], new \DateTime());
print_r($data);

Which should output something like this (truncated for readability):, <sub>(*6)</sub>

Array
(
    [0] => stdClass Object
        (
            [line] => 123
            [secDetail] => 10
            [orderDetail] => 1
            [node] => 1425
            [distance] => 0
            [distancePreviousStop] => 0
            [name] => PZA.DE LEGAZPI-MAESTRO ARBOS
            [latitude] => 40.390813555735
            [longitude] => -3.6951516754786
        )

    [1] => stdClass Object
        (
            [line] => 123
            [secDetail] => 10
            [orderDetail] => 1
            [node] => 930
            [distance] => 839
            [distancePreviousStop] => 839
            [name] => ANTONIO LOPEZ-AV.CORDOBA
            [latitude] => 40.386984182818
            [longitude] => -3.6982344337479
        )
)

Each web service has its own client implementation:, <sub>(*7)</sub>

$busClient = new Afonso\Emt\BusClient($clientId, $passkey);
$geoClient = new Afonso\Emt\GeoClient($clientId, $passkey);

/* (additional clients are on the works) */

Available methods

The current version of this library exposes all API endpoints from the BUS web service (http://opendata.emtmadrid.es/Servicios-web/BUS)., <sub>(*8)</sub>

Additional services are expected to be implemented soon., <sub>(*9)</sub>

Change log

Please see CHANGELOG for more information on what has changed recently., <sub>(*10)</sub>

Testing

bash $ composer test, <sub>(*11)</sub>

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*12)</sub>

Security

If you discover any security related issues, please email carlos.afonso.perez@gmail.com instead of using the issue tracker., <sub>(*13)</sub>

Credits

• Carlos Afonso
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*14)</sub>