README

Web Service Postmon ZipCode - Github https://github.com/PostmonAPI/postmon

所需设置

在composer.json文件的require键中添加以下内容

"canducci/zipcodepostmon": "1.*" 

运行Composer更新命令

$ composer update

在Laravel中配置

在您的config/app.php中，将Canducci\ZipCodePostmon\Providers\ZipCodeProvider::class添加到providers数组的末尾

'providers' => array(
    ...,
    Canducci\ZipCodePostmon\Providers\ZipCodeProvider::class
),

在config/app.php的末尾，将'ZipCodeRequest' => 'Canducci\ZipCodePostmon\Facades\ZipCodeRequest'添加到aliases数组中

'aliases' => array(
    ...,
    'ZipCodeRequest' => Canducci\ZipCode\Facades\ZipCodeRequest::class,
),

如何使用

使用非常简单，传递ZIP并调用各种类型的返回，如下所示

1) Facade

• 添加命名空间

use Canducci\ZipCodePostmon\Facades\ZipCodeRequest;

• 代码示例

$zipCodeResult = ZipCodeRequest::find('01414-001');

2) Helper

• 代码示例

$zipCodeResult = zipcode('01414000'); 
//or 
$zipCodeResult = zipcode()->find('01414000');

3) 注入

• 添加命名空间

use Canducci\ZipCodePostmon\ZipCodeRequest;

• 代码示例

public function index(ZipCodeRequest $zipCodeRequest)
{
      $zipCodeResult = $zipCodeRequest->find('01414000');
}      

使用总结

• 代码

$zipCodeResult = ZipCodeRequest::find('01414000'); //Facade
$zipCodeResult = $zipCodeRequest->find('01414000'); //Contracts
$zipCodeResult = zipcode('01414000'); // Helper
$zipCodeResult = zipcode()->find('01414000'); // Helper

• 返回

返回可以是null或类实例ZipCode Object (Canducci\ZipCodePostMon\ZipCode)

• 评估方法

$zipCodeResult->getNumber() // 01414000
$zipCodeResult->getComplement() // até 1048 - lado par
$zipCodeResult->getDistrict() // Cerqueira César
$zipCodeResult->getAddress() // Rua Haddock Lobo

$zipCodeResult->getCity()->getAreaKm() // 1521,11
$zipCodeResult->getCity()->getCodeIbge() // 3550308
$zipCodeResult->getCity()->getName() // São Paulo

$zipCodeResult->getState()->getAreaKm() // 248.221,996
$zipCodeResult->getState()->getCodeIbge() // 35
$zipCodeResult->getState()->getName() // SP
$zipCodeResult->getState()->getFullName() // São Paulo
$zipCodeResult->getClient() // Empty ZipCode Extra

或

$zipCodeResult->number // 01414000
$zipCodeResult->complement // até 1048 - lado par
$zipCodeResult->district // Cerqueira César
$zipCodeResult->address // Rua Haddock Lobo

$zipCodeResult->city->areaKm // 1521,11
$zipCodeResult->city->codeIbge // 3550308
$zipCodeResult->city->name // São Paulo

$zipCodeResult->state->areaKm // 248.221,996
$zipCodeResult->state->codeIbge // 35
$zipCodeResult->state->name // SP
$zipCodeResult->state->fullName // São Paulo
$zipCodeResult->client // Empty ZipCode Extra

• toArray和toJson方法

$arrayResult = $zipCodeResult->toArray();

Array
(
    [district] => Cerqueira César
    [number] => 01414000
    [state] => Array
        (
            [areaKm] => 248.221,996
            [codeIbge] => 35
            [name] => SP
            [fullName] => São Paulo
        )

    [city] => Array
        (
            [areaKm] => 1521,11
            [codeIbge] => 3550308
            [name] => São Paulo
        )

    [complement] => até 1048 - lado par
    [address] => Rua Haddock Lobo
    [client] =>
)

$jsonResult = $zipCodeResult->toJson();
{
    "district": "Cerqueira C\u00e9sar",
    "number": "01414000",
    "state": {
        "areaKm": "248.221,996",
        "codeIbge": "35",
        "name": "SP",
        "fullName": "S\u00e3o Paulo"
    },
    "city": {
        "areaKm": "1521,11",
        "codeIbge": "3550308",
        "name": "S\u00e3o Paulo"
    },
    "complement": "at\u00e9 1048 - lado par",
    "address": "Rua Haddock Lobo",
    "client": ""
}