---
name: location-region-data
description: "当用户需要使用咕咕数据公开 API 完成地址标准化、业务数据组合、参数传递、接口选型或结果校验时使用；不适用于绕过接口详情页、购买规则或人工复核要求的场景。"
---

# 地理位置与行政区划 Skill

面向行政区划、IP 定位、国家地区、坐标转换、院校和医院地理信息的公开 API 组合。

## 业务场景

用于行政区划、地址标准化、IP 定位、坐标转换、国家地区数据、医院地理信息和区域筛选。适合地图应用、区域运营、机构检索和地址录入场景。

- 数据范围：覆盖行政区划、街道村、国家地区、IP 定位、坐标转换、医院和部分机构地理数据。
- 关键数据维度：区域维度：国家、省、市、区县、街道、村居和行政编码。；定位维度：IP、经纬度、坐标系、地理位置和机构地址。；机构维度：医院、院校、地区归属和可展示名称。

## 何时使用

- 查询省市区街道村、国家地区、IP 地址位置和坐标转换结果。
- 把用户输入的地址、IP 或坐标转成统一的区域数据。
- 为医院、院校、门店或区域业务提供地理基础信息。

## 不适用场景

- 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
- 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
- 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。

## 用户需要提供的信息

- 国家、省、市、区县、街道、地址、IP、经纬度或机构名称。
- 坐标系、地区层级、定位精度和结果展示方式。
- 调用接口所需的 AppKey、开通状态和接口详情页限制。

## 推荐工作流

1. 先按国家、省市区或机构类型确定基础范围。
2. 再使用 IP 定位或坐标转换补齐位置上下文。
3. 需要行业对象时，结合院校、医院等基础数据接口。

## 参数传递关系

- 行政区划接口输出的省市区街道名称和编码可作为机构查询、地址标准化和区域筛选的输入。
- IP 定位输出的城市或地区只能作为粗粒度位置，不能替代精确坐标。
- 坐标转换前必须明确原坐标系，转换结果再用于地图展示或区域归属判断。

## 典型任务模板

- 地址标准化：输入地址或行政区；输出省市区街道层级和候选结果。
- IP 定位：输入 IP；输出粗粒度地区、使用边界和复核建议。
- 坐标处理：输入经纬度和坐标系；输出转换坐标和行政归属。

## 接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 `appkey` 仍以接口详情页说明为准。

### 全国省市区街道村信息

- 业务角色：省市区街道村
- 调用阶段：行政区划
- 接口地址：`GET https://api.gugudata.com/location/chinaregions`
- 产出用途：用于查询全国省市区街道村信息。
- 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果
- 接口详情页：https://www.gugudata.com/api/details/chinaregions
- 接口 Markdown：https://www.gugudata.com/api/details/chinaregions/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `regioncode` | 是 | `string` | YOUR_VALUE | 需要查询的父级区域编码，传递 0 获取全国所有省级别数据；编码格式为 00000000，每两位分别对应省、市、区、镇/街道编码（注意：v2 版本会在国家 6 位行政区划标准代码后添加 00 两位编码以保持接口兼容，v3 版本为 12 位编码格式） | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `version` | 是 | `integer` | 3 | 当传递参数值为 2 时，调用 v2 版本的接口，regioncode 遵循国家行政区划代码标准，同时可返回新增区划中心点坐标。当传递参数值为 3 时，调用 v3 版本的接口（v1 版本主要为了兼容历史用户调用逻辑，新用户强烈建议调用 v3 接口） | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 国家地区基础信息数据

- 业务角色：国家地区
- 调用阶段：基础区域
- 接口地址：`GET https://api.gugudata.com/v2/location/country`
- 产出用途：用于查询国家地区基础信息。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 接口详情页：https://www.gugudata.com/api/details/metacountry
- 接口 Markdown：https://www.gugudata.com/api/details/metacountry/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `languages` | 否 | `string` | zh | 语言代码筛选条件，例如 zh、en；为空时返回默认范围。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 国内 IP 地址定位

- 业务角色：国内 IP 定位
- 调用阶段：定位
- 接口地址：`GET https://api.gugudata.com/websitetools/iplocation`
- 产出用途：用于查询国内 IP 地址定位。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 接口详情页：https://www.gugudata.com/api/details/iplocation
- 接口 Markdown：https://www.gugudata.com/api/details/iplocation/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `ip` | 是 | `string` | YOUR_VALUE | IP 地址，可以传递 IPv4 或 IPv6 地址 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 国际 IP 地址定位

