PHPackages                             ajtarragona/vialer - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. ajtarragona/vialer

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

ajtarragona/vialer
==================

Paquet per accedir al vialer de l'Ajuntament de Tarragona.

v1.0.21(9mo ago)0527MITPHPPHP &gt;=7.0.0

Since May 8Pushed 4mo ago1 watchersCompare

[ Source](https://github.com/ajtarragona/vialer)[ Packagist](https://packagist.org/packages/ajtarragona/vialer)[ RSS](/packages/ajtarragona-vialer/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (3)Versions (30)Used By (0)

Vialer for Laravel 5.6
======================

[](#vialer-for-laravel-56)

Paquet d'accés al Vialer de l'Ajuntament de Tarragona

- [Instalació](#instalaci%C3%B3)
- [Configuració](#configuraci%C3%B3)
- [Providers](#providers)
    - [VialerProvider](#vialerprovider)
    - [DistricteSeccioProvider](#districteseccioprovider)
    - [CatastroProvider](#catastroprovider)
- [Component blade](#component-blade)

Instalació
----------

[](#instalació)

```
composer require ajtarragona/vialer:"@dev"
```

Publicar els assets js i css

```
php artisan vendor:publish --tag=ajtarragona-vialer-assets
```

> **Important!!** Cada vegada que s'actualitzi el paquet, cal executar aquesta comanda (amb el paràmetre --force) per sobrescriure els assets (js i css)

```
php artisan vendor:publish --tag=ajtarragona-vialer-assets --force
```

Configuració
------------

[](#configuració)

Pots publicar l'arxiu de configuració del paquet amb la comanda:

```
php artisan vendor:publish --tag=ajtarragona-vialer-config
```

Això copiarà l'arxiu a `config/vialer.php`.

Providers
---------

[](#providers)

Es proporcionen 3 Providers:

### VialerProvider

[](#vialerprovider)

Simplement és una capa sobre el paquet tsystems-client. Podeu consultar els mètodes i la configuració a la web del paquet [tsystems-client](https://github.com/ajtarragona/tsystems-client).

Proporciona com a extra que totes les consultes es guarden a cache durant una hora.

Ho podem fer servir:

#### A través d'una `Facade`:

[](#a-través-duna-facade)

```
use Vialer;
...
public function test(){
    $paisos=Vialer::paisos();
    ...
}
```

#### Vía Injecció de dependències:

[](#vía-injecció-de-dependències)

Als teus controlladors, helpers, model:

```
use Ajtarragona\Vialer\Providers\VialerProvider;
...
public function test(VialerProvider $vialer){
	$vies=$vialer->getAllVies();
	...
}
```

#### Vía funció `helper`:

[](#vía-funció-helper)

```
...
public function test(){
	$tercer=vialer()->getAllVies();
	...
}
```

### DistricteSeccioProvider

[](#districteseccioprovider)

Proporciona accés al servei web d'ARCGIS de districtes i seccions.

FuncióParàmetresRetorn**getDistricteISeccio**`lat`: Latitud
 `lng`: LongitudUn objecte amb els atributs `districte`, `seccio` i `districte_administratiu` o bé `null`La latitud i longitud han d'anar en el sistema de referència indicat a l'atribut `srs` de l'arxiu de configuració `config/vialer.php`. Per defecte és 4326.

Ho podem fer servir:

#### A través d'una `Facade`:

[](#a-través-duna-facade-1)

```
use Districtes;
...
public function test(){
    $dissec=Districtes::getDistricteISeccio(41.111,12.3323);
    ...
}
```

#### Vía Injecció de dependències:

[](#vía-injecció-de-dependències-1)

Als teus controlladors, helpers, model:

```
use Ajtarragona\Vialer\Providers\DistricteSeccioProvider;
...
public function test(DistricteSeccioProvider $disprov){
	$dissec=$disprov->getDistricteISeccio(41.111,12.3323);
	...
}
```

#### Vía funció `helper`:

[](#vía-funció-helper-1)

```
...
public function test(){
	$dissec=districtes()->getDistricteISeccio(41.111,12.3323);
	...
}
```

### CatastroProvider

[](#catastroprovider)

Accés al catastre per comnsulta de referències catastrals.

FuncióParàmetresRetorn**getVia**$codigoIneVia, $codigoProvincia=null, $codigoMunicipio=null, $codigoMunicipioIne=null)**consultaViasPorNombre**$nombreVia, $tipoVia=null**consultaDomiciliosPorVia**$codigoVia, $numero, $partes=\[\], $codigoProvincia=null, $codigoMunicipio=null, $codigoMunicipioIne=null**consultaDomiliciosPorRC**$rc**consultaDomiciliosPorXY**$lat, $lng**consultaXYporRC**$rc, $srs=null, $provincia = null, $municipio=null**consultaRCporXY**$x, $y, $srs=null```
use Catastro;
...
public function test(){
    $via=Catastro::getVia(1234);
    ...
}
```

#### Vía Injecció de dependències:

[](#vía-injecció-de-dependències-2)

Als teus controlladors, helpers, model:

```
use Ajtarragona\Vialer\Providers\CatastroProvider;
...
public function test(CatastroProvider $catastro){
	$vies=$catastro->getVia(1234);
	...
}
```

#### Vía funció `helper`:

[](#vía-funció-helper-2)

```
...
public function test(){
	$via=catastro()->getVia(1234);
	...
}
```

Component blade
---------------

[](#component-blade)

Es disposa d'un component blade que renderitza un camp de formulari funcional.

Primer cal, a la teva plantilla, afegir els assets js i css:

```

```

Ús del component

```
@vialerFormControl([
	'name'=>'vialer1',
	'class' => 'mb-3',
	'color'=>'info',
	'show_map'=>false,
	'show_refcat'=>true,
	'show_xy'=>true,
	"search_xy"=>false,
	"search_refcat"=>false,
	"btn_parcela"=>true,

	'via_fields'=>['numero','lletra','escala','bloc','planta','porta','codi_postal','provincia','municipi','districte','seccio',
	"value"=> [
		"via"=> [
			"tipus" => "CR",
			"nom" => "DE LA UNIO",
			"codi" => 3120
		],
		"numero" => 12,
		"refcat"=> "3231506CF5533A0016DM",
		"location" =>[
			"lat" => "41.1147391577075",
			"lng" => "1.25146962624948",
		]
	],
	"readonly" =>true
])
```

#### Paràmetres

[](#paràmetres)

NomDescripcióValor per defecteclassClasse/s CSSvalueArray amb els valors dels diferents subcampsnullnameNom del campvialeridIdentificador del campmap\_positionleft, right, top, bottombottommap\_height300pxmap\_columnsEn cas de posicio del mapa left o right, columes que ocuparà (1 a 12)6colorDels colors bootstrap (primary, secondary, etc.)nullvia\_fieldsEspecifica quins camps del vialer mostrarnumero, lletra, escala, bloc, planta, porta, codi\_postal, provincia, municipi, districte, seccio, districte\_administratiushow\_mapMostrar el mapa de googletrueshow\_refcatMostrar la pestanya de referència catastraltrueshow\_xyMostrar la pestanya de Latitud i longitudtruesearch\_refcatHabilita la cerca per referència catastraltruebtn\_parcelaHabilita el botó per mostrar la parcela al catastretruesearch\_xyHabilita la cerca per Latitud i longitudtruesearch\_viaHabilita la cerca per carrertruebtn\_add\_markerHabilita el botó d'afegir marcador al mapatruebtn\_clearHabilita el botó de netejar tot el camptruereadonlyNomés lecturafalseSi fem servir el camp dins d'un formulari, quan fem el submit el que s'enviarà per la request és un sol camp amb el nom del camp i el valor de tots els subcamps per separat.

```
"vialer1" => array:15 [
    "via" => array:3 [
      "tipus" => "CR"
      "nom" => "DE LA UNIO"
      "codi" => "3120"
    ]
    "numero" => "13"
    "lletra" => null
    "escala" => null
    "bloc" => null
    "planta" => "01"
    "porta" => "01"
    "codi_postal" => "43001"
    "provincia" => "TARRAGONA"
    "municipi" => "TARRAGONA"
    "districte" => "5"
    "seccio" => "2"
    "districte_administratiu" => "CENTRE"
    "refcat" => "3332212CF5533A0002FS"
    "location" => array:2 [
      "lat" => "41.1151162899822"
      "lng" => "1.25189613335773"
    ]
  ]
```

###  Health Score

40

↑

FairBetter than 88% of packages

Maintenance66

Regular maintenance activity

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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.

###  Release Activity

Cadence

Every ~68 days

Recently: every ~58 days

Total

29

Last Release

292d ago

Major Versions

v0.0.7 → v1.0.02020-10-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/eae0bc56bebf7416d9c7ad9f0c8a7aa91e8911c8f8a8a34207d90a201df3deff?d=identicon)[ajtarragona](/maintainers/ajtarragona)

---

Top Contributors

[![ajtarragona](https://avatars.githubusercontent.com/u/45968689?v=4)](https://github.com/ajtarragona "ajtarragona (37 commits)")

---

Tags

laravellaravel5vialer

### Embed Badge

![Health badge](/badges/ajtarragona-vialer/health.svg)

```
[![Health](https://phpackages.com/badges/ajtarragona-vialer/health.svg)](https://phpackages.com/packages/ajtarragona-vialer)
```

###  Alternatives

[livewire/volt

An elegantly crafted functional API for Laravel Livewire.

4195.3M84](/packages/livewire-volt)[imanghafoori/laravel-terminator

A minimal yet powerful package to give you opportunity to refactor your controllers.

25353.0k](/packages/imanghafoori-laravel-terminator)[brexis/laravel-workflow

Integerate Symfony Workflow component into Laravel.

283125.6k](/packages/brexis-laravel-workflow)[imanghafoori/laravel-anypass

A minimal yet powerful package to help you in development.

21421.6k](/packages/imanghafoori-laravel-anypass)[summerblue/generator

Extend Laravel's generators scaffold.

34139.9k](/packages/summerblue-generator)[forxer/laravel-gravatar

A library providing easy gravatar integration in a Laravel project.

4235.6k](/packages/forxer-laravel-gravatar)

PHPackages © 2026

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