shenstef/qqlbs

腾讯位置服务中国标准行政区划数据 SDK

v1.0.0 2019-06-17 07:41 UTC

Requires

• guzzlehttp/guzzle: ^6.3

MIT

• tumobi

README

腾讯位置服务中国标准行政区划数据 SDK.

安装

$ composer require tumobi/qqmap-region -vvv

配置

创建 key

在使用本扩展之前，你需要去 腾讯位置服务 注册账号，在 key管理 中创建新密钥。

开启 WebServiceAPI

找到刚新创建的 key ，点击 设置 按钮进入 KEY 设置页面，勾选 WebServiceAPI 后保存。

使用

use Tumobi\QQMapRegion\Region;

$key = '你创建的 key';
$region = new Region($key);

获取全部行政区划数据

$result = $region->getAllDistrict();
print_r($result);

获取子级行政区划

// 北京市
$region_id = 110000;
$result = $region->getChildrenDistrict($region_id);
print_r($result);

搜索指定关键词的行政区划

$keyword = '香格里拉';
$result = $region->searchDistrict($keyword);
print_r($result);

获取省市区三级选择器行政区划数据

$result = $region->getSelectorRegions();
print_r($result);

在 Laravel 中使用

安装方式同上，需要添加两处配置，在 config/services.php 加入如下配置

'region' => [
    'key' => env('REGION_KEY'),
],

在 .env 文件中加入如下配置

REGION_KEY=在腾讯位置服务创建的key

使用方法

public function edit(Region $region) 
{
    $districts = $region->getAllDistrict();
}

或

public function edit() 
{
    $districts = app('region')->getAllDistrict();
}

参考

• 行政区划 | 腾讯位置服务
• PHP 扩展包实战教程 - 从入门到发布

License

MIT