- 业务角色：国际 IP 定位
- 调用阶段：定位
- 接口地址：`GET https://api.gugudata.com/v2/location/ip`
- 产出用途：用于查询国际 IP 地址定位。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 接口详情页：https://www.gugudata.com/api/details/internationaliplocation
- 接口 Markdown：https://www.gugudata.com/api/details/internationaliplocation/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `ip` | 是 | `string` | YOUR_VALUE | IP 地址，可以传递 IPv4 或 IPv6 地址 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 地理坐标系转换

- 业务角色：坐标转换
- 调用阶段：坐标
- 接口地址：`GET https://api.gugudata.com/location/coordinateconverter`
- 产出用途：用于地理坐标系转换。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 接口详情页：https://www.gugudata.com/api/details/coordinateconverter
- 接口 Markdown：https://www.gugudata.com/api/details/coordinateconverter/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `from` | 是 | `string` | YOUR_VALUE | 原数据的坐标系，可选值：WGS84, GCJ02, BD09 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `to` | 是 | `string` | YOUR_VALUE | 目标数据的坐标系，可选值：WGS84, GCJ02, BD09 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `value` | 是 | `string` | YOUR_VALUE | 需要转换的坐标值，格式为：[120.54,32.74] | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 全国三甲医院主体信息

- 业务角色：三甲医院
- 调用阶段：机构数据
- 接口地址：`GET https://api.gugudata.com/location/hospital-3a`
- 产出用途：用于查询全国三甲医院主体信息。
- 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果；关键词由用户输入或从上一轮内容抽取结果中生成；分页参数由调用方控制，用于分批读取结果
- 接口详情页：https://www.gugudata.com/api/details/hospital-3a
- 接口 Markdown：https://www.gugudata.com/api/details/hospital-3a/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `province` | 否 | `string` | - | 省份名称，例如 北京、广东。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `city` | 否 | `string` | - | 城市名称，例如 北京市、广州市。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `district` | 否 | `string` | - | 区县名称，例如 海淀区、天河区。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `keyword` | 否 | `string` | - | 医院名称或别名关键词，支持模糊搜索。 | 关键词由用户输入或从上一轮内容抽取结果中生成 |
| `pageIndex` | 否 | `integer` | 1 | 分页页码，从 1 开始。 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 否 | `integer` | 20 | 每页数量。 | 分页参数由调用方控制，用于分批读取结果 |

### 全国大学高校基础信息

- 业务角色：高校位置
- 调用阶段：机构数据
- 接口地址：`GET https://api.gugudata.com/location/college`
- 产出用途：用于查询全国大学高校基础信息。
- 参数来源：关键词由用户输入或从上一轮内容抽取结果中生成；分页参数由调用方控制，用于分批读取结果
- 接口详情页：https://www.gugudata.com/api/details/college
- 接口 Markdown：https://www.gugudata.com/api/details/college/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `keywords` | 是 | `string` | KEYWORDS | 搜索关键字，模糊匹配高校名称、省市区、高校旧称、地址字段，参数值为空则返回所有数据 | 关键词由用户输入或从上一轮内容抽取结果中生成 |
| `uuid` | 否 | `string` | - | 咕咕数据平台高校唯一 ID，可按响应字段 SchoolUUID 精确查询高校基础信息 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `pageindex` | 否 | `integer` | 1 | 页码，第几页数据，用于控制分页 | 分页参数由调用方控制，用于分批读取结果 |
| `pagesize` | 否 | `integer` | 10 | 每页数据量，参数最大值为 20，用于控制分页 | 分页参数由调用方控制，用于分批读取结果 |
| `keywordstrict` | 否 | `boolean` | false | 控制 keyword 参数在查询时是否进行模糊查询，true 为精确匹配高校名称，默认值为 false 进行模糊查询，可模糊匹配高校名称、省市区、高校旧称、地址字段。参数值为空则返回所有数据 | 关键词由用户输入或从上一轮内容抽取结果中生成 |
| `collegecategory` | 否 | `string` | - | 学院类别，参数默认值为空，不进行筛选。参数可选枚举值：理工类\|综合类\|师范类\|财经类\|医药类\|艺术类\|农林类\|军事类\|政法类\|语言类\|体育类\|民族类\|其它 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `collegetype` | 否 | `string` | - | 学院性质，参数默认值为空，不进行筛选。参数可选枚举值: 普通本科\|远程教育学院\|中外合作办学\|\|独立学院\|高职高专\|HND项目\|其它\|成人教育\|专科（高职） | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `is985` | 否 | `boolean` | - | 是否为 985 院校，需要参与查询则传参为：true | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `is211` | 否 | `boolean` | - | 是否为 211 院校，需要参与查询则传参为：true | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `isdualclass` | 否 | `boolean` | - | 是否为双一流院校，需要参与查询则传参为：true | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/college/llm.md

