qqmap-region:腾讯位置服务中国标准行政区划数据 SDK.
GitHub:https://github.com/tumobi/qqmap-region
一步步跟着《PHP 扩展包实战教程 - 从入门到发布》教程做的扩展包,感谢 Laravel China 。
安装
$ 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);
在 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();
}
参考
License
MIT