行政区划-免费API,收集所有免费的API

基本说明：

接口地址：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))
}