{"id":"5fb43bcf-a0de-4bb8-ab95-12703ea6591c","entityType":"agent","slug":"clawhub-baidu-maps-baidu-map-webapi","name":"Baidu Map WebAPI（百度地图官方Web服务 SKills）","canonicalUrl":"https://www.xpersona.co/agent/clawhub-baidu-maps-baidu-map-webapi","canonicalPath":"/agent/clawhub-baidu-maps-baidu-map-webapi","generatedAt":"2026-10-10T11:49:42.662Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:36:15.178Z","emptyReason":null},"description":"百度地图 webapi 开发指南。在编写、审查或调试使用百度地图webAPI的代码时应运用此技能，也适用于直接调用百度地图API获取结果的场景。涵盖：地图位置搜索、POI检索、路线规划、建议出发时间、路线耗时预测、实时路况、行政区划查询、地址坐标转换、沿途交通事件、天气查询、智能推荐上车点等。当用户提及出发时间、...","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.5K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s178nge8tvzzhnan6cc08q0ech84dmtm:baidu-map-webapi","sourceUrl":"https://clawhub.ai/baidu-maps/baidu-map-webapi","homepage":"https://clawhub.ai/baidu-maps/skills/baidu-map-webapi","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/baidu-maps/baidu-map-webapi","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/baidu-maps/skills/baidu-map-webapi","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Baidu Map WebAPI（百度地图官方Web服务 SKills） technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:36:15.178Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:36:15.178Z","emptyReason":null},"stars":null,"forks":null,"downloads":1522,"packageName":null,"latestVersion":"1.0.8","tractionLabel":"1.5K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:36:15.178Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T09:36:15.178Z","lastCrawledAt":"2026-10-10T09:36:15.178Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T09:36:15.178Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.8","createdAt":"2026-06-01T03:39:22.438Z","changelog":"- Removed two documentation files: _meta.json and skill-card.md. - No changes to functionality or APIs. - No updates to user-facing features; guides and interface remain the same.","fileCount":33,"zipByteSize":89134},{"version":"1.0.7","createdAt":"2026-04-07T07:04:40.918Z","changelog":"No file or documentation changes were detected in this version. - No updates or modifications were made in version 1.0.7.","fileCount":33,"zipByteSize":88940},{"version":"1.0.6","createdAt":"2026-04-07T03:17:31.072Z","changelog":"Version 1.0.6 - 新增 _meta.json 文件，完善技能元数据管理。","fileCount":32,"zipByteSize":87420},{"version":"1.0.5","createdAt":"2026-03-20T04:43:29.103Z","changelog":"Version 1.0.5 - 环境变量名称从 BAIDU_MAP_AK 改为 BMAP_WEBAPI_AK（含所有相关处用法与说明同步更新） - 依赖和 metadata 格式规范化，采用 openclaw 标准结构 - AK 获取和设置流程文本做细化，明确“服务端”AK的申请要求 - 删除对体验端点的调用流程中的用户确认相关内容 - 其它文本规范优化，内容未新增或删除任何API或recipe","fileCount":32,"zipByteSize":87420},{"version":"1.0.4","createdAt":"2026-03-20T04:28:51.464Z","changelog":"baidu-map-webapi 1.0.4 - 增加 repository 字段，补充技能源代码仓库地址 - 补充 requires 字段，声明所需环境变量 - 新增 metadata 字段，丰富技能元信息（如 emoji、依赖项、主环境变量） - 版本号由 1.0.3 升级至 1.0.4 - 其余内容未变，功能无新增或更新","fileCount":32,"zipByteSize":88140},{"version":"1.0.3","createdAt":"2026-03-20T04:13:51.470Z","changelog":"更新已知问题","fileCount":32,"zipByteSize":88075},{"version":"1.0.1","createdAt":"2026-03-20T03:36:55.774Z","changelog":"更新AK获取方式, 改为更安全的环境变量读取, 删除自动更换端点URL场景","fileCount":32,"zipByteSize":87400},{"version":"1.0.0","createdAt":"2026-03-16T06:10:02.188Z","changelog":"1. 初始版本发布 2. 增加百度地图 webapi-skills (baidu-map-webapi) 3. 百度地图 WebAPI 的 AI 助手 Skills，涵盖 POI 检索、路线规划、地理编码、天气查询等，适配 Claude / Cursor 等 AI 客户端。","fileCount":33,"zipByteSize":88436}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s178nge8tvzzhnan6cc08q0ech84dmtm:baidu-map-webapi","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s178nge8tvzzhnan6cc08q0ech84dmtm:baidu-map-webapi` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/baidu-maps/baidu-map-webapi before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-webapi/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-webapi/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-webapi/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-webapi/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-webapi/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-webapi/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T11:49:42.658Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-webapi/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-webapi/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-webapi/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-baidu-map-webapi/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:36:15.178Z","emptyReason":null},"readme":"Skill: Baidu Map WebAPI（百度地图官方Web服务 SKills）\n\nOwner: baidu-maps\n\nSummary: 百度地图 webapi 开发指南。在编写、审查或调试使用百度地图webAPI的代码时应运用此技能，也适用于直接调用百度地图API获取结果的场景。涵盖：地图位置搜索、POI检索、路线规划、建议出发时间、路线耗时预测、实时路况、行政区划查询、地址坐标转换、沿途交通事件、天气查询、智能推荐上车点等。当用户提及出发时间、...\n\nTags: latest:1.0.8\n\nVersion history:\n\nv1.0.8 | 2026-06-01T03:39:22.438Z | user\n\n- Removed two documentation files: _meta.json and skill-card.md.\n- No changes to functionality or APIs.\n- No updates to user-facing features; guides and interface remain the same.\n\nv1.0.7 | 2026-04-07T07:04:40.918Z | user\n\nNo file or documentation changes were detected in this version.\n\n- No updates or modifications were made in version 1.0.7.\n\nv1.0.6 | 2026-04-07T03:17:31.072Z | user\n\nVersion 1.0.6\n\n- 新增 _meta.json 文件，完善技能元数据管理。\n\nv1.0.5 | 2026-03-20T04:43:29.103Z | user\n\nVersion 1.0.5\n\n- 环境变量名称从 BAIDU_MAP_AK 改为 BMAP_WEBAPI_AK（含所有相关处用法与说明同步更新）\n- 依赖和 metadata 格式规范化，采用 openclaw 标准结构\n- AK 获取和设置流程文本做细化，明确“服务端”AK的申请要求\n- 删除对体验端点的调用流程中的用户确认相关内容\n- 其它文本规范优化，内容未新增或删除任何API或recipe\n\nv1.0.4 | 2026-03-20T04:28:51.464Z | user\n\nbaidu-map-webapi 1.0.4\n\n- 增加 repository 字段，补充技能源代码仓库地址\n- 补充 requires 字段，声明所需环境变量\n- 新增 metadata 字段，丰富技能元信息（如 emoji、依赖项、主环境变量）\n- 版本号由 1.0.3 升级至 1.0.4\n- 其余内容未变，功能无新增或更新\n\nv1.0.3 | 2026-03-20T04:13:51.470Z | user\n\n更新已知问题\n\nv1.0.1 | 2026-03-20T03:36:55.774Z | user\n\n更新AK获取方式, 改为更安全的环境变量读取, 删除自动更换端点URL场景\n\nv1.0.0 | 2026-03-16T06:10:02.188Z | user\n\n1. 初始版本发布\n2. 增加百度地图 webapi-skills (baidu-map-webapi)\n3. 百度地图 WebAPI 的 AI 助手 Skills，涵盖 POI 检索、路线规划、地理编码、天气查询等，适配 Claude / Cursor 等 AI 客户端。\n\nArchive index:\n\nArchive v1.0.8: 33 files, 89134 bytes\n\nFiles: recipes/address_to_full_location.md (2798b), recipes/address_to_poi.md (3253b), recipes/coordinate_to_structured_address.md (2660b), recipes/nearby_poi_search.md (3249b), recipes/poi_search_to_detail.md (2898b), recipes/route_to_named_place.md (3428b), recipes/smart_departure_time.md (3109b), recipes/traffic_aware_route.md (2905b), recipes/weather_query.md (8504b), references/admin_division_query.md (5257b), references/administrative_region_search.md (11699b), references/capabilities/driving_route_duration.md (2169b), references/capabilities/future_driving_route.md (2040b), references/capabilities/suggested_departure_time.md (1875b), references/capabilities/waypoint_route_planning.md (1870b), references/circular_region_search.md (11139b), references/constants.md (2745b), references/cycling_route_planning.md (8538b), references/domestic_weather_query.md (9230b), references/driving_route_planning.md (15150b), references/geocoding.md (7917b), references/global_reverse_geocoding.md (12529b), references/motorcycle_route_planning.md (11016b), references/multi_dimensional_search.md (11468b), references/overseas_weather_query.md (6416b), references/place_detail_search.md (10185b), references/place_input_suggestion.md (7801b), references/reverse_geocoding_agent.md (11084b), references/transit_route_planning.md (6249b), references/walking_route_planning.md (7277b), skill-card.md (3282b), SKILL.md (8793b), _meta.json (135b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: baidu-map-webapi\ndescription: 百度地图 webapi 开发指南。在编写、审查或调试使用百度地图webAPI的代码时应运用此技能，也适用于直接调用百度地图API获取结果的场景。涵盖：地图位置搜索、POI检索、路线规划、建议出发时间、路线耗时预测、实时路况、行政区划查询、地址坐标转换、沿途交通事件、天气查询、智能推荐上车点等。当用户提及出发时间、导航路线、地点查询、坐标转换、地图相关开发需求时自动触发。\nlicense: MIT\nversion: 1.0.5\nhomepage: https://lbs.baidu.com\nrepository: https://github.com/baidu-maps/webapi-skills\nmetadata:\n  openclaw:\n    requires:\n      bins: [\"curl\"]\n      env: BMAP_WEBAPI_AK\n    primaryEnv: BMAP_WEBAPI_AK\n---\n\n# webapi 开发指南\n\n百度地图 webapi 版本开发指南。包含地图位置搜索、路线导航、行政区划等核心模块的 API 说明和代码示例，既可直接调用 API 获取结果，也可帮助开发者快速集成百度地图服务。\n\n## 何时适用\n\n遇到以下任意场景时，均应读取本指南并调用对应 API：\n\n### 路线规划与出行决策\n- 规划驾车、步行、骑行、摩托车、公共交通路线\n- **查询从 A 到 B 的建议出发时间**（如\"想晚上8点到达，几点出发合适\"）\n- **预测未来某时刻出发的路线耗时**（如\"下午3点出发要多久\"）\n- 查询历史路况下的路线耗时\n- 规划含多个途经点的最优路线\n\n### 实时动态信息\n- 查询路线沿途的动态交通事件（事故、拥堵、施工等）\n- 查询海外城市天气信息\n\n### 地点与POI搜索\n- 查找城市中的餐厅、酒店、景点等 POI 信息\n- 在指定圆形区域内检索地点\n- 按行政区划检索地点\n- 多条件组合检索 POI\n- 获取 POI 详细信息\n- 输入联想/地点补全提示\n- 智能推荐安全上车点\n\n### 地址与坐标转换\n- 地址文本解析为经纬度坐标（地理编码）\n- 经纬度坐标解析为地址信息（逆地理编码）\n\n### 行政区划与区域查询\n- 查询行政区划地点\n- 获取行政区划边界坐标\n\n## 开发准则\n\n在使用本技能的任何场景中，请遵守以下通用准则：\n\n### 准则 1：API 端点选择\n\n百度地图提供两个服务端点，必须根据使用场景选择正确的端点：\n\n| 端点类型 | Base URL | 适用场景 |\n|---|---|---|\n| **标准端点** | `https://api.map.baidu.com/` | 正式开发、生产环境、为用户生成的代码 |\n| **高级功能体验端点** | `https://api.map.baidu.com/map_service/` | 百度地图官方提供，仅供大模型直接调用时快速体验高级权限功能 |\n\n**使用规则：**\n- 为用户生成的开发代码，**必须使用标准端点** `https://api.map.baidu.com/`\n- **大模型直接调用高级权限功能（如建议出发时间、未来路线规划）进行演示/体验时，使用体验端点**\n- **体验端点仅供功能体验和演示，不可用于开发或生产环境**\n- **均需要AK凭证**\n- **调用体验端点前，必须向用户说明：① 将使用体验端点发起外部 API 调用；② 该调用会消耗用户 AK 的配额；并获得用户明确确认后方可执行**\n\n\n### 准则 2：AK 凭证安全处理\n\nAK（Access Key）是使用技能之前的必须参数:\n\n1. 优先读取环境变量 `BMAP_WEBAPI_AK` 中的 AK\n2. `BMAP_WEBAPI_AK`为空时, 提示用户:**请先前往[百度地图开放平台](https://lbs.baidu.com/apiconsole/key)申请`服务端`的AK**\n3. 然后设置为环境变量\n```\nexport BMAP_WEBAPI_AK=\"百度地图AK\"\n```\n4. 使用 references/ 所有能力时的ak参数请使用 `$BMAP_WEBAPI_AK`, 示例如下:\n```\ncurl \"https://api.map.baidu.com/place/v3/region?query=美食&region=北京&ak=$BMAP_WEBAPI_AK\"\n```\n\n### 准则 3：地址/地名统一通过 `address_to_poi` 转换\n\n任何需要将**用户输入的地名或地址文本**转换为坐标/UID 的场景，**优先参考**：\n\n> `recipes/address_to_poi.md` — 地址/地名转坐标与 POI UID\n\n该文件描述了两种输入类型的判断方法和对应调用方式：\n- **结构化地址**（含门牌号/楼栋）→ `references/geocoding` API\n- **POI 名称/地标/商家名** → `references/administrative_region_search` API\n\n### 准则 4：算路时 UID 优先于纯坐标\n\n向算路接口（驾车/步行/骑行/公交）传参时：\n\n```\n推荐：同时传坐标 + uid（绑路更精准，尤其对大型 POI） origin_uid / destination_uid 有值时必传\n```\n\nUID 通过 `references/address_to_poi.md` 描述的方法获取。\n\n---\n\n## 场景示例（推荐优先阅读）\n\n遇到以下场景时，**优先使用对应 recipe**，内含完整调用链、参数说明和可运行代码示例。\n单个 API 用法请查阅下方「快速参考」。\n\n### 地址/地名预处理（算路前必读）\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/address_to_poi.md` | 地址文本或地名 → 坐标 + POI UID（算路前置步骤） | 标准 AK |\n\n### 路线规划\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/route_to_named_place.md` | 用户说出地名 → 规划驾车路线 | 标准 AK |\n| `recipes/smart_departure_time.md` | \"几点出发才能准时到\" | ⚠️ 高级权限 |\n| `recipes/traffic_aware_route.md` | 预测未来某时刻出发的路况耗时 | ⚠️ 高级权限 |\n\n### POI 搜索\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/nearby_poi_search.md` | 搜索用户附近的某类地点 | 标准 AK |\n| `recipes/poi_search_to_detail.md` | 关键词搜索 → 获取 POI 完整详情 | 标准 AK |\n\n### 地址与坐标\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/address_to_full_location.md` | 地址文本 → 坐标 + 行政区划 | 标准 AK |\n| `recipes/coordinate_to_structured_address.md` | 坐标 → 结构化地址 + 行政区划 | 标准 AK |\n\n### 天气查询\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/weather_query.md` | 通过城市名称/行政区划编码/坐标, 获取当地详细的天气信息 | 标准 AK |\n\n---\n\n## 快速参考\n\n### 基础概念\n\n- `references/constants.md` - 通用常量：状态码\n\n### 位置搜索\n\n- `references/global_reverse_geocoding.md` - 全球逆地理编码: 坐标转位置信息\n- `references/reverse_geocoding_agent.md` - 逆地理编码智能体: 智能逆地理编码地址解析\n- `references/administrative_region_search.md` - 行政区划区域检索: 行政区划地点检索\n- `references/circular_region_search.md` - 圆形区域检索: 圆形区域地点检索\n- `references/multi_dimensional_search.md` - 多维检索: 多条件智能检索POI\n- `references/place_detail_search.md` - 地点详情检索: 获取指定地点详细信息\n- `references/place_input_suggestion.md` - 地点输入提示: 地点输入提示匹配\n- `references/geocoding.md` - 地理编码: 地址解析为坐标\n\n### AOI区域\n\n- `references/admin_division_query.md` - 行政区划查询: 查询中国行政区划信息\n\n### 动态数据\n\n- `references/domestic_weather_query.md` - 国内天气查询: 国内天气查询多功能接口\n- `references/overseas_weather_query.md` - 海外天气查询: 查询海外城市天气\n\n### 路线导航\n\n- `references/cycling_route_planning.md` - 骑行路线规划: 骑行路线规划方案检索\n- `references/driving_route_planning.md` - 驾车路线规划: 驾车路线规划与路况预测\n    - `references/capabilities/driving_route_duration.md` - 驾车路线历史耗时: 设置驾车路线历史耗时\n    - `references/capabilities/future_driving_route.md` - 未来驾车路线规划: 预测未来驾车路线耗时\n    - `references/capabilities/suggested_departure_time.md` - 建议出发时间: 高级权限出行时间建议\n    - `references/capabilities/waypoint_route_planning.md` - 途经点智能路线规划: 智能优化途经点顺序\n- `references/motorcycle_route_planning.md` - 摩托车路线规划: 摩托车路线规划服务\n- `references/transit_route_planning.md` - 公交路线规划: 多交通方式路线规划\n- `references/walking_route_planning.md` - 步行路线规划: 步行路线规划\n\n## 如何使用\n\n**推荐决策路径**：\n1. 用户需求是**多步串联场景**（如\"输入地名规划路线\"、\"获取附近 POI\"）→ 直接找 `recipes/` 目录下对应 recipe\n2. 用户需求是**单个 API 的参数细节**（如\"这个接口的 tactics 参数有哪些值\"）→ 查阅 `references/` 目录\n\n每个 **references** 参考文件包含：\n- 功能简要说明\n- API 参数说明和注意事项\n\n每个 **recipes** 场景包含：\n- 触发意图（什么场景适用）\n- 完整调用链与分步说明\n- 常见错误和变体\n\nFile v1.0.8:_meta.json\n\n{\n  \"ownerId\": \"kn778b6bf766ym71fdvrc5yvg98319rv\",\n  \"slug\": \"baidu-map-webapi\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1780285162438\n}\n\nFile v1.0.8:references/admin_division_query.md\n\n# 百度地图行政区划查询 API\n\n## 服务概述\n\n行政区划查询接口用于获取中国行政区划的详细信息。支持通过行政区划名称或adcode进行查询，返回结果包括行政区划的边界坐标、中心点、父级行政区划、行政区划级别等详细信息。该接口适用于需要行政区划数据的各类应用场景，如地图应用、数据分析、地址解析等。\n\n- **版本**: 2.0.0\n- **服务标识**: `region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/district-search/base>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/api_region_search/v1/`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| ak | string | T | - | 开发者密钥，即API Key，用于身份验证和配额管理。 | E4805d16520de693a3fe707cdc962045 |\n| keyword | string | T | - | 检索行政区划关键字。仅支持单关键字检索，可填写行政区名称（如“中国”“全国”、省/市/区/镇名称）或 adcode。 | 河北 |\n| sub_admin | string |  | 0 | 行政区划显示子级级数。可填 0、1、2、3 等：0 不返回下级；1 返回下一级；2 返回下两级；3 返回下三级，以此类推。 | 2 |\n| extensions_code | string (enum: 0, 1) |  | 0 | 是否召回国标行政区划编码，1 为召回，0 为不召回。 | 1 |\n| boundary | string (enum: 0, 1) |  | 0 | 是否返回区划边界数据：0 不返回，1 返回。仅返回查询行政区划的边界，不返回子级边界；仅支持省/市/区边界，暂不支持乡镇/街道。 | 1 |\n| boundarycode | string |  | - | 需要返回边界数据的行政区划编码。若输入 adcode 则返回该 adcode 边界；若未输入或输入错误，则返回 keyword 匹配到的第一个行政区划边界。 | 110112 |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"result\": {\n    \"name\": \"北京市\",\n    \"level\": \"province\",\n    \"adcode\": \"110000\",\n    \"parent\": {\n      \"name\": \"中国\",\n      \"adcode\": \"100000\"\n    },\n    \"boundary\": \"116.123,39.123;116.456,39.456\",\n    \"children\": [\n      {\n        \"name\": \"东城区\",\n        \"level\": \"district\",\n        \"adcode\": \"110101\"\n      }\n    ],\n    \"location\": {\n      \"lat\": 39.929986,\n      \"lng\": 116.395645\n    }\n  },\n  \"status\": 0,\n  \"message\": \"ok\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的描述信息。 | ok |\n| `result` | object |  | 查询结果对象。 | None |\n| `result.adcode` | string |  | 行政区划代码。 | 110000 |\n| `result.boundary` | string |  | 行政区划边界坐标，格式为经纬度坐标串，需设置 boundary=1 时返回。 | 116.123,39.123;116.456,39.456 |\n| `result.children` | array |  | 子级行政区划列表，当 sub_admin 大于 0 时返回。 | None |\n| `result.children[].adcode` | string |  | 子级行政区划代码。 | 110101 |\n| `result.children[].level` | string |  | 子级行政区划级别。 | district |\n| `result.children[].name` | string |  | 子级行政区划名称。 | 东城区 |\n| `result.level` | string (enum: country, province, city... (共5个值)) |  | 行政区划级别，如 country、province、city、district、town 等。 | province |\n| `result.location` | object |  | 行政区划的中心点坐标。 | None |\n| `result.location.lat` | number |  | 中心点纬度。 | 39.929986 |\n| `result.location.lng` | number |  | 中心点经度。 | 116.395645 |\n| `result.name` | string |  | 行政区划名称。 | 北京市 |\n| `result.parent` | object |  | 父级行政区划信息。 | None |\n| `result.parent.adcode` | string |  | 父级行政区划代码。 | 100000 |\n| `result.parent.name` | string |  | 父级行政区划名称。 | 中国 |\n| `status` | integer |  | 返回结果状态码，0表示成功，其他值为错误码。<br/><br/>**枚举值说明：**<br/>`0`: ok：正常<br/>`1`: 服务器内部错误：服务器端出现未知错误，请稍后重试<br/>`2`: 请求参数非法：请求参数缺失或格式错误<br/>`3`: 权限校验失败：ak无效或没有权限<br/>`4`: 配额校验失败：访问超出配额限制<br/>`5`: ak不存在或被封禁：ak不存在或已被封禁，请检查ak状态<br/>`101`: 服务禁用：该服务已被禁用<br/>`102`: 不通过白名单或安全码不对：服务器没有开启白名单，或安全码不对 | 0 |\n\n### 常见问题\n\n**Q: 支持查询哪些级别的行政区划？**\n\nA: 支持国家(country)、省(province)、市(city)、区/县(district)级别的行政区划查询\n\n**Q: 如何获取行政区划的边界坐标？**\n\nA: 设置 boundary=1 可返回边界坐标串（boundary 字段），格式为'经度,纬度;经度,纬度;...'\n\n**Q: 如何获取下一级行政区划？**\n\nA: 设置 sub_admin 大于 0 可返回子级行政区划；如 sub_admin=1 返回下一级，sub_admin=2 返回下两级\n\n**Q: 边界坐标使用什么坐标系？**\n\nA: 返回的边界坐标使用百度BD-09坐标系\n\n**Q: 如何获取ak？**\n\nA: 需要在百度地图开放平台控制台（https://lbsyun.baidu.com/）注册并创建应用获取API Key\n\nFile v1.0.8:references/administrative_region_search.md\n\n# 百度地图地点检索及联想 API\n\n## 服务概述\n\n开发者可通过该功能，检索某一行政区划内（目前最细到区县级别）的地点信息。支持通过关键字、POI类型、区域限制、排序、分页等多种参数进行精细化检索。\n\n- **版本**: 2.0.0\n- **服务标识**: `administrative_region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/guide/webservice-placeapiV3/interfaceDocumentV3>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/place/v3/region`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| query | string | T | - | 检索关键字。 | ATM机、美食 |\n| region | string | T | - | 检索行政区划区域（支持到区县级）。增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用region_limit参数。可输入行政区划名或对应citycode。 | 北京市海淀区 |\n| ak | string | T | - | 开发者的访问密钥，必填项。v2之前该属性为key。 | 您的AK |\n| region_limit | boolean |  | - | 区域数据召回限制，为true时，仅召回region对应区域内数据。 | False |\n| is_light_version | boolean |  | False | true：轻量化检索，检索速度大幅提升，排序更简单直接；false（默认）：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验。 | False |\n| type | string |  | - | 对query召回结果进行二次筛选，type内容建议参考POI分类，建议query同属于一个大类；如query=美食 type=火锅（用于泛搜索场景）。query和type支持只填一项。 | 火锅 |\n| center | string |  | - | 传入poi坐标，辅助检索结果按距离排序与返回。需要搭配排序字段一起使用并结合coord_type字段说明该字段的坐标类型。 | 38.76623,116.43213 |\n| scope | integer (enum: 1, 2) |  | - | 检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息。 | - |\n| coord_type | integer (enum: 1, 2, 3, 4) |  | 3 | 传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）。 | - |\n| filter | string |  | - | 检索排序条件，包含以下3部分：industry_type（行业类型：hotel/cater/life）；sort_name（排序方式：default/price/overall_rating/distance）；sort_rule（排序规则：0从高到低，1从低到高）。 | industry_type:cater,sort_name:overall_rating,sort_rule:1 |\n| extensions_adcode | boolean |  | - | 是否召回国标行政区划编码。 | False |\n| address_result | boolean (enum: false) |  | - | query传入结构化地址时，控制返回数据的类型。若不传入该字段，可能会召回门址数据，当address_result=false时，召回相应的POI数据避免召回门址数据。 | False |\n| photo_show | boolean |  | False | 是否输出图片信息：true(输出)，false(不输出)。购买商用授权后可申请开通。 | False |\n| from_language | string |  | 中文 | 入参query的语言类型，支持不同语言的检索词作为入参，不填默认为中文，可以设置为auto，大模型会自行判断入参语言。 | auto |\n| language | string |  | 中文 | 召回结果的语言类型，支持多种语言召回结果，默认为中文。该功能为高级权限功能。 | en，fr |\n| page_num | integer |  | 0 | 分页页码，默认为0,0代表第一页，1代表第二页，以此类推。常与page_size搭配使用，仅当返回结果为poi时可以翻页。 | - |\n| page_size | integer |  | 10 | 单次召回POI数量，默认为10条记录，最大返回20条。取值为10-20。 | 10 |\n| ret_coordtype | string |  | - | 返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标。 | gcj02ll |\n| output | string (enum: json) |  | json | 输出数据格式，仅支持json。 | json |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"status\": 0,\n  \"message\": \"ok\",\n  \"results\": [\n    {\n      \"uid\": \"05478f385d3729eef4eafc16\",\n      \"area\": \"海淀区\",\n      \"city\": \"北京市\",\n      \"name\": \"中国银行ATM(北京上地信息路支行)\",\n      \"town\": \"上地街道\",\n      \"detail\": 1,\n      \"address\": \"上地信息路15号1层104室\",\n      \"location\": {\n        \"lat\": 40.04383967179688,\n        \"lng\": 116.31584460688308\n      },\n      \"province\": \"北京市\",\n      \"town_code\": 110108022\n    }\n  ],\n  \"query_type\": \"general\",\n  \"result_type\": \"poi_type\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。 | ok |\n| `query_type` | string |  | 搜索类型：精搜precise/泛搜general。 | general |\n| `result_type` | string |  | 召回结果类型：region_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型。 | poi_type |\n| `results[]` | object |  |  | None |\n| `results[].adcode` | integer \\| null |  | poi所属区域代码。 | 110101 |\n| `results[].address` | string \\| null |  | poi所在地址。 | 上地信息路15号1层104室 |\n| `results[].area` | string \\| null |  | poi所属区县。 | 海淀区 |\n| `results[].arrival_heat` | number \\| null |  | poi的到达热度（高级权限）。 | 190.65 |\n| `results[].city` | string \\| null |  | poi所属城市。 | 北京市 |\n| `results[].d7_hot_value` | integer \\| null |  | poi近7天的热度总值。 | 211 |\n| `results[].detail` | string \\| null |  | 是否有详情页：1有，0没有。 | 1 |\n| `results[].detail_info` | object \\| null |  | 详细信息。 |  |\n| `results[].detail_info.brand` | string \\| null |  | poi对应的品牌。 | 淮扬菜 |\n| `results[].detail_info.children[]` | object |  |  | None |\n| `results[].detail_info.children[].address` | string \\| null |  | poi子点地址。 | 北京市海淀区新建宫门路19号颐和园内 |\n| `results[].detail_info.children[].classified_poi_tag` | string \\| null |  | poi子点详细分类标签。 | 出入口;门 |\n| `results[].detail_info.children[].location` | object \\| null |  | poi子点坐标。 |  |\n| `results[].detail_info.children[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.children[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.children[].name` | string |  | poi子点名称。 | 颐和园-西门 |\n| `results[].detail_info.children[].show_name` | string \\| null |  | poi子点简称。 | 西门 |\n| `results[].detail_info.children[].uid` | string |  | poi子点ID，可用于poi详情检索。 | 331152d1b94bc54dc41e5148 |\n| `results[].detail_info.classified_poi_tag` | string \\| null |  | POI展示分类（细致分类）。 | 旅游景点;5A景区 |\n| `results[].detail_info.comment_num` | string \\| null |  | poi的评论数。 |  |\n| `results[].detail_info.description` | string \\| null |  | 描述。 |  |\n| `results[].detail_info.detail_url` | string \\| null |  | poi的详情页。 | http://api.map.baidu.com/place/detail?uid=2a7a2... |\n| `results[].detail_info.image_num` | string \\| null |  | poi图片数。 | 10 |\n| `results[].detail_info.indoor_floor` | string \\| null |  | 室内poi所在楼层。 |  |\n| `results[].detail_info.label` | string \\| null |  | poi权威标签，标签细分解释。 | 淮扬菜 |\n| `results[].detail_info.navi_location` | object \\| null |  | poi对应的导航引导点坐标（上车点）。 |  |\n| `results[].detail_info.navi_location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.navi_location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.new_alias` | string \\| null |  | poi别名。 | 故宫 |\n| `results[].detail_info.overall_rating` | string \\| null |  | poi的综合评分。 | 4.7 |\n| `results[].detail_info.parent_id` | string \\| null |  | poi父点id。 | 06d2dffda107b0ef89f15db6 |\n| `results[].detail_info.photos` | array \\| null |  | poi图片的下载链接。购买商用授权后可申请开通。 | [] |\n| `results[].detail_info.price` | string \\| null |  | poi商户的价格。 | 4.7 |\n| `results[].detail_info.ranking` | string \\| null |  | poi的相关榜单排名。 | 北京市展览馆榜NO.1 |\n| `results[].detail_info.shop_hours` | string \\| null |  | poi的营业时间。 | 10:30-14:00,16:30-22:00 |\n| `results[].detail_info.type` | string \\| null |  | 类型，如（hotel、cater、life），配合filter排序。 | hotel |\n| `results[].heat_trend` | string \\| null |  | 近7天热度增长（递减）XX%（高级权限）。 | 近7天热度递减5% |\n| `results[].interact_heat` | number \\| null |  | poi的互动热度（高级权限）。 | 36.05 |\n| `results[].location` | object \\| null |  | poi经纬度坐标。 |  |\n| `results[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].name` | string |  | poi名称，单次请求最多返回10条结果。 | 中国银行ATM(北京上地信息路支行) |\n| `results[].province` | string \\| null |  | poi所属省份。 | 北京市 |\n| `results[].status` | string \\| null |  | poi营业状态 ：空（代表正常营业）、推算位置、暂停营业、可能已关闭、已关闭。 |  |\n| `results[].street_id` | string \\| null |  | poi所在街景图id。 | e176ad06ea2a026cd2f49e2c |\n| `results[].telephone` | string \\| null |  | poi的电话。 |  |\n| `results[].town` | string \\| null |  | poi所属乡镇街道。 | 上地街道 |\n| `results[].town_code` | integer \\| null |  | poi所属乡镇街道编码。 | 110108022 |\n| `results[].uid` | string |  | poi的唯一标示，ID。 | 05478f385d3729eef4eafc16 |\n| `results[].view_heat` | number \\| null |  | poi的浏览热度（高级权限）。 | 2302.75 |\n| `status` | integer |  | 本次API访问状态，如果成功返回0，如果失败返回其他数字。 | 0 |\n| `total` | integer \\| null |  | 召回poi数量，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。 |  |\n\n### 常见问题\n\n**Q: 哪些参数是调用此接口时必须填写的？**\n\nA: query（检索关键字）、region（检索区域）和ak（访问密钥）是三个必填参数。\n\n**Q: 如何严格限制检索结果只返回指定区域内的数据？**\n\nA: 除了填写region参数外，还需要将region_limit参数设置为true，这样将仅召回region对应区域内的数据。\n\n**Q: 如何对检索结果进行排序，例如按距离或评分排序？**\n\nA: 可以使用filter参数进行排序。需要指定industry_type（行业）、sort_name（排序字段，如distance或overall_rating）和sort_rule（排序规则）。按距离排序时还需配合center参数提供中心点坐标。\n\n**Q: 接口支持分页吗？最多能获取多少条数据？**\n\nA: 支持分页，使用page_num和page_size参数。page_size默认为10，最大为20。当启用分页时，total字段表示总条数，但出于数据保护，单次请求total最多显示150条。\n\n**Q: 返回结果中的一些字段（如photos、热度数据）为什么是空的？**\n\nA: 部分字段属于高级功能，例如图片信息(photo_show)、多语言检索(language)、热度数据(view_heat等)需要购买商用授权或联系商务提交工单申请开通后才能返回数据。\n\nFile v1.0.8:references/capabilities/driving_route_duration.md\n\n# 驾车路线规划-历史路线耗时\n\n## 服务概述\n\n该功能需要开通高级权限，开发者可设置更多出发时间（用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个）\n\n- **版本**: 2.0.0\n- **服务标识**: `driving_route_duration`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-logotime>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| ext_departure_time | string |  | - | 更多出发时间，UNIX时间戳。该字段将影响ext_duration字段的返回，用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个），多个时间戳之间用','英文半角逗号隔开。ext_departure_time=1526527619,1526525384,1526523654 目前出发时间仅影响ext_duration字段，还不会影响路线计算和选择。即仍按照现在的路况计算并推荐路线，但将增加返回该路线在其他时间的耗时。不填则不返回ext_duration字段 | 1609459200 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].ext_duration` | integer \\| string \\| null |  | 驾车路线历史耗时（扩展），单位：秒。当设置了ext_departure_time时返回，多个时间戳对应多个耗时以英文逗号分隔，计算失败返回-1。 | 500,520,-1 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.8:references/capabilities/future_driving_route.md\n\n# 驾车路线规划-未来驾车\n\n## 服务概述\n\n该功能需要开通高级权限，开发者可设置出发时间（支持未来7天），UNIX时间戳。该字段将影响duration字段的返回，用于返回未来驾车路线耗时。取值范围：当前时间之后7天*24小时内任意时刻（超出时间范围将预估路线）若设置该参数，则路线规划服务将依据设定时间预测路况和限行规则，并据此计算路线和耗时。\n\n- **版本**: 2.0.0\n- **服务标识**: `future_driving_route`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-time>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| departure_time | string |  | - | 出发时间，UNIX时间戳。支持未来7天任意时刻。设置后将依据设定时间预测路况和限行规则计算路线和耗时（高级权限服务）。 | 1609459200 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].duration` | integer |  | 未来驾车路线耗时（若请求参数设置了符合规则的departure_time，则按照设定出发时间的预测路况计算路线耗时。若未设置departure_time，则按照当前时刻的路况计算路线耗时）或当前路况耗时，单位：秒 | 600 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n| `type` | integer |  | 默认返回2，开发者无需关注 | 2 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.8:references/capabilities/suggested_departure_time.md\n\n# 驾车路线规划-建议出发时间\n\n## 服务概述\n\n该功能需要开通高级权限，开发者设置预期到达时间后,将返回建议出发时间\n\n- **版本**: 2.0.0\n- **服务标识**: `suggested_departure_time`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-suggtime>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| expect_arrival_time | string |  | - | 预期到达时间，UNIX时间戳。取值范围：当前时间之后15分钟任意时刻。设置后将返回suggest_departure_time字段, （小于这个时间则不做处理）若设置此参数，则路线规划服务将依据设定时间计算路线和耗时，并给出建议出发时间, 若算出的suggest_departure_time小于当前时间，则设置suggest_departure_time为-1 | 1609462800 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].suggest_departure_time` | integer \\| null |  | 建议出发时间，单位：秒。当设置了expect_arrival_time时返回，按照预计到达时间预测路况计算路线，并给出建议出发时间，若计算出的时间小于当前时间则返回-1。 | 1609459200 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.8:references/capabilities/waypoint_route_planning.md\n\n# 驾车路线规划-途经点智能路线规划\n\n## 服务概述\n\n该功能需要开通高级权限，传入多个途经点，综合考虑路况、交规限行、 途经点的相对位置以及路线整体的绕路成本等，支持智能调整途经点顺序，给出最优路线。\n\n- **版本**: 2.0.0\n- **服务标识**: `waypoint_route_planning`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-aiplan>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| intelligent_plan | integer (enum: 0, 1) |  | 0 | 是否执行途经点智能规划，综合考虑路况、限行、途经点相对位置及绕路成本，支持智能调整途经点顺序可选值：0（默认值）：不执行途经点智能规划1：执行途经点智能规划（高级权限服务）。 | 1 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].suggest_departure_time` | integer \\| null |  | 建议出发时间，单位：秒。当设置了expect_arrival_time时返回，按照预计到达时间预测路况计算路线，并给出建议出发时间，若计算出的时间小于当前时间则返回-1。 | 1609459200 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.8:references/circular_region_search.md\n\n# 百度地图地点检索及联想 API\n\n## 服务概述\n\n开发者可设置圆心坐标和半径，检索圆形区域内的地点信息（POI）。支持多关键字并集检索、按POI分类检索、结果排序、分页、多语言检索等高级功能。当检索半径过大，超过中心点所在城市边界时，检索范围会自动变为该城市范围。\n\n- **版本**: 2.0.0\n- **服务标识**: `circular_region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/guide/webservice-placeapiV3/interfaceDocumentV3>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/place/v3/around`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| query | string | T | - | 检索关键字。支持多个关键字并集检索，不同关键字间以$符号分隔，最多10个。也可通过POI分类进行检索。 | 银行 |\n| location | string | T | - | 圆形区域检索中心点经纬度坐标，格式为“纬度,经度”。不支持多个点。 | 39.915,116.404 |\n| ak | string | T | - | 开发者的访问密钥（API Key），必填项。 | 您的AK |\n| radius | integer |  | 1000 | 圆形区域检索半径，单位为米。默认1000。 | 2000 |\n| radius_limit | boolean |  | - | 是否严格限定召回结果在设置的检索半径范围内。true（是），false（否）。 | True |\n| is_light_version | boolean |  | False | true：优先保证检索速度，排序更简单直接；false（默认）：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序。 | True |\n| type | string |  | - | 对query召回结果进行二次筛选，内容建议参考POI分类。query和type支持只填一项。 | 火锅 |\n| scope | integer (enum: 1, 2) |  | - | 检索结果详细程度。1 或空：返回基本信息；2：返回检索POI详细信息。 | 2 |\n| coord_type | integer (enum: 1, 2, 3, 4) |  | 3 | 传入的坐标类型。1：wgs84ll（GPS经纬度）；2：gcj02ll（国测局经纬度）；3：bd09ll（百度经纬度，默认）；4：bd09mc（百度米制坐标）。 | 3 |\n| filter | string |  | - | 检索排序条件，格式：industry_type:行业\\|sort_name:排序方式\\|sort_rule:排序规则。行业：hotel/cater/life；排序方式：default/price/overall_rating/distance；排序规则：0（从高到低）/1（从低到高）。 | industry_type:cater|sort_name:overall_rating|sort_rule:1 |\n| extensions_adcode | boolean |  | - | 是否召回国标行政区划编码。true（召回）、false（不召回）。 | True |\n| photo_show | boolean |  | False | 是否输出图片信息：true(输出)，false(不输出)。此为高级权限功能。 | False |\n| from_language | string |  | zh | query的语言类型，支持不同语言的检索词。不填默认为中文，可设置为auto（自动判断）。 | auto |\n| language | string |  | zh | 多语言检索，支持多种语言召回结果。默认为中文。此为高级权限功能。 | en |\n| page_num | integer |  | 0 | 分页页码，默认为0（第一页），1代表第二页，以此类推。仅当返回结果为poi时可以翻页。 | 0 |\n| page_size | integer |  | 10 | 单次召回POI数量，默认为10条，最大返回20条。取值范围10-20。 | 10 |\n| ret_coordtype | string |  | - | 返回的坐标类型，添加后POI返回国测局经纬度坐标（gcj02ll）。 | gcj02ll |\n| output | string (enum: json) |  | json | 输出数据格式，仅支持json。 | json |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"status\": 0,\n  \"message\": \"ok\",\n  \"results\": [\n    {\n      \"uid\": \"14cf81e3aae18d1914948ebb\",\n      \"area\": \"东城区\",\n      \"city\": \"北京市\",\n      \"name\": \"中国民生银行(北京正义路支行)\",\n      \"town\": \"东华门街道\",\n      \"detail\": 1,\n      \"address\": \"北京市东城区东长安街35号首层西侧\",\n      \"location\": {\n        \"lat\": 39.91518549590169,\n        \"lng\": 116.41350155480602\n      },\n      \"province\": \"北京市\",\n      \"street_id\": \"14cf81e3aae18d1914948ebb\",\n      \"telephone\": \"(010)65284468\",\n      \"town_code\": 110101001\n    }\n  ],\n  \"query_type\": \"general\",\n  \"result_type\": \"poi_type\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。 | ok |\n| `query_type` | string |  | 搜索类型：精搜precise/泛搜general。 | general |\n| `result_type` | string |  | 召回结果类型：region_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型。 | poi_type |\n| `results[]` | object |  |  | None |\n| `results[].adcode` | integer \\| null |  | poi所属区域代码。 | 110101 |\n| `results[].address` | string \\| null |  | poi所在地址。 | 上地信息路15号1层104室 |\n| `results[].area` | string \\| null |  | poi所属区县。 | 海淀区 |\n| `results[].arrival_heat` | number \\| null |  | poi的到达热度（高级权限）。 | 190.65 |\n| `results[].city` | string \\| null |  | poi所属城市。 | 北京市 |\n| `results[].d7_hot_value` | integer \\| null |  | poi近7天的热度总值。 | 211 |\n| `results[].detail` | string \\| null |  | 是否有详情页：1有，0没有。 | 1 |\n| `results[].detail_info` | object \\| null |  | 详细信息。 |  |\n| `results[].detail_info.brand` | string \\| null |  | poi对应的品牌。 | 淮扬菜 |\n| `results[].detail_info.children[]` | object |  |  | None |\n| `results[].detail_info.children[].address` | string \\| null |  | poi子点地址。 | 北京市海淀区新建宫门路19号颐和园内 |\n| `results[].detail_info.children[].classified_poi_tag` | string \\| null |  | poi子点详细分类标签。 | 出入口;门 |\n| `results[].detail_info.children[].location` | object \\| null |  | poi子点坐标。 |  |\n| `results[].detail_info.children[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.children[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.children[].name` | string |  | poi子点名称。 | 颐和园-西门 |\n| `results[].detail_info.children[].show_name` | string \\| null |  | poi子点简称。 | 西门 |\n| `results[].detail_info.children[].uid` | string |  | poi子点ID，可用于poi详情检索。 | 331152d1b94bc54dc41e5148 |\n| `results[].detail_info.classified_poi_tag` | string \\| null |  | POI展示分类（细致分类）。 | 旅游景点;5A景区 |\n| `results[].detail_info.comment_num` | string \\| null |  | poi的评论数。 |  |\n| `results[].detail_info.description` | string \\| null |  | 描述。 |  |\n| `results[].detail_info.detail_url` | string \\| null |  | poi的详情页。 | http://api.map.baidu.com/place/detail?uid=2a7a2... |\n| `results[].detail_info.image_num` | string \\| null |  | poi图片数。 | 10 |\n| `results[].detail_info.indoor_floor` | string \\| null |  | 室内poi所在楼层。 |  |\n| `results[].detail_info.label` | string \\| null |  | poi权威标签，标签细分解释。 | 淮扬菜 |\n| `results[].detail_info.navi_location` | object \\| null |  | poi对应的导航引导点坐标（上车点）。 |  |\n| `results[].detail_info.navi_location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.navi_location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.new_alias` | string \\| null |  | poi别名。 | 故宫 |\n| `results[].detail_info.overall_rating` | string \\| null |  | poi的综合评分。 | 4.7 |\n| `results[].detail_info.parent_id` | string \\| null |  | poi父点id。 | 06d2dffda107b0ef89f15db6 |\n| `results[].detail_info.photos` | array \\| null |  | poi图片的下载链接。购买商用授权后可申请开通。 | [] |\n| `results[].detail_info.price` | string \\| null |  | poi商户的价格。 | 4.7 |\n| `results[].detail_info.ranking` | string \\| null |  | poi的相关榜单排名。 | 北京市展览馆榜NO.1 |\n| `results[].detail_info.shop_hours` | string \\| null |  | poi的营业时间。 | 10:30-14:00,16:30-22:00 |\n| `results[].detail_info.type` | string \\| null |  | 类型，如（hotel、cater、life），配合filter排序。 | hotel |\n| `results[].heat_trend` | string \\| null |  | 近7天热度增长（递减）XX%（高级权限）。 | 近7天热度递减5% |\n| `results[].interact_heat` | number \\| null |  | poi的互动热度（高级权限）。 | 36.05 |\n| `results[].location` | object \\| null |  | poi经纬度坐标。 |  |\n| `results[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].name` | string |  | poi名称，单次请求最多返回10条结果。 | 中国银行ATM(北京上地信息路支行) |\n| `results[].province` | string \\| null |  | poi所属省份。 | 北京市 |\n| `results[].status` | string \\| null |  | poi营业状态 ：空（代表正常营业）、推算位置、暂停营业、可能已关闭、已关闭。 |  |\n| `results[].street_id` | string \\| null |  | poi所在街景图id。 | e176ad06ea2a026cd2f49e2c |\n| `results[].telephone` | string \\| null |  | poi的电话。 |  |\n| `results[].town` | string \\| null |  | poi所属乡镇街道。 | 上地街道 |\n| `results[].town_code` | integer \\| null |  | poi所属乡镇街道编码。 | 110108022 |\n| `results[].uid` | string |  | poi的唯一标示，ID。 | 05478f385d3729eef4eafc16 |\n| `results[].view_heat` | number \\| null |  | poi的浏览热度（高级权限）。 | 2302.75 |\n| `status` | integer |  | 本次API访问状态，如果成功返回0，如果失败返回其他数字。 | 0 |\n| `total` | integer \\| null |  | 召回poi数量，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。 |  |\n\n### 常见问题\n\n**Q: 哪些参数是调用此接口时必须填写的？**\n\nA: query（检索关键字）、location（中心点坐标）、ak（访问密钥）这三个参数是必须填写的。\n\n**Q: 如果设置的检索半径很大，会有什么影响？**\n\nA: 当半径过大，超过中心点所在城市边界时，检索范围会自动变为该城市范围，而不再严格限定为圆形区域。\n\n**Q: 如何对检索结果进行排序？**\n\nA: 可以使用filter参数进行排序，指定行业类型(industry_type)、排序方式(sort_name)和排序规则(sort_rule)，例如按餐饮行业评分从低到高排序。\n\n**Q: 接口是否支持使用英文或其他语言关键字进行检索？**\n\nA: 支持。通过设置from_language参数（如设为'auto'或指定语种代码）可以传入非中文关键字。通过language参数可以指定返回结果的语种，但此为高级权限功能。\n\n**Q: 如何获取POI的图片、详细热度等高级信息？**\n\nA: 需要购买百度地图的商用授权，然后联系商务提交工单申请开通相应的高级权限（如photo_show、view_heat等字段）。\n\nFile v1.0.8:references/constants.md\n\n# 通用常量\n\n## 返回值状态常量\n\n所有 webapi 服务共用的状态码, 部分服务会有自己特有的状态码, 请结合使用\n\n# 返回值状态码说明表\n\n| 返回值 | 定义 | 英文描述 | 常见原因 |\n|--------|------|----------|----------|\n| 0 | 正常 | ok | 服务请求正常召回 |\n| 1 | 服务器内部错误 | - | 该服务响应超时或系统内部错误,请留下联系方式 |\n| 2 | 请求参数非法 | Parameter Invalid | 必要参数拼写错误或漏传(如query和tag请求中均未传入) |\n| 3 | 权限校验失败 | Verify Failure | - |\n| 4 | 配额校验失败 | Quota Failure | 服务当日调用次数已超限,请前往 API控制台 提升(请优先进行开发者认证) |\n| 5 | ak不存在或者非法 | AK Failure | 未传入ak参数;ak已被删除(可前往 回收站 恢复) |\n| 8 | 数据解析失败 | Parse Proto Failure | 一般是query输入有误导致,如query输入特殊字符,全角符号 |\n| 9 | 高级权限校验失败 | Permission Denied | - |\n| 101 | AK参数不存在 | - | 请求消息没有携带AK参数 |\n| 200 | APP不存在,AK有误请检查再重试 | - | 根据请求的ak,找不到对应的服务,请检查ak, url是否正确 |\n| 201 | APP被用户自己禁用,请在控制台解禁 | - | - |\n| 202 | APP被管理员删除 | - | 恶意APP被管理员删除 |\n| 203 | APP类型错误 | - | 当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone(类型22))及Browser(类型3),除此之外其他类型认为是APP类型错误 |\n| 210 | APP IP校验失败 | - | 在申请SERVER类型应用的时候选择IP校验,需要填写IP白名单,如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败 |\n| 211 | APP SN校验失败 | - | SERVER类型APP有两种校验方式IP校验和SN校验,当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败 |\n| 240 | APP 服务被禁用 | - | 用户在API控制台中创建或设置某APP的时候禁用了某项服务,若需开通权限,可进入API控制台为AK勾选对应服务 |\n| 250 | 用户不存在 | - | 根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id |\n| 251 | 用户被自己删除 | - | 该用户处于未激活状态 |\n| 252 | 用户被管理员删除 | - | 恶意用户被加入黑名单 |\n| 260 | 服务不存在 | - | 服务器解析不到用户请求的服务名称 |\n| 261 | 服务被禁用 | - | 该服务已下线 |\n| 302 | 天配额超限,限制访问 | - | 配额超限,如果想增加配额请联系我们 |\n| 401 | 当前并发量已经超过约定并发配额,限制访问 | - | 并发控制超限,请控制并发量或联系我们 |\n\nFile v1.0.8:references/cycling_route_planning.md\n\n# 百度地图骑行路线规划 API\n\n## 服务概述\n\n根据起终点坐标检索符合条件的骑行路线规划方案，支持普通自行车和电动自行车出行方式。\n\n- **版本**: 2.0.0\n- **服务标识**: `direction_v2_riding`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction/cycling>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/riding`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| origin | string | T | - | 起点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815 | 40.01116,116.339303 |\n| destination | string | T | - | 终点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815 | 39.936404,116.452562 |\n| origin_uid | string |  | - | 起点POI的uid（请尽量填写uid，将提升路线规划的准确性。使用地点检索服务或地点输入提示服务获取uid） | - |\n| destination_uid | string |  | - | 终点POI的uid（请尽量填写uid，将提升路线规划的准确性。使用地点检索服务或地点输入提示服务获取uid） | - |\n| coord_type | string (enum: bd09ll, bd09mc, gcj02, wgs84) |  | bd09ll | 输入坐标类型，默认bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度墨卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps设备获取的坐标）。 | - |\n| ret_coordtype | string (enum: bd09ll, gcj02) |  | bd09ll | 输出坐标类型，默认为百度经纬度坐标：bd09ll。可选值：bd09ll：百度经纬度坐标；gcj02：国测局坐标。 | - |\n| output | string (enum: json, xml) |  | json | 表示输出类型，可设置为xml或json | - |\n| riding_type | string (enum: 0, 1) |  | 0 | 骑行类型。默认0：0-普通 1-电动车 | - |\n| road_prefer | integer (enum: 0, 3) |  | 0 | 算路方案。默认0：0-默认路线；3-无逆行且无阶梯的算路方案（不传默认0） | - |\n| ak | string | T | - | 用户的访问权限，AK申请 | 您的AK |\n| sn | string |  | - | 用户的权限签名，当AK设置为SN校验时，该参数必填。SN计算方法请参考相关文档。 | - |\n| timestamp | integer |  | - | 时间戳，与SN配合使用，SN存在时必填 | - |\n| callback | string |  | - | 回调函数，用于解决浏览器请求跨域问题。仅在output=json时，该参数有效。 | - |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `info` | object |  | 版权信息 | None |\n| `info.copyright` | object |  |  | None |\n| `info.copyright.imageUrl` | string |  |  | http://api.map.baidu.com/images/copyright_logo.png |\n| `info.copyright.text` | string |  |  | @2023 Baidu - Data |\n| `message` | string |  | 状态码对应的信息 | ok |\n| `result` | object |  | 返回的结果 | None |\n| `result.destination` | object |  |  | None |\n| `result.destination.destinationPt` | object |  |  | None |\n| `result.destination.destinationPt.lat` | number |  | 终点纬度 | None |\n| `result.destination.destinationPt.lng` | number |  | 终点经度 | None |\n| `result.origin` | object |  |  | None |\n| `result.origin.originPt` | object |  |  | None |\n| `result.origin.originPt.lat` | number |  | 起点纬度 | None |\n| `result.origin.originPt.lng` | number |  | 起点经度 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].destinationLocation` | object |  |  | None |\n| `result.routes[].destinationLocation.lat` | number |  | 路线终点纬度 | None |\n| `result.routes[].destinationLocation.lng` | number |  | 路线终点经度 | None |\n| `result.routes[].distance` | integer |  | 方案距离，单位：米 | 17279 |\n| `result.routes[].duration` | integer |  | 线路耗时，单位：秒 | 5969 |\n| `result.routes[].originLocation` | object |  |  | None |\n| `result.routes[].originLocation.lat` | number |  | 路线起点纬度 | None |\n| `result.routes[].originLocation.lng` | number |  | 路线起点经度 | None |\n| `result.routes[].restrictions_info` | string |  | 限行信息，如 '包含禁行路段\\|包含逆行路段' |  |\n| `result.routes[].restrictions_status` | integer |  | 限行类型，0x01表示禁行；0x02表示逆行 | 0 |\n| `result.routes[].steps` | array |  | 路段信息集合 | None |\n| `result.routes[].steps[].area` | integer |  |  | 0 |\n| `result.routes[].steps[].direction` | integer |  | 当前道路方向角 | 176 |\n| `result.routes[].steps[].distance` | integer |  | 路段距离，单位：米 | 200 |\n| `result.routes[].steps[].duration` | integer |  | 路段耗时，单位：秒 | 60 |\n| `result.routes[].steps[].guidance` | array |  | 诱导信息,有高级权限才能返回 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions` | array |  | 播报详细信息 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].cloud_guide_version` | string |  | 云导版本 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details` | array |  | 播报点详情 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details[].distance_to_gdpt` | integer |  | 播报点与诱导点的距离 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details[].speak_text` | string |  | 播报内容 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details[].voice_level` | integer |  | 音量级别 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].distance_to_origin` | Integer |  | 播报点与起点的距离 | None |\n| `result.routes[].steps[].instructions` | string |  | 路段描述，如'骑行50米' | 骑行200米 |\n| `result.routes[].steps[].leg_index` | integer |  |  | 0 |\n| `result.routes[].steps[].links` | array |  | link信息集合 | None |\n| `result.routes[].steps[].links[].attr` | integer |  | link属性，0x01表示禁行；0x02表示逆行 | 0 |\n| `result.routes[].steps[].links[].length` | integer |  | link长度，单位：米 | 70 |\n| `result.routes[].steps[].name` | string |  | 该路段道路名称，如'信息路'。若道路未命名或百度地图未采集到该道路名称，则返回'无名路'。 |  |\n| `result.routes[].steps[].path` | string |  | 路段位置坐标描述 | 116.339966,40.011176;116.340006,40.010546;116.3... |\n| `result.routes[].steps[].restrictions_info` | string |  | 限行信息 |  |\n| `result.routes[].steps[].restrictions_status` | integer |  | 限行类型，0x01表示禁行；0x02表示逆行 | 0 |\n| `result.routes[].steps[].stepDestinationInstruction` | string |  |  |  |\n| `result.routes[].steps[].stepDestinationLocation` | object |  |  | None |\n| `result.routes[].steps[].stepDestinationLocation.lat` | number |  | 路段终点纬度 | None |\n| `result.routes[].steps[].stepDestinationLocation.lng` | number |  | 路段终点经度 | None |\n| `result.routes[].steps[].stepOriginInstruction` | string |  |  |  |\n| `result.routes[].steps[].stepOriginLocation` | object |  |  | None |\n| `result.routes[].steps[].stepOriginLocation.lat` | number |  | 路段起点纬度 | None |\n| `result.routes[].steps[].stepOriginLocation.lng` | number |  | 路段起点经度 | None |\n| `result.routes[].steps[].turn_type` | string |  | 行驶转向方向，如'直行'、'左前方转弯' | 左转 |\n| `result.routes[].steps[].type` | integer |  |  | 5 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`2001`: 无骑行路线 | 0 |\n| `type` | integer |  | 返回数据类型 | 2 |\n\n### 常见问题\n\n**Q: 起点和终点的坐标格式是什么？小数点后支持几位？**\n\nA: 格式为：纬度,经度（例如：40.01116,116.339303）。小数点后不超过6位。\n\n**Q: 如何提升路线规划的准确性？**\n\nA: 建议填写起点和终点的POI uid（通过地点检索或输入提示服务获取），可显著提升准确性。\n\n**Q: 支持哪些输入和输出的坐标系？**\n\nA: 输入支持bd09ll、bd09mc、gcj02、wgs84；输出支持bd09ll和gcj02。\n\n**Q: 电动车和普通自行车规划有什么区别？**\n\nA: 选择电动车骑行类型（riding_type=1）时，路线规划算法会考虑电动车的通行规则和偏好。\n\n**Q: “无逆行且无阶梯”的算路方案是什么意思？**\n\nA: 选择road_prefer=3时，系统会尽量避免规划包含逆行路段和人行阶梯的路线。\n\nFile v1.0.8:references/domestic_weather_query.md\n\n# 百度地图国内天气查询 API\n\n## 服务概述\n\n国内天气查询接口，支持通过行政区划代码、经纬度坐标或省市区名称查询国内天气信息。可获取实时天气、未来7天预报、逐小时预报、生活指数、气象预警等数据。支持百度坐标（BD-09ll/BD-09mc）、国测局坐标（GCJ-02）、GPS坐标（WGS-84）四种坐标系。适用于天气应用开发、出行规划、农业气象监测、智能家居天气联动等场景。\n\n- **版本**: 2.0.0\n- **服务标识**: `weather`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/weather/base>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/weather/v1/`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| district_id | string |  | - | 区县的行政区划编码，与 location、district 三者必选其一。 | 222405 |\n| location | string |  | - | 经纬度，经度在前纬度在后，逗号分隔。支持 bd09mc/bd09ll/wgs84/gcj02。与 district_id、district 三者必选其一。 | 116.405285,39.904989 |\n| province | string |  | - | 省份名称，用于辅助名称查询。 | 山东省 |\n| city | string |  | - | 城市名称，用于辅助名称查询。 | 济南市 |\n| district | string |  | - | 区县名称，用于名称查询，与 district_id、location 三者必填其一。 | 历下区 |\n| ak | string | T | - | 开发者密钥，在API控制台申请获得。 | hhR4GDGHfREwblbolOYhio8HkHyRdDoq |\n| data_type | string (enum: now, fc, index, alert, fc_hour...) | T | - | 请求数据类型，控制返回内容。可选值：now(实时天气)、fc(7天预报)、index(生活指数)、alert(气象预警)、fc_hour(逐小时预报)、all(全部)。 | all |\n| output | string (enum: json, xml) |  | json | 返回格式，支持 json/xml，默认为 json。 | json |\n| coordtype | string (enum: wgs84, bd09ll, bd09mc, gcj02) |  | wgs84 | 坐标类型。支持 wgs84/bd09ll/bd09mc/gcj02，默认为 wgs84。 | wgs84 |\n| callback | string |  | - | JSONP 回调函数名，当 output=json 时有效。 | showWeather |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"result\": {\n    \"now\": {\n      \"rh\": 73,\n      \"aqi\": 140,\n      \"vis\": 3471,\n      \"pm25\": 107,\n      \"temp\": 4,\n      \"text\": \"多云\",\n      \"clouds\": 999999,\n      \"uptime\": \"20200220143500\",\n      \"prec_1h\": 0,\n      \"wind_dir\": \"东风\",\n      \"feels_like\": 1,\n      \"wind_class\": \"2级\"\n    },\n    \"alerts\": [\n      {\n        \"desc\": \"市气象局发布道路冰雪蓝色预警信号...\",\n        \"type\": \"道路冰雪\",\n        \"level\": \"蓝色预警\",\n        \"title\": \"市气象局发布道路冰雪蓝色预警[IV级/一般]\"\n      }\n    ],\n    \"indexes\": [\n      {\n        \"name\": \"晨练指数\",\n        \"brief\": \"较适宜\",\n        \"detail\": \"天气阴沉，请避免在林中晨练。\"\n      }\n    ],\n    \"location\": {\n      \"id\": \"110101\",\n      \"city\": \"北京市\",\n      \"name\": \"东城\",\n      \"country\": \"中国\",\n      \"province\": \"北京市\"\n    },\n    \"forecasts\": [\n      {\n        \"aqi\": 93,\n        \"low\": -2,\n        \"date\": \"2020-02-20\",\n        \"high\": 7,\n        \"week\": \"星期四\",\n        \"wc_day\": \"<3级\",\n        \"wd_day\": \"东南风\",\n        \"text_day\": \"多云\",\n        \"wc_night\": \"<3级\",\n        \"wd_night\": \"北风\",\n        \"text_night\": \"阴\"\n      }\n    ]\n  },\n  \"status\": 0\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态信息描述 | success |\n| `result` | object |  | 天气查询结果 | None |\n| `result.alerts` | array |  | 气象预警数组，data_type=alert/all 时返回 | None |\n| `result.alerts[].desc` | string |  | 预警详细描述 | None |\n| `result.alerts[].level` | string |  | 预警等级 | 蓝色预警 |\n| `result.alerts[].title` | string |  | 预警标题 | None |\n| `result.alerts[].type` | string |  | 预警事件类型 | 道路冰雪 |\n| `result.forecast_hours` | array |  | 未来24小时逐小时预报，data_type=fc_hour/all 时返回 | None |\n| `result.forecast_hours[].clouds` | integer |  | 云量（%） | None |\n| `result.forecast_hours[].data_time` | string |  | 数据时间 | None |\n| `result.forecast_hours[].prec_1h` | number |  | 1小时累计降水量（mm） | None |\n| `result.forecast_hours[].rh` | integer |  | 相对湿度 | None |\n| `result.forecast_hours[].temp_fc` | integer |  | 温度（℃） | None |\n| `result.forecast_hours[].text` | string |  | 天气现象 | None |\n| `result.forecast_hours[].wind_class` | string |  | 风力等级 | None |\n| `result.forecast_hours[].wind_dir` | string |  | 风向描述 | None |\n| `result.forecasts` | array |  | 7天预报数组，data_type=fc/all 时返回 | None |\n| `result.forecasts[].aqi` | integer |  | 空气质量指数 | 93 |\n| `result.forecasts[].date` | string |  | 日期，北京时区 | 2020-02-20 |\n| `result.forecasts[].high` | integer |  | 最高温度（℃） | 7 |\n| `result.forecasts[].low` | integer |  | 最低温度（℃） | -2 |\n| `result.forecasts[].text_day` | string |  | 白天天气现象 | 多云 |\n| `result.forecasts[].text_night` | string |  | 夜间天气现象 | 阴 |\n| `result.forecasts[].wc_day` | string |  | 白天风力 | <3级 |\n| `result.forecasts[].wc_night` | string |  | 夜间风力 | <3级 |\n| `result.forecasts[].wd_day` | string |  | 白天风向 | 东南风 |\n| `result.forecasts[].wd_night` | string |  | 夜间风向 | 北风 |\n| `result.forecasts[].week` | string |  | 星期 | 星期四 |\n| `result.indexes` | array |  | 生活指数数组，data_type=index/all 时返回 | None |\n| `result.indexes[].brief` | string |  | 概要说明 | 较适宜 |\n| `result.indexes[].detail` | string |  | 详细说明 | 天气阴沉，请避免在林中晨练。 |\n| `result.indexes[].name` | string |  | 指数名称 | 晨练指数 |\n| `result.location` | object |  | 查询位置信息。行政区划查询时含 country/province/city/name/id；经纬度查询时含 lng/lat | None |\n| `result.location.city` | string |  | 城市名称 | 北京市 |\n| `result.location.country` | string |  | 国家名称 | 中国 |\n| `result.location.id` | string |  | 区县行政区划编码 | 110101 |\n| `result.location.lat` | number |  | 纬度（经纬度查询时返回） | 39.904989 |\n| `result.location.lng` | number |  | 经度（经纬度查询时返回） | 116.405285 |\n| `result.location.name` | string |  | 区县名称 | 东城 |\n| `result.location.province` | string |  | 省份名称 | 北京市 |\n| `result.now` | object |  | 实时天气数据，data_type=now/all 时返回 | None |\n| `result.now.aqi` | integer |  | 空气质量指数 | 140 |\n| `result.now.clouds` | integer |  | 云量（%） | 999999 |\n| `result.now.co` | number |  | 一氧化碳浓度（mg/m³） | None |\n| `result.now.feels_like` | integer |  | 体感温度（℃） | 1 |\n| `result.now.no2` | integer |  | 二氧化氮浓度（μg/m³） | None |\n| `result.now.o3` | integer |  | 臭氧浓度（μg/m³） | None |\n| `result.now.pm10` | integer |  | PM10浓度（μg/m³） | None |\n| `result.now.pm25` | integer |  | PM2.5浓度（μg/m³） | 107 |\n| `result.now.prec_1h` | number |  | 1小时累计降水量（mm） | 0 |\n| `result.now.rh` | integer |  | 相对湿度（%） | 73 |\n| `result.now.so2` | integer |  | 二氧化硫浓度（μg/m³） | None |\n| `result.now.temp` | integer |  | 温度（℃） | 4 |\n| `result.now.text` | string |  | 天气现象 | 多云 |\n| `result.now.uptime` | string |  | 数据更新时间，北京时间 | 20200220143500 |\n| `result.now.vis` | integer |  | 能见度（m） | 3471 |\n| `result.now.wind_class` | string |  | 风力等级 | 2级 |\n| `result.now.wind_dir` | string |  | 风向描述 | 东风 |\n| `status` | integer |  | 请求状态码，0表示成功<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: AK参数错误：AK不存在或非法<br/>`2`: 服务内部错误：服务器内部错误，请稍后重试<br/>`3`: 位置参数错误：location/district_id/district 参数格式错误或无效<br/>`4`: 坐标类型错误：coordtype 参数值不在允许范围内<br/>`5`: 无权限：该AK没有权限调用此服务<br/>`101`: 服务禁用：服务已被禁用<br/>`102`: 请求超限：访问频次超限 | 0 |\n\n### 常见问题\n\n**Q: district_id、location、district 三个参数如何选择？**\n\nA: 三者必填其一。district_id 用于行政区划编码查询；location 用于经纬度查询；district 用于区县名称查询，可配合 province、city 辅助定位。\n\n**Q: location 参数的格式是什么？**\n\nA: 经纬度，经度在前纬度在后，逗号分隔，例如 \"116.405285,39.904989\"。坐标类型由 coordtype 指定。\n\n**Q: data_type 各取值分别返回什么数据？**\n\nA: now: 实时天气；fc: 7天预报；index: 生活指数；alert: 气象预警；fc_hour: 24小时逐小时预报；all: 全部数据。\n\n**Q: 如果 district_id 和 location 同时传会怎样？**\n\nA: 默认以 district_id 为准。\n\n**Q: 生活指数包含哪些字段？**\n\nA: 每项包含 name(名称)、brief(概要)、detail(详细说明)。\n\nArchive v1.0.7: 33 files, 88940 bytes\n\nFiles: _meta.json (135b), recipes/address_to_full_location.md (2798b), recipes/address_to_poi.md (3253b), recipes/coordinate_to_structured_address.md (2660b), recipes/nearby_poi_search.md (3249b), recipes/poi_search_to_detail.md (2898b), recipes/route_to_named_place.md (3428b), recipes/smart_departure_time.md (3109b), recipes/traffic_aware_route.md (2905b), recipes/weather_query.md (8504b), references/admin_division_query.md (5257b), references/administrative_region_search.md (11699b), references/capabilities/driving_route_duration.md (2169b), references/capabilities/future_driving_route.md (2040b), references/capabilities/suggested_departure_time.md (1875b), references/capabilities/waypoint_route_planning.md (1870b), references/circular_region_search.md (11139b), references/constants.md (2745b), references/cycling_route_planning.md (8538b), references/domestic_weather_query.md (9230b), references/driving_route_planning.md (15150b), references/geocoding.md (7917b), references/global_reverse_geocoding.md (12529b), references/motorcycle_route_planning.md (11016b), references/multi_dimensional_search.md (11468b), references/overseas_weather_query.md (6416b), references/place_detail_search.md (10185b), references/place_input_suggestion.md (7801b), references/reverse_geocoding_agent.md (11084b), references/transit_route_planning.md (6249b), references/walking_route_planning.md (7277b), skill-card.md (3140b), SKILL.md (8596b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: baidu-map-webapi\ndescription: 百度地图 webapi 开发指南。在编写、审查或调试使用百度地图webAPI的代码时应运用此技能，也适用于直接调用百度地图API获取结果的场景。涵盖：地图位置搜索、POI检索、路线规划、建议出发时间、路线耗时预测、实时路况、行政区划查询、地址坐标转换、沿途交通事件、天气查询、智能推荐上车点等。当用户提及出发时间、导航路线、地点查询、坐标转换、地图相关开发需求时自动触发。\nlicense: MIT\nversion: 1.0.5\nhomepage: https://lbs.baidu.com\nrepository: https://github.com/baidu-maps/webapi-skills\nmetadata:\n  openclaw:\n    requires:\n      bins: [\"curl\"]\n      env: BMAP_WEBAPI_AK\n    primaryEnv: BMAP_WEBAPI_AK\n---\n\n# webapi 开发指南\n\n百度地图 webapi 版本开发指南。包含地图位置搜索、路线导航、行政区划等核心模块的 API 说明和代码示例，既可直接调用 API 获取结果，也可帮助开发者快速集成百度地图服务。\n\n## 何时适用\n\n遇到以下任意场景时，均应读取本指南并调用对应 API：\n\n### 路线规划与出行决策\n- 规划驾车、步行、骑行、摩托车、公共交通路线\n- **查询从 A 到 B 的建议出发时间**（如\"想晚上8点到达，几点出发合适\"）\n- **预测未来某时刻出发的路线耗时**（如\"下午3点出发要多久\"）\n- 查询历史路况下的路线耗时\n- 规划含多个途经点的最优路线\n\n### 实时动态信息\n- 查询路线沿途的动态交通事件（事故、拥堵、施工等）\n- 查询海外城市天气信息\n\n### 地点与POI搜索\n- 查找城市中的餐厅、酒店、景点等 POI 信息\n- 在指定圆形区域内检索地点\n- 按行政区划检索地点\n- 多条件组合检索 POI\n- 获取 POI 详细信息\n- 输入联想/地点补全提示\n- 智能推荐安全上车点\n\n### 地址与坐标转换\n- 地址文本解析为经纬度坐标（地理编码）\n- 经纬度坐标解析为地址信息（逆地理编码）\n\n### 行政区划与区域查询\n- 查询行政区划地点\n- 获取行政区划边界坐标\n\n## 开发准则\n\n在使用本技能的任何场景中，请遵守以下通用准则：\n\n### 准则 1：API 端点选择\n\n百度地图提供两个服务端点，必须根据使用场景选择正确的端点：\n\n| 端点类型 | Base URL | 适用场景 |\n|---|---|---|\n| **标准端点** | `https://api.map.baidu.com/` | 正式开发、生产环境、为用户生成的代码 |\n| **高级功能体验端点** | `https://api.map.baidu.com/map_service/` | 百度地图官方提供，仅供大模型直接调用时快速体验高级权限功能 |\n\n**使用规则：**\n- 为用户生成的开发代码，**必须使用标准端点** `https://api.map.baidu.com/`\n- 大模型直接调用高级权限功能（如建议出发时间、未来路线规划）进行演示/体验时，使用体验端点\n- **体验端点仅供功能体验和演示，不可用于开发或生产环境**\n- **均需要AK凭证**\n\n### 准则 2：AK 凭证安全处理\n\nAK（Access Key）是使用技能之前的必须参数:\n\n1. 优先读取环境变量 `BMAP_WEBAPI_AK` 中的 AK\n2. `BMAP_WEBAPI_AK`为空时, 提示用户:**请先前往[百度地图开放平台](https://lbs.baidu.com/apiconsole/key)申请`服务端`的AK**\n3. 然后设置为环境变量\n```\nexport BMAP_WEBAPI_AK=\"百度地图AK\"\n```\n4. 使用 references/ 所有能力时的ak参数请使用 `$BMAP_WEBAPI_AK`, 示例如下:\n```\ncurl \"https://api.map.baidu.com/place/v3/region?query=美食&region=北京&ak=$BMAP_WEBAPI_AK\"\n```\n\n### 准则 3：地址/地名统一通过 `address_to_poi` 转换\n\n任何需要将**用户输入的地名或地址文本**转换为坐标/UID 的场景，**优先参考**：\n\n> `recipes/address_to_poi.md` — 地址/地名转坐标与 POI UID\n\n该文件描述了两种输入类型的判断方法和对应调用方式：\n- **结构化地址**（含门牌号/楼栋）→ `references/geocoding` API\n- **POI 名称/地标/商家名** → `references/administrative_region_search` API\n\n### 准则 4：算路时 UID 优先于纯坐标\n\n向算路接口（驾车/步行/骑行/公交）传参时：\n\n```\n推荐：同时传坐标 + uid（绑路更精准，尤其对大型 POI） origin_uid / destination_uid 有值时必传\n```\n\nUID 通过 `references/address_to_poi.md` 描述的方法获取。\n\n---\n\n## 场景示例（推荐优先阅读）\n\n遇到以下场景时，**优先使用对应 recipe**，内含完整调用链、参数说明和可运行代码示例。\n单个 API 用法请查阅下方「快速参考」。\n\n### 地址/地名预处理（算路前必读）\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/address_to_poi.md` | 地址文本或地名 → 坐标 + POI UID（算路前置步骤） | 标准 AK |\n\n### 路线规划\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/route_to_named_place.md` | 用户说出地名 → 规划驾车路线 | 标准 AK |\n| `recipes/smart_departure_time.md` | \"几点出发才能准时到\" | ⚠️ 高级权限 |\n| `recipes/traffic_aware_route.md` | 预测未来某时刻出发的路况耗时 | ⚠️ 高级权限 |\n\n### POI 搜索\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/nearby_poi_search.md` | 搜索用户附近的某类地点 | 标准 AK |\n| `recipes/poi_search_to_detail.md` | 关键词搜索 → 获取 POI 完整详情 | 标准 AK |\n\n### 地址与坐标\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/address_to_full_location.md` | 地址文本 → 坐标 + 行政区划 | 标准 AK |\n| `recipes/coordinate_to_structured_address.md` | 坐标 → 结构化地址 + 行政区划 | 标准 AK |\n\n### 天气查询\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/weather_query.md` | 通过城市名称/行政区划编码/坐标, 获取当地详细的天气信息 | 标准 AK |\n\n---\n\n## 快速参考\n\n### 基础概念\n\n- `references/constants.md` - 通用常量：状态码\n\n### 位置搜索\n\n- `references/global_reverse_geocoding.md` - 全球逆地理编码: 坐标转位置信息\n- `references/reverse_geocoding_agent.md` - 逆地理编码智能体: 智能逆地理编码地址解析\n- `references/administrative_region_search.md` - 行政区划区域检索: 行政区划地点检索\n- `references/circular_region_search.md` - 圆形区域检索: 圆形区域地点检索\n- `references/multi_dimensional_search.md` - 多维检索: 多条件智能检索POI\n- `references/place_detail_search.md` - 地点详情检索: 获取指定地点详细信息\n- `references/place_input_suggestion.md` - 地点输入提示: 地点输入提示匹配\n- `references/geocoding.md` - 地理编码: 地址解析为坐标\n\n### AOI区域\n\n- `references/admin_division_query.md` - 行政区划查询: 查询中国行政区划信息\n\n### 动态数据\n\n- `references/domestic_weather_query.md` - 国内天气查询: 国内天气查询多功能接口\n- `references/overseas_weather_query.md` - 海外天气查询: 查询海外城市天气\n\n### 路线导航\n\n- `references/cycling_route_planning.md` - 骑行路线规划: 骑行路线规划方案检索\n- `references/driving_route_planning.md` - 驾车路线规划: 驾车路线规划与路况预测\n    - `references/capabilities/driving_route_duration.md` - 驾车路线历史耗时: 设置驾车路线历史耗时\n    - `references/capabilities/future_driving_route.md` - 未来驾车路线规划: 预测未来驾车路线耗时\n    - `references/capabilities/suggested_departure_time.md` - 建议出发时间: 高级权限出行时间建议\n    - `references/capabilities/waypoint_route_planning.md` - 途经点智能路线规划: 智能优化途经点顺序\n- `references/motorcycle_route_planning.md` - 摩托车路线规划: 摩托车路线规划服务\n- `references/transit_route_planning.md` - 公交路线规划: 多交通方式路线规划\n- `references/walking_route_planning.md` - 步行路线规划: 步行路线规划\n\n## 如何使用\n\n**推荐决策路径**：\n1. 用户需求是**多步串联场景**（如\"输入地名规划路线\"、\"获取附近 POI\"）→ 直接找 `recipes/` 目录下对应 recipe\n2. 用户需求是**单个 API 的参数细节**（如\"这个接口的 tactics 参数有哪些值\"）→ 查阅 `references/` 目录\n\n每个 **references** 参考文件包含：\n- 功能简要说明\n- API 参数说明和注意事项\n\n每个 **recipes** 场景包含：\n- 触发意图（什么场景适用）\n- 完整调用链与分步说明\n- 常见错误和变体\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn778b6bf766ym71fdvrc5yvg98319rv\",\n  \"slug\": \"baidu-map-webapi\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1775545480918\n}\n\nFile v1.0.7:references/admin_division_query.md\n\n# 百度地图行政区划查询 API\n\n## 服务概述\n\n行政区划查询接口用于获取中国行政区划的详细信息。支持通过行政区划名称或adcode进行查询，返回结果包括行政区划的边界坐标、中心点、父级行政区划、行政区划级别等详细信息。该接口适用于需要行政区划数据的各类应用场景，如地图应用、数据分析、地址解析等。\n\n- **版本**: 2.0.0\n- **服务标识**: `region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/district-search/base>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/api_region_search/v1/`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| ak | string | T | - | 开发者密钥，即API Key，用于身份验证和配额管理。 | E4805d16520de693a3fe707cdc962045 |\n| keyword | string | T | - | 检索行政区划关键字。仅支持单关键字检索，可填写行政区名称（如“中国”“全国”、省/市/区/镇名称）或 adcode。 | 河北 |\n| sub_admin | string |  | 0 | 行政区划显示子级级数。可填 0、1、2、3 等：0 不返回下级；1 返回下一级；2 返回下两级；3 返回下三级，以此类推。 | 2 |\n| extensions_code | string (enum: 0, 1) |  | 0 | 是否召回国标行政区划编码，1 为召回，0 为不召回。 | 1 |\n| boundary | string (enum: 0, 1) |  | 0 | 是否返回区划边界数据：0 不返回，1 返回。仅返回查询行政区划的边界，不返回子级边界；仅支持省/市/区边界，暂不支持乡镇/街道。 | 1 |\n| boundarycode | string |  | - | 需要返回边界数据的行政区划编码。若输入 adcode 则返回该 adcode 边界；若未输入或输入错误，则返回 keyword 匹配到的第一个行政区划边界。 | 110112 |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"result\": {\n    \"name\": \"北京市\",\n    \"level\": \"province\",\n    \"adcode\": \"110000\",\n    \"parent\": {\n      \"name\": \"中国\",\n      \"adcode\": \"100000\"\n    },\n    \"boundary\": \"116.123,39.123;116.456,39.456\",\n    \"children\": [\n      {\n        \"name\": \"东城区\",\n        \"level\": \"district\",\n        \"adcode\": \"110101\"\n      }\n    ],\n    \"location\": {\n      \"lat\": 39.929986,\n      \"lng\": 116.395645\n    }\n  },\n  \"status\": 0,\n  \"message\": \"ok\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的描述信息。 | ok |\n| `result` | object |  | 查询结果对象。 | None |\n| `result.adcode` | string |  | 行政区划代码。 | 110000 |\n| `result.boundary` | string |  | 行政区划边界坐标，格式为经纬度坐标串，需设置 boundary=1 时返回。 | 116.123,39.123;116.456,39.456 |\n| `result.children` | array |  | 子级行政区划列表，当 sub_admin 大于 0 时返回。 | None |\n| `result.children[].adcode` | string |  | 子级行政区划代码。 | 110101 |\n| `result.children[].level` | string |  | 子级行政区划级别。 | district |\n| `result.children[].name` | string |  | 子级行政区划名称。 | 东城区 |\n| `result.level` | string (enum: country, province, city... (共5个值)) |  | 行政区划级别，如 country、province、city、district、town 等。 | province |\n| `result.location` | object |  | 行政区划的中心点坐标。 | None |\n| `result.location.lat` | number |  | 中心点纬度。 | 39.929986 |\n| `result.location.lng` | number |  | 中心点经度。 | 116.395645 |\n| `result.name` | string |  | 行政区划名称。 | 北京市 |\n| `result.parent` | object |  | 父级行政区划信息。 | None |\n| `result.parent.adcode` | string |  | 父级行政区划代码。 | 100000 |\n| `result.parent.name` | string |  | 父级行政区划名称。 | 中国 |\n| `status` | integer |  | 返回结果状态码，0表示成功，其他值为错误码。<br/><br/>**枚举值说明：**<br/>`0`: ok：正常<br/>`1`: 服务器内部错误：服务器端出现未知错误，请稍后重试<br/>`2`: 请求参数非法：请求参数缺失或格式错误<br/>`3`: 权限校验失败：ak无效或没有权限<br/>`4`: 配额校验失败：访问超出配额限制<br/>`5`: ak不存在或被封禁：ak不存在或已被封禁，请检查ak状态<br/>`101`: 服务禁用：该服务已被禁用<br/>`102`: 不通过白名单或安全码不对：服务器没有开启白名单，或安全码不对 | 0 |\n\n### 常见问题\n\n**Q: 支持查询哪些级别的行政区划？**\n\nA: 支持国家(country)、省(province)、市(city)、区/县(district)级别的行政区划查询\n\n**Q: 如何获取行政区划的边界坐标？**\n\nA: 设置 boundary=1 可返回边界坐标串（boundary 字段），格式为'经度,纬度;经度,纬度;...'\n\n**Q: 如何获取下一级行政区划？**\n\nA: 设置 sub_admin 大于 0 可返回子级行政区划；如 sub_admin=1 返回下一级，sub_admin=2 返回下两级\n\n**Q: 边界坐标使用什么坐标系？**\n\nA: 返回的边界坐标使用百度BD-09坐标系\n\n**Q: 如何获取ak？**\n\nA: 需要在百度地图开放平台控制台（https://lbsyun.baidu.com/）注册并创建应用获取API Key\n\nFile v1.0.7:references/administrative_region_search.md\n\n# 百度地图地点检索及联想 API\n\n## 服务概述\n\n开发者可通过该功能，检索某一行政区划内（目前最细到区县级别）的地点信息。支持通过关键字、POI类型、区域限制、排序、分页等多种参数进行精细化检索。\n\n- **版本**: 2.0.0\n- **服务标识**: `administrative_region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/guide/webservice-placeapiV3/interfaceDocumentV3>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/place/v3/region`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| query | string | T | - | 检索关键字。 | ATM机、美食 |\n| region | string | T | - | 检索行政区划区域（支持到区县级）。增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用region_limit参数。可输入行政区划名或对应citycode。 | 北京市海淀区 |\n| ak | string | T | - | 开发者的访问密钥，必填项。v2之前该属性为key。 | 您的AK |\n| region_limit | boolean |  | - | 区域数据召回限制，为true时，仅召回region对应区域内数据。 | False |\n| is_light_version | boolean |  | False | true：轻量化检索，检索速度大幅提升，排序更简单直接；false（默认）：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验。 | False |\n| type | string |  | - | 对query召回结果进行二次筛选，type内容建议参考POI分类，建议query同属于一个大类；如query=美食 type=火锅（用于泛搜索场景）。query和type支持只填一项。 | 火锅 |\n| center | string |  | - | 传入poi坐标，辅助检索结果按距离排序与返回。需要搭配排序字段一起使用并结合coord_type字段说明该字段的坐标类型。 | 38.76623,116.43213 |\n| scope | integer (enum: 1, 2) |  | - | 检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息。 | - |\n| coord_type | integer (enum: 1, 2, 3, 4) |  | 3 | 传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）。 | - |\n| filter | string |  | - | 检索排序条件，包含以下3部分：industry_type（行业类型：hotel/cater/life）；sort_name（排序方式：default/price/overall_rating/distance）；sort_rule（排序规则：0从高到低，1从低到高）。 | industry_type:cater,sort_name:overall_rating,sort_rule:1 |\n| extensions_adcode | boolean |  | - | 是否召回国标行政区划编码。 | False |\n| address_result | boolean (enum: false) |  | - | query传入结构化地址时，控制返回数据的类型。若不传入该字段，可能会召回门址数据，当address_result=false时，召回相应的POI数据避免召回门址数据。 | False |\n| photo_show | boolean |  | False | 是否输出图片信息：true(输出)，false(不输出)。购买商用授权后可申请开通。 | False |\n| from_language | string |  | 中文 | 入参query的语言类型，支持不同语言的检索词作为入参，不填默认为中文，可以设置为auto，大模型会自行判断入参语言。 | auto |\n| language | string |  | 中文 | 召回结果的语言类型，支持多种语言召回结果，默认为中文。该功能为高级权限功能。 | en，fr |\n| page_num | integer |  | 0 | 分页页码，默认为0,0代表第一页，1代表第二页，以此类推。常与page_size搭配使用，仅当返回结果为poi时可以翻页。 | - |\n| page_size | integer |  | 10 | 单次召回POI数量，默认为10条记录，最大返回20条。取值为10-20。 | 10 |\n| ret_coordtype | string |  | - | 返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标。 | gcj02ll |\n| output | string (enum: json) |  | json | 输出数据格式，仅支持json。 | json |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"status\": 0,\n  \"message\": \"ok\",\n  \"results\": [\n    {\n      \"uid\": \"05478f385d3729eef4eafc16\",\n      \"area\": \"海淀区\",\n      \"city\": \"北京市\",\n      \"name\": \"中国银行ATM(北京上地信息路支行)\",\n      \"town\": \"上地街道\",\n      \"detail\": 1,\n      \"address\": \"上地信息路15号1层104室\",\n      \"location\": {\n        \"lat\": 40.04383967179688,\n        \"lng\": 116.31584460688308\n      },\n      \"province\": \"北京市\",\n      \"town_code\": 110108022\n    }\n  ],\n  \"query_type\": \"general\",\n  \"result_type\": \"poi_type\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。 | ok |\n| `query_type` | string |  | 搜索类型：精搜precise/泛搜general。 | general |\n| `result_type` | string |  | 召回结果类型：region_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型。 | poi_type |\n| `results[]` | object |  |  | None |\n| `results[].adcode` | integer \\| null |  | poi所属区域代码。 | 110101 |\n| `results[].address` | string \\| null |  | poi所在地址。 | 上地信息路15号1层104室 |\n| `results[].area` | string \\| null |  | poi所属区县。 | 海淀区 |\n| `results[].arrival_heat` | number \\| null |  | poi的到达热度（高级权限）。 | 190.65 |\n| `results[].city` | string \\| null |  | poi所属城市。 | 北京市 |\n| `results[].d7_hot_value` | integer \\| null |  | poi近7天的热度总值。 | 211 |\n| `results[].detail` | string \\| null |  | 是否有详情页：1有，0没有。 | 1 |\n| `results[].detail_info` | object \\| null |  | 详细信息。 |  |\n| `results[].detail_info.brand` | string \\| null |  | poi对应的品牌。 | 淮扬菜 |\n| `results[].detail_info.children[]` | object |  |  | None |\n| `results[].detail_info.children[].address` | string \\| null |  | poi子点地址。 | 北京市海淀区新建宫门路19号颐和园内 |\n| `results[].detail_info.children[].classified_poi_tag` | string \\| null |  | poi子点详细分类标签。 | 出入口;门 |\n| `results[].detail_info.children[].location` | object \\| null |  | poi子点坐标。 |  |\n| `results[].detail_info.children[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.children[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.children[].name` | string |  | poi子点名称。 | 颐和园-西门 |\n| `results[].detail_info.children[].show_name` | string \\| null |  | poi子点简称。 | 西门 |\n| `results[].detail_info.children[].uid` | string |  | poi子点ID，可用于poi详情检索。 | 331152d1b94bc54dc41e5148 |\n| `results[].detail_info.classified_poi_tag` | string \\| null |  | POI展示分类（细致分类）。 | 旅游景点;5A景区 |\n| `results[].detail_info.comment_num` | string \\| null |  | poi的评论数。 |  |\n| `results[].detail_info.description` | string \\| null |  | 描述。 |  |\n| `results[].detail_info.detail_url` | string \\| null |  | poi的详情页。 | http://api.map.baidu.com/place/detail?uid=2a7a2... |\n| `results[].detail_info.image_num` | string \\| null |  | poi图片数。 | 10 |\n| `results[].detail_info.indoor_floor` | string \\| null |  | 室内poi所在楼层。 |  |\n| `results[].detail_info.label` | string \\| null |  | poi权威标签，标签细分解释。 | 淮扬菜 |\n| `results[].detail_info.navi_location` | object \\| null |  | poi对应的导航引导点坐标（上车点）。 |  |\n| `results[].detail_info.navi_location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.navi_location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.new_alias` | string \\| null |  | poi别名。 | 故宫 |\n| `results[].detail_info.overall_rating` | string \\| null |  | poi的综合评分。 | 4.7 |\n| `results[].detail_info.parent_id` | string \\| null |  | poi父点id。 | 06d2dffda107b0ef89f15db6 |\n| `results[].detail_info.photos` | array \\| null |  | poi图片的下载链接。购买商用授权后可申请开通。 | [] |\n| `results[].detail_info.price` | string \\| null |  | poi商户的价格。 | 4.7 |\n| `results[].detail_info.ranking` | string \\| null |  | poi的相关榜单排名。 | 北京市展览馆榜NO.1 |\n| `results[].detail_info.shop_hours` | string \\| null |  | poi的营业时间。 | 10:30-14:00,16:30-22:00 |\n| `results[].detail_info.type` | string \\| null |  | 类型，如（hotel、cater、life），配合filter排序。 | hotel |\n| `results[].heat_trend` | string \\| null |  | 近7天热度增长（递减）XX%（高级权限）。 | 近7天热度递减5% |\n| `results[].interact_heat` | number \\| null |  | poi的互动热度（高级权限）。 | 36.05 |\n| `results[].location` | object \\| null |  | poi经纬度坐标。 |  |\n| `results[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].name` | string |  | poi名称，单次请求最多返回10条结果。 | 中国银行ATM(北京上地信息路支行) |\n| `results[].province` | string \\| null |  | poi所属省份。 | 北京市 |\n| `results[].status` | string \\| null |  | poi营业状态 ：空（代表正常营业）、推算位置、暂停营业、可能已关闭、已关闭。 |  |\n| `results[].street_id` | string \\| null |  | poi所在街景图id。 | e176ad06ea2a026cd2f49e2c |\n| `results[].telephone` | string \\| null |  | poi的电话。 |  |\n| `results[].town` | string \\| null |  | poi所属乡镇街道。 | 上地街道 |\n| `results[].town_code` | integer \\| null |  | poi所属乡镇街道编码。 | 110108022 |\n| `results[].uid` | string |  | poi的唯一标示，ID。 | 05478f385d3729eef4eafc16 |\n| `results[].view_heat` | number \\| null |  | poi的浏览热度（高级权限）。 | 2302.75 |\n| `status` | integer |  | 本次API访问状态，如果成功返回0，如果失败返回其他数字。 | 0 |\n| `total` | integer \\| null |  | 召回poi数量，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。 |  |\n\n### 常见问题\n\n**Q: 哪些参数是调用此接口时必须填写的？**\n\nA: query（检索关键字）、region（检索区域）和ak（访问密钥）是三个必填参数。\n\n**Q: 如何严格限制检索结果只返回指定区域内的数据？**\n\nA: 除了填写region参数外，还需要将region_limit参数设置为true，这样将仅召回region对应区域内的数据。\n\n**Q: 如何对检索结果进行排序，例如按距离或评分排序？**\n\nA: 可以使用filter参数进行排序。需要指定industry_type（行业）、sort_name（排序字段，如distance或overall_rating）和sort_rule（排序规则）。按距离排序时还需配合center参数提供中心点坐标。\n\n**Q: 接口支持分页吗？最多能获取多少条数据？**\n\nA: 支持分页，使用page_num和page_size参数。page_size默认为10，最大为20。当启用分页时，total字段表示总条数，但出于数据保护，单次请求total最多显示150条。\n\n**Q: 返回结果中的一些字段（如photos、热度数据）为什么是空的？**\n\nA: 部分字段属于高级功能，例如图片信息(photo_show)、多语言检索(language)、热度数据(view_heat等)需要购买商用授权或联系商务提交工单申请开通后才能返回数据。\n\nFile v1.0.7:references/capabilities/driving_route_duration.md\n\n# 驾车路线规划-历史路线耗时\n\n## 服务概述\n\n该功能需要开通高级权限，开发者可设置更多出发时间（用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个）\n\n- **版本**: 2.0.0\n- **服务标识**: `driving_route_duration`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-logotime>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| ext_departure_time | string |  | - | 更多出发时间，UNIX时间戳。该字段将影响ext_duration字段的返回，用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个），多个时间戳之间用','英文半角逗号隔开。ext_departure_time=1526527619,1526525384,1526523654 目前出发时间仅影响ext_duration字段，还不会影响路线计算和选择。即仍按照现在的路况计算并推荐路线，但将增加返回该路线在其他时间的耗时。不填则不返回ext_duration字段 | 1609459200 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].ext_duration` | integer \\| string \\| null |  | 驾车路线历史耗时（扩展），单位：秒。当设置了ext_departure_time时返回，多个时间戳对应多个耗时以英文逗号分隔，计算失败返回-1。 | 500,520,-1 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.7:references/capabilities/future_driving_route.md\n\n# 驾车路线规划-未来驾车\n\n## 服务概述\n\n该功能需要开通高级权限，开发者可设置出发时间（支持未来7天），UNIX时间戳。该字段将影响duration字段的返回，用于返回未来驾车路线耗时。取值范围：当前时间之后7天*24小时内任意时刻（超出时间范围将预估路线）若设置该参数，则路线规划服务将依据设定时间预测路况和限行规则，并据此计算路线和耗时。\n\n- **版本**: 2.0.0\n- **服务标识**: `future_driving_route`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-time>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| departure_time | string |  | - | 出发时间，UNIX时间戳。支持未来7天任意时刻。设置后将依据设定时间预测路况和限行规则计算路线和耗时（高级权限服务）。 | 1609459200 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].duration` | integer |  | 未来驾车路线耗时（若请求参数设置了符合规则的departure_time，则按照设定出发时间的预测路况计算路线耗时。若未设置departure_time，则按照当前时刻的路况计算路线耗时）或当前路况耗时，单位：秒 | 600 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n| `type` | integer |  | 默认返回2，开发者无需关注 | 2 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.7:references/capabilities/suggested_departure_time.md\n\n# 驾车路线规划-建议出发时间\n\n## 服务概述\n\n该功能需要开通高级权限，开发者设置预期到达时间后,将返回建议出发时间\n\n- **版本**: 2.0.0\n- **服务标识**: `suggested_departure_time`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-suggtime>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| expect_arrival_time | string |  | - | 预期到达时间，UNIX时间戳。取值范围：当前时间之后15分钟任意时刻。设置后将返回suggest_departure_time字段, （小于这个时间则不做处理）若设置此参数，则路线规划服务将依据设定时间计算路线和耗时，并给出建议出发时间, 若算出的suggest_departure_time小于当前时间，则设置suggest_departure_time为-1 | 1609462800 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].suggest_departure_time` | integer \\| null |  | 建议出发时间，单位：秒。当设置了expect_arrival_time时返回，按照预计到达时间预测路况计算路线，并给出建议出发时间，若计算出的时间小于当前时间则返回-1。 | 1609459200 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.7:references/capabilities/waypoint_route_planning.md\n\n# 驾车路线规划-途经点智能路线规划\n\n## 服务概述\n\n该功能需要开通高级权限，传入多个途经点，综合考虑路况、交规限行、 途经点的相对位置以及路线整体的绕路成本等，支持智能调整途经点顺序，给出最优路线。\n\n- **版本**: 2.0.0\n- **服务标识**: `waypoint_route_planning`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-aiplan>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| intelligent_plan | integer (enum: 0, 1) |  | 0 | 是否执行途经点智能规划，综合考虑路况、限行、途经点相对位置及绕路成本，支持智能调整途经点顺序可选值：0（默认值）：不执行途经点智能规划1：执行途经点智能规划（高级权限服务）。 | 1 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].suggest_departure_time` | integer \\| null |  | 建议出发时间，单位：秒。当设置了expect_arrival_time时返回，按照预计到达时间预测路况计算路线，并给出建议出发时间，若计算出的时间小于当前时间则返回-1。 | 1609459200 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.7:references/circular_region_search.md\n\n# 百度地图地点检索及联想 API\n\n## 服务概述\n\n开发者可设置圆心坐标和半径，检索圆形区域内的地点信息（POI）。支持多关键字并集检索、按POI分类检索、结果排序、分页、多语言检索等高级功能。当检索半径过大，超过中心点所在城市边界时，检索范围会自动变为该城市范围。\n\n- **版本**: 2.0.0\n- **服务标识**: `circular_region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/guide/webservice-placeapiV3/interfaceDocumentV3>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/place/v3/around`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| query | string | T | - | 检索关键字。支持多个关键字并集检索，不同关键字间以$符号分隔，最多10个。也可通过POI分类进行检索。 | 银行 |\n| location | string | T | - | 圆形区域检索中心点经纬度坐标，格式为“纬度,经度”。不支持多个点。 | 39.915,116.404 |\n| ak | string | T | - | 开发者的访问密钥（API Key），必填项。 | 您的AK |\n| radius | integer |  | 1000 | 圆形区域检索半径，单位为米。默认1000。 | 2000 |\n| radius_limit | boolean |  | - | 是否严格限定召回结果在设置的检索半径范围内。true（是），false（否）。 | True |\n| is_light_version | boolean |  | False | true：优先保证检索速度，排序更简单直接；false（默认）：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序。 | True |\n| type | string |  | - | 对query召回结果进行二次筛选，内容建议参考POI分类。query和type支持只填一项。 | 火锅 |\n| scope | integer (enum: 1, 2) |  | - | 检索结果详细程度。1 或空：返回基本信息；2：返回检索POI详细信息。 | 2 |\n| coord_type | integer (enum: 1, 2, 3, 4) |  | 3 | 传入的坐标类型。1：wgs84ll（GPS经纬度）；2：gcj02ll（国测局经纬度）；3：bd09ll（百度经纬度，默认）；4：bd09mc（百度米制坐标）。 | 3 |\n| filter | string |  | - | 检索排序条件，格式：industry_type:行业\\|sort_name:排序方式\\|sort_rule:排序规则。行业：hotel/cater/life；排序方式：default/price/overall_rating/distance；排序规则：0（从高到低）/1（从低到高）。 | industry_type:cater|sort_name:overall_rating|sort_rule:1 |\n| extensions_adcode | boolean |  | - | 是否召回国标行政区划编码。true（召回）、false（不召回）。 | True |\n| photo_show | boolean |  | False | 是否输出图片信息：true(输出)，false(不输出)。此为高级权限功能。 | False |\n| from_language | string |  | zh | query的语言类型，支持不同语言的检索词。不填默认为中文，可设置为auto（自动判断）。 | auto |\n| language | string |  | zh | 多语言检索，支持多种语言召回结果。默认为中文。此为高级权限功能。 | en |\n| page_num | integer |  | 0 | 分页页码，默认为0（第一页），1代表第二页，以此类推。仅当返回结果为poi时可以翻页。 | 0 |\n| page_size | integer |  | 10 | 单次召回POI数量，默认为10条，最大返回20条。取值范围10-20。 | 10 |\n| ret_coordtype | string |  | - | 返回的坐标类型，添加后POI返回国测局经纬度坐标（gcj02ll）。 | gcj02ll |\n| output | string (enum: json) |  | json | 输出数据格式，仅支持json。 | json |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"status\": 0,\n  \"message\": \"ok\",\n  \"results\": [\n    {\n      \"uid\": \"14cf81e3aae18d1914948ebb\",\n      \"area\": \"东城区\",\n      \"city\": \"北京市\",\n      \"name\": \"中国民生银行(北京正义路支行)\",\n      \"town\": \"东华门街道\",\n      \"detail\": 1,\n      \"address\": \"北京市东城区东长安街35号首层西侧\",\n      \"location\": {\n        \"lat\": 39.91518549590169,\n        \"lng\": 116.41350155480602\n      },\n      \"province\": \"北京市\",\n      \"street_id\": \"14cf81e3aae18d1914948ebb\",\n      \"telephone\": \"(010)65284468\",\n      \"town_code\": 110101001\n    }\n  ],\n  \"query_type\": \"general\",\n  \"result_type\": \"poi_type\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。 | ok |\n| `query_type` | string |  | 搜索类型：精搜precise/泛搜general。 | general |\n| `result_type` | string |  | 召回结果类型：region_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型。 | poi_type |\n| `results[]` | object |  |  | None |\n| `results[].adcode` | integer \\| null |  | poi所属区域代码。 | 110101 |\n| `results[].address` | string \\| null |  | poi所在地址。 | 上地信息路15号1层104室 |\n| `results[].area` | string \\| null |  | poi所属区县。 | 海淀区 |\n| `results[].arrival_heat` | number \\| null |  | poi的到达热度（高级权限）。 | 190.65 |\n| `results[].city` | string \\| null |  | poi所属城市。 | 北京市 |\n| `results[].d7_hot_value` | integer \\| null |  | poi近7天的热度总值。 | 211 |\n| `results[].detail` | string \\| null |  | 是否有详情页：1有，0没有。 | 1 |\n| `results[].detail_info` | object \\| null |  | 详细信息。 |  |\n| `results[].detail_info.brand` | string \\| null |  | poi对应的品牌。 | 淮扬菜 |\n| `results[].detail_info.children[]` | object |  |  | None |\n| `results[].detail_info.children[].address` | string \\| null |  | poi子点地址。 | 北京市海淀区新建宫门路19号颐和园内 |\n| `results[].detail_info.children[].classified_poi_tag` | string \\| null |  | poi子点详细分类标签。 | 出入口;门 |\n| `results[].detail_info.children[].location` | object \\| null |  | poi子点坐标。 |  |\n| `results[].detail_info.children[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.children[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.children[].name` | string |  | poi子点名称。 | 颐和园-西门 |\n| `results[].detail_info.children[].show_name` | string \\| null |  | poi子点简称。 | 西门 |\n| `results[].detail_info.children[].uid` | string |  | poi子点ID，可用于poi详情检索。 | 331152d1b94bc54dc41e5148 |\n| `results[].detail_info.classified_poi_tag` | string \\| null |  | POI展示分类（细致分类）。 | 旅游景点;5A景区 |\n| `results[].detail_info.comment_num` | string \\| null |  | poi的评论数。 |  |\n| `results[].detail_info.description` | string \\| null |  | 描述。 |  |\n| `results[].detail_info.detail_url` | string \\| null |  | poi的详情页。 | http://api.map.baidu.com/place/detail?uid=2a7a2... |\n| `results[].detail_info.image_num` | string \\| null |  | poi图片数。 | 10 |\n| `results[].detail_info.indoor_floor` | string \\| null |  | 室内poi所在楼层。 |  |\n| `results[].detail_info.label` | string \\| null |  | poi权威标签，标签细分解释。 | 淮扬菜 |\n| `results[].detail_info.navi_location` | object \\| null |  | poi对应的导航引导点坐标（上车点）。 |  |\n| `results[].detail_info.navi_location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.navi_location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.new_alias` | string \\| null |  | poi别名。 | 故宫 |\n| `results[].detail_info.overall_rating` | string \\| null |  | poi的综合评分。 | 4.7 |\n| `results[].detail_info.parent_id` | string \\| null |  | poi父点id。 | 06d2dffda107b0ef89f15db6 |\n| `results[].detail_info.photos` | array \\| null |  | poi图片的下载链接。购买商用授权后可申请开通。 | [] |\n| `results[].detail_info.price` | string \\| null |  | poi商户的价格。 | 4.7 |\n| `results[].detail_info.ranking` | string \\| null |  | poi的相关榜单排名。 | 北京市展览馆榜NO.1 |\n| `results[].detail_info.shop_hours` | string \\| null |  | poi的营业时间。 | 10:30-14:00,16:30-22:00 |\n| `results[].detail_info.type` | string \\| null |  | 类型，如（hotel、cater、life），配合filter排序。 | hotel |\n| `results[].heat_trend` | string \\| null |  | 近7天热度增长（递减）XX%（高级权限）。 | 近7天热度递减5% |\n| `results[].interact_heat` | number \\| null |  | poi的互动热度（高级权限）。 | 36.05 |\n| `results[].location` | object \\| null |  | poi经纬度坐标。 |  |\n| `results[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].name` | string |  | poi名称，单次请求最多返回10条结果。 | 中国银行ATM(北京上地信息路支行) |\n| `results[].province` | string \\| null |  | poi所属省份。 | 北京市 |\n| `results[].status` | string \\| null |  | poi营业状态 ：空（代表正常营业）、推算位置、暂停营业、可能已关闭、已关闭。 |  |\n| `results[].street_id` | string \\| null |  | poi所在街景图id。 | e176ad06ea2a026cd2f49e2c |\n| `results[].telephone` | string \\| null |  | poi的电话。 |  |\n| `results[].town` | string \\| null |  | poi所属乡镇街道。 | 上地街道 |\n| `results[].town_code` | integer \\| null |  | poi所属乡镇街道编码。 | 110108022 |\n| `results[].uid` | string |  | poi的唯一标示，ID。 | 05478f385d3729eef4eafc16 |\n| `results[].view_heat` | number \\| null |  | poi的浏览热度（高级权限）。 | 2302.75 |\n| `status` | integer |  | 本次API访问状态，如果成功返回0，如果失败返回其他数字。 | 0 |\n| `total` | integer \\| null |  | 召回poi数量，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。 |  |\n\n### 常见问题\n\n**Q: 哪些参数是调用此接口时必须填写的？**\n\nA: query（检索关键字）、location（中心点坐标）、ak（访问密钥）这三个参数是必须填写的。\n\n**Q: 如果设置的检索半径很大，会有什么影响？**\n\nA: 当半径过大，超过中心点所在城市边界时，检索范围会自动变为该城市范围，而不再严格限定为圆形区域。\n\n**Q: 如何对检索结果进行排序？**\n\nA: 可以使用filter参数进行排序，指定行业类型(industry_type)、排序方式(sort_name)和排序规则(sort_rule)，例如按餐饮行业评分从低到高排序。\n\n**Q: 接口是否支持使用英文或其他语言关键字进行检索？**\n\nA: 支持。通过设置from_language参数（如设为'auto'或指定语种代码）可以传入非中文关键字。通过language参数可以指定返回结果的语种，但此为高级权限功能。\n\n**Q: 如何获取POI的图片、详细热度等高级信息？**\n\nA: 需要购买百度地图的商用授权，然后联系商务提交工单申请开通相应的高级权限（如photo_show、view_heat等字段）。\n\nFile v1.0.7:references/constants.md\n\n# 通用常量\n\n## 返回值状态常量\n\n所有 webapi 服务共用的状态码, 部分服务会有自己特有的状态码, 请结合使用\n\n# 返回值状态码说明表\n\n| 返回值 | 定义 | 英文描述 | 常见原因 |\n|--------|------|----------|----------|\n| 0 | 正常 | ok | 服务请求正常召回 |\n| 1 | 服务器内部错误 | - | 该服务响应超时或系统内部错误,请留下联系方式 |\n| 2 | 请求参数非法 | Parameter Invalid | 必要参数拼写错误或漏传(如query和tag请求中均未传入) |\n| 3 | 权限校验失败 | Verify Failure | - |\n| 4 | 配额校验失败 | Quota Failure | 服务当日调用次数已超限,请前往 API控制台 提升(请优先进行开发者认证) |\n| 5 | ak不存在或者非法 | AK Failure | 未传入ak参数;ak已被删除(可前往 回收站 恢复) |\n| 8 | 数据解析失败 | Parse Proto Failure | 一般是query输入有误导致,如query输入特殊字符,全角符号 |\n| 9 | 高级权限校验失败 | Permission Denied | - |\n| 101 | AK参数不存在 | - | 请求消息没有携带AK参数 |\n| 200 | APP不存在,AK有误请检查再重试 | - | 根据请求的ak,找不到对应的服务,请检查ak, url是否正确 |\n| 201 | APP被用户自己禁用,请在控制台解禁 | - | - |\n| 202 | APP被管理员删除 | - | 恶意APP被管理员删除 |\n| 203 | APP类型错误 | - | 当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone(类型22))及Browser(类型3),除此之外其他类型认为是APP类型错误 |\n| 210 | APP IP校验失败 | - | 在申请SERVER类型应用的时候选择IP校验,需要填写IP白名单,如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败 |\n| 211 | APP SN校验失败 | - | SERVER类型APP有两种校验方式IP校验和SN校验,当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败 |\n| 240 | APP 服务被禁用 | - | 用户在API控制台中创建或设置某APP的时候禁用了某项服务,若需开通权限,可进入API控制台为AK勾选对应服务 |\n| 250 | 用户不存在 | - | 根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id |\n| 251 | 用户被自己删除 | - | 该用户处于未激活状态 |\n| 252 | 用户被管理员删除 | - | 恶意用户被加入黑名单 |\n| 260 | 服务不存在 | - | 服务器解析不到用户请求的服务名称 |\n| 261 | 服务被禁用 | - | 该服务已下线 |\n| 302 | 天配额超限,限制访问 | - | 配额超限,如果想增加配额请联系我们 |\n| 401 | 当前并发量已经超过约定并发配额,限制访问 | - | 并发控制超限,请控制并发量或联系我们 |\n\nFile v1.0.7:references/cycling_route_planning.md\n\n# 百度地图骑行路线规划 API\n\n## 服务概述\n\n根据起终点坐标检索符合条件的骑行路线规划方案，支持普通自行车和电动自行车出行方式。\n\n- **版本**: 2.0.0\n- **服务标识**: `direction_v2_riding`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction/cycling>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/riding`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| origin | string | T | - | 起点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815 | 40.01116,116.339303 |\n| destination | string | T | - | 终点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815 | 39.936404,116.452562 |\n| origin_uid | string |  | - | 起点POI的uid（请尽量填写uid，将提升路线规划的准确性。使用地点检索服务或地点输入提示服务获取uid） | - |\n| destination_uid | string |  | - | 终点POI的uid（请尽量填写uid，将提升路线规划的准确性。使用地点检索服务或地点输入提示服务获取uid） | - |\n| coord_type | string (enum: bd09ll, bd09mc, gcj02, wgs84) |  | bd09ll | 输入坐标类型，默认bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度墨卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps设备获取的坐标）。 | - |\n| ret_coordtype | string (enum: bd09ll, gcj02) |  | bd09ll | 输出坐标类型，默认为百度经纬度坐标：bd09ll。可选值：bd09ll：百度经纬度坐标；gcj02：国测局坐标。 | - |\n| output | string (enum: json, xml) |  | json | 表示输出类型，可设置为xml或json | - |\n| riding_type | string (enum: 0, 1) |  | 0 | 骑行类型。默认0：0-普通 1-电动车 | - |\n| road_prefer | integer (enum: 0, 3) |  | 0 | 算路方案。默认0：0-默认路线；3-无逆行且无阶梯的算路方案（不传默认0） | - |\n| ak | string | T | - | 用户的访问权限，AK申请 | 您的AK |\n| sn | string |  | - | 用户的权限签名，当AK设置为SN校验时，该参数必填。SN计算方法请参考相关文档。 | - |\n| timestamp | integer |  | - | 时间戳，与SN配合使用，SN存在时必填 | - |\n| callback | string |  | - | 回调函数，用于解决浏览器请求跨域问题。仅在output=json时，该参数有效。 | - |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `info` | object |  | 版权信息 | None |\n| `info.copyright` | object |  |  | None |\n| `info.copyright.imageUrl` | string |  |  | http://api.map.baidu.com/images/copyright_logo.png |\n| `info.copyright.text` | string |  |  | @2023 Baidu - Data |\n| `message` | string |  | 状态码对应的信息 | ok |\n| `result` | object |  | 返回的结果 | None |\n| `result.destination` | object |  |  | None |\n| `result.destination.destinationPt` | object |  |  | None |\n| `result.destination.destinationPt.lat` | number |  | 终点纬度 | None |\n| `result.destination.destinationPt.lng` | number |  | 终点经度 | None |\n| `result.origin` | object |  |  | None |\n| `result.origin.originPt` | object |  |  | None |\n| `result.origin.originPt.lat` | number |  | 起点纬度 | None |\n| `result.origin.originPt.lng` | number |  | 起点经度 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].destinationLocation` | object |  |  | None |\n| `result.routes[].destinationLocation.lat` | number |  | 路线终点纬度 | None |\n| `result.routes[].destinationLocation.lng` | number |  | 路线终点经度 | None |\n| `result.routes[].distance` | integer |  | 方案距离，单位：米 | 17279 |\n| `result.routes[].duration` | integer |  | 线路耗时，单位：秒 | 5969 |\n| `result.routes[].originLocation` | object |  |  | None |\n| `result.routes[].originLocation.lat` | number |  | 路线起点纬度 | None |\n| `result.routes[].originLocation.lng` | number |  | 路线起点经度 | None |\n| `result.routes[].restrictions_info` | string |  | 限行信息，如 '包含禁行路段\\|包含逆行路段' |  |\n| `result.routes[].restrictions_status` | integer |  | 限行类型，0x01表示禁行；0x02表示逆行 | 0 |\n| `result.routes[].steps` | array |  | 路段信息集合 | None |\n| `result.routes[].steps[].area` | integer |  |  | 0 |\n| `result.routes[].steps[].direction` | integer |  | 当前道路方向角 | 176 |\n| `result.routes[].steps[].distance` | integer |  | 路段距离，单位：米 | 200 |\n| `result.routes[].steps[].duration` | integer |  | 路段耗时，单位：秒 | 60 |\n| `result.routes[].steps[].guidance` | array |  | 诱导信息,有高级权限才能返回 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions` | array |  | 播报详细信息 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].cloud_guide_version` | string |  | 云导版本 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details` | array |  | 播报点详情 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details[].distance_to_gdpt` | integer |  | 播报点与诱导点的距离 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details[].speak_text` | string |  | 播报内容 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details[].voice_level` | integer |  | 音量级别 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].distance_to_origin` | Integer |  | 播报点与起点的距离 | None |\n| `result.routes[].steps[].instructions` | string |  | 路段描述，如'骑行50米' | 骑行200米 |\n| `result.routes[].steps[].leg_index` | integer |  |  | 0 |\n| `result.routes[].steps[].links` | array |  | link信息集合 | None |\n| `result.routes[].steps[].links[].attr` | integer |  | link属性，0x01表示禁行；0x02表示逆行 | 0 |\n| `result.routes[].steps[].links[].length` | integer |  | link长度，单位：米 | 70 |\n| `result.routes[].steps[].name` | string |  | 该路段道路名称，如'信息路'。若道路未命名或百度地图未采集到该道路名称，则返回'无名路'。 |  |\n| `result.routes[].steps[].path` | string |  | 路段位置坐标描述 | 116.339966,40.011176;116.340006,40.010546;116.3... |\n| `result.routes[].steps[].restrictions_info` | string |  | 限行信息 |  |\n| `result.routes[].steps[].restrictions_status` | integer |  | 限行类型，0x01表示禁行；0x02表示逆行 | 0 |\n| `result.routes[].steps[].stepDestinationInstruction` | string |  |  |  |\n| `result.routes[].steps[].stepDestinationLocation` | object |  |  | None |\n| `result.routes[].steps[].stepDestinationLocation.lat` | number |  | 路段终点纬度 | None |\n| `result.routes[].steps[].stepDestinationLocation.lng` | number |  | 路段终点经度 | None |\n| `result.routes[].steps[].stepOriginInstruction` | string |  |  |  |\n| `result.routes[].steps[].stepOriginLocation` | object |  |  | None |\n| `result.routes[].steps[].stepOriginLocation.lat` | number |  | 路段起点纬度 | None |\n| `result.routes[].steps[].stepOriginLocation.lng` | number |  | 路段起点经度 | None |\n| `result.routes[].steps[].turn_type` | string |  | 行驶转向方向，如'直行'、'左前方转弯' | 左转 |\n| `result.routes[].steps[].type` | integer |  |  | 5 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`2001`: 无骑行路线 | 0 |\n| `type` | integer |  | 返回数据类型 | 2 |\n\n### 常见问题\n\n**Q: 起点和终点的坐标格式是什么？小数点后支持几位？**\n\nA: 格式为：纬度,经度（例如：40.01116,116.339303）。小数点后不超过6位。\n\n**Q: 如何提升路线规划的准确性？**\n\nA: 建议填写起点和终点的POI uid（通过地点检索或输入提示服务获取），可显著提升准确性。\n\n**Q: 支持哪些输入和输出的坐标系？**\n\nA: 输入支持bd09ll、bd09mc、gcj02、wgs84；输出支持bd09ll和gcj02。\n\n**Q: 电动车和普通自行车规划有什么区别？**\n\nA: 选择电动车骑行类型（riding_type=1）时，路线规划算法会考虑电动车的通行规则和偏好。\n\n**Q: “无逆行且无阶梯”的算路方案是什么意思？**\n\nA: 选择road_prefer=3时，系统会尽量避免规划包含逆行路段和人行阶梯的路线。\n\nFile v1.0.7:references/domestic_weather_query.md\n\n# 百度地图国内天气查询 API\n\n## 服务概述\n\n国内天气查询接口，支持通过行政区划代码、经纬度坐标或省市区名称查询国内天气信息。可获取实时天气、未来7天预报、逐小时预报、生活指数、气象预警等数据。支持百度坐标（BD-09ll/BD-09mc）、国测局坐标（GCJ-02）、GPS坐标（WGS-84）四种坐标系。适用于天气应用开发、出行规划、农业气象监测、智能家居天气联动等场景。\n\n- **版本**: 2.0.0\n- **服务标识**: `weather`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/weather/base>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/weather/v1/`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| district_id | string |  | - | 区县的行政区划编码，与 location、district 三者必选其一。 | 222405 |\n| location | string |  | - | 经纬度，经度在前纬度在后，逗号分隔。支持 bd09mc/bd09ll/wgs84/gcj02。与 district_id、district 三者必选其一。 | 116.405285,39.904989 |\n| province | string |  | - | 省份名称，用于辅助名称查询。 | 山东省 |\n| city | string |  | - | 城市名称，用于辅助名称查询。 | 济南市 |\n| district | string |  | - | 区县名称，用于名称查询，与 district_id、location 三者必填其一。 | 历下区 |\n| ak | string | T | - | 开发者密钥，在API控制台申请获得。 | hhR4GDGHfREwblbolOYhio8HkHyRdDoq |\n| data_type | string (enum: now, fc, index, alert, fc_hour...) | T | - | 请求数据类型，控制返回内容。可选值：now(实时天气)、fc(7天预报)、index(生活指数)、alert(气象预警)、fc_hour(逐小时预报)、all(全部)。 | all |\n| output | string (enum: json, xml) |  | json | 返回格式，支持 json/xml，默认为 json。 | json |\n| coordtype | string (enum: wgs84, bd09ll, bd09mc, gcj02) |  | wgs84 | 坐标类型。支持 wgs84/bd09ll/bd09mc/gcj02，默认为 wgs84。 | wgs84 |\n| callback | string |  | - | JSONP 回调函数名，当 output=json 时有效。 | showWeather |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"result\": {\n    \"now\": {\n      \"rh\": 73,\n      \"aqi\": 140,\n      \"vis\": 3471,\n      \"pm25\": 107,\n      \"temp\": 4,\n      \"text\": \"多云\",\n      \"clouds\": 999999,\n      \"uptime\": \"20200220143500\",\n      \"prec_1h\": 0,\n      \"wind_dir\": \"东风\",\n      \"feels_like\": 1,\n      \"wind_class\": \"2级\"\n    },\n    \"alerts\": [\n      {\n        \"desc\": \"市气象局发布道路冰雪蓝色预警信号...\",\n        \"type\": \"道路冰雪\",\n        \"level\": \"蓝色预警\",\n        \"title\": \"市气象局发布道路冰雪蓝色预警[IV级/一般]\"\n      }\n    ],\n    \"indexes\": [\n      {\n        \"name\": \"晨练指数\",\n        \"brief\": \"较适宜\",\n        \"detail\": \"天气阴沉，请避免在林中晨练。\"\n      }\n    ],\n    \"location\": {\n      \"id\": \"110101\",\n      \"city\": \"北京市\",\n      \"name\": \"东城\",\n      \"country\": \"中国\",\n      \"province\": \"北京市\"\n    },\n    \"forecasts\": [\n      {\n        \"aqi\": 93,\n        \"low\": -2,\n        \"date\": \"2020-02-20\",\n        \"high\": 7,\n        \"week\": \"星期四\",\n        \"wc_day\": \"<3级\",\n        \"wd_day\": \"东南风\",\n        \"text_day\": \"多云\",\n        \"wc_night\": \"<3级\",\n        \"wd_night\": \"北风\",\n        \"text_night\": \"阴\"\n      }\n    ]\n  },\n  \"status\": 0\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态信息描述 | success |\n| `result` | object |  | 天气查询结果 | None |\n| `result.alerts` | array |  | 气象预警数组，data_type=alert/all 时返回 | None |\n| `result.alerts[].desc` | string |  | 预警详细描述 | None |\n| `result.alerts[].level` | string |  | 预警等级 | 蓝色预警 |\n| `result.alerts[].title` | string |  | 预警标题 | None |\n| `result.alerts[].type` | string |  | 预警事件类型 | 道路冰雪 |\n| `result.forecast_hours` | array |  | 未来24小时逐小时预报，data_type=fc_hour/all 时返回 | None |\n| `result.forecast_hours[].clouds` | integer |  | 云量（%） | None |\n| `result.forecast_hours[].data_time` | string |  | 数据时间 | None |\n| `result.forecast_hours[].prec_1h` | number |  | 1小时累计降水量（mm） | None |\n| `result.forecast_hours[].rh` | integer |  | 相对湿度 | None |\n| `result.forecast_hours[].temp_fc` | integer |  | 温度（℃） | None |\n| `result.forecast_hours[].text` | string |  | 天气现象 | None |\n| `result.forecast_hours[].wind_class` | string |  | 风力等级 | None |\n| `result.forecast_hours[].wind_dir` | string |  | 风向描述 | None |\n| `result.forecasts` | array |  | 7天预报数组，data_type=fc/all 时返回 | None |\n| `result.forecasts[].aqi` | integer |  | 空气质量指数 | 93 |\n| `result.forecasts[].date` | string |  | 日期，北京时区 | 2020-02-20 |\n| `result.forecasts[].high` | integer |  | 最高温度（℃） | 7 |\n| `result.forecasts[].low` | integer |  | 最低温度（℃） | -2 |\n| `result.forecasts[].text_day` | string |  | 白天天气现象 | 多云 |\n| `result.forecasts[].text_night` | string |  | 夜间天气现象 | 阴 |\n| `result.forecasts[].wc_day` | string |  | 白天风力 | <3级 |\n| `result.forecasts[].wc_night` | string |  | 夜间风力 | <3级 |\n| `result.forecasts[].wd_day` | string |  | 白天风向 | 东南风 |\n| `result.forecasts[].wd_night` | string |  | 夜间风向 | 北风 |\n| `result.forecasts[].week` | string |  | 星期 | 星期四 |\n| `result.indexes` | array |  | 生活指数数组，data_type=index/all 时返回 | None |\n| `result.indexes[].brief` | string |  | 概要说明 | 较适宜 |\n| `result.indexes[].detail` | string |  | 详细说明 | 天气阴沉，请避免在林中晨练。 |\n| `result.indexes[].name` | string |  | 指数名称 | 晨练指数 |\n| `result.location` | object |  | 查询位置信息。行政区划查询时含 country/province/city/name/id；经纬度查询时含 lng/lat | None |\n| `result.location.city` | string |  | 城市名称 | 北京市 |\n| `result.location.country` | string |  | 国家名称 | 中国 |\n| `result.location.id` | string |  | 区县行政区划编码 | 110101 |\n| `result.location.lat` | number |  | 纬度（经纬度查询时返回） | 39.904989 |\n| `result.location.lng` | number |  | 经度（经纬度查询时返回） | 116.405285 |\n| `result.location.name` | string |  | 区县名称 | 东城 |\n| `result.location.province` | string |  | 省份名称 | 北京市 |\n| `result.now` | object |  | 实时天气数据，data_type=now/all 时返回 | None |\n| `result.now.aqi` | integer |  | 空气质量指数 | 140 |\n| `result.now.clouds` | integer |  | 云量（%） | 999999 |\n| `result.now.co` | number |  | 一氧化碳浓度（mg/m³） | None |\n| `result.now.feels_like` | integer |  | 体感温度（℃） | 1 |\n| `result.now.no2` | integer |  | 二氧化氮浓度（μg/m³） | None |\n| `result.now.o3` | integer |  | 臭氧浓度（μg/m³） | None |\n| `result.now.pm10` | integer |  | PM10浓度（μg/m³） | None |\n| `result.now.pm25` | integer |  | PM2.5浓度（μg/m³） | 107 |\n| `result.now.prec_1h` | number |  | 1小时累计降水量（mm） | 0 |\n| `result.now.rh` | integer |  | 相对湿度（%） | 73 |\n| `result.now.so2` | integer |  | 二氧化硫浓度（μg/m³） | None |\n| `result.now.temp` | integer |  | 温度（℃） | 4 |\n| `result.now.text` | string |  | 天气现象 | 多云 |\n| `result.now.uptime` | string |  | 数据更新时间，北京时间 | 20200220143500 |\n| `result.now.vis` | integer |  | 能见度（m） | 3471 |\n| `result.now.wind_class` | string |  | 风力等级 | 2级 |\n| `result.now.wind_dir` | string |  | 风向描述 | 东风 |\n| `status` | integer |  | 请求状态码，0表示成功<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: AK参数错误：AK不存在或非法<br/>`2`: 服务内部错误：服务器内部错误，请稍后重试<br/>`3`: 位置参数错误：location/district_id/district 参数格式错误或无效<br/>`4`: 坐标类型错误：coordtype 参数值不在允许范围内<br/>`5`: 无权限：该AK没有权限调用此服务<br/>`101`: 服务禁用：服务已被禁用<br/>`102`: 请求超限：访问频次超限 | 0 |\n\n### 常见问题\n\n**Q: district_id、location、district 三个参数如何选择？**\n\nA: 三者必填其一。district_id 用于行政区划编码查询；location 用于经纬度查询；district 用于区县名称查询，可配合 province、city 辅助定位。\n\n**Q: location 参数的格式是什么？**\n\nA: 经纬度，经度在前纬度在后，逗号分隔，例如 \"116.405285,39.904989\"。坐标类型由 coordtype 指定。\n\n**Q: data_type 各取值分别返回什么数据？**\n\nA: now: 实时天气；fc: 7天预报；index: 生活指数；alert: 气象预警；fc_hour: 24小时逐小时预报；all: 全部数据。\n\n**Q: 如果 district_id 和 location 同时传会怎样？**\n\nA: 默认以 district_id 为准。\n\n**Q: 生活指数包含哪些字段？**\n\nA: 每项包含 name(名称)、brief(概要)、detail(详细说明)。\n\nArchive v1.0.6: 32 files, 87420 bytes\n\nFiles: _meta.json (135b), recipes/address_to_full_location.md (2798b), recipes/address_to_poi.md (3253b), recipes/coordinate_to_structured_address.md (2660b), recipes/nearby_poi_search.md (3249b), recipes/poi_search_to_detail.md (2898b), recipes/route_to_named_place.md (3428b), recipes/smart_departure_time.md (3109b), recipes/traffic_aware_route.md (2905b), recipes/weather_query.md (8504b), references/admin_division_query.md (5257b), references/administrative_region_search.md (11699b), references/capabilities/driving_route_duration.md (2169b), references/capabilities/future_driving_route.md (2040b), references/capabilities/suggested_departure_time.md (1875b), references/capabilities/waypoint_route_planning.md (1870b), references/circular_region_search.md (11139b), references/constants.md (2745b), references/cycling_route_planning.md (8538b), references/domestic_weather_query.md (9230b), references/driving_route_planning.md (15150b), references/geocoding.md (7917b), references/global_reverse_geocoding.md (12529b), references/motorcycle_route_planning.md (11016b), references/multi_dimensional_search.md (11468b), references/overseas_weather_query.md (6416b), references/place_detail_search.md (10185b), references/place_input_suggestion.md (7801b), references/reverse_geocoding_agent.md (11084b), references/transit_route_planning.md (6249b), references/walking_route_planning.md (7277b), SKILL.md (8596b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: baidu-map-webapi\ndescription: 百度地图 webapi 开发指南。在编写、审查或调试使用百度地图webAPI的代码时应运用此技能，也适用于直接调用百度地图API获取结果的场景。涵盖：地图位置搜索、POI检索、路线规划、建议出发时间、路线耗时预测、实时路况、行政区划查询、地址坐标转换、沿途交通事件、天气查询、智能推荐上车点等。当用户提及出发时间、导航路线、地点查询、坐标转换、地图相关开发需求时自动触发。\nlicense: MIT\nversion: 1.0.5\nhomepage: https://lbs.baidu.com\nrepository: https://github.com/baidu-maps/webapi-skills\nmetadata:\n  openclaw:\n    requires:\n      bins: [\"curl\"]\n      env: BMAP_WEBAPI_AK\n    primaryEnv: BMAP_WEBAPI_AK\n---\n\n# webapi 开发指南\n\n百度地图 webapi 版本开发指南。包含地图位置搜索、路线导航、行政区划等核心模块的 API 说明和代码示例，既可直接调用 API 获取结果，也可帮助开发者快速集成百度地图服务。\n\n## 何时适用\n\n遇到以下任意场景时，均应读取本指南并调用对应 API：\n\n### 路线规划与出行决策\n- 规划驾车、步行、骑行、摩托车、公共交通路线\n- **查询从 A 到 B 的建议出发时间**（如\"想晚上8点到达，几点出发合适\"）\n- **预测未来某时刻出发的路线耗时**（如\"下午3点出发要多久\"）\n- 查询历史路况下的路线耗时\n- 规划含多个途经点的最优路线\n\n### 实时动态信息\n- 查询路线沿途的动态交通事件（事故、拥堵、施工等）\n- 查询海外城市天气信息\n\n### 地点与POI搜索\n- 查找城市中的餐厅、酒店、景点等 POI 信息\n- 在指定圆形区域内检索地点\n- 按行政区划检索地点\n- 多条件组合检索 POI\n- 获取 POI 详细信息\n- 输入联想/地点补全提示\n- 智能推荐安全上车点\n\n### 地址与坐标转换\n- 地址文本解析为经纬度坐标（地理编码）\n- 经纬度坐标解析为地址信息（逆地理编码）\n\n### 行政区划与区域查询\n- 查询行政区划地点\n- 获取行政区划边界坐标\n\n## 开发准则\n\n在使用本技能的任何场景中，请遵守以下通用准则：\n\n### 准则 1：API 端点选择\n\n百度地图提供两个服务端点，必须根据使用场景选择正确的端点：\n\n| 端点类型 | Base URL | 适用场景 |\n|---|---|---|\n| **标准端点** | `https://api.map.baidu.com/` | 正式开发、生产环境、为用户生成的代码 |\n| **高级功能体验端点** | `https://api.map.baidu.com/map_service/` | 百度地图官方提供，仅供大模型直接调用时快速体验高级权限功能 |\n\n**使用规则：**\n- 为用户生成的开发代码，**必须使用标准端点** `https://api.map.baidu.com/`\n- 大模型直接调用高级权限功能（如建议出发时间、未来路线规划）进行演示/体验时，使用体验端点\n- **体验端点仅供功能体验和演示，不可用于开发或生产环境**\n- **均需要AK凭证**\n\n### 准则 2：AK 凭证安全处理\n\nAK（Access Key）是使用技能之前的必须参数:\n\n1. 优先读取环境变量 `BMAP_WEBAPI_AK` 中的 AK\n2. `BMAP_WEBAPI_AK`为空时, 提示用户:**请先前往[百度地图开放平台](https://lbs.baidu.com/apiconsole/key)申请`服务端`的AK**\n3. 然后设置为环境变量\n```\nexport BMAP_WEBAPI_AK=\"百度地图AK\"\n```\n4. 使用 references/ 所有能力时的ak参数请使用 `$BMAP_WEBAPI_AK`, 示例如下:\n```\ncurl \"https://api.map.baidu.com/place/v3/region?query=美食&region=北京&ak=$BMAP_WEBAPI_AK\"\n```\n\n### 准则 3：地址/地名统一通过 `address_to_poi` 转换\n\n任何需要将**用户输入的地名或地址文本**转换为坐标/UID 的场景，**优先参考**：\n\n> `recipes/address_to_poi.md` — 地址/地名转坐标与 POI UID\n\n该文件描述了两种输入类型的判断方法和对应调用方式：\n- **结构化地址**（含门牌号/楼栋）→ `references/geocoding` API\n- **POI 名称/地标/商家名** → `references/administrative_region_search` API\n\n### 准则 4：算路时 UID 优先于纯坐标\n\n向算路接口（驾车/步行/骑行/公交）传参时：\n\n```\n推荐：同时传坐标 + uid（绑路更精准，尤其对大型 POI） origin_uid / destination_uid 有值时必传\n```\n\nUID 通过 `references/address_to_poi.md` 描述的方法获取。\n\n---\n\n## 场景示例（推荐优先阅读）\n\n遇到以下场景时，**优先使用对应 recipe**，内含完整调用链、参数说明和可运行代码示例。\n单个 API 用法请查阅下方「快速参考」。\n\n### 地址/地名预处理（算路前必读）\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/address_to_poi.md` | 地址文本或地名 → 坐标 + POI UID（算路前置步骤） | 标准 AK |\n\n### 路线规划\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/route_to_named_place.md` | 用户说出地名 → 规划驾车路线 | 标准 AK |\n| `recipes/smart_departure_time.md` | \"几点出发才能准时到\" | ⚠️ 高级权限 |\n| `recipes/traffic_aware_route.md` | 预测未来某时刻出发的路况耗时 | ⚠️ 高级权限 |\n\n### POI 搜索\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/nearby_poi_search.md` | 搜索用户附近的某类地点 | 标准 AK |\n| `recipes/poi_search_to_detail.md` | 关键词搜索 → 获取 POI 完整详情 | 标准 AK |\n\n### 地址与坐标\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/address_to_full_location.md` | 地址文本 → 坐标 + 行政区划 | 标准 AK |\n| `recipes/coordinate_to_structured_address.md` | 坐标 → 结构化地址 + 行政区划 | 标准 AK |\n\n### 天气查询\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/weather_query.md` | 通过城市名称/行政区划编码/坐标, 获取当地详细的天气信息 | 标准 AK |\n\n---\n\n## 快速参考\n\n### 基础概念\n\n- `references/constants.md` - 通用常量：状态码\n\n### 位置搜索\n\n- `references/global_reverse_geocoding.md` - 全球逆地理编码: 坐标转位置信息\n- `references/reverse_geocoding_agent.md` - 逆地理编码智能体: 智能逆地理编码地址解析\n- `references/administrative_region_search.md` - 行政区划区域检索: 行政区划地点检索\n- `references/circular_region_search.md` - 圆形区域检索: 圆形区域地点检索\n- `references/multi_dimensional_search.md` - 多维检索: 多条件智能检索POI\n- `references/place_detail_search.md` - 地点详情检索: 获取指定地点详细信息\n- `references/place_input_suggestion.md` - 地点输入提示: 地点输入提示匹配\n- `references/geocoding.md` - 地理编码: 地址解析为坐标\n\n### AOI区域\n\n- `references/admin_division_query.md` - 行政区划查询: 查询中国行政区划信息\n\n### 动态数据\n\n- `references/domestic_weather_query.md` - 国内天气查询: 国内天气查询多功能接口\n- `references/overseas_weather_query.md` - 海外天气查询: 查询海外城市天气\n\n### 路线导航\n\n- `references/cycling_route_planning.md` - 骑行路线规划: 骑行路线规划方案检索\n- `references/driving_route_planning.md` - 驾车路线规划: 驾车路线规划与路况预测\n    - `references/capabilities/driving_route_duration.md` - 驾车路线历史耗时: 设置驾车路线历史耗时\n    - `references/capabilities/future_driving_route.md` - 未来驾车路线规划: 预测未来驾车路线耗时\n    - `references/capabilities/suggested_departure_time.md` - 建议出发时间: 高级权限出行时间建议\n    - `references/capabilities/waypoint_route_planning.md` - 途经点智能路线规划: 智能优化途经点顺序\n- `references/motorcycle_route_planning.md` - 摩托车路线规划: 摩托车路线规划服务\n- `references/transit_route_planning.md` - 公交路线规划: 多交通方式路线规划\n- `references/walking_route_planning.md` - 步行路线规划: 步行路线规划\n\n## 如何使用\n\n**推荐决策路径**：\n1. 用户需求是**多步串联场景**（如\"输入地名规划路线\"、\"获取附近 POI\"）→ 直接找 `recipes/` 目录下对应 recipe\n2. 用户需求是**单个 API 的参数细节**（如\"这个接口的 tactics 参数有哪些值\"）→ 查阅 `references/` 目录\n\n每个 **references** 参考文件包含：\n- 功能简要说明\n- API 参数说明和注意事项\n\n每个 **recipes** 场景包含：\n- 触发意图（什么场景适用）\n- 完整调用链与分步说明\n- 常见错误和变体\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn778b6bf766ym71fdvrc5yvg98319rv\",\n  \"slug\": \"baidu-map-webapi\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1775531851072\n}\n\nFile v1.0.6:references/admin_division_query.md\n\n# 百度地图行政区划查询 API\n\n## 服务概述\n\n行政区划查询接口用于获取中国行政区划的详细信息。支持通过行政区划名称或adcode进行查询，返回结果包括行政区划的边界坐标、中心点、父级行政区划、行政区划级别等详细信息。该接口适用于需要行政区划数据的各类应用场景，如地图应用、数据分析、地址解析等。\n\n- **版本**: 2.0.0\n- **服务标识**: `region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/district-search/base>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/api_region_search/v1/`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| ak | string | T | - | 开发者密钥，即API Key，用于身份验证和配额管理。 | E4805d16520de693a3fe707cdc962045 |\n| keyword | string | T | - | 检索行政区划关键字。仅支持单关键字检索，可填写行政区名称（如“中国”“全国”、省/市/区/镇名称）或 adcode。 | 河北 |\n| sub_admin | string |  | 0 | 行政区划显示子级级数。可填 0、1、2、3 等：0 不返回下级；1 返回下一级；2 返回下两级；3 返回下三级，以此类推。 | 2 |\n| extensions_code | string (enum: 0, 1) |  | 0 | 是否召回国标行政区划编码，1 为召回，0 为不召回。 | 1 |\n| boundary | string (enum: 0, 1) |  | 0 | 是否返回区划边界数据：0 不返回，1 返回。仅返回查询行政区划的边界，不返回子级边界；仅支持省/市/区边界，暂不支持乡镇/街道。 | 1 |\n| boundarycode | string |  | - | 需要返回边界数据的行政区划编码。若输入 adcode 则返回该 adcode 边界；若未输入或输入错误，则返回 keyword 匹配到的第一个行政区划边界。 | 110112 |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"result\": {\n    \"name\": \"北京市\",\n    \"level\": \"province\",\n    \"adcode\": \"110000\",\n    \"parent\": {\n      \"name\": \"中国\",\n      \"adcode\": \"100000\"\n    },\n    \"boundary\": \"116.123,39.123;116.456,39.456\",\n    \"children\": [\n      {\n        \"name\": \"东城区\",\n        \"level\": \"district\",\n        \"adcode\": \"110101\"\n      }\n    ],\n    \"location\": {\n      \"lat\": 39.929986,\n      \"lng\": 116.395645\n    }\n  },\n  \"status\": 0,\n  \"message\": \"ok\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的描述信息。 | ok |\n| `result` | object |  | 查询结果对象。 | None |\n| `result.adcode` | string |  | 行政区划代码。 | 110000 |\n| `result.boundary` | string |  | 行政区划边界坐标，格式为经纬度坐标串，需设置 boundary=1 时返回。 | 116.123,39.123;116.456,39.456 |\n| `result.children` | array |  | 子级行政区划列表，当 sub_admin 大于 0 时返回。 | None |\n| `result.children[].adcode` | string |  | 子级行政区划代码。 | 110101 |\n| `result.children[].level` | string |  | 子级行政区划级别。 | district |\n| `result.children[].name` | string |  | 子级行政区划名称。 | 东城区 |\n| `result.level` | string (enum: country, province, city... (共5个值)) |  | 行政区划级别，如 country、province、city、district、town 等。 | province |\n| `result.location` | object |  | 行政区划的中心点坐标。 | None |\n| `result.location.lat` | number |  | 中心点纬度。 | 39.929986 |\n| `result.location.lng` | number |  | 中心点经度。 | 116.395645 |\n| `result.name` | string |  | 行政区划名称。 | 北京市 |\n| `result.parent` | object |  | 父级行政区划信息。 | None |\n| `result.parent.adcode` | string |  | 父级行政区划代码。 | 100000 |\n| `result.parent.name` | string |  | 父级行政区划名称。 | 中国 |\n| `status` | integer |  | 返回结果状态码，0表示成功，其他值为错误码。<br/><br/>**枚举值说明：**<br/>`0`: ok：正常<br/>`1`: 服务器内部错误：服务器端出现未知错误，请稍后重试<br/>`2`: 请求参数非法：请求参数缺失或格式错误<br/>`3`: 权限校验失败：ak无效或没有权限<br/>`4`: 配额校验失败：访问超出配额限制<br/>`5`: ak不存在或被封禁：ak不存在或已被封禁，请检查ak状态<br/>`101`: 服务禁用：该服务已被禁用<br/>`102`: 不通过白名单或安全码不对：服务器没有开启白名单，或安全码不对 | 0 |\n\n### 常见问题\n\n**Q: 支持查询哪些级别的行政区划？**\n\nA: 支持国家(country)、省(province)、市(city)、区/县(district)级别的行政区划查询\n\n**Q: 如何获取行政区划的边界坐标？**\n\nA: 设置 boundary=1 可返回边界坐标串（boundary 字段），格式为'经度,纬度;经度,纬度;...'\n\n**Q: 如何获取下一级行政区划？**\n\nA: 设置 sub_admin 大于 0 可返回子级行政区划；如 sub_admin=1 返回下一级，sub_admin=2 返回下两级\n\n**Q: 边界坐标使用什么坐标系？**\n\nA: 返回的边界坐标使用百度BD-09坐标系\n\n**Q: 如何获取ak？**\n\nA: 需要在百度地图开放平台控制台（https://lbsyun.baidu.com/）注册并创建应用获取API Key\n\nFile v1.0.6:references/administrative_region_search.md\n\n# 百度地图地点检索及联想 API\n\n## 服务概述\n\n开发者可通过该功能，检索某一行政区划内（目前最细到区县级别）的地点信息。支持通过关键字、POI类型、区域限制、排序、分页等多种参数进行精细化检索。\n\n- **版本**: 2.0.0\n- **服务标识**: `administrative_region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/guide/webservice-placeapiV3/interfaceDocumentV3>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/place/v3/region`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| query | string | T | - | 检索关键字。 | ATM机、美食 |\n| region | string | T | - | 检索行政区划区域（支持到区县级）。增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用region_limit参数。可输入行政区划名或对应citycode。 | 北京市海淀区 |\n| ak | string | T | - | 开发者的访问密钥，必填项。v2之前该属性为key。 | 您的AK |\n| region_limit | boolean |  | - | 区域数据召回限制，为true时，仅召回region对应区域内数据。 | False |\n| is_light_version | boolean |  | False | true：轻量化检索，检索速度大幅提升，排序更简单直接；false（默认）：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验。 | False |\n| type | string |  | - | 对query召回结果进行二次筛选，type内容建议参考POI分类，建议query同属于一个大类；如query=美食 type=火锅（用于泛搜索场景）。query和type支持只填一项。 | 火锅 |\n| center | string |  | - | 传入poi坐标，辅助检索结果按距离排序与返回。需要搭配排序字段一起使用并结合coord_type字段说明该字段的坐标类型。 | 38.76623,116.43213 |\n| scope | integer (enum: 1, 2) |  | - | 检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息。 | - |\n| coord_type | integer (enum: 1, 2, 3, 4) |  | 3 | 传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）。 | - |\n| filter | string |  | - | 检索排序条件，包含以下3部分：industry_type（行业类型：hotel/cater/life）；sort_name（排序方式：default/price/overall_rating/distance）；sort_rule（排序规则：0从高到低，1从低到高）。 | industry_type:cater,sort_name:overall_rating,sort_rule:1 |\n| extensions_adcode | boolean |  | - | 是否召回国标行政区划编码。 | False |\n| address_result | boolean (enum: false) |  | - | query传入结构化地址时，控制返回数据的类型。若不传入该字段，可能会召回门址数据，当address_result=false时，召回相应的POI数据避免召回门址数据。 | False |\n| photo_show | boolean |  | False | 是否输出图片信息：true(输出)，false(不输出)。购买商用授权后可申请开通。 | False |\n| from_language | string |  | 中文 | 入参query的语言类型，支持不同语言的检索词作为入参，不填默认为中文，可以设置为auto，大模型会自行判断入参语言。 | auto |\n| language | string |  | 中文 | 召回结果的语言类型，支持多种语言召回结果，默认为中文。该功能为高级权限功能。 | en，fr |\n| page_num | integer |  | 0 | 分页页码，默认为0,0代表第一页，1代表第二页，以此类推。常与page_size搭配使用，仅当返回结果为poi时可以翻页。 | - |\n| page_size | integer |  | 10 | 单次召回POI数量，默认为10条记录，最大返回20条。取值为10-20。 | 10 |\n| ret_coordtype | string |  | - | 返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标。 | gcj02ll |\n| output | string (enum: json) |  | json | 输出数据格式，仅支持json。 | json |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"status\": 0,\n  \"message\": \"ok\",\n  \"results\": [\n    {\n      \"uid\": \"05478f385d3729eef4eafc16\",\n      \"area\": \"海淀区\",\n      \"city\": \"北京市\",\n      \"name\": \"中国银行ATM(北京上地信息路支行)\",\n      \"town\": \"上地街道\",\n      \"detail\": 1,\n      \"address\": \"上地信息路15号1层104室\",\n      \"location\": {\n        \"lat\": 40.04383967179688,\n        \"lng\": 116.31584460688308\n      },\n      \"province\": \"北京市\",\n      \"town_code\": 110108022\n    }\n  ],\n  \"query_type\": \"general\",\n  \"result_type\": \"poi_type\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。 | ok |\n| `query_type` | string |  | 搜索类型：精搜precise/泛搜general。 | general |\n| `result_type` | string |  | 召回结果类型：region_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型。 | poi_type |\n| `results[]` | object |  |  | None |\n| `results[].adcode` | integer \\| null |  | poi所属区域代码。 | 110101 |\n| `results[].address` | string \\| null |  | poi所在地址。 | 上地信息路15号1层104室 |\n| `results[].area` | string \\| null |  | poi所属区县。 | 海淀区 |\n| `results[].arrival_heat` | number \\| null |  | poi的到达热度（高级权限）。 | 190.65 |\n| `results[].city` | string \\| null |  | poi所属城市。 | 北京市 |\n| `results[].d7_hot_value` | integer \\| null |  | poi近7天的热度总值。 | 211 |\n| `results[].detail` | string \\| null |  | 是否有详情页：1有，0没有。 | 1 |\n| `results[].detail_info` | object \\| null |  | 详细信息。 |  |\n| `results[].detail_info.brand` | string \\| null |  | poi对应的品牌。 | 淮扬菜 |\n| `results[].detail_info.children[]` | object |  |  | None |\n| `results[].detail_info.children[].address` | string \\| null |  | poi子点地址。 | 北京市海淀区新建宫门路19号颐和园内 |\n| `results[].detail_info.children[].classified_poi_tag` | string \\| null |  | poi子点详细分类标签。 | 出入口;门 |\n| `results[].detail_info.children[].location` | object \\| null |  | poi子点坐标。 |  |\n| `results[].detail_info.children[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.children[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.children[].name` | string |  | poi子点名称。 | 颐和园-西门 |\n| `results[].detail_info.children[].show_name` | string \\| null |  | poi子点简称。 | 西门 |\n| `results[].detail_info.children[].uid` | string |  | poi子点ID，可用于poi详情检索。 | 331152d1b94bc54dc41e5148 |\n| `results[].detail_info.classified_poi_tag` | string \\| null |  | POI展示分类（细致分类）。 | 旅游景点;5A景区 |\n| `results[].detail_info.comment_num` | string \\| null |  | poi的评论数。 |  |\n| `results[].detail_info.description` | string \\| null |  | 描述。 |  |\n| `results[].detail_info.detail_url` | string \\| null |  | poi的详情页。 | http://api.map.baidu.com/place/detail?uid=2a7a2... |\n| `results[].detail_info.image_num` | string \\| null |  | poi图片数。 | 10 |\n| `results[].detail_info.indoor_floor` | string \\| null |  | 室内poi所在楼层。 |  |\n| `results[].detail_info.label` | string \\| null |  | poi权威标签，标签细分解释。 | 淮扬菜 |\n| `results[].detail_info.navi_location` | object \\| null |  | poi对应的导航引导点坐标（上车点）。 |  |\n| `results[].detail_info.navi_location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.navi_location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.new_alias` | string \\| null |  | poi别名。 | 故宫 |\n| `results[].detail_info.overall_rating` | string \\| null |  | poi的综合评分。 | 4.7 |\n| `results[].detail_info.parent_id` | string \\| null |  | poi父点id。 | 06d2dffda107b0ef89f15db6 |\n| `results[].detail_info.photos` | array \\| null |  | poi图片的下载链接。购买商用授权后可申请开通。 | [] |\n| `results[].detail_info.price` | string \\| null |  | poi商户的价格。 | 4.7 |\n| `results[].detail_info.ranking` | string \\| null |  | poi的相关榜单排名。 | 北京市展览馆榜NO.1 |\n| `results[].detail_info.shop_hours` | string \\| null |  | poi的营业时间。 | 10:30-14:00,16:30-22:00 |\n| `results[].detail_info.type` | string \\| null |  | 类型，如（hotel、cater、life），配合filter排序。 | hotel |\n| `results[].heat_trend` | string \\| null |  | 近7天热度增长（递减）XX%（高级权限）。 | 近7天热度递减5% |\n| `results[].interact_heat` | number \\| null |  | poi的互动热度（高级权限）。 | 36.05 |\n| `results[].location` | object \\| null |  | poi经纬度坐标。 |  |\n| `results[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].name` | string |  | poi名称，单次请求最多返回10条结果。 | 中国银行ATM(北京上地信息路支行) |\n| `results[].province` | string \\| null |  | poi所属省份。 | 北京市 |\n| `results[].status` | string \\| null |  | poi营业状态 ：空（代表正常营业）、推算位置、暂停营业、可能已关闭、已关闭。 |  |\n| `results[].street_id` | string \\| null |  | poi所在街景图id。 | e176ad06ea2a026cd2f49e2c |\n| `results[].telephone` | string \\| null |  | poi的电话。 |  |\n| `results[].town` | string \\| null |  | poi所属乡镇街道。 | 上地街道 |\n| `results[].town_code` | integer \\| null |  | poi所属乡镇街道编码。 | 110108022 |\n| `results[].uid` | string |  | poi的唯一标示，ID。 | 05478f385d3729eef4eafc16 |\n| `results[].view_heat` | number \\| null |  | poi的浏览热度（高级权限）。 | 2302.75 |\n| `status` | integer |  | 本次API访问状态，如果成功返回0，如果失败返回其他数字。 | 0 |\n| `total` | integer \\| null |  | 召回poi数量，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。 |  |\n\n### 常见问题\n\n**Q: 哪些参数是调用此接口时必须填写的？**\n\nA: query（检索关键字）、region（检索区域）和ak（访问密钥）是三个必填参数。\n\n**Q: 如何严格限制检索结果只返回指定区域内的数据？**\n\nA: 除了填写region参数外，还需要将region_limit参数设置为true，这样将仅召回region对应区域内的数据。\n\n**Q: 如何对检索结果进行排序，例如按距离或评分排序？**\n\nA: 可以使用filter参数进行排序。需要指定industry_type（行业）、sort_name（排序字段，如distance或overall_rating）和sort_rule（排序规则）。按距离排序时还需配合center参数提供中心点坐标。\n\n**Q: 接口支持分页吗？最多能获取多少条数据？**\n\nA: 支持分页，使用page_num和page_size参数。page_size默认为10，最大为20。当启用分页时，total字段表示总条数，但出于数据保护，单次请求total最多显示150条。\n\n**Q: 返回结果中的一些字段（如photos、热度数据）为什么是空的？**\n\nA: 部分字段属于高级功能，例如图片信息(photo_show)、多语言检索(language)、热度数据(view_heat等)需要购买商用授权或联系商务提交工单申请开通后才能返回数据。\n\nFile v1.0.6:references/capabilities/driving_route_duration.md\n\n# 驾车路线规划-历史路线耗时\n\n## 服务概述\n\n该功能需要开通高级权限，开发者可设置更多出发时间（用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个）\n\n- **版本**: 2.0.0\n- **服务标识**: `driving_route_duration`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-logotime>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| ext_departure_time | string |  | - | 更多出发时间，UNIX时间戳。该字段将影响ext_duration字段的返回，用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个），多个时间戳之间用','英文半角逗号隔开。ext_departure_time=1526527619,1526525384,1526523654 目前出发时间仅影响ext_duration字段，还不会影响路线计算和选择。即仍按照现在的路况计算并推荐路线，但将增加返回该路线在其他时间的耗时。不填则不返回ext_duration字段 | 1609459200 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].ext_duration` | integer \\| string \\| null |  | 驾车路线历史耗时（扩展），单位：秒。当设置了ext_departure_time时返回，多个时间戳对应多个耗时以英文逗号分隔，计算失败返回-1。 | 500,520,-1 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.6:references/capabilities/future_driving_route.md\n\n# 驾车路线规划-未来驾车\n\n## 服务概述\n\n该功能需要开通高级权限，开发者可设置出发时间（支持未来7天），UNIX时间戳。该字段将影响duration字段的返回，用于返回未来驾车路线耗时。取值范围：当前时间之后7天*24小时内任意时刻（超出时间范围将预估路线）若设置该参数，则路线规划服务将依据设定时间预测路况和限行规则，并据此计算路线和耗时。\n\n- **版本**: 2.0.0\n- **服务标识**: `future_driving_route`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-time>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| departure_time | string |  | - | 出发时间，UNIX时间戳。支持未来7天任意时刻。设置后将依据设定时间预测路况和限行规则计算路线和耗时（高级权限服务）。 | 1609459200 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].duration` | integer |  | 未来驾车路线耗时（若请求参数设置了符合规则的departure_time，则按照设定出发时间的预测路况计算路线耗时。若未设置departure_time，则按照当前时刻的路况计算路线耗时）或当前路况耗时，单位：秒 | 600 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n| `type` | integer |  | 默认返回2，开发者无需关注 | 2 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.6:references/capabilities/suggested_departure_time.md\n\n# 驾车路线规划-建议出发时间\n\n## 服务概述\n\n该功能需要开通高级权限，开发者设置预期到达时间后,将返回建议出发时间\n\n- **版本**: 2.0.0\n- **服务标识**: `suggested_departure_time`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-suggtime>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| expect_arrival_time | string |  | - | 预期到达时间，UNIX时间戳。取值范围：当前时间之后15分钟任意时刻。设置后将返回suggest_departure_time字段, （小于这个时间则不做处理）若设置此参数，则路线规划服务将依据设定时间计算路线和耗时，并给出建议出发时间, 若算出的suggest_departure_time小于当前时间，则设置suggest_departure_time为-1 | 1609462800 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].suggest_departure_time` | integer \\| null |  | 建议出发时间，单位：秒。当设置了expect_arrival_time时返回，按照预计到达时间预测路况计算路线，并给出建议出发时间，若计算出的时间小于当前时间则返回-1。 | 1609459200 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.6:references/capabilities/waypoint_route_planning.md\n\n# 驾车路线规划-途经点智能路线规划\n\n## 服务概述\n\n该功能需要开通高级权限，传入多个途经点，综合考虑路况、交规限行、 途经点的相对位置以及路线整体的绕路成本等，支持智能调整途经点顺序，给出最优路线。\n\n- **版本**: 2.0.0\n- **服务标识**: `waypoint_route_planning`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-aiplan>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| intelligent_plan | integer (enum: 0, 1) |  | 0 | 是否执行途经点智能规划，综合考虑路况、限行、途经点相对位置及绕路成本，支持智能调整途经点顺序可选值：0（默认值）：不执行途经点智能规划1：执行途经点智能规划（高级权限服务）。 | 1 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].suggest_departure_time` | integer \\| null |  | 建议出发时间，单位：秒。当设置了expect_arrival_time时返回，按照预计到达时间预测路况计算路线，并给出建议出发时间，若计算出的时间小于当前时间则返回-1。 | 1609459200 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限\n\nFile v1.0.6:references/circular_region_search.md\n\n# 百度地图地点检索及联想 API\n\n## 服务概述\n\n开发者可设置圆心坐标和半径，检索圆形区域内的地点信息（POI）。支持多关键字并集检索、按POI分类检索、结果排序、分页、多语言检索等高级功能。当检索半径过大，超过中心点所在城市边界时，检索范围会自动变为该城市范围。\n\n- **版本**: 2.0.0\n- **服务标识**: `circular_region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/guide/webservice-placeapiV3/interfaceDocumentV3>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/place/v3/around`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| query | string | T | - | 检索关键字。支持多个关键字并集检索，不同关键字间以$符号分隔，最多10个。也可通过POI分类进行检索。 | 银行 |\n| location | string | T | - | 圆形区域检索中心点经纬度坐标，格式为“纬度,经度”。不支持多个点。 | 39.915,116.404 |\n| ak | string | T | - | 开发者的访问密钥（API Key），必填项。 | 您的AK |\n| radius | integer |  | 1000 | 圆形区域检索半径，单位为米。默认1000。 | 2000 |\n| radius_limit | boolean |  | - | 是否严格限定召回结果在设置的检索半径范围内。true（是），false（否）。 | True |\n| is_light_version | boolean |  | False | true：优先保证检索速度，排序更简单直接；false（默认）：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序。 | True |\n| type | string |  | - | 对query召回结果进行二次筛选，内容建议参考POI分类。query和type支持只填一项。 | 火锅 |\n| scope | integer (enum: 1, 2) |  | - | 检索结果详细程度。1 或空：返回基本信息；2：返回检索POI详细信息。 | 2 |\n| coord_type | integer (enum: 1, 2, 3, 4) |  | 3 | 传入的坐标类型。1：wgs84ll（GPS经纬度）；2：gcj02ll（国测局经纬度）；3：bd09ll（百度经纬度，默认）；4：bd09mc（百度米制坐标）。 | 3 |\n| filter | string |  | - | 检索排序条件，格式：industry_type:行业\\|sort_name:排序方式\\|sort_rule:排序规则。行业：hotel/cater/life；排序方式：default/price/overall_rating/distance；排序规则：0（从高到低）/1（从低到高）。 | industry_type:cater|sort_name:overall_rating|sort_rule:1 |\n| extensions_adcode | boolean |  | - | 是否召回国标行政区划编码。true（召回）、false（不召回）。 | True |\n| photo_show | boolean |  | False | 是否输出图片信息：true(输出)，false(不输出)。此为高级权限功能。 | False |\n| from_language | string |  | zh | query的语言类型，支持不同语言的检索词。不填默认为中文，可设置为auto（自动判断）。 | auto |\n| language | string |  | zh | 多语言检索，支持多种语言召回结果。默认为中文。此为高级权限功能。 | en |\n| page_num | integer |  | 0 | 分页页码，默认为0（第一页），1代表第二页，以此类推。仅当返回结果为poi时可以翻页。 | 0 |\n| page_size | integer |  | 10 | 单次召回POI数量，默认为10条，最大返回20条。取值范围10-20。 | 10 |\n| ret_coordtype | string |  | - | 返回的坐标类型，添加后POI返回国测局经纬度坐标（gcj02ll）。 | gcj02ll |\n| output | string (enum: json) |  | json | 输出数据格式，仅支持json。 | json |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"status\": 0,\n  \"message\": \"ok\",\n  \"results\": [\n    {\n      \"uid\": \"14cf81e3aae18d1914948ebb\",\n      \"area\": \"东城区\",\n      \"city\": \"北京市\",\n      \"name\": \"中国民生银行(北京正义路支行)\",\n      \"town\": \"东华门街道\",\n      \"detail\": 1,\n      \"address\": \"北京市东城区东长安街35号首层西侧\",\n      \"location\": {\n        \"lat\": 39.91518549590169,\n        \"lng\": 116.41350155480602\n      },\n      \"province\": \"北京市\",\n      \"street_id\": \"14cf81e3aae18d1914948ebb\",\n      \"telephone\": \"(010)65284468\",\n      \"town_code\": 110101001\n    }\n  ],\n  \"query_type\": \"general\",\n  \"result_type\": \"poi_type\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。 | ok |\n| `query_type` | string |  | 搜索类型：精搜precise/泛搜general。 | general |\n| `result_type` | string |  | 召回结果类型：region_type 行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型。 | poi_type |\n| `results[]` | object |  |  | None |\n| `results[].adcode` | integer \\| null |  | poi所属区域代码。 | 110101 |\n| `results[].address` | string \\| null |  | poi所在地址。 | 上地信息路15号1层104室 |\n| `results[].area` | string \\| null |  | poi所属区县。 | 海淀区 |\n| `results[].arrival_heat` | number \\| null |  | poi的到达热度（高级权限）。 | 190.65 |\n| `results[].city` | string \\| null |  | poi所属城市。 | 北京市 |\n| `results[].d7_hot_value` | integer \\| null |  | poi近7天的热度总值。 | 211 |\n| `results[].detail` | string \\| null |  | 是否有详情页：1有，0没有。 | 1 |\n| `results[].detail_info` | object \\| null |  | 详细信息。 |  |\n| `results[].detail_info.brand` | string \\| null |  | poi对应的品牌。 | 淮扬菜 |\n| `results[].detail_info.children[]` | object |  |  | None |\n| `results[].detail_info.children[].address` | string \\| null |  | poi子点地址。 | 北京市海淀区新建宫门路19号颐和园内 |\n| `results[].detail_info.children[].classified_poi_tag` | string \\| null |  | poi子点详细分类标签。 | 出入口;门 |\n| `results[].detail_info.children[].location` | object \\| null |  | poi子点坐标。 |  |\n| `results[].detail_info.children[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.children[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.children[].name` | string |  | poi子点名称。 | 颐和园-西门 |\n| `results[].detail_info.children[].show_name` | string \\| null |  | poi子点简称。 | 西门 |\n| `results[].detail_info.children[].uid` | string |  | poi子点ID，可用于poi详情检索。 | 331152d1b94bc54dc41e5148 |\n| `results[].detail_info.classified_poi_tag` | string \\| null |  | POI展示分类（细致分类）。 | 旅游景点;5A景区 |\n| `results[].detail_info.comment_num` | string \\| null |  | poi的评论数。 |  |\n| `results[].detail_info.description` | string \\| null |  | 描述。 |  |\n| `results[].detail_info.detail_url` | string \\| null |  | poi的详情页。 | http://api.map.baidu.com/place/detail?uid=2a7a2... |\n| `results[].detail_info.image_num` | string \\| null |  | poi图片数。 | 10 |\n| `results[].detail_info.indoor_floor` | string \\| null |  | 室内poi所在楼层。 |  |\n| `results[].detail_info.label` | string \\| null |  | poi权威标签，标签细分解释。 | 淮扬菜 |\n| `results[].detail_info.navi_location` | object \\| null |  | poi对应的导航引导点坐标（上车点）。 |  |\n| `results[].detail_info.navi_location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].detail_info.navi_location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].detail_info.new_alias` | string \\| null |  | poi别名。 | 故宫 |\n| `results[].detail_info.overall_rating` | string \\| null |  | poi的综合评分。 | 4.7 |\n| `results[].detail_info.parent_id` | string \\| null |  | poi父点id。 | 06d2dffda107b0ef89f15db6 |\n| `results[].detail_info.photos` | array \\| null |  | poi图片的下载链接。购买商用授权后可申请开通。 | [] |\n| `results[].detail_info.price` | string \\| null |  | poi商户的价格。 | 4.7 |\n| `results[].detail_info.ranking` | string \\| null |  | poi的相关榜单排名。 | 北京市展览馆榜NO.1 |\n| `results[].detail_info.shop_hours` | string \\| null |  | poi的营业时间。 | 10:30-14:00,16:30-22:00 |\n| `results[].detail_info.type` | string \\| null |  | 类型，如（hotel、cater、life），配合filter排序。 | hotel |\n| `results[].heat_trend` | string \\| null |  | 近7天热度增长（递减）XX%（高级权限）。 | 近7天热度递减5% |\n| `results[].interact_heat` | number \\| null |  | poi的互动热度（高级权限）。 | 36.05 |\n| `results[].location` | object \\| null |  | poi经纬度坐标。 |  |\n| `results[].location.lat` | number |  | 纬度值。 | 40.04383967179688 |\n| `results[].location.lng` | number |  | 经度值。 | 116.31584460688308 |\n| `results[].name` | string |  | poi名称，单次请求最多返回10条结果。 | 中国银行ATM(北京上地信息路支行) |\n| `results[].province` | string \\| null |  | poi所属省份。 | 北京市 |\n| `results[].status` | string \\| null |  | poi营业状态 ：空（代表正常营业）、推算位置、暂停营业、可能已关闭、已关闭。 |  |\n| `results[].street_id` | string \\| null |  | poi所在街景图id。 | e176ad06ea2a026cd2f49e2c |\n| `results[].telephone` | string \\| null |  | poi的电话。 |  |\n| `results[].town` | string \\| null |  | poi所属乡镇街道。 | 上地街道 |\n| `results[].town_code` | integer \\| null |  | poi所属乡镇街道编码。 | 110108022 |\n| `results[].uid` | string |  | poi的唯一标示，ID。 | 05478f385d3729eef4eafc16 |\n| `results[].view_heat` | number \\| null |  | poi的浏览热度（高级权限）。 | 2302.75 |\n| `status` | integer |  | 本次API访问状态，如果成功返回0，如果失败返回其他数字。 | 0 |\n| `total` | integer \\| null |  | 召回poi数量，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。 |  |\n\n### 常见问题\n\n**Q: 哪些参数是调用此接口时必须填写的？**\n\nA: query（检索关键字）、location（中心点坐标）、ak（访问密钥）这三个参数是必须填写的。\n\n**Q: 如果设置的检索半径很大，会有什么影响？**\n\nA: 当半径过大，超过中心点所在城市边界时，检索范围会自动变为该城市范围，而不再严格限定为圆形区域。\n\n**Q: 如何对检索结果进行排序？**\n\nA: 可以使用filter参数进行排序，指定行业类型(industry_type)、排序方式(sort_name)和排序规则(sort_rule)，例如按餐饮行业评分从低到高排序。\n\n**Q: 接口是否支持使用英文或其他语言关键字进行检索？**\n\nA: 支持。通过设置from_language参数（如设为'auto'或指定语种代码）可以传入非中文关键字。通过language参数可以指定返回结果的语种，但此为高级权限功能。\n\n**Q: 如何获取POI的图片、详细热度等高级信息？**\n\nA: 需要购买百度地图的商用授权，然后联系商务提交工单申请开通相应的高级权限（如photo_show、view_heat等字段）。\n\nFile v1.0.6:references/constants.md\n\n# 通用常量\n\n## 返回值状态常量\n\n所有 webapi 服务共用的状态码, 部分服务会有自己特有的状态码, 请结合使用\n\n# 返回值状态码说明表\n\n| 返回值 | 定义 | 英文描述 | 常见原因 |\n|--------|------|----------|----------|\n| 0 | 正常 | ok | 服务请求正常召回 |\n| 1 | 服务器内部错误 | - | 该服务响应超时或系统内部错误,请留下联系方式 |\n| 2 | 请求参数非法 | Parameter Invalid | 必要参数拼写错误或漏传(如query和tag请求中均未传入) |\n| 3 | 权限校验失败 | Verify Failure | - |\n| 4 | 配额校验失败 | Quota Failure | 服务当日调用次数已超限,请前往 API控制台 提升(请优先进行开发者认证) |\n| 5 | ak不存在或者非法 | AK Failure | 未传入ak参数;ak已被删除(可前往 回收站 恢复) |\n| 8 | 数据解析失败 | Parse Proto Failure | 一般是query输入有误导致,如query输入特殊字符,全角符号 |\n| 9 | 高级权限校验失败 | Permission Denied | - |\n| 101 | AK参数不存在 | - | 请求消息没有携带AK参数 |\n| 200 | APP不存在,AK有误请检查再重试 | - | 根据请求的ak,找不到对应的服务,请检查ak, url是否正确 |\n| 201 | APP被用户自己禁用,请在控制台解禁 | - | - |\n| 202 | APP被管理员删除 | - | 恶意APP被管理员删除 |\n| 203 | APP类型错误 | - | 当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone(类型22))及Browser(类型3),除此之外其他类型认为是APP类型错误 |\n| 210 | APP IP校验失败 | - | 在申请SERVER类型应用的时候选择IP校验,需要填写IP白名单,如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败 |\n| 211 | APP SN校验失败 | - | SERVER类型APP有两种校验方式IP校验和SN校验,当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败 |\n| 240 | APP 服务被禁用 | - | 用户在API控制台中创建或设置某APP的时候禁用了某项服务,若需开通权限,可进入API控制台为AK勾选对应服务 |\n| 250 | 用户不存在 | - | 根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id |\n| 251 | 用户被自己删除 | - | 该用户处于未激活状态 |\n| 252 | 用户被管理员删除 | - | 恶意用户被加入黑名单 |\n| 260 | 服务不存在 | - | 服务器解析不到用户请求的服务名称 |\n| 261 | 服务被禁用 | - | 该服务已下线 |\n| 302 | 天配额超限,限制访问 | - | 配额超限,如果想增加配额请联系我们 |\n| 401 | 当前并发量已经超过约定并发配额,限制访问 | - | 并发控制超限,请控制并发量或联系我们 |\n\nFile v1.0.6:references/cycling_route_planning.md\n\n# 百度地图骑行路线规划 API\n\n## 服务概述\n\n根据起终点坐标检索符合条件的骑行路线规划方案，支持普通自行车和电动自行车出行方式。\n\n- **版本**: 2.0.0\n- **服务标识**: `direction_v2_riding`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction/cycling>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/riding`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| origin | string | T | - | 起点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815 | 40.01116,116.339303 |\n| destination | string | T | - | 终点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815 | 39.936404,116.452562 |\n| origin_uid | string |  | - | 起点POI的uid（请尽量填写uid，将提升路线规划的准确性。使用地点检索服务或地点输入提示服务获取uid） | - |\n| destination_uid | string |  | - | 终点POI的uid（请尽量填写uid，将提升路线规划的准确性。使用地点检索服务或地点输入提示服务获取uid） | - |\n| coord_type | string (enum: bd09ll, bd09mc, gcj02, wgs84) |  | bd09ll | 输入坐标类型，默认bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度墨卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps设备获取的坐标）。 | - |\n| ret_coordtype | string (enum: bd09ll, gcj02) |  | bd09ll | 输出坐标类型，默认为百度经纬度坐标：bd09ll。可选值：bd09ll：百度经纬度坐标；gcj02：国测局坐标。 | - |\n| output | string (enum: json, xml) |  | json | 表示输出类型，可设置为xml或json | - |\n| riding_type | string (enum: 0, 1) |  | 0 | 骑行类型。默认0：0-普通 1-电动车 | - |\n| road_prefer | integer (enum: 0, 3) |  | 0 | 算路方案。默认0：0-默认路线；3-无逆行且无阶梯的算路方案（不传默认0） | - |\n| ak | string | T | - | 用户的访问权限，AK申请 | 您的AK |\n| sn | string |  | - | 用户的权限签名，当AK设置为SN校验时，该参数必填。SN计算方法请参考相关文档。 | - |\n| timestamp | integer |  | - | 时间戳，与SN配合使用，SN存在时必填 | - |\n| callback | string |  | - | 回调函数，用于解决浏览器请求跨域问题。仅在output=json时，该参数有效。 | - |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `info` | object |  | 版权信息 | None |\n| `info.copyright` | object |  |  | None |\n| `info.copyright.imageUrl` | string |  |  | http://api.map.baidu.com/images/copyright_logo.png |\n| `info.copyright.text` | string |  |  | @2023 Baidu - Data |\n| `message` | string |  | 状态码对应的信息 | ok |\n| `result` | object |  | 返回的结果 | None |\n| `result.destination` | object |  |  | None |\n| `result.destination.destinationPt` | object |  |  | None |\n| `result.destination.destinationPt.lat` | number |  | 终点纬度 | None |\n| `result.destination.destinationPt.lng` | number |  | 终点经度 | None |\n| `result.origin` | object |  |  | None |\n| `result.origin.originPt` | object |  |  | None |\n| `result.origin.originPt.lat` | number |  | 起点纬度 | None |\n| `result.origin.originPt.lng` | number |  | 起点经度 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].destinationLocation` | object |  |  | None |\n| `result.routes[].destinationLocation.lat` | number |  | 路线终点纬度 | None |\n| `result.routes[].destinationLocation.lng` | number |  | 路线终点经度 | None |\n| `result.routes[].distance` | integer |  | 方案距离，单位：米 | 17279 |\n| `result.routes[].duration` | integer |  | 线路耗时，单位：秒 | 5969 |\n| `result.routes[].originLocation` | object |  |  | None |\n| `result.routes[].originLocation.lat` | number |  | 路线起点纬度 | None |\n| `result.routes[].originLocation.lng` | number |  | 路线起点经度 | None |\n| `result.routes[].restrictions_info` | string |  | 限行信息，如 '包含禁行路段\\|包含逆行路段' |  |\n| `result.routes[].restrictions_status` | integer |  | 限行类型，0x01表示禁行；0x02表示逆行 | 0 |\n| `result.routes[].steps` | array |  | 路段信息集合 | None |\n| `result.routes[].steps[].area` | integer |  |  | 0 |\n| `result.routes[].steps[].direction` | integer |  | 当前道路方向角 | 176 |\n| `result.routes[].steps[].distance` | integer |  | 路段距离，单位：米 | 200 |\n| `result.routes[].steps[].duration` | integer |  | 路段耗时，单位：秒 | 60 |\n| `result.routes[].steps[].guidance` | array |  | 诱导信息,有高级权限才能返回 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions` | array |  | 播报详细信息 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].cloud_guide_version` | string |  | 云导版本 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details` | array |  | 播报点详情 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details[].distance_to_gdpt` | integer |  | 播报点与诱导点的距离 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details[].speak_text` | string |  | 播报内容 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].details[].voice_level` | integer |  | 音量级别 | None |\n| `result.routes[].steps[].guidance[].verbal_instructions[].distance_to_origin` | Integer |  | 播报点与起点的距离 | None |\n| `result.routes[].steps[].instructions` | string |  | 路段描述，如'骑行50米' | 骑行200米 |\n| `result.routes[].steps[].leg_index` | integer |  |  | 0 |\n| `result.routes[].steps[].links` | array |  | link信息集合 | None |\n| `result.routes[].steps[].links[].attr` | integer |  | link属性，0x01表示禁行；0x02表示逆行 | 0 |\n| `result.routes[].steps[].links[].length` | integer |  | link长度，单位：米 | 70 |\n| `result.routes[].steps[].name` | string |  | 该路段道路名称，如'信息路'。若道路未命名或百度地图未采集到该道路名称，则返回'无名路'。 |  |\n| `result.routes[].steps[].path` | string |  | 路段位置坐标描述 | 116.339966,40.011176;116.340006,40.010546;116.3... |\n| `result.routes[].steps[].restrictions_info` | string |  | 限行信息 |  |\n| `result.routes[].steps[].restrictions_status` | integer |  | 限行类型，0x01表示禁行；0x02表示逆行 | 0 |\n| `result.routes[].steps[].stepDestinationInstruction` | string |  |  |  |\n| `result.routes[].steps[].stepDestinationLocation` | object |  |  | None |\n| `result.routes[].steps[].stepDestinationLocation.lat` | number |  | 路段终点纬度 | None |\n| `result.routes[].steps[].stepDestinationLocation.lng` | number |  | 路段终点经度 | None |\n| `result.routes[].steps[].stepOriginInstruction` | string |  |  |  |\n| `result.routes[].steps[].stepOriginLocation` | object |  |  | None |\n| `result.routes[].steps[].stepOriginLocation.lat` | number |  | 路段起点纬度 | None |\n| `result.routes[].steps[].stepOriginLocation.lng` | number |  | 路段起点经度 | None |\n| `result.routes[].steps[].turn_type` | string |  | 行驶转向方向，如'直行'、'左前方转弯' | 左转 |\n| `result.routes[].steps[].type` | integer |  |  | 5 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`2001`: 无骑行路线 | 0 |\n| `type` | integer |  | 返回数据类型 | 2 |\n\n### 常见问题\n\n**Q: 起点和终点的坐标格式是什么？小数点后支持几位？**\n\nA: 格式为：纬度,经度（例如：40.01116,116.339303）。小数点后不超过6位。\n\n**Q: 如何提升路线规划的准确性？**\n\nA: 建议填写起点和终点的POI uid（通过地点检索或输入提示服务获取），可显著提升准确性。\n\n**Q: 支持哪些输入和输出的坐标系？**\n\nA: 输入支持bd09ll、bd09mc、gcj02、wgs84；输出支持bd09ll和gcj02。\n\n**Q: 电动车和普通自行车规划有什么区别？**\n\nA: 选择电动车骑行类型（riding_type=1）时，路线规划算法会考虑电动车的通行规则和偏好。\n\n**Q: “无逆行且无阶梯”的算路方案是什么意思？**\n\nA: 选择road_prefer=3时，系统会尽量避免规划包含逆行路段和人行阶梯的路线。\n\nFile v1.0.6:references/domestic_weather_query.md\n\n# 百度地图国内天气查询 API\n\n## 服务概述\n\n国内天气查询接口，支持通过行政区划代码、经纬度坐标或省市区名称查询国内天气信息。可获取实时天气、未来7天预报、逐小时预报、生活指数、气象预警等数据。支持百度坐标（BD-09ll/BD-09mc）、国测局坐标（GCJ-02）、GPS坐标（WGS-84）四种坐标系。适用于天气应用开发、出行规划、农业气象监测、智能家居天气联动等场景。\n\n- **版本**: 2.0.0\n- **服务标识**: `weather`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/weather/base>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/weather/v1/`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| district_id | string |  | - | 区县的行政区划编码，与 location、district 三者必选其一。 | 222405 |\n| location | string |  | - | 经纬度，经度在前纬度在后，逗号分隔。支持 bd09mc/bd09ll/wgs84/gcj02。与 district_id、district 三者必选其一。 | 116.405285,39.904989 |\n| province | string |  | - | 省份名称，用于辅助名称查询。 | 山东省 |\n| city | string |  | - | 城市名称，用于辅助名称查询。 | 济南市 |\n| district | string |  | - | 区县名称，用于名称查询，与 district_id、location 三者必填其一。 | 历下区 |\n| ak | string | T | - | 开发者密钥，在API控制台申请获得。 | hhR4GDGHfREwblbolOYhio8HkHyRdDoq |\n| data_type | string (enum: now, fc, index, alert, fc_hour...) | T | - | 请求数据类型，控制返回内容。可选值：now(实时天气)、fc(7天预报)、index(生活指数)、alert(气象预警)、fc_hour(逐小时预报)、all(全部)。 | all |\n| output | string (enum: json, xml) |  | json | 返回格式，支持 json/xml，默认为 json。 | json |\n| coordtype | string (enum: wgs84, bd09ll, bd09mc, gcj02) |  | wgs84 | 坐标类型。支持 wgs84/bd09ll/bd09mc/gcj02，默认为 wgs84。 | wgs84 |\n| callback | string |  | - | JSONP 回调函数名，当 output=json 时有效。 | showWeather |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"result\": {\n    \"now\": {\n      \"rh\": 73,\n      \"aqi\": 140,\n      \"vis\": 3471,\n      \"pm25\": 107,\n      \"temp\": 4,\n      \"text\": \"多云\",\n      \"clouds\": 999999,\n      \"uptime\": \"20200220143500\",\n      \"prec_1h\": 0,\n      \"wind_dir\": \"东风\",\n      \"feels_like\": 1,\n      \"wind_class\": \"2级\"\n    },\n    \"alerts\": [\n      {\n        \"desc\": \"市气象局发布道路冰雪蓝色预警信号...\",\n        \"type\": \"道路冰雪\",\n        \"level\": \"蓝色预警\",\n        \"title\": \"市气象局发布道路冰雪蓝色预警[IV级/一般]\"\n      }\n    ],\n    \"indexes\": [\n      {\n        \"name\": \"晨练指数\",\n        \"brief\": \"较适宜\",\n        \"detail\": \"天气阴沉，请避免在林中晨练。\"\n      }\n    ],\n    \"location\": {\n      \"id\": \"110101\",\n      \"city\": \"北京市\",\n      \"name\": \"东城\",\n      \"country\": \"中国\",\n      \"province\": \"北京市\"\n    },\n    \"forecasts\": [\n      {\n        \"aqi\": 93,\n        \"low\": -2,\n        \"date\": \"2020-02-20\",\n        \"high\": 7,\n        \"week\": \"星期四\",\n        \"wc_day\": \"<3级\",\n        \"wd_day\": \"东南风\",\n        \"text_day\": \"多云\",\n        \"wc_night\": \"<3级\",\n        \"wd_night\": \"北风\",\n        \"text_night\": \"阴\"\n      }\n    ]\n  },\n  \"status\": 0\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态信息描述 | success |\n| `result` | object |  | 天气查询结果 | None |\n| `result.alerts` | array |  | 气象预警数组，data_type=alert/all 时返回 | None |\n| `result.alerts[].desc` | string |  | 预警详细描述 | None |\n| `result.alerts[].level` | string |  | 预警等级 | 蓝色预警 |\n| `result.alerts[].title` | string |  | 预警标题 | None |\n| `result.alerts[].type` | string |  | 预警事件类型 | 道路冰雪 |\n| `result.forecast_hours` | array |  | 未来24小时逐小时预报，data_type=fc_hour/all 时返回 | None |\n| `result.forecast_hours[].clouds` | integer |  | 云量（%） | None |\n| `result.forecast_hours[].data_time` | string |  | 数据时间 | None |\n| `result.forecast_hours[].prec_1h` | number |  | 1小时累计降水量（mm） | None |\n| `result.forecast_hours[].rh` | integer |  | 相对湿度 | None |\n| `result.forecast_hours[].temp_fc` | integer |  | 温度（℃） | None |\n| `result.forecast_hours[].text` | string |  | 天气现象 | None |\n| `result.forecast_hours[].wind_class` | string |  | 风力等级 | None |\n| `result.forecast_hours[].wind_dir` | string |  | 风向描述 | None |\n| `result.forecasts` | array |  | 7天预报数组，data_type=fc/all 时返回 | None |\n| `result.forecasts[].aqi` | integer |  | 空气质量指数 | 93 |\n| `result.forecasts[].date` | string |  | 日期，北京时区 | 2020-02-20 |\n| `result.forecasts[].high` | integer |  | 最高温度（℃） | 7 |\n| `result.forecasts[].low` | integer |  | 最低温度（℃） | -2 |\n| `result.forecasts[].text_day` | string |  | 白天天气现象 | 多云 |\n| `result.forecasts[].text_night` | string |  | 夜间天气现象 | 阴 |\n| `result.forecasts[].wc_day` | string |  | 白天风力 | <3级 |\n| `result.forecasts[].wc_night` | string |  | 夜间风力 | <3级 |\n| `result.forecasts[].wd_day` | string |  | 白天风向 | 东南风 |\n| `result.forecasts[].wd_night` | string |  | 夜间风向 | 北风 |\n| `result.forecasts[].week` | string |  | 星期 | 星期四 |\n| `result.indexes` | array |  | 生活指数数组，data_type=index/all 时返回 | None |\n| `result.indexes[].brief` | string |  | 概要说明 | 较适宜 |\n| `result.indexes[].detail` | string |  | 详细说明 | 天气阴沉，请避免在林中晨练。 |\n| `result.indexes[].name` | string |  | 指数名称 | 晨练指数 |\n| `result.location` | object |  | 查询位置信息。行政区划查询时含 country/province/city/name/id；经纬度查询时含 lng/lat | None |\n| `result.location.city` | string |  | 城市名称 | 北京市 |\n| `result.location.country` | string |  | 国家名称 | 中国 |\n| `result.location.id` | string |  | 区县行政区划编码 | 110101 |\n| `result.location.lat` | number |  | 纬度（经纬度查询时返回） | 39.904989 |\n| `result.location.lng` | number |  | 经度（经纬度查询时返回） | 116.405285 |\n| `result.location.name` | string |  | 区县名称 | 东城 |\n| `result.location.province` | string |  | 省份名称 | 北京市 |\n| `result.now` | object |  | 实时天气数据，data_type=now/all 时返回 | None |\n| `result.now.aqi` | integer |  | 空气质量指数 | 140 |\n| `result.now.clouds` | integer |  | 云量（%） | 999999 |\n| `result.now.co` | number |  | 一氧化碳浓度（mg/m³） | None |\n| `result.now.feels_like` | integer |  | 体感温度（℃） | 1 |\n| `result.now.no2` | integer |  | 二氧化氮浓度（μg/m³） | None |\n| `result.now.o3` | integer |  | 臭氧浓度（μg/m³） | None |\n| `result.now.pm10` | integer |  | PM10浓度（μg/m³） | None |\n| `result.now.pm25` | integer |  | PM2.5浓度（μg/m³） | 107 |\n| `result.now.prec_1h` | number |  | 1小时累计降水量（mm） | 0 |\n| `result.now.rh` | integer |  | 相对湿度（%） | 73 |\n| `result.now.so2` | integer |  | 二氧化硫浓度（μg/m³） | None |\n| `result.now.temp` | integer |  | 温度（℃） | 4 |\n| `result.now.text` | string |  | 天气现象 | 多云 |\n| `result.now.uptime` | string |  | 数据更新时间，北京时间 | 20200220143500 |\n| `result.now.vis` | integer |  | 能见度（m） | 3471 |\n| `result.now.wind_class` | string |  | 风力等级 | 2级 |\n| `result.now.wind_dir` | string |  | 风向描述 | 东风 |\n| `status` | integer |  | 请求状态码，0表示成功<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: AK参数错误：AK不存在或非法<br/>`2`: 服务内部错误：服务器内部错误，请稍后重试<br/>`3`: 位置参数错误：location/district_id/district 参数格式错误或无效<br/>`4`: 坐标类型错误：coordtype 参数值不在允许范围内<br/>`5`: 无权限：该AK没有权限调用此服务<br/>`101`: 服务禁用：服务已被禁用<br/>`102`: 请求超限：访问频次超限 | 0 |\n\n### 常见问题\n\n**Q: district_id、location、district 三个参数如何选择？**\n\nA: 三者必填其一。district_id 用于行政区划编码查询；location 用于经纬度查询；district 用于区县名称查询，可配合 province、city 辅助定位。\n\n**Q: location 参数的格式是什么？**\n\nA: 经纬度，经度在前纬度在后，逗号分隔，例如 \"116.405285,39.904989\"。坐标类型由 coordtype 指定。\n\n**Q: data_type 各取值分别返回什么数据？**\n\nA: now: 实时天气；fc: 7天预报；index: 生活指数；alert: 气象预警；fc_hour: 24小时逐小时预报；all: 全部数据。\n\n**Q: 如果 district_id 和 location 同时传会怎样？**\n\nA: 默认以 district_id 为准。\n\n**Q: 生活指数包含哪些字段？**\n\nA: 每项包含 name(名称)、brief(概要)、detail(详细说明)。\n\nArchive v1.0.5: 32 files, 87420 bytes\n\nFiles: recipes/address_to_full_location.md (2798b), recipes/address_to_poi.md (3253b), recipes/coordinate_to_structured_address.md (2660b), recipes/nearby_poi_search.md (3249b), recipes/poi_search_to_detail.md (2898b), recipes/route_to_named_place.md (3428b), recipes/smart_departure_time.md (3109b), recipes/traffic_aware_route.md (2905b), recipes/weather_query.md (8504b), references/admin_division_query.md (5257b), references/administrative_region_search.md (11699b), references/capabilities/driving_route_duration.md (2169b), references/capabilities/future_driving_route.md (2040b), references/capabilities/suggested_departure_time.md (1875b), references/capabilities/waypoint_route_planning.md (1870b), references/circular_region_search.md (11139b), references/constants.md (2745b), references/cycling_route_planning.md (8538b), references/domestic_weather_query.md (9230b), references/driving_route_planning.md (15150b), references/geocoding.md (7917b), references/global_reverse_geocoding.md (12529b), references/motorcycle_route_planning.md (11016b), references/multi_dimensional_search.md (11468b), references/overseas_weather_query.md (6416b), references/place_detail_search.md (10185b), references/place_input_suggestion.md (7801b), references/reverse_geocoding_agent.md (11084b), references/transit_route_planning.md (6249b), references/walking_route_planning.md (7277b), SKILL.md (8596b), _meta.json (135b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: baidu-map-webapi\ndescription: 百度地图 webapi 开发指南。在编写、审查或调试使用百度地图webAPI的代码时应运用此技能，也适用于直接调用百度地图API获取结果的场景。涵盖：地图位置搜索、POI检索、路线规划、建议出发时间、路线耗时预测、实时路况、行政区划查询、地址坐标转换、沿途交通事件、天气查询、智能推荐上车点等。当用户提及出发时间、导航路线、地点查询、坐标转换、地图相关开发需求时自动触发。\nlicense: MIT\nversion: 1.0.5\nhomepage: https://lbs.baidu.com\nrepository: https://github.com/baidu-maps/webapi-skills\nmetadata:\n  openclaw:\n    requires:\n      bins: [\"curl\"]\n      env: BMAP_WEBAPI_AK\n    primaryEnv: BMAP_WEBAPI_AK\n---\n\n# webapi 开发指南\n\n百度地图 webapi 版本开发指南。包含地图位置搜索、路线导航、行政区划等核心模块的 API 说明和代码示例，既可直接调用 API 获取结果，也可帮助开发者快速集成百度地图服务。\n\n## 何时适用\n\n遇到以下任意场景时，均应读取本指南并调用对应 API：\n\n### 路线规划与出行决策\n- 规划驾车、步行、骑行、摩托车、公共交通路线\n- **查询从 A 到 B 的建议出发时间**（如\"想晚上8点到达，几点出发合适\"）\n- **预测未来某时刻出发的路线耗时**（如\"下午3点出发要多久\"）\n- 查询历史路况下的路线耗时\n- 规划含多个途经点的最优路线\n\n### 实时动态信息\n- 查询路线沿途的动态交通事件（事故、拥堵、施工等）\n- 查询海外城市天气信息\n\n### 地点与POI搜索\n- 查找城市中的餐厅、酒店、景点等 POI 信息\n- 在指定圆形区域内检索地点\n- 按行政区划检索地点\n- 多条件组合检索 POI\n- 获取 POI 详细信息\n- 输入联想/地点补全提示\n- 智能推荐安全上车点\n\n### 地址与坐标转换\n- 地址文本解析为经纬度坐标（地理编码）\n- 经纬度坐标解析为地址信息（逆地理编码）\n\n### 行政区划与区域查询\n- 查询行政区划地点\n- 获取行政区划边界坐标\n\n## 开发准则\n\n在使用本技能的任何场景中，请遵守以下通用准则：\n\n### 准则 1：API 端点选择\n\n百度地图提供两个服务端点，必须根据使用场景选择正确的端点：\n\n| 端点类型 | Base URL | 适用场景 |\n|---|---|---|\n| **标准端点** | `https://api.map.baidu.com/` | 正式开发、生产环境、为用户生成的代码 |\n| **高级功能体验端点** | `https://api.map.baidu.com/map_service/` | 百度地图官方提供，仅供大模型直接调用时快速体验高级权限功能 |\n\n**使用规则：**\n- 为用户生成的开发代码，**必须使用标准端点** `https://api.map.baidu.com/`\n- 大模型直接调用高级权限功能（如建议出发时间、未来路线规划）进行演示/体验时，使用体验端点\n- **体验端点仅供功能体验和演示，不可用于开发或生产环境**\n- **均需要AK凭证**\n\n### 准则 2：AK 凭证安全处理\n\nAK（Access Key）是使用技能之前的必须参数:\n\n1. 优先读取环境变量 `BMAP_WEBAPI_AK` 中的 AK\n2. `BMAP_WEBAPI_AK`为空时, 提示用户:**请先前往[百度地图开放平台](https://lbs.baidu.com/apiconsole/key)申请`服务端`的AK**\n3. 然后设置为环境变量\n```\nexport BMAP_WEBAPI_AK=\"百度地图AK\"\n```\n4. 使用 references/ 所有能力时的ak参数请使用 `$BMAP_WEBAPI_AK`, 示例如下:\n```\ncurl \"https://api.map.baidu.com/place/v3/region?query=美食&region=北京&ak=$BMAP_WEBAPI_AK\"\n```\n\n### 准则 3：地址/地名统一通过 `address_to_poi` 转换\n\n任何需要将**用户输入的地名或地址文本**转换为坐标/UID 的场景，**优先参考**：\n\n> `recipes/address_to_poi.md` — 地址/地名转坐标与 POI UID\n\n该文件描述了两种输入类型的判断方法和对应调用方式：\n- **结构化地址**（含门牌号/楼栋）→ `references/geocoding` API\n- **POI 名称/地标/商家名** → `references/administrative_region_search` API\n\n### 准则 4：算路时 UID 优先于纯坐标\n\n向算路接口（驾车/步行/骑行/公交）传参时：\n\n```\n推荐：同时传坐标 + uid（绑路更精准，尤其对大型 POI） origin_uid / destination_uid 有值时必传\n```\n\nUID 通过 `references/address_to_poi.md` 描述的方法获取。\n\n---\n\n## 场景示例（推荐优先阅读）\n\n遇到以下场景时，**优先使用对应 recipe**，内含完整调用链、参数说明和可运行代码示例。\n单个 API 用法请查阅下方「快速参考」。\n\n### 地址/地名预处理（算路前必读）\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/address_to_poi.md` | 地址文本或地名 → 坐标 + POI UID（算路前置步骤） | 标准 AK |\n\n### 路线规划\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/route_to_named_place.md` | 用户说出地名 → 规划驾车路线 | 标准 AK |\n| `recipes/smart_departure_time.md` | \"几点出发才能准时到\" | ⚠️ 高级权限 |\n| `recipes/traffic_aware_route.md` | 预测未来某时刻出发的路况耗时 | ⚠️ 高级权限 |\n\n### POI 搜索\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/nearby_poi_search.md` | 搜索用户附近的某类地点 | 标准 AK |\n| `recipes/poi_search_to_detail.md` | 关键词搜索 → 获取 POI 完整详情 | 标准 AK |\n\n### 地址与坐标\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/address_to_full_location.md` | 地址文本 → 坐标 + 行政区划 | 标准 AK |\n| `recipes/coordinate_to_structured_address.md` | 坐标 → 结构化地址 + 行政区划 | 标准 AK |\n\n### 天气查询\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/weather_query.md` | 通过城市名称/行政区划编码/坐标, 获取当地详细的天气信息 | 标准 AK |\n\n---\n\n## 快速参考\n\n### 基础概念\n\n- `references/constants.md` - 通用常量：状态码\n\n### 位置搜索\n\n- `references/global_reverse_geocoding.md` - 全球逆地理编码: 坐标转位置信息\n- `references/reverse_geocoding_agent.md` - 逆地理编码智能体: 智能逆地理编码地址解析\n- `references/administrative_region_search.md` - 行政区划区域检索: 行政区划地点检索\n- `references/circular_region_search.md` - 圆形区域检索: 圆形区域地点检索\n- `references/multi_dimensional_search.md` - 多维检索: 多条件智能检索POI\n- `references/place_detail_search.md` - 地点详情检索: 获取指定地点详细信息\n- `references/place_input_suggestion.md` - 地点输入提示: 地点输入提示匹配\n- `references/geocoding.md` - 地理编码: 地址解析为坐标\n\n### AOI区域\n\n- `references/admin_division_query.md` - 行政区划查询: 查询中国行政区划信息\n\n### 动态数据\n\n- `references/domestic_weather_query.md` - 国内天气查询: 国内天气查询多功能接口\n- `references/overseas_weather_query.md` - 海外天气查询: 查询海外城市天气\n\n### 路线导航\n\n- `references/cycling_route_planning.md` - 骑行路线规划: 骑行路线规划方案检索\n- `references/driving_route_planning.md` - 驾车路线规划: 驾车路线规划与路况预测\n    - `references/capabilities/driving_route_duration.md` - 驾车路线历史耗时: 设置驾车路线历史耗时\n    - `references/capabilities/future_driving_route.md` - 未来驾车路线规划: 预测未来驾车路线耗时\n    - `references/capabilities/suggested_departure_time.md` - 建议出发时间: 高级权限出行时间建议\n    - `references/capabilities/waypoint_route_planning.md` - 途经点智能路线规划: 智能优化途经点顺序\n- `references/motorcycle_route_planning.md` - 摩托车路线规划: 摩托车路线规划服务\n- `references/transit_route_planning.md` - 公交路线规划: 多交通方式路线规划\n- `references/walking_route_planning.md` - 步行路线规划: 步行路线规划\n\n## 如何使用\n\n**推荐决策路径**：\n1. 用户需求是**多步串联场景**（如\"输入地名规划路线\"、\"获取附近 POI\"）→ 直接找 `recipes/` 目录下对应 recipe\n2. 用户需求是**单个 API 的参数细节**（如\"这个接口的 tactics 参数有哪些值\"）→ 查阅 `references/` 目录\n\n每个 **references** 参考文件包含：\n- 功能简要说明\n- API 参数说明和注意事项\n\n每个 **recipes** 场景包含：\n- 触发意图（什么场景适用）\n- 完整调用链与分步说明\n- 常见错误和变体\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn778b6bf766ym71fdvrc5yvg98319rv\",\n  \"slug\": \"baidu-map-webapi\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1773981809103\n}\n\nFile v1.0.5:references/admin_division_query.md\n\n# 百度地图行政区划查询 API\n\n## 服务概述\n\n行政区划查询接口用于获取中国行政区划的详细信息。支持通过行政区划名称或adcode进行查询，返回结果包括行政区划的边界坐标、中心点、父级行政区划、行政区划级别等详细信息。该接口适用于需要行政区划数据的各类应用场景，如地图应用、数据分析、地址解析等。\n\n- **版本**: 2.0.0\n- **服务标识**: `region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/district-search/base>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/api_region_search/v1/`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| ak | string | T | - | 开发者密钥，即API Key，用于身份验证和配额管理。 | E4805d16520de693a3fe707cdc962045 |\n| keyword | string | T | - | 检索行政区划关键字。仅支持单关键字检索，可填写行政区名称（如“中国”“全国”、省/市/区/镇名称）或 adcode。 | 河北 |\n| sub_admin | string |  | 0 | 行政区划显示子级级数。可填 0、1、2、3 等：0 不返回下级；1 返回下一级；2 返回下两级；3 返回下三级，以此类推。 | 2 |\n| extensions_code | string (enum: 0, 1) |  | 0 | 是否召回国标行政区划编码，1 为召回，0 为不召回。 | 1 |\n| boundary | string (enum: 0, 1) |  | 0 | 是否返回区划边界数据：0 不返回，1 返回。仅返回查询行政区划的边界，不返回子级边界；仅支持省/市/区边界，暂不支持乡镇/街道。 | 1 |\n| boundarycode | string |  | - | 需要返回边界数据的行政区划编码。若输入 adcode 则返回该 adcode 边界；若未输入或输入错误，则返回 keyword 匹配到的第一个行政区划边界。 | 110112 |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"result\": {\n    \"name\": \"北京市\",\n    \"level\": \"province\",\n    \"adcode\": \"110000\",\n    \"parent\": {\n      \"name\": \"中国\",\n      \"adcode\": \"100000\"\n    },\n    \"boundary\": \"116.123,39.123;116.456,39.456\",\n    \"children\": [\n      {\n        \"name\": \"东城区\",\n        \"level\": \"district\",\n        \"adcode\": \"110101\"\n      }\n    ],\n    \"location\": {\n      \"lat\": 39.929986,\n      \"lng\": 116.395645\n    }\n  },\n  \"status\": 0,\n  \"message\": \"ok\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的描述信息。 | ok |\n| `result` | object |  | 查询结果对象。 | None |\n| `result.adcode` | string |  | 行政区划代码。 | 110000 |\n| `result.boundary` | string |  | 行政区划边界坐标，格式为经纬度坐标串，需设置 boundary=1 时返回。 | 116.123,39.123;116.456,39.456 |\n| `result.children` | array |  | 子级行政区划列表，当 sub_admin 大于 0 时返回。 | None |\n| `result.children[].adcode` | string |  | 子级行政区划代码。 | 110101 |\n| `result.children[].level` | string |  | 子级行政区划级别。 | district |\n| `result.children[].name` | string |  | 子级行政区划名称。 | 东城区 |\n| `result.level` | string (enum: country, province, city... (共5个值)) |  | 行政区划级别，如 country、province、city、district、town 等。 | province |\n| `result.location` | object |  | 行政区划的中心点坐标。 | None |\n| `result.location.lat` | number |  | 中心点纬度。 | 39.929986 |\n| `result.location.lng` | number |  | 中心点经度。 | 116.395645 |\n| `result.name` | string |  | 行政区划名称。 | 北京市 |\n| `result.parent` | object |  | 父级行政区划信息。 | None |\n| `result.parent.adcode` | string |  | 父级行政区划代码。 | 100000 |\n| `result.parent.name` | string |  | 父级行政区划名称。 | 中国 |\n| `status` | integer |  | 返回结果状态码，0表示成功，其他值为错误码。<br/><br/>**枚举值说明：**<br/>`0`: ok：正常<br/>`1`: 服务器内部错误：服务器端出现未知错误，请稍后重试<br/>`2`: 请求参数非法：请求参数缺失或格式错误<br/>`3`: 权限校验失败：ak无效或没有权限<br/>`4`: 配额校验失败：访问超出配额限制<br/>`5`: ak不存在或被封禁：ak不存在或已被封禁，请检查ak状态<br/>`101`: 服务禁用：该服务已被禁用<br/>`102`: 不通过白名单或安全码不对：服务器没有开启白名单，或安全码不对 | 0 |\n\n### 常见问题\n\n**Q: 支持查询哪些级别的行政区划？**\n\nA: 支持国家(country)、省(province)、市(city)、区/县(district)级别的行政区划查询\n\n**Q: 如何获取行政区划的边界坐标？**\n\nA: 设置 boundary=1 可返回边界坐标串（boundary 字段），格式为'经度,纬度;经度,纬度;...'\n\n**Q: 如何获取下一级行政区划？**\n\nA: 设置 sub_admin 大于 0 可返回子级行政区划；如 sub_admin=1 返回下一级，sub_admin=2 返回下两级\n\n**Q: 边界坐标使用什么坐标系？**\n\nA: 返回的边界坐标使用百度BD-09坐标系\n\n**Q: 如何获取ak？**\n\nA: 需要在百度地图开放平台控制台（https://lbsyun.baidu.com/）注册并创建应用获取API Key\n\nFile v1.0.5:references/administrative_region_search.md\n\n# 百度地图地点检索及联想 API\n\n## 服务概述\n\n开发者可通过该功能，检索某一行政区划内（目前最细到区县级别）的地点信息。支持通过关键字、POI类型、区域限制、排序、分页等多种参数进行精细化检索。\n\n- **版本**: 2.0.0\n- **服务标识**: `administrative_region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/guide/webservice-placeapiV3/interfaceDocumentV3>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/place/v3/region`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| query | string | T | - | 检索关键字。 | ATM机、美食 |\n| region | string | T | - | 检索行政区划区域（支持到区县级）。增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用region_limit参数。可输入行政区划名或对应citycode。 | 北京市海淀区 |\n| ak | string | T | - | 开发者的访问密钥，必填项。v2之前该属性为key。 | 您的AK |\n| region_limit | boolean |  | - | 区域数据召回限制，为true时，仅召回region对应区域内数据。 | False |\n| is_light_version | boolean |  | False | true：轻量化检索，检索速度大幅提升，排序更简单直接；false（默认）：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验。 | False |\n| type | string |  | - | 对query召回结果进行二次筛选，type内容建议参考POI分类，建议query同属于一个大类；如query=美食 type=火锅（用于泛搜索场景）。query和type支持只填一项。 | 火锅 |\n| center | string |  | - | 传入poi坐标，辅助检索结果按距离排序与返回。需要搭配排序字段一起使用并结合coord_type字段说明该字段的坐标类型。 | 38.76623,116.43213 |\n| scope | integer (enum: 1, 2) |  | - | 检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细\n\nArchive v1.0.4: 32 files, 88140 bytes\n\nFiles: recipes/address_to_full_location.md (2798b), recipes/address_to_poi.md (3253b), recipes/coordinate_to_structured_address.md (2660b), recipes/nearby_poi_search.md (3249b), recipes/poi_search_to_detail.md (2898b), recipes/route_to_named_place.md (3428b), recipes/smart_departure_time.md (3109b), recipes/traffic_aware_route.md (2905b), recipes/weather_query.md (8504b), references/admin_division_query.md (5257b), references/administrative_region_search.md (11699b), references/capabilities/driving_route_duration.md (2169b), references/capabilities/future_driving_route.md (2040b), references/capabilities/suggested_departure_time.md (1875b), references/capabilities/waypoint_route_planning.md (1870b), references/circular_region_search.md (11139b), references/constants.md (2745b), references/cycling_route_planning.md (8538b), references/domestic_weather_query.md (9230b), references/driving_route_planning.md (15150b), references/geocoding.md (7917b), references/global_reverse_geocoding.md (12529b), references/motorcycle_route_planning.md (11016b), references/multi_dimensional_search.md (11468b), references/overseas_weather_query.md (6416b), references/place_detail_search.md (10185b), references/place_input_suggestion.md (7801b), references/reverse_geocoding_agent.md (11084b), references/transit_route_planning.md (6249b), references/walking_route_planning.md (7277b), SKILL.md (10318b), _meta.json (135b)\n\nArchive v1.0.3: 32 files, 88075 bytes\n\nFiles: recipes/address_to_full_location.md (2798b), recipes/address_to_poi.md (3253b), recipes/coordinate_to_structured_address.md (2660b), recipes/nearby_poi_search.md (3249b), recipes/poi_search_to_detail.md (2898b), recipes/route_to_named_place.md (3428b), recipes/smart_departure_time.md (3109b), recipes/traffic_aware_route.md (2905b), recipes/weather_query.md (8504b), references/admin_division_query.md (5257b), references/administrative_region_search.md (11699b), references/capabilities/driving_route_duration.md (2169b), references/capabilities/future_driving_route.md (2040b), references/capabilities/suggested_departure_time.md (1875b), references/capabilities/waypoint_route_planning.md (1870b), references/circular_region_search.md (11139b), references/constants.md (2745b), references/cycling_route_planning.md (8538b), references/domestic_weather_query.md (9230b), references/driving_route_planning.md (15150b), references/geocoding.md (7917b), references/global_reverse_geocoding.md (12529b), references/motorcycle_route_planning.md (11016b), references/multi_dimensional_search.md (11468b), references/overseas_weather_query.md (6416b), references/place_detail_search.md (10185b), references/place_input_suggestion.md (7801b), references/reverse_geocoding_agent.md (11084b), references/transit_route_planning.md (6249b), references/walking_route_planning.md (7277b), SKILL.md (10302b), _meta.json (135b)\n\nArchive v1.0.1: 32 files, 87400 bytes\n\nFiles: recipes/address_to_full_location.md (2798b), recipes/address_to_poi.md (3253b), recipes/coordinate_to_structured_address.md (2660b), recipes/nearby_poi_search.md (3249b), recipes/poi_search_to_detail.md (2898b), recipes/route_to_named_place.md (3428b), recipes/smart_departure_time.md (3109b), recipes/traffic_aware_route.md (2905b), recipes/weather_query.md (8165b), references/admin_division_query.md (5257b), references/administrative_region_search.md (11699b), references/capabilities/driving_route_duration.md (2169b), references/capabilities/future_driving_route.md (2040b), references/capabilities/suggested_departure_time.md (1875b), references/capabilities/waypoint_route_planning.md (1870b), references/circular_region_search.md (11139b), references/constants.md (2745b), references/cycling_route_planning.md (8538b), references/domestic_weather_query.md (9230b), references/driving_route_planning.md (15150b), references/geocoding.md (7917b), references/global_reverse_geocoding.md (12529b), references/motorcycle_route_planning.md (11016b), references/multi_dimensional_search.md (11468b), references/overseas_weather_query.md (6416b), references/place_detail_search.md (10185b), references/place_input_suggestion.md (7801b), references/reverse_geocoding_agent.md (11084b), references/transit_route_planning.md (6249b), references/walking_route_planning.md (7277b), SKILL.md (8806b), _meta.json (135b)\n\nArchive v1.0.0: 33 files, 88436 bytes\n\nFiles: recipes/address_to_full_location.md (2798b), recipes/address_to_poi.md (3253b), recipes/advanced_permissions.md (2642b), recipes/coordinate_to_structured_address.md (2660b), recipes/nearby_poi_search.md (3249b), recipes/poi_search_to_detail.md (2898b), recipes/route_to_named_place.md (3428b), recipes/smart_departure_time.md (3109b), recipes/traffic_aware_route.md (2905b), recipes/weather_query.md (8165b), references/admin_division_query.md (5257b), references/administrative_region_search.md (11699b), references/capabilities/driving_route_duration.md (2169b), references/capabilities/future_driving_route.md (2040b), references/capabilities/suggested_departure_time.md (1875b), references/capabilities/waypoint_route_planning.md (1870b), references/circular_region_search.md (11139b), references/constants.md (2745b), references/cycling_route_planning.md (8538b), references/domestic_weather_query.md (9230b), references/driving_route_planning.md (15150b), references/geocoding.md (7917b), references/global_reverse_geocoding.md (12529b), references/motorcycle_route_planning.md (11016b), references/multi_dimensional_search.md (11468b), references/overseas_weather_query.md (6416b), references/place_detail_search.md (10185b), references/place_input_suggestion.md (7801b), references/reverse_geocoding_agent.md (11084b), references/transit_route_planning.md (6249b), references/walking_route_planning.md (7277b), SKILL.md (7702b), _meta.json (135b)","readmeExcerpt":"Skill: Baidu Map WebAPI（百度地图官方Web服务 SKills） Owner: baidu-maps Summary: 百度地图 webapi 开发指南。在编写、审查或调试使用百度地图webAPI的代码时应运用此技能，也适用于直接调用百度地图API获取结果的场景。涵盖：地图位置搜索、POI检索、路线规划、建议出发时间、路线耗时预测、实时路况、行政区划查询、地址坐标转换、沿途交通事件、天气查询、智能推荐上车点等。当用户提及出发时间、... Tags: latest:1.0.8 Version history: v1.0.8 | 2026-06-01T03:39:22.438Z | user - Removed two documentation files: _meta.json and skill-card.md. - No changes to functionality or APIs. - No up","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"export BMAP_WEBAPI_AK=\"百度地图AK\""},{"language":"text","snippet":"curl \"https://api.map.baidu.com/place/v3/region?query=美食&region=北京&ak=$BMAP_WEBAPI_AK\""},{"language":"text","snippet":"推荐：同时传坐标 + uid（绑路更精准，尤其对大型 POI） origin_uid / destination_uid 有值时必传"},{"language":"json","snippet":"{\n  \"result\": {\n    \"name\": \"北京市\",\n    \"level\": \"province\",\n    \"adcode\": \"110000\",\n    \"parent\": {\n      \"name\": \"中国\",\n      \"adcode\": \"100000\"\n    },\n    \"boundary\": \"116.123,39.123;116.456,39.456\",\n    \"children\": [\n      {\n        \"name\": \"东城区\",\n        \"level\": \"district\",\n        \"adcode\": \"110101\"\n      }\n    ],\n    \"location\": {\n      \"lat\": 39.929986,\n      \"lng\": 116.395645\n    }\n  },\n  \"status\": 0,\n  \"message\": \"ok\"\n}"},{"language":"json","snippet":"{\n  \"status\": 0,\n  \"message\": \"ok\",\n  \"results\": [\n    {\n      \"uid\": \"05478f385d3729eef4eafc16\",\n      \"area\": \"海淀区\",\n      \"city\": \"北京市\",\n      \"name\": \"中国银行ATM(北京上地信息路支行)\",\n      \"town\": \"上地街道\",\n      \"detail\": 1,\n      \"address\": \"上地信息路15号1层104室\",\n      \"location\": {\n        \"lat\": 40.04383967179688,\n        \"lng\": 116.31584460688308\n      },\n      \"province\": \"北京市\",\n      \"town_code\": 110108022\n    }\n  ],\n  \"query_type\": \"general\",\n  \"result_type\": \"poi_type\"\n}"},{"language":"json","snippet":"{\n  \"status\": 0,\n  \"message\": \"ok\",\n  \"results\": [\n    {\n      \"uid\": \"14cf81e3aae18d1914948ebb\",\n      \"area\": \"东城区\",\n      \"city\": \"北京市\",\n      \"name\": \"中国民生银行(北京正义路支行)\",\n      \"town\": \"东华门街道\",\n      \"detail\": 1,\n      \"address\": \"北京市东城区东长安街35号首层西侧\",\n      \"location\": {\n        \"lat\": 39.91518549590169,\n        \"lng\": 116.41350155480602\n      },\n      \"province\": \"北京市\",\n      \"street_id\": \"14cf81e3aae18d1914948ebb\",\n      \"telephone\": \"(010)65284468\",\n      \"town_code\": 110101001\n    }\n  ],\n  \"query_type\": \"general\",\n  \"result_type\": \"poi_type\"\n}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: baidu-map-webapi\ndescription: 百度地图 webapi 开发指南。在编写、审查或调试使用百度地图webAPI的代码时应运用此技能，也适用于直接调用百度地图API获取结果的场景。涵盖：地图位置搜索、POI检索、路线规划、建议出发时间、路线耗时预测、实时路况、行政区划查询、地址坐标转换、沿途交通事件、天气查询、智能推荐上车点等。当用户提及出发时间、导航路线、地点查询、坐标转换、地图相关开发需求时自动触发。\nlicense: MIT\nversion: 1.0.5\nhomepage: https://lbs.baidu.com\nrepository: https://github.com/baidu-maps/webapi-skills\nmetadata:\n  openclaw:\n    requires:\n      bins: [\"curl\"]\n      env: BMAP_WEBAPI_AK\n    primaryEnv: BMAP_WEBAPI_AK\n---\n\n# webapi 开发指南\n\n百度地图 webapi 版本开发指南。包含地图位置搜索、路线导航、行政区划等核心模块的 API 说明和代码示例，既可直接调用 API 获取结果，也可帮助开发者快速集成百度地图服务。\n\n## 何时适用\n\n遇到以下任意场景时，均应读取本指南并调用对应 API：\n\n### 路线规划与出行决策\n- 规划驾车、步行、骑行、摩托车、公共交通路线\n- **查询从 A 到 B 的建议出发时间**（如\"想晚上8点到达，几点出发合适\"）\n- **预测未来某时刻出发的路线耗时**（如\"下午3点出发要多久\"）\n- 查询历史路况下的路线耗时\n- 规划含多个途经点的最优路线\n\n### 实时动态信息\n- 查询路线沿途的动态交通事件（事故、拥堵、施工等）\n- 查询海外城市天气信息\n\n### 地点与POI搜索\n- 查找城市中的餐厅、酒店、景点等 POI 信息\n- 在指定圆形区域内检索地点\n- 按行政区划检索地点\n- 多条件组合检索 POI\n- 获取 POI 详细信息\n- 输入联想/地点补全提示\n- 智能推荐安全上车点\n\n### 地址与坐标转换\n- 地址文本解析为经纬度坐标（地理编码）\n- 经纬度坐标解析为地址信息（逆地理编码）\n\n### 行政区划与区域查询\n- 查询行政区划地点\n- 获取行政区划边界坐标\n\n## 开发准则\n\n在使用本技能的任何场景中，请遵守以下通用准则：\n\n### 准则 1：API 端点选择\n\n百度地图提供两个服务端点，必须根据使用场景选择正确的端点：\n\n| 端点类型 | Base URL | 适用场景 |\n|---|---|---|\n| **标准端点** | `https://api.map.baidu.com/` | 正式开发、生产环境、为用户生成的代码 |\n| **高级功能体验端点** | `https://api.map.baidu.com/map_service/` | 百度地图官方提供，仅供大模型直接调用时快速体验高级权限功能 |\n\n**使用规则：**\n- 为用户生成的开发代码，**必须使用标准端点** `https://api.map.baidu.com/`\n- **大模型直接调用高级权限功能（如建议出发时间、未来路线规划）进行演示/体验时，使用体验端点**\n- **体验端点仅供功能体验和演示，不可用于开发或生产环境**\n- **均需要AK凭证**\n- **调用体验端点前，必须向用户说明：① 将使用体验端点发起外部 API 调用；② 该调用会消耗用户 AK 的配额；并获得用户明确确认后方可执行**\n\n\n### 准则 2：AK 凭证安全处理\n\nAK（Access Key）是使用技能之前的必须参数:\n\n1. 优先读取环境变量 `BMAP_WEBAPI_AK` 中的 AK\n2. `BMAP_WEBAPI_AK`为空时, 提示用户:**请先前往[百度地图开放平台](https://lbs.baidu.com/apiconsole/key)申请`服务端`的AK**\n3. 然后设置为环境变量\n```\nexport BMAP_WEBAPI_AK=\"百度地图AK\"\n```\n4. 使用 references/ 所有能力时的ak参数请使用 `$BMAP_WEBAPI_AK`, 示例如下:\n```\ncurl \"https://api.map.baidu.com/place/v3/region?query=美食&region=北京&ak=$BMAP_WEBAPI_AK\"\n```\n\n### 准则 3：地址/地名统一通过 `address_to_poi` 转换\n\n任何需要将**用户输入的地名或地址文本**转换为坐标/UID 的场景，**优先参考**：\n\n> `recipes/address_to_poi.md` — 地址/地名转坐标与 POI UID\n\n该文件描述了两种输入类型的判断方法和对应调用方式：\n- **结构化地址**（含门牌号/楼栋）→ `references/geocoding` API\n- **POI 名称/地标/商家名** → `references/administrative_region_search` API\n\n### 准则 4：算路时 UID 优先于纯坐标\n\n向算路接口（驾车/步行/骑行/公交）传参时：\n\n```\n推荐：同时传坐标 + uid（绑路更精准，尤其对大型 POI） origin_uid / destination_uid 有值时必传\n```\n\nUID 通过 `references/address_to_poi.md` 描述的方法获取。\n\n---\n\n## 场景示例（推荐优先阅读）\n\n遇到以下场景时，**优先使用对应 recipe**，内含完整调用链、参数说明和可运行代码示例。\n单个 API 用法请查阅下方「快速参考」。\n\n### 地址/地名预处理（算路前必读）\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/address_to_poi.md` | 地址文本或地名 → 坐标 + POI UID（算路前置步骤） | 标准 AK |\n\n### 路线规划\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/route_to_named_place.md` | 用户说出地名 → 规划驾车路线 | 标准 AK |\n| `recipes/smart_departure_time.md` | \"几点出发才能准时到\" | ⚠️ 高级权限 |\n| `recipes/traffic_aware_route.md` | 预测未来某时刻出发的路况耗时 | ⚠️ 高级权限 |\n\n### POI 搜索\n\n| recipe 文件 | 适用场景 | 权限要求 |\n|---|---|---|\n| `recipes/nearby_poi_search.md` | 搜索用户附近的某类地点 | 标准 AK |\n| `recipes/poi_search_to_detail."},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn778b6bf766ym71fdvrc5yvg98319rv\",\n  \"slug\": \"baidu-map-webapi\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1780285162438\n}"},{"path":"references/admin_division_query.md","content":"# 百度地图行政区划查询 API\n\n## 服务概述\n\n行政区划查询接口用于获取中国行政区划的详细信息。支持通过行政区划名称或adcode进行查询，返回结果包括行政区划的边界坐标、中心点、父级行政区划、行政区划级别等详细信息。该接口适用于需要行政区划数据的各类应用场景，如地图应用、数据分析、地址解析等。\n\n- **版本**: 2.0.0\n- **服务标识**: `region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/district-search/base>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/api_region_search/v1/`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| ak | string | T | - | 开发者密钥，即API Key，用于身份验证和配额管理。 | E4805d16520de693a3fe707cdc962045 |\n| keyword | string | T | - | 检索行政区划关键字。仅支持单关键字检索，可填写行政区名称（如“中国”“全国”、省/市/区/镇名称）或 adcode。 | 河北 |\n| sub_admin | string |  | 0 | 行政区划显示子级级数。可填 0、1、2、3 等：0 不返回下级；1 返回下一级；2 返回下两级；3 返回下三级，以此类推。 | 2 |\n| extensions_code | string (enum: 0, 1) |  | 0 | 是否召回国标行政区划编码，1 为召回，0 为不召回。 | 1 |\n| boundary | string (enum: 0, 1) |  | 0 | 是否返回区划边界数据：0 不返回，1 返回。仅返回查询行政区划的边界，不返回子级边界；仅支持省/市/区边界，暂不支持乡镇/街道。 | 1 |\n| boundarycode | string |  | - | 需要返回边界数据的行政区划编码。若输入 adcode 则返回该 adcode 边界；若未输入或输入错误，则返回 keyword 匹配到的第一个行政区划边界。 | 110112 |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"result\": {\n    \"name\": \"北京市\",\n    \"level\": \"province\",\n    \"adcode\": \"110000\",\n    \"parent\": {\n      \"name\": \"中国\",\n      \"adcode\": \"100000\"\n    },\n    \"boundary\": \"116.123,39.123;116.456,39.456\",\n    \"children\": [\n      {\n        \"name\": \"东城区\",\n        \"level\": \"district\",\n        \"adcode\": \"110101\"\n      }\n    ],\n    \"location\": {\n      \"lat\": 39.929986,\n      \"lng\": 116.395645\n    }\n  },\n  \"status\": 0,\n  \"message\": \"ok\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的描述信息。 | ok |\n| `result` | object |  | 查询结果对象。 | None |\n| `result.adcode` | string |  | 行政区划代码。 | 110000 |\n| `result.boundary` | string |  | 行政区划边界坐标，格式为经纬度坐标串，需设置 boundary=1 时返回。 | 116.123,39.123;116.456,39.456 |\n| `result.children` | array |  | 子级行政区划列表，当 sub_admin 大于 0 时返回。 | None |\n| `result.children[].adcode` | string |  | 子级行政区划代码。 | 110101 |\n| `result.children[].level` | string |  | 子级行政区划级别。 | district |\n| `result.children[].name` | string |  | 子级行政区划名称。 | 东城区 |\n| `result.level` | string (enum: country, province, city... (共5个值)) |  | 行政区划级别，如 country、province、city、district、town 等。 | province |\n| `result.location` | object |  | 行政区划的中心点坐标。 | None |\n| `result.location.lat` | number |  | 中心点纬度。 | 39.929986 |\n| `result.location.lng` | number |  | 中心点经度。 | 116.395645 |\n| `result.name` | string |  | 行政区划名称。 | 北京市 |\n| `result.parent` | object |  | 父级行政区划信息。 | None |\n| `result.parent.adcode` | string |  | 父级行政区划代码。 | 100000 |\n| `result.parent.name` | string |  | 父级行政区划名称。 | 中国 |\n| `status` | integer |  | 返回结果状态码，0表示成功，其他值为错误码。<br/><br/>**枚举值说明：**<br/>`0`: ok：正常<br/>`1`: 服务器内部错误：服务器端出现未知错误，请稍后重试<br/>`2`: 请求参数非法：请求参数缺失或格式错误<br/>`3`: 权限校验失败：ak无效或没有权限<br/>`4`: 配额校验失败：访问超出配额限制<br/>`5`: ak不存在或被封禁：ak不存在或已被封禁，请检查ak状态<br/>`101`: 服务禁用：该服务已被禁用<br/>`102`: 不通过白名单或安全码不对：服务器没有开启白名单，或安全码不对 | 0 |\n\n### 常见问题\n\n**Q: 支持查询哪些级别的行政区划？**\n\nA: 支持国家(country)、省(province"},{"path":"references/administrative_region_search.md","content":"# 百度地图地点检索及联想 API\n\n## 服务概述\n\n开发者可通过该功能，检索某一行政区划内（目前最细到区县级别）的地点信息。支持通过关键字、POI类型、区域限制、排序、分页等多种参数进行精细化检索。\n\n- **版本**: 2.0.0\n- **服务标识**: `administrative_region_search`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/guide/webservice-placeapiV3/interfaceDocumentV3>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/place/v3/region`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| query | string | T | - | 检索关键字。 | ATM机、美食 |\n| region | string | T | - | 检索行政区划区域（支持到区县级）。增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用region_limit参数。可输入行政区划名或对应citycode。 | 北京市海淀区 |\n| ak | string | T | - | 开发者的访问密钥，必填项。v2之前该属性为key。 | 您的AK |\n| region_limit | boolean |  | - | 区域数据召回限制，为true时，仅召回region对应区域内数据。 | False |\n| is_light_version | boolean |  | False | true：轻量化检索，检索速度大幅提升，排序更简单直接；false（默认）：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验。 | False |\n| type | string |  | - | 对query召回结果进行二次筛选，type内容建议参考POI分类，建议query同属于一个大类；如query=美食 type=火锅（用于泛搜索场景）。query和type支持只填一项。 | 火锅 |\n| center | string |  | - | 传入poi坐标，辅助检索结果按距离排序与返回。需要搭配排序字段一起使用并结合coord_type字段说明该字段的坐标类型。 | 38.76623,116.43213 |\n| scope | integer (enum: 1, 2) |  | - | 检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息。 | - |\n| coord_type | integer (enum: 1, 2, 3, 4) |  | 3 | 传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）。 | - |\n| filter | string |  | - | 检索排序条件，包含以下3部分：industry_type（行业类型：hotel/cater/life）；sort_name（排序方式：default/price/overall_rating/distance）；sort_rule（排序规则：0从高到低，1从低到高）。 | industry_type:cater,sort_name:overall_rating,sort_rule:1 |\n| extensions_adcode | boolean |  | - | 是否召回国标行政区划编码。 | False |\n| address_result | boolean (enum: false) |  | - | query传入结构化地址时，控制返回数据的类型。若不传入该字段，可能会召回门址数据，当address_result=false时，召回相应的POI数据避免召回门址数据。 | False |\n| photo_show | boolean |  | False | 是否输出图片信息：true(输出)，false(不输出)。购买商用授权后可申请开通。 | False |\n| from_language | string |  | 中文 | 入参query的语言类型，支持不同语言的检索词作为入参，不填默认为中文，可以设置为auto，大模型会自行判断入参语言。 | auto |\n| language | string |  | 中文 | 召回结果的语言类型，支持多种语言召回结果，默认为中文。该功能为高级权限功能。 | en，fr |\n| page_num | integer |  | 0 | 分页页码，默认为0,0代表第一页，1代表第二页，以此类推。常与page_size搭配使用，仅当返回结果为poi时可以翻页。 | - |\n| page_size | integer |  | 10 | 单次召回POI数量，默认为10条记录，最大返回20条。取值为10-20。 | 10 |\n| ret_coordtype | string |  | - | 返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标。 | gcj02ll |\n| output | string (enum: json) |  | json | 输出数据格式，仅支持json。 | json |\n\n### 响应结果\n\n#### 响应示例 (供参考)\n\n```json\n{\n  \"status\": 0,\n  \"message\": \"ok\",\n  \"results\": [\n    {\n      \"uid\": \"05478f385d3729eef4eafc16\",\n      \"area\": \"海淀区\",\n      \"city\": \"北京市\",\n      \"name\": \"中国银行ATM(北京上地信息路支行)\",\n      \"town\": \"上地街道\",\n      \"detail\": 1,\n      \"address\": \"上地信息路15号1层104室\",\n      \"location\": {\n        \"lat\": 40.04383967179688,\n        \"lng\": 116.31584460688308\n      },\n      \"province\": \"北京市\",\n      \"town_code\": 110108022\n    }\n  ],\n  \"query_type\": \"general\",\n  \"result_type\": \"poi_type\"\n}\n```\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 对API访问状态值的英文说"},{"path":"references/capabilities/driving_route_duration.md","content":"# 驾车路线规划-历史路线耗时\n\n## 服务概述\n\n该功能需要开通高级权限，开发者可设置更多出发时间（用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个）\n\n- **版本**: 2.0.0\n- **服务标识**: `driving_route_duration`\n- **官方文档**: <https://lbs.baidu.com/faq/api?title=webapi/webservice-direction-logotime>\n\n### API调用\n\n**GET** `https://api.map.baidu.com/direction/v2/driving`\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |\n|--------|------|------|--------|------|------|\n| ext_departure_time | string |  | - | 更多出发时间，UNIX时间戳。该字段将影响ext_duration字段的返回，用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个），多个时间戳之间用','英文半角逗号隔开。ext_departure_time=1526527619,1526525384,1526523654 目前出发时间仅影响ext_duration字段，还不会影响路线计算和选择。即仍按照现在的路况计算并推荐路线，但将增加返回该路线在其他时间的耗时。不填则不返回ext_duration字段 | 1609459200 |\n\n### 响应结果\n\n#### 响应字段定义 (基于 Schema)\n\n| 字段路径 | 类型 | 必填 | 说明 | 示例 |\n|----------|------|------|------|------|\n| `message` | string |  | 状态码对应的信息 | 成功 |\n| `result` | object |  | 返回的结果 | None |\n| `result.routes` | array |  | 返回的方案集 | None |\n| `result.routes[].ext_duration` | integer \\| string \\| null |  | 驾车路线历史耗时（扩展），单位：秒。当设置了ext_departure_time时返回，多个时间戳对应多个耗时以英文逗号分隔，计算失败返回-1。 | 500,520,-1 |\n| `status` | integer |  | 本次API访问状态码<br/><br/>**枚举值说明：**<br/>`0`: 成功<br/>`1`: 服务内部错误<br/>`2`: 参数无效<br/>`7`: 无返回结果 | 0 |\n\n### 常见问题\n\n**Q: 该高级功能是否可以直接使用?**\n\nA: 需要先开通对应的高级权限"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1052,"uniquenessScore":44,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T09:36:15.178Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T09:36:15.178Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T11:49:42.662Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}