PHPackages                             jhamnerx/wialon-api-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. jhamnerx/wialon-api-php

ActiveLibrary[API Development](/categories/api)

jhamnerx/wialon-api-php
=======================

PHP client for the Wialon API.

04PHP

Since Oct 23Pushed 6mo agoCompare

[ Source](https://github.com/Jhamnerx/wialon-api-php)[ Packagist](https://packagist.org/packages/jhamnerx/wialon-api-php)[ RSS](/packages/jhamnerx-wialon-api-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

jhamnerx/wialon-api-php
=======================

[](#jhamnerxwialon-api-php)

Cliente PHP para la API de Wialon.

> **Nota:** Este paquete es un fork de [xint0/wialon-php](https://gitlab.com/xint0-open-source/wialon-php) publicado únicamente para uso personal en proyectos propios. Se le han realizado mejoras y actualizaciones específicas para necesidades particulares.

Instalación
-----------

[](#instalación)

### Requisitos

[](#requisitos)

- PHP 8.1 o superior.
- Implementación de cliente HTTP PSR-18.

### Instalar usando Composer

[](#instalar-usando-composer)

Instalar con el adaptador Guzzle 7:

```
composer require jhamnerx/wialon-api-php php-http/guzzle7-adapter
```

Si ya tienes un cliente PSR-18 en tu proyecto, puedes instalar solo el cliente de la API de Wialon:

```
composer require jhamnerx/wialon-api-php
```

Cómo usar
---------

[](#cómo-usar)

### Autenticación con token

[](#autenticación-con-token)

Primero sigue las instrucciones en la documentación del SDK de Wialon para obtener un token de autenticación.

### Iniciar sesión en el servicio Wialon

[](#iniciar-sesión-en-el-servicio-wialon)

```
use Jhamnerx\WialonApiPhp\Wialon;
use Jhamnerx\WialonApiPhp\WialonException;

// Puedes especificar un host personalizado.
$baseUri = 'https://hst-api.wialon.com';

$wialon = new Wialon($baseUri);

try {
    $token = 'tu token de autenticación';
    $wialon->login($token);
    // Después de iniciar sesión se retorna un ID de sesión.
    $wialon->sessionId();
} catch (WialonException $exception) {
    // WialonException se lanza cuando la petición falla o el servicio retorna un error.
}
```

### Cerrar sesión

[](#cerrar-sesión)

```
use Jhamnerx\WialonApiPhp\Wialon;
use Jhamnerx\WialonApiPhp\WialonException;

$token = 'token';

$wialon = new Wialon();

$wialon->login($token);
$wialon->logout();

$wialon->sessionId(); // Retorna `null` después de cerrar sesión.
```

### Obtener unidad por nombre

[](#obtener-unidad-por-nombre)

```
use Jhamnerx\WialonApiPhp\Wialon;
use Jhamnerx\WialonApiPhp\WialonException;

$token = 'token';

$wialon = new Wialon();

$wialon->login($token);

$data = $wialon->unitByName('Nombre de unidad'); // Retorna un array asociativo con los datos de respuesta.
```

### Obtener ubicación por coordenadas

[](#obtener-ubicación-por-coordenadas)

```
use Jhamnerx\WialonApiPhp\Wialon;
use Jhamnerx\WialonApiPhp\WialonException;

$token = 'token';

$wialon = new Wialon();

$wialon->login($token);

$longitude = -111.004287;
$latitude = 30.6141861;
$format = '32100';
$data = $wialon->getLocations($longitude, $latitude, $format); // Retorna un array asociativo con los datos de respuesta.

/*
$data == ["Magdalena, Sonora, Mexico"]
*/
```

### Buscar múltiples unidades por IDs

[](#buscar-múltiples-unidades-por-ids)

```
use Jhamnerx\WialonApiPhp\Wialon;

$wialon = new Wialon();
$wialon->login($token);

// Array de IDs de dispositivos
$devices_actives = ['123456', '789012', '345678'];

// Convertir a string con separador |
$propValueMask = implode('|', $devices_actives); // "123456|789012|345678"

// Buscar todas las unidades con esos IDs
$response = $wialon->searchItems('avl_unit', 'sys_id', $propValueMask);

// $response['items'] contendrá todas las unidades que coincidan
```

Licencia
--------

[](#licencia)

El cliente de la API de Wialon es software de código abierto licenciado bajo la [licencia MIT](https://github.com/jhamnerx/wialon-api-php/blob/main/LICENSE).

Créditos
--------

[](#créditos)

Este paquete es un fork de [xint0/wialon-php](https://gitlab.com/xint0-open-source/wialon-php) creado por Rogelio Jacinto. Agradecemos su trabajo original que sirvió como base para este proyecto.

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance46

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 Bus Factor1

Top contributor holds 91.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/69a60c00428e9075a85759d44949d3506aedfe06c9b37b27a90fce39493c5158?d=identicon)[Jhamnerx](/maintainers/Jhamnerx)

---

Top Contributors

[![Xint0-elab](https://avatars.githubusercontent.com/u/60675277?v=4)](https://github.com/Xint0-elab "Xint0-elab (280 commits)")[![Xint0](https://avatars.githubusercontent.com/u/227148?v=4)](https://github.com/Xint0 "Xint0 (25 commits)")[![Jhamnerx](https://avatars.githubusercontent.com/u/30221273?v=4)](https://github.com/Jhamnerx "Jhamnerx (1 commits)")

### Embed Badge

![Health badge](/badges/jhamnerx-wialon-api-php/health.svg)

```
[![Health](https://phpackages.com/badges/jhamnerx-wialon-api-php/health.svg)](https://phpackages.com/packages/jhamnerx-wialon-api-php)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M475](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M270](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M452](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)