地理位置与行政区划 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

关键请求参数：

国家地区基础信息数据

• 业务角色：国家地区
• 调用阶段：基础区域
• 接口地址：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

关键请求参数：

国内 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 地址定位

• 业务角色：国际 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

关键请求参数：

地理坐标系转换

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

关键请求参数：

全国三甲医院主体信息

• 业务角色：三甲医院
• 调用阶段：机构数据
• 接口地址：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

关键请求参数：

全国大学高校基础信息

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

关键请求参数：

完整请求参数、响应字段和调用示例以接口 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

关键请求参数：

手机归属地查询

• 业务角色：手机归属地
• 调用阶段：归属地
• 接口地址：GET https://api.gugudata.com/sms/mobileattribution
• 产出用途：用于手机号码归属地查询。
• 参数来源：号码来自用户输入、表单线索或上一轮内容抽取结果
• 接口资料：详情页 https://www.gugudata.com/api/details/mobileattribution；接口 Markdown https://www.gugudata.com/api/details/mobileattribution/llm.md

关键请求参数：

国际手机号码检查纠正

• 业务角色：国际号码
• 调用阶段：归属地
• 接口地址：GET https://api.gugudata.com/sms/internationalphone
• 产出用途：用于国际手机号码检查纠正。
• 参数来源：号码来自用户输入、表单线索或上一轮内容抽取结果；国家地区来自用户输入、国家地区接口或业务目标市场
• 接口资料：详情页 https://www.gugudata.com/api/details/internationalphone；接口 Markdown https://www.gugudata.com/api/details/internationalphone/llm.md

关键请求参数：

数据校验与使用边界

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

输出建议

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

常见问题

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