qqmap-region:騰訊位置服務(wù)中國標(biāo)準(zhǔn)行政區(qū)劃數(shù)據(jù) SDK.
GitHub:https://github.com/tumobi/qqmap-region
一步步跟著《PHP 擴展包實戰(zhàn)教程 - 從入門到發(fā)布》教程做的擴展包,感謝 Laravel China 。
安裝
$ composer require tumobi/qqmap-region -vvv
配置
創(chuàng)建 key
在使用本擴展之前,你需要去 騰訊位置服務(wù) 注冊賬號,在 key管理 中創(chuàng)建新密鑰。
開啟 WebServiceAPI
找到剛新創(chuàng)建的 key ,點擊 設(shè)置 按鈕進(jìn)入 KEY 設(shè)置頁面,勾選 WebServiceAPI 后保存。
使用
use Tumobi\QQMapRegion\Region;
$key = '你創(chuàng)建的 key';
$region = new Region($key);
獲取全部行政區(qū)劃數(shù)據(jù)
$result = $region->getAllDistrict();
print_r($result);
獲取子級行政區(qū)劃
// 北京市
$region_id = 110000;
$result = $region->getChildrenDistrict($region_id);
print_r($result);
搜索指定關(guān)鍵詞的行政區(qū)劃
$keyword = '香格里拉';
$result = $region->searchDistrict($keyword);
print_r($result);
在 Laravel 中使用
安裝方式同上,需要添加兩處配置,在 config/services.php 加入如下配置
'region' => [
'key' => env('REGION_KEY'),
],
在 .env 文件中加入如下配置
REGION_KEY=在騰訊位置服務(wù)創(chuàng)建的key
使用方法
public function edit(Region $region)
{
$districts = $region->getAllDistrict();
}
或
public function edit()
{
$districts = app('region')->getAllDistrict();
}
參考
License
MIT