行政区域查询

GET

/v3/config/district

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://restapi.amap.com/v3/config/district?Key='

响应示例

{
    "status": "1",
    "info": "OK",
    "infocode": "10000",
    "count": "1",
    "suggestion": {
        "keywords": [],
        "cities": []
    },
    "districts": [
        {
            "citycode": [],
            "adcode": "370000",
            "name": "山东省",
            "center": "117.020725,36.670201",
            "level": "province",
            "districts": [
                {
                    "citycode": "0631",
                    "adcode": "371000",
                    "name": "威海市",
                    "center": "122.120519,37.513315",
                    "level": "city",
                    "districts": [
                        {
                            "citycode": "0631",
                            "adcode": "371002",
                            "name": "环翠区",
                            "center": "122.123115,37.501735",
                            "level": "district",
                            "districts": []
                        },
                        {
                            "citycode": "0631",
                            "adcode": "371082",
                            "name": "荣成市",
                            "center": "122.487036,37.165698",
                            "level": "district",
                            "districts": []
                        },
                        {
                            "citycode": "0631",
                            "adcode": "371083",
                            "name": "乳山市",
                            "center": "121.539557,36.920329",
                            "level": "district",
                            "districts": []
                        },
                        {
                            "citycode": "0631",
                            "adcode": "371003",
                            "name": "文登区",
                            "center": "122.08832,37.196032",
                            "level": "district",
                            "districts": []
                        }
                    ]
                },
                {
                    "citycode": "0533",
                    "adcode": "370300",
                    "name": "淄博市",
                    "center": "118.054994,36.813787",
                    "level": "city",
                    "districts": [
                        {
                            "citycode": "0533",
                            "adcode": "370321",
                            "name": "桓台县",
                            "center": "118.097923,36.959794",
                            "level": "district",
                            "districts": []
                        },
                        {
                            "citycode": "0533",
                            "adcode": "370322",
                            "name": "高青县",
                            "center": "117.826743,37.171042",
                            "level": "district",
                            "districts": []
                        },
                        {
                            "citycode": "0533",
                            "adcode": "370305",
                            "name": "临淄区",
                            "center": "118.309398,36.826882",
                            "level": "district",
                            "districts": []
                        },
                        {
                            "citycode": "0533",
                            "adcode": "370303",
                            "name": "张店区",
                            "center": "118.017877,36.807011",
                            "level": "district",
                            "districts": []
                        },
                        {
                            "citycode": "0533",
                            "adcode": "370304",
                            "name": "博山区",
                            "center": "117.8627,36.495014",
                            "level": "district",
                            "districts": []
                        },
                        {
                            "citycode": "0533",
                            "adcode": "370323",
                            "name": "沂源县",
                            "center": "118.170856,36.185402",
                            "level": "district",
                            "districts": []
                        },
                        {
                            "citycode": "0533",
                            "adcode": "370306",
                            "name": "周村区",
                            "center": "117.869686,36.80309",
                            "level": "district",
                            "districts": []
                        },
                        {
                            "citycode": "0533",
                            "adcode": "370302",
                            "name": "淄川区",
                            "center": "117.966978,36.644211",

请求参数

Query 参数

keywords

string

可选

查询关键字规则：只支持单个关键词语搜索关键词支持：行政区名称、citycode、adcode 例如，在subdistrict=2，搜索省份（例如山东），能够显示市（例如济南），区（例如历下区） adcode信息可参考城市编码表获取

示例值:

山东

subdistrict

string

可选

子级行政区规则：设置显示下级行政区级数（行政区级别包括：国家、省/直辖市、市、区/县、乡镇/街道多级数据）可选值：0、1、2、3等数字，并以此类推 0：不返回下级行政区； 1：返回下一级行政区； 2：返回下两级行政区； 3：返回下三级行政区；需要在此特殊说明，目前部分城市和省直辖县因为没有区县的概念，故在市级下方直接显示街道。例如：广东-东莞、海南-文昌市

示例值:

page

string

可选

需要第几页数据最外层的districts最多会返回20个数据，若超过限制，请用page请求下一页数据。例如page=2；page=3。默认page=1

offset

string

最外层返回数据个数

可选

extensions

string

可选

返回结果控制此项控制行政区信息中返回行政区边界坐标点；可选值：base、all; base:不返回行政区边界坐标点； all:只返回当前查询district的边界值，不返回子节点的边界值；目前不能返回乡镇/街道级别的边界值

示例值:

base

filter

string

可选

根据区划过滤按照指定行政区划进行过滤，填入后则只返回该省/直辖市信息需填入adcode，为了保证数据的正确，强烈建议填入此参数

callback

string

可选

回调函数 callback值是用户定义的函数名称，此参数只在output=JSON时有效

output

string

可选

返回数据格式类型可选值：JSON，XML

Key

string

必需

用户在高德地图官网申请Web服务API类型Key

默认值:

返回响应

🟢200成功

application/json

Body

status

string

可选

返回结果状态值值为0或1，0表示失败；1表示成功

info

string

可选

返回状态说明返回状态说明，status为0时，info返回错误原因，否则返回“OK”。

infocode

string

可选

状态码返回状态说明，10000代表正确，详情参阅info状态表

suggestion

object

建议结果列表

可选

keywords

string

建议关键字列表

可选

cites

string

建议城市列表

可选

districts

object

行政区列表

可选

修改于 2022-03-22 13:27:35

概述

地理编码