### 全国中学基础信息

- 业务角色：中学位置
- 调用阶段：机构数据
- 接口地址：`GET https://api.gugudata.com/metadata/middle-school`
- 产出用途：用于查询全国中学基础信息。
- 参数来源：分页参数由调用方控制，用于分批读取结果；地区参数来自用户输入、行政区划查询结果或定位结果
- 接口详情页：https://www.gugudata.com/api/details/middleschool
- 接口 Markdown：https://www.gugudata.com/api/details/middleschool/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `pageIndex` | 是 | `integer` | 1 | 页码，第几页数据 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 是 | `integer` | 10 | 每页数据量，参数最大值为 20 | 分页参数由调用方控制，用于分批读取结果 |
| `schoolName` | 否 | `string` | - | 学校名称，模糊搜索，参数默认值为空，不进行筛选 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `provinceName` | 否 | `string` | - | 学校所在省份，参数默认值为空，不进行筛选 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `schoolType` | 否 | `string` | ALL | 中学类型：ALL (不限制) \| MIDDLE_SCHOOL (初级中学) \| HIGH_SCHOOL (高级中学) | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `cityName` | 否 | `string` | - | 学校所在城市，参数默认值为空，不进行筛选 | 地区参数来自用户输入、行政区划查询结果或定位结果 |

### 手机归属地查询

- 业务角色：手机归属地
- 调用阶段：归属地
- 接口地址：`GET https://api.gugudata.com/sms/mobileattribution`
- 产出用途：用于手机号码归属地查询。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 接口详情页：https://www.gugudata.com/api/details/mobileattribution
- 接口 Markdown：https://www.gugudata.com/api/details/mobileattribution/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `mobile` | 是 | `string` | YOUR_VALUE | 查询的手机号码 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 国际手机号码检查纠正

- 业务角色：国际号码
- 调用阶段：归属地
- 接口地址：`GET https://api.gugudata.com/sms/internationalphone`
- 产出用途：用于国际手机号码检查纠正。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 接口详情页：https://www.gugudata.com/api/details/internationalphone
- 接口 Markdown：https://www.gugudata.com/api/details/internationalphone/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `phone` | 是 | `string` | PHONE | 查询的手机号码，如 +1(817) 569-8900 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `countrycode` | 否 | `string` | COUNTRY_CODE | ISO-3166 标准的两位或三位国家代码，用于校验号码在提供的归属国家是否为有效号码，如 US, USA，不传递则智能纠错 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

## 数据校验与使用边界

- 行政区划和机构地址可能随时间调整，需要标注数据更新时间或复核来源。
- IP 定位通常只能作为粗粒度参考，不适合精确定位个人位置。
- 坐标转换前必须确认原始坐标系。

## 输出建议

- 输出地址结果时按国家、省、市、区县、街道逐级展示。
- 对地图场景同时输出坐标、坐标系和行政归属。
- 对无法定位或多候选地址给出候选列表和复核建议。

## 常见问题

- 问：什么情况下应该使用这个 Skill？ 答：当用户提出的目标需要多个咕咕数据公开 API 组合完成，而不是只查询一个接口时，优先阅读这个 Skill。
- 问：这个 Skill 是否需要单独购买？ 答：不需要。Skill 文档只负责业务流程和接口选型，具体接口购买、价格和账号权益仍以接口详情页为准。
- 问：Agent 应该怎样使用这个 Skill？ 答：Agent 应先阅读 SKILL.md，确认业务场景和推荐工作流，再进入接口详情页核对参数、响应字段、价格和调用示例。
- 问：调用接口前需要先核对什么？ 答：需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
- 问：地理位置与行政区划 Skill 会替代接口文档吗？ 答：不会。Skill 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。