teamzac / geocoder
关于Google地理编码和方向服务的简单封装
v5.0
2021-03-08 19:17 UTC
Requires
- php: >=7.2.5
- guzzlehttp/guzzle: ^6.0|^7.0.1
- illuminate/console: ^7.0|^8.0
- illuminate/support: ^7.0|^8.0
Requires (Dev)
- orchestra/testbench: 5.*|6.*
- phpunit/phpunit: ^8.5|^9.0
This package is auto-updated.
Last update: 2024-09-05 20:56:23 UTC
README
安装
您可以通过composer安装此包
composer require teamzac/geocoder
使用方法
此包使用Laravel的自动发现功能,因此您无需手动添加服务提供者。
如果您想发布配置文件,或者只需将以下内容添加到您的.env文件中
GOOGLE_MAPS_API_KEY={{YOUR API KEY HERE}}
TeamZac\Geocoder\Geocoder
类可以从容器中解析,或者您可以使用外观。该类有两个主要方法
// get lat/lng from an address Geocoder::geocode('1600 Pennsvylvania Ave, Washington DC 20500'); // get an address from lat/lng pair Geocoder::reverseGeocode(38.8976633, -77.036573);
这两个方法都将返回一个TeamZac\Geocoder\GeocodeResult
实例,如果没有找到结果,将抛出异常。
GeocodeResult
类是一个简单的数据传输对象,使得访问响应信息更加方便。
$result = Geocoder::geocode('123 main street anywhere USA'); $result->getState(); $result->getLocality(); $result->getStreetNumber();
有关可用方法的完整列表,请查看类的实现。
测试
composer test
您需要将.env.example
文件复制为.env.testing.php
,并添加您的Google Maps API密钥以启用测试。
变更日志
有关最近更改的更多信息,请参阅CHANGELOG。
贡献
有关详细信息,请参阅CONTRIBUTING。
安全
如果您发现任何安全相关的问题,请通过电子邮件chad@zactax.com联系,而不是使用问题跟踪器。