lukeraymonddowning/laravel-address-lookup

允许您使用多种不同的服务根据地址查询字符串查找地址。

1.1.0 2020-09-11 13:41 UTC

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)。有关更多信息,请参阅许可文件