(Translated by https://www.hiragana.jp/)
WebService API | 腾讯位置服务
WebService API / 开发指南しなん / 行政ぎょうせい区く划

正せい在ざい跳とべ转至目め标页，请稍后きさき…

概がい述じゅつ

本ほん服ふく务提供ていきょう中国ちゅうごく标准行政ぎょうせい区く划数据すえ查询功こう能のう，支持しじ：
1 . 全国ぜんこく省しょう、市し、区く/县、乡镇/街道かいどう 四级行政区划数据；
2 . 支持しじ三さん级区划（省しょう/市し - 区く/县）轮廓数すう据すえ；
3 . 支持しじ区く划查询、省しょう市区しく列れつ表ひょう、查询子こ级区划等功こう能のう。
4. 支持しじ获取乡镇/街道かいどう级（4级区划）轮廓边界（高こう级）


获取省しょう市区しく列れつ表ひょう

本ほん接せっ口こう用よう于获取全部ぜんぶ省しょう市区しく三级行政区划列表。
注ちゅう：获取四よん级乡镇/街道かいどう数すう据すえ，需要じゅよう通どおり过获取と子こ级区划接口こう，传入指定してい三さん级区划，获取相しょう应四级数据すえ。

请求地ち址し：

https://apis.map.qq.com/ws/district/v1/list // get请求

请求参さん数すう：

参さん数すう 必填 说明 示しめせ例れい
key 是これ 开发密みつ钥（Key） key=OB4BZ-D4W3U-*
output 否いや 返かえし回かい格式かくしき：支持しじJSON/JSONP，默だま认JSON output=json
callback 否いや JSONP方式ほうしき回かい调函数すう callback=function1

响应结果： 见下文ぶん


获取下か级行政ぎょうせい区く划

获取指定してい行政ぎょうせい区く划的子こ级行政ぎょうせい区く划
本ほん接せっ口こう支持しじ获取 指定してい区く县（三さん级）其下乡镇/街道かいどう（四よん级）列れつ表ひょう

请求地ち址し：

https://apis.map.qq.com/ws/district/v1/getchildren // get请求

请求参さん数すう：

参さん数すう 必填 说明 示しめせ例れい
key 是これ 开发密みつ钥（Key） key=OB4BZ-D4W3U-*
id 否いや 父ちち级行政ぎょうせい区く划ID（adcode），
缺かけ省しょう时返回かい一级行政区划，也就是ぜ省しょう级		 id=110000
get_polygon 否いや 返かえし回かい行政ぎょうせい区く划轮廓くるわ点てん串くし（经纬度ど点てん串くし），取と值：
0 默だま认，不ふ返かえし回かい轮廓
1 固定こてい3公里くり抽稀粒つぶ度ど的てき区く划轮廓くるわ
2 支持しじ多た种抽稀まれ粒つぶ度ど的てき区く划轮廓くるわ，可か通どおり过max_offset设置返かえし回かい轮廓的てき抽稀级别
3 获取乡镇/街道かいどう（四よん级）轮廓边界（高こう级功能のう请提 工こう单 联系开通）		 get_polygon=2
max_offset 否いや 轮廓点てん串くし的てき抽稀精度せいど（仅对get_polygon=2时支持しじ），
单位米まい，可か选值：
100 ：100米まい（当とう缺かけ省しょうid返かえし回かい省しょう级区划时，将はた按500米めーとる返かえし回かい，其它级别正常せいじょう生せい效こう）
500 ：500米めーとる
1000：1000米めーとる
3000：3000米めーとる		 max_offset=1000
output 否いや 返かえし回かい格式かくしき：支持しじJSON/JSONP，默だま认JSON output=json
callback 否いや JSONP方式ほうしき回かい调函数すう callback=function1

响应结果： 见下文ぶん



行政ぎょうせい区く划搜索そうさく

根ね据すえ关键词或行政ぎょうせい区く划代码搜索そうさく

请求地ち址し：

https://apis.map.qq.com/ws/district/v1/search // get请求

请求参さん数すう：

参さん数すう 必填 说明 示しめせ例れい
key 是これ 开发密みつ钥（Key） key=OB4BZ-D4W3U-*
keyword 是これ 搜索そうさく关键词：
1.支持しじ输入一个文本关键词
2.支持しじ多た个行政ぎょうせい区く划代码(adcode)，英文えいぶん逗号分ぶん隔へだた		 keyword=北京ぺきん
keyword=130681
get_polygon 否いや 返かえし回かい行政ぎょうせい区く划轮廓くるわ点てん串くし（经纬度ど点てん串くし），取と值：
0 默だま认，不ふ返かえし回かい轮廓
1 固定こてい3公里くり抽稀粒つぶ度ど的てき区く划轮廓くるわ
2 支持しじ多た种抽稀まれ粒つぶ度ど的てき区く划轮廓くるわ，可か通どおり过max_offset设置返かえし回かい轮廓的てき抽稀级别
注ちゅう：本ほん参さん数すう仅在keyword为adcode，且仅检索一个行政区划时生效；		 get_polygon=2
max_offset 否いや 轮廓点てん串くし的てき抽稀精度せいど（仅对get_polygon=2时支持しじ），
单位米まい，可か选值：
100 ：100米めーとる
500 ：500米めーとる
1000：1000米めーとる
3000：3000米めーとる		 max_offset=1000
output 否いや 返かえし回かい格式かくしき：支持しじJSON/JSONP，默だま认JSON output=json
callback 否いや JSONP方式ほうしき回かい调函数すう callback=function1

响应结果

名称めいしょう 类型 必有 说明
status number 是これ 状じょう态码，0为正常せいじょう，其它为异常つね，详细请参阅状じょう态码说明
message string 是これ 状じょう态说明あきら
data_version number 是これ 行政ぎょうせい区く划数据すえ版本はんぽん，便びん于您判断はんだん更新こうしん
result[] array 是これ 结果数すう组
其下数すう组项 array 否いや 第だい0项，代表だいひょう一级行政区划，第だい1项代表だいひょう二级行政区划，以此类推；使用しようgetChildren接せっ口こう时，仅为指定してい父ちち级行政ぎょうせい区く划的子こ级区划
id string 是これ 行政ぎょうせい区く划唯一いち标识（adcode）
name string 是これ 简称，如“内うち蒙こうむ古いにしえ”
fullname string 是これ 全ぜん称たたえ，如“内うち蒙こうむ古こ自治じち区く”
location object 是これ 经纬度ど
lat number 是これ 纬度
lng number 是これ 经度
pinyin array 否いや 行政ぎょうせい区く划拼音おん，每まい一下标为一个字的全拼，如：
[“nei”,“meng”,“gu”]
level number 否いや 行政ぎょうせい区く划级别，仅行政ぎょうせい区く划搜索そうさく接せっ口こう返かえし回かい此字段だん
cidx array 否いや 子こ级行政ぎょうせい区く划在下か级数组中的てき下か标位置いち
address string 否いや 完かん整せい区く划信息いき，仅行政ぎょうせい区く划搜索そうさく接せっ口こう返かえし回かい此字段だん
polygon array 否いや 该行政ぎょうせい区く划的轮廓经纬度ど点てん串くし（当とう使用しようget_polygon=1或ある2时返回かい），数かず组每一项为一个多边形，一个行政区划可以由多块多边形组成
注意ちゅうい：部分ぶぶん城市じょうし存在そんざい飞地，当とう两个polygon重じゅう叠时，重じゅう叠区域くいき隶属其他城市じょうし，不ふ重じゅう叠时代表だいひょう此城市し的てき飞地
其下数すう组项 array 否いや 每まい个数组为一个轮廓多边形点串（经纬度ど），格式かくしき为：
[坐すわ标1经度,坐すわ标1纬度,坐すわ标2经度,坐すわ标2纬度…]
address string 否いや 完かん整せい区く划信息いき，仅行政ぎょうせい区く划搜索そうさく接せっ口こう返かえし回かい此字段だん

行政ぎょうせい区く划代码（adcode）规则说明

代だい码共6位い，前ぜん两位代表だいひょう省しょう（一いち级）、中ちゅう间两位い为市/地区ちく（二に级），最さい后きさき两位为区县（三さん级）
 1）省しょう级：前ぜん两位有ゆう值，后きさき4位置いち0，如，河北かほく省しょう：130000
 2）市し/地区ちく：前ぜん4四よん位い有ゆう值，包含ほうがん省しょう代だい码与市代いちよ码，最さい后きさき两位置いち0，如河北きた省しょう保ほ定てい市し：130600
 3）区く县：6位い全ちょん有ゆう值，包含ほうがん前まえ4位い省しょう市代いちよ码及区く县代码，河北かほく省しょう保ほ定じょう市し涿州市し：130681
 4）直ちょく辖市、香港ほんこん、澳门：
      同省どうしょう级，在ざい行政ぎょうせい区く划接口こう（ws/district/v1/list）中ちゅう，其下直接ちょくせつ为区级（没ぼつ有ゆう二级结构填充）
      例れい：北京ぺきん,东城区く （而非：“北京ぺきん,北京ぺきん,东城区く”）
 5）直ちょく辖县：第だい3、4位い为90的てき，为省直ちょく辖县
 6）中国ちゅうごく范围内ない，省しょう市区しく行政ぎょうせい区く划以外的がいてき区域くいき值为999999（如中国ちゅうごく东海）
 7）东莞市し、中山ちゅうざん市し、儋州市し、嘉よしみ峪关市し 因いん其下无区县级，因いん此增加ぞうか了りょう末位まつい为99代だい码的同どう名子なご级，用よう于补齐到三级区划的结构

如何いか获取城市じょうし编码（city_code）：
1）编码前まえ4位い不ふ为0，第だい5、6位い为0的てき，为常规城市し，可か直接ちょくせつ取と用よう
2）北京ぺきん、上海しゃんはい、重じゅう庆、天津てんしん、香港ほんこん、澳门，编码和わ省しょう一致いっち，需要じゅよう单独提出ていしゅつ
3）第だい3、4位い为90的てき为省直ちょく辖县，一般当做城市来应用，也需要よう单独提出ていしゅつ

调用示しめせ例れい

// GET请求，注意ちゅうい参さん数すう值要进行URL编码
// list接せっ口こう：获取全部ぜんぶ行政ぎょうせい区く划数据すえ
https://apis.map.qq.com/ws/district/v1/list?key=[你的key]

// getchildren接せっ口こう：获取北京ぺきん市し的てき子こ级行政ぎょうせい区く划
https://apis.map.qq.com/ws/district/v1/getchildren?id=110000&key=[你的key]

// search接せっ口こう：搜索そうさく关键词为香が格かく里さと拉ひしげ的てき行政ぎょうせい区く划
https://apis.map.qq.com/ws/district/v1/search?&keyword=香こう格かく里さと拉ひしげ&key=[你的key]

{
    "status": 0,
    "message": "query ok",
    "data_version":"20200301",
    "result": [
        [
            {
                "id": "110101",
                "fullname": "东城区く",
                "location": {
                    "lat": "39.928353",
                    "lng": "116.416357"
                },
               "polygon": [ //行政ぎょうせい区く划轮廓くるわ点てん串くし，search及getchildren接せっ口こう加かget_polygon=1/2时返回かい
                   [116.809403,39.61482,116.790175,39.610555,116.780286,39.593196....],
                   //其它项省略しょうりゃく(若わか有ゆう)...
                ]
            },
            {
                "id": "110102",
                "fullname": "西城にししろ区く",
                "location": {
                    "lat": "39.912289",
                    "lng": "116.365868"
                },
               "polygon": [ //行政ぎょうせい区く划轮廓くるわ点てん串くし，search及getchildren接せっ口こう加かget_polygon=1/2时返回かい
                   [116.478298,39.550134,116.476457,39.539085,116.442606,39.529289,....],
                   //其它项省略しょうりゃく(若わか有ゆう)...
                ]
            },
            {
                "id": "110105",
                "fullname": "朝あさ阳区",
                "location": {
                    "lat": "39.921470",
                    "lng": "116.443108"
                },
               "polygon": [ //行政ぎょうせい区く划轮廓くるわ点てん串くし，search及getchildren接せっ口こう加かget_polygon=1/2时返回かい
                   [116.221662,39.577632,116.206491,39.57579,116.201021,39.586952,....],
                   //其它项省略しょうりゃく(若わか有ゆう)...
                ]
            }, 
           //其它项省略しょうりゃく...
        ]
   ]
}

行政ぎょうせい区く划编码表下か载

当とう前まえ区く划信息いき

点てん击下载行政ぎょうせい区く划编码表（更新こうしん于2023年ねん9月がつ1日にち）

历史更新こうしん信しん息いき

这篇文章ぶんしょう对您解かい决问题是否いや有ゆう帮助？

已やめ解かい决
未み解かい决