🗺️ 接口概述
该接口提供社区资源位置信息查询功能,支持通过地理坐标或地址名称获取附近设施详情。数据包含:公共厕所、快递柜、便利店、医院、公园等便民设施的实时位置与服务信息。
📌 请求方式
- HTTP 方法:GET
- 路径:
/api-docs/Community_Resources/map
- 参数说明:
latitude
(必需):纬度值(如39.9042
)longitude
(必需):经度值(如116.4074
)radius
(可选):搜索半径(单位:米,默认1000
)
📌 响应示例
{
"status": "success",
"data": {
"facilities": [
{
"name": "朝阳区便民服务中心",
"type": "government",
"address": "北京市朝阳区光华路8号",
"distance": "200米",
"icon": "building_01"
},
{
"name": "7-11便利店",
"type": "retail",
"address": "北京市朝阳区光华路10号",
"distance": "500米",
"icon": "store_02"
}
]
}
}
⚠️ 注意事项
- 坐标需符合 WGS84 标准
- 高德地图/百度地图API密钥需在请求头中携带(
X-API-Key
) - 支持的资源类型:
government
(政务)、retail
(零售)、health
(医疗)、education
(教育)
📚 扩展阅读
如需了解资源分类标准,可查看 社区资源类型说明。对于开发者文档,建议参考 地图API使用指南 获取更多参数细节。
📱 使用示例
curl "https://api.example.com/api-docs/Community_Resources/map?latitude=39.9042&longitude=116.4074"
响应中 icon
字段对应图标库,完整图标列表见 图标资源中心。