lukeraymonddowning / laravel-address-lookup
允许您使用多种不同的服务根据地址查询字符串查找地址。
1.1.0
2020-09-11 13:41 UTC
Requires
- php: ^7.1
- guzzlehttp/guzzle: ^7.0
- illuminate/support: ^7.0|^8.0
Requires (Dev)
- orchestra/testbench: ^5
- phpunit/phpunit: ^8.5
This package is auto-updated.
Last update: 2024-09-11 22:26:27 UTC
README
这是一个小型包,用于根据搜索查询统一地址查找。它目前支持Algolia Places API。
安装
您可以通过composer安装此包
composer require lukeraymonddowning/laravel-address-lookup
用法
要查找地址,您应该从容器中获取一个AddressLookup
接口的实例,无论是通过app
辅助函数还是通过类型提示。
默认提供者是Algolia,但您可以通过在.env
文件中设置ADDRESS_LOOKUP_DRIVER
来更改此提供者,并使用所需的驱动程序键。
以下是一个使用此包确定地址的示例。
use Lukeraymonddowning\PostcodeLookup\Drivers\AddressLookup; $addressLookup = app(AddressLookup::class); $results = $addressLookup->lookup('1 Test Road, Some Street');
lookup
方法将返回一个地址的Collection
,该地址符合Lukeraymonddowning\PostcodeLookup\Address\AddressInterface
。
如果在检索结果时发生错误,将抛出AddressLookupFailed
异常。
Algolia
Algolia Places API可以在没有任何凭证的情况下使用,但使用是有限的。您可以通过添加自己的凭证来移除这些限制。为此,请将以下密钥添加到您的.env
文件中
ALGOLIA_PLACES_APPLICATION_ID=XXXX ALGOLIA_PLACES_APPLICATION_KEY=XXXX
您应该将这些密钥的值设置为从Algolia Places控制面板获取的值。
重要信息
虽然这个包是开源的,但它主要用于内部业务目的,因此不应期望根据功能请求及时进行更改。
安全
如果您发现任何与安全相关的问题,请通过电子邮件lukeraymonddowning@gmail.com报告,而不是使用问题跟踪器。
鸣谢
许可协议
MIT许可协议(MIT)。有关更多信息,请参阅许可文件。