所有文档
快速开始
接口文档
相关资料
该服务用于检索定位点周边的水域，返回命中水域的名称、水域类型以及定位点到水域的最近距离，可用于儿童手表、亲子守护等场景下的靠近水域报警。百度地图水域类型覆盖海域、河川域、湖沼地、水库、港湾、运河、小型湖、游泳池、喷泉、公园水池等。
https://api.map.baidu.com/api_water_area_search/v1/?location=116.307526,40.056898&coordtype=bd09ll&radius=500&ak=您的ak//GET请求
ak
开发者密钥，用于服务鉴权与配额统计
您的ak
是
location
检索中心点坐标，格式为“经度,纬度”，仅支持数字、小数点和英文逗号
116.307526,40.056898
coordtype
请求坐标的坐标系类型，可选值：bd09ll（百度经纬度）、bd09mc（百度墨卡托）、gcj02（国测局经纬度）、wgs84（GPS原始经纬度）
bd09ll
radius
检索半径，单位：米。取值范围 1~5000，小于 1 按 1 处理，大于 5000 按 5000 处理
500
stretch_range
定位容错半径，单位：米。不传时为 0；传入值小于 1 按 1 处理，大于 5000 按 5000 处理。用于补偿设备定位误差，服务实际检索半径为 radius + stretch_range
50
否
status
int
本次API访问状态，成功返回 0，失败返回其他数字（见服务状态码）
message
string
对访问状态值的说明，参数错误时会带上具体原因
results
object
检索结果
total
命中水域总数，按水域名称去重后的条数；无命中时为 0
waterinfo
array
水域结果数组，按距离由近到远排序；无命中时不返回该字段。结果按水域名称去重，因此多个无名水域（name 为空）只会返回一条
name
水域名称。部分水域无名称，此时返回空字符串
id
水域唯一标识，即水域面的 uid
type
水域类型编码（字符串形式），取值含义：0：未调查；1：海域；2：河川域；3：湖沼地；4：水库；5：港湾；6：运河；11：公园；31：小型湖；32：游泳池；33：喷泉；其他编码按未调查理解
distance
定位点到水域边界的最近距离，单位：米。定位点落在水域面内时为 0
0
OK
正常状态
1
Param Error. / Coordtype Error / Location format Error. / Radius range Error.
参数错误。message 直接返回具体原因文本，而非统一描述；注意本接口沿用旧版水域预警服务的定义，参数错误是 1、内部错误是 2
2
Service internal error
服务内部错误
3
protocol type error, only support HTTP
协议类型错误，仅支持 HTTP
4
http method error
HTTP 方法错误，仅支持 GET
上一篇
下一篇
