Skip to content

Search for Brazilian addresses by zip code using the ViaCEP REST API.

License

Notifications You must be signed in to change notification settings

KDevelopement/PHPViaCEP

Repository files navigation

ViaCEP PHP SDK

Latest Version on Packagist Software License Total Downloads Coverage Status

Pesquise endereços por CEP usando a API REST ViaCEP.

Instalar

Via Composer

$ composer require kseven/phpviacep

Uso

findByZipCode (Sem retorno de chamada)

Encontre o endereço pelo código postal.

use KSeven\ViaCEP\VCRun AS ViaCEP;

$ViaCEP = new ViaCEP;

$Address = $ViaCEP->findByZipCode('01001-000')->toArray();

/*
Deve retornar algo assim:

[
    'zipCode' => '01001-000',
    'street' => 'Praça da Sé',
    'complement' => 'lado ímpar',
    'neighborhood' => 'Sé',
    'city' => 'São Paulo',
    'state' => 'SP',
    'ibge' => '3550308',
]
*/

$Address = $ViaCEP->findByZipCode('01001-000')->toJson();

/*
Deve retornar algo assim:

{
    "zipCode": "01001-000",
    "street": "Praça da Sé",
    "complement": "lado ímpar",
    "neighborhood": "Sé",
    "city": "São Paulo",
    "state": "SP",
    "ibge": "3550308"
}
*/

findByZipCode (Com retorno de chamada)

Encontre o endereço por código postal, com retorno de chamada.

use KSeven\ViaCEP\VCRun AS ViaCEP;

$ViaCEP = new ViaCEP;

$Address = $ViaCEP->findByZipCode('01001-000', 'callback_name')->withCallback();

/*
Deve retornar algo assim:

callback_name({
    "cep": "01001-000",
    "logradouro": "Praça da Sé",
    "complemento": "lado ímpar",
    "bairro": "Sé",
    "localidade": "São Paulo",
    "uf": "SP",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
});
*/

findByStreetName

Pesquise endereços usando estado, cidade e nome de uma rua.

use KSeven\ViaCEP\VCRun AS ViaCEP;

$ViaCEP = new ViaCEP;

$Addresses = $ViaCEP->findByStreetName('SP', 'São Paulo', 'Gomes de Carvalho');

/*
Deve retornar algo assim:

[
    [
        'zipCode' => '01001-000',
        'street' => 'Praça da Sé',
        'complement' => 'lado ímpar',
        'neighborhood' => 'Sé',
        'city' => 'São Paulo',
        'state' => 'SP',
        'ibge' => '3550308',
    ],
    [
        'zipCode' => '01001-000',
        'street' => 'Praça da Sé',
        'complement' => 'lado ímpar',
        'neighborhood' => 'Sé',
        'city' => 'São Paulo',
        'state' => 'SP',
        'ibge' => '3550308',
    ]
]
*/

Registo de alterações

Consulte CHANGELOG para obter mais informações sobre o que mudou recentemente.

Contribuindos

Consulte CONTRIBUINDO e CONDUTA para obter detalhes.

Segurança

Se você descobrir algum problema relacionado à segurança, envie um e-mail para contato@kseven.dev.br em vez de usar o rastreador de problemas.

Credits

Licença

A licença MIT (MIT). Consulte Arquivo de licença para obter mais informações..

About

Search for Brazilian addresses by zip code using the ViaCEP REST API.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages