faisalawanisee/postcodes

UK Postcode API Facade for Laravel 9

dev-main 2022-10-10 12:56 UTC

This package is auto-updated.

Last update: 2024-09-10 17:23:11 UTC


README

这是一个用于postcodes.io API方法的Laravel facade/service provider - 用于UK邮编验证和反向地理编码:即,根据经纬度坐标确定邮编。无需麻烦地处理API密钥、认证等...

感谢https://postcodes.io

安装

composer require faisalawanisee/postcodes

对于Laravel,Postcodes将会自动发现。

编辑/config/app.php并在providers数组中添加service provider。

'providers' => [
	Faisalawanisee\Postcodes\PostcodeServiceProvider::class,
]

在这里也添加别名

'aliases' => [
	'Postcode' => Faisalawanisee\Postcodes\Facades\Postcode::class,
]

基本Laravel使用示例

返回给定邮编的数据

Route::get('/postcode', function(){
    $data = Postcode::postcodeLookup('SE21 8JL');
    print_r($data);
    return null;      
});	

方法

Postcode::validate('SE31 9AX'); //returns boolean
Postcode::postcodeLookup('SE21 8JL');
Postcode::nearest('SE21 8JL');
Postcode::reverseGeocode(-0.397913, 51.44015); // long,lat
Postcode::autocomplete('RG1 3');
Postcode::outcodeLookup('SE21');

$postcodes = ['OX49 5NU', 'M32 0JG', 'NE30 1DP'];
Postcode::postcodeLookupBulk($postcodes);
	
$coordinates = [
    ['longitude' =>  0.629834723775309, 'latitude' => 51.7923246977375],
    ['longitude' => -2.49690382054704, 	'latitude' => 53.5351312861402]
    ];
Postcode::reverseGeocodeBulk($coordinates);

测试

$ composer test