README

PHP库，使用Google Maps API进行邮编查找。

与Laravel 4-8兼容。

快速开始

首先，您需要在您的composer.json文件中引入此包

{
    "require": {
        "lodge/postcode-lookup": "0.7.0"
    }
}

注意：对于Laravel 4，请使用版本0.3.0

在Laravel中注册

注册服务提供者。在您的app.php配置文件中添加

'providers' => array(
	...
	'Lodge\Postcode\PostcodeServiceProvider',
)

还提供了一个外观，因此为了注册它，请将以下内容添加到您的app.php配置文件中

'aliases' => array(
	...
	'Postcode' => 'Lodge\Postcode\Facades\Postcode',
);

发布配置文件。

php artisan vendor:publish --provider="Lodge\Postcode\PostcodeServiceProvider"

在config/postcode.php文件中设置您的Google API密钥。

在Laravel中使用

从您的控制器中，您可以调用

	$postcode = Postcode::lookup('SW3 4SZ');

	print_r($postcode);

	// Outputs
	array(
		'postcode'      => 'SW34SZ',
		'street_number' => '',
		'street'        => '',
		'sublocality'   => '',
		'town'          => 'London',
		'county'        => 'Greater London',
		'country'       => 'United Kingdom',
		'latitude'      => 51.489117499999999,
		'longitude'     => -0.1579016
	);

获取地址的经纬度

	$coordinates = Postcode::getCoordinates($address);

	print_r($coordinates);

	// Outputs
	array(
		'latitude'  => 1.521231
		'longitude' => -23.012123
	)

在Laravel外部使用

	// First of all you need to instantiate the class
	// And assuming that you have required the composer
	// autoload.php file
	require 'vendor/autoload.php';

    $googleApiKey = 'your-google-api-key';
	$postcode = new Lodge\Postcode\Postcode($googleApiKey);
	$results = $postcode->lookup('SW3 4SZ');

	print_r($results);

	// Outputs
	array(
		'postcode'      => 'SW34SZ',
		'street_number' => '',
		'street'        => '',
		'sublocality'   => '',
		'town'          => 'London',
		'county'        => 'Greater London',
		'country'       => 'United Kingdom',
		'latitude'      => 51.489117499999999,
		'longitude'     => -0.1579016
	)

如果您需要获取地址的经纬度，可以使用

    $googleApiKey = 'your-google-api-key';
	$postcode = new Lodge\Postcode\Postcode($googleApiKey);
	$results = $postcode->getCoordinates('SW3 4SZ');

	print_r($results);

	// Outputs
	array(
		'latitude'  => 51.489117499999999
		'longitude' => -0.1579016
	)

变更日志

版本 0.7
- 添加了对Laravel 8的支持
版本 0.6
- 添加了对Laravel 7的支持
版本 0.4
- 添加了配置文件和设置Google API密钥的能力。
- 更新命名空间到PSR-4
- 添加测试存根。
- 停止了对Laravel 4的支持。
版本 0.3
- 移除了过时的bind调用，并改为以单例的形式实例化。
版本 0.2
- Laravel 5兼容
- 修复了外观命名空间，使其不遵循PSR-0
- 更新了文档
版本 0.1
- 初始发布

许可证

MIT许可（MIT）

特此授予任何获得此软件及其相关文档文件（“软件”）副本的任何人免费使用软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许向获得软件的人提供此副本，前提是

lodge / postcode-lookup

维护者

详细信息