rentloop/google-geo-code

Google 地理位置API包装器

1.0.0 2020-06-20 21:19 UTC

This package is not auto-updated.

Last update: 2024-09-25 09:02:28 UTC


README

一个用于使用谷歌地址地理编码查找的小型包。

安装

此包已在Laravel 5.4及以上版本进行了测试。

您可以通过composer安装此包

composer require tjefford/google-geo-code

在Laravel 5.5中,服务提供程序将自动注册。在框架的旧版本中,只需在config/app.php文件中添加服务提供程序和外观即可

'providers' => [
    // ...
    Tjefford\GoogleGeoCode\GoogleGeoCodeServiceProvider::class,
];

'aliases' => [
    // ...
    'Lookup' => Tjefford\GoogleGeoCode\Facades\Lookup::class,
];

环境

此包使用环境密钥从您的.env文件中拉取秘密API令牌。您需要从Google Geocode API 获取API密钥,并将其放入环境文件中,如下所示

GOOGLE_GEOCODE_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

使用方法

使用查找非常简单。您只需要提供地址、城市和州(以提高准确性)。然后您将收到谷歌关于该位置的数组数据。

在您的文件中包含查找类。

use Tjefford\GoogleGeoCode\Lookup;

初始化类,然后调用定位方法。

$lookup = new Lookup;
$lookup->locate('1901 W Madison St', 'Chicago', 'IL');

您的响应应类似于以下内容

[
  "formatted_address" => "1901 W Madison St, Chicago, IL 60612, USA"
  "place_id" => "ChIJTeP2tz4tDogRADDUGhbXDB8"
  "neighborhood" => "Near West Side"
  "address" => "1901 West Madison Street"
  "city" => "Chicago"
  "state" => "Illinois"
  "postal_code" => "60612"
  "county" => "Cook County"
  "country" => "United States"
  "lat" => 41.8806285
  "lng" => -87.6740482
]

方法

您可以使用的方法只有一个,即locate。它接受3个参数,第一个是唯一必需的参数。