行政区划
腾讯地图 官方文档
本接口提供中国标准行政区划数据,可用于生成城市列表控件等功能时使用,共有三个接口,list接口: 获取全部行政区划数据;getchildren接口:获取指定行政区划的子级行政区划;search接口:根据关键词搜索行政区划
基本说明:
接口地址:https://apis.map.qq.com/ws/district/v1/(list|getchildren|search)
返回格式:json/jsonp
请求方式:get
请求示例:https://apis.map.qq.com/ws/district/v1/(list|getchildren|search)
请求参数说明:
名称 类型 必填 说明
key string 必填 开发密钥
keyword string 必填 【search接口参数】搜索关键词:1.支持输入一个文本关键词;2.支持多个行政区划代码,英文逗号分隔
id string 选填 【getchildren接口参数】父级行政区划ID,缺省时则返回最顶级行政区划
output string 选填 返回格式:支持JSON/JSONP,默认JSON
callback string 选填 JSONP方式回调函数
返回参数说明:
名称 类型 说明
- - -
JSON返回示例:
{
	"status": 0,
	"message": "query ok",
	"data_version": "20190722",
	"result": [
		[{
			"id": "110000",
			"name": "北京",
			"fullname": "北京市",
			"pinyin": [
				"bei",
				"jing"
			],
			"location": {
				"lat": 39.90469,
				"lng": 116.40717
			},
			"cidx": [
				0,
				15
			]
		}]
	]
}
服务级错误码参照
错误码 说明
310 请求参数信息有误
311 Key格式错误
306 请求有护持信息请检查字符串
110 请求来源未被授权
完整教学代码示例
<?php
class freeApi{
    private $apiUrl;
    private $appKey;

    public function __construct($appKey){
        $this->appKey = $appKey;
        $this->apiUrl = 'https://apis.map.qq.com/ws/district/v1/search';
    }
    /**
     * 获取结果
     * @return string
     */
    public function getResult(){
        $paras = [
            'key' => $this->appKey,
            'keyword' => '北京市',
        ];
        return $this->freeApiCurl($this->apiUrl,$paras);
    }
    /**
     * 请求接口返回内容
     * @param  string $url [请求的URL地址]
     * @param  string $params [请求的参数]
     * @return  string
     */
    public function freeApiCurl($url,$params=[]){
        if (!$params) return false;
        return file_get_contents($url.'?'.http_build_query($params));
    }
}
package main

import (
	"fmt"
	"io/ioutil"
	"log"
	"net/http"
)

const (
	APIURL   = "https://apis.map.qq.com/ws/district/v1/search"
	APIKEY = "your key"
)

func main() {
	queryUrl := fmt.Sprintf("%s?key=%s&keyword=北京市",APIURL,APIKEY)
	resp, err := http.Get(queryUrl)
	if err != nil {
		log.Println(err)
		return
	}

	defer resp.Body.Close()

	body, err := ioutil.ReadAll(resp.Body)

	if err != nil {
		fmt.Println(err)
		return
	}

	fmt.Println(string(body))
}