PHPackages                             anselmojacyntho/carrier - 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. anselmojacyntho/carrier

ActiveLibrary

anselmojacyntho/carrier
=======================

Custom library for address search by brazilians cep or listing regions, states, cities and district, using postmon and ibge service

08PHP

Since May 20Pushed 5y ago1 watchersCompare

[ Source](https://github.com/anselmojacyntho/carrier)[ Packagist](https://packagist.org/packages/anselmojacyntho/carrier)[ RSS](/packages/anselmojacyntho-carrier/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Carrier
=======

[](#carrier)

[![Latest Version on Packagist](https://camo.githubusercontent.com/7229e3b99025c2c330cd1af156d47bc18ffa6259c12037e3712f672965cc2c75/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616e73656c6d6f6a6163796e74686f2f636172726965722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/anselmojacyntho/carrier)[![Total Downloads](https://camo.githubusercontent.com/dfdcd294fd1b904218c7c29ee9eca87b06d7968d5fad28737ed2a24809919a70/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616e73656c6d6f6a6163796e74686f2f636172726965722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/anselmojacyntho/carrier)[![Build Status](https://camo.githubusercontent.com/0c33a75a021c6d9c2a47e6e76742fe82bc7f2d7c2584c38e7cd7ca56a5138894/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f616e73656c6d6f6a6163796e74686f2f636172726965722f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/anselmojacyntho/carrier)

The Carrier is a package for PHP and Laravel that provides integration with [postmon](https://postmon.com.br/) and the [IBGE api](https://servicodados.ibge.gov.br/api/docs/localidades?versao=1) to allow searches of addresses by cep and listings of states, cities, neighborhoods and regions of Brazil.

Installation
------------

[](#installation)

Via Composer

Pull this package in through Composer.

```
    {
        "require": {
            "anselmojacyntho/carrier": "dev-master"
        }
    }
```

or run in terminal: `composer require anselmojacyntho/carrier`

### Laravel 5.0+ Integration

[](#laravel-50-integration)

Add the service provider to your `config/app.php` file:

```
    'providers'     => array(

        //...
        AnselmoJacyntho\Carrier\CarrierServiceProvider::class

    ),
```

Add the facade to your `config/app.php` file:

```
    'aliases'       => array(

        //...
        'Carrier' => AnselmoJacyntho\Carrier\Facades\Carrier::class

    ),
```

Usage
-----

[](#usage)

The package provides an easy interface for search address by CEP or litings regions, states, cities and neighborhoods from your application.

### Laravel usage

[](#laravel-usage)

```
    use AnselmoJacyntho\Carrier\Facades\Carrier;

    // Get address by cep
    $response = Carrier::findByCep('328947');

    // Get all regions
    $response = Carrier::getRegions();

    // Get states by region id
    $response = Carrier::getStatesByRegion(1);

    // Get all states
    $response = Carrier::getStates();

    // Get all cities
    $response = Carrier::getCities();

    // Get city by state id
    $response = Carrier::getCitiesByState(3);

    // Get all district by city id
    $response = Carrier::getDistrictsByCity(3550308);
```

Change log
----------

[](#change-log)

Please see the [changelog](changelog.md) for more information on what has changed recently.

Testing
-------

[](#testing)

```
$ composer test
```

Contributing
------------

[](#contributing)

Please see [contributing.md](contributing.md) for details and a todolist.

Security
--------

[](#security)

If you discover any security related issues, please email author email instead of using the issue tracker.

Credits
-------

[](#credits)

- [author name](https://github.com/anselmojacyntho)
- [All Contributors](../../contributors)

License
-------

[](#license)

license. Please see the [license file](license.md) for more information.

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/4b9210418c0f9d13e224ed9e3016bc103a661c2a1d73bab1e43b7cbcbe92a48e?d=identicon)[anselmojacyntho](/maintainers/anselmojacyntho)

---

Top Contributors

[![anselmojacyntho](https://avatars.githubusercontent.com/u/2342602?v=4)](https://github.com/anselmojacyntho "anselmojacyntho (17 commits)")

### Embed Badge

![Health badge](/badges/anselmojacyntho-carrier/health.svg)

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

PHPackages © 2026

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