概述最后更新时间: 2026年02月02日

Web服务API简介

高德Web服务API向开发者提供HTTP接口，开发者可通过这些接口使用各类型的地理数据服务，返回结果支持JSON和XML格式。Web服务API对所有用户开放。使用本组服务之前，需要申请应用Key。不同类型用户可获取不同的数据访问能力。

通过下面的demo，可以直观的体验我们提供的服务，点击下拉框，可切换需要体验的服务。

参数	值	备注	必选
ip		需要搜索的IP地址（仅支持国内），若用户不填写IP，则取客户HTTP之中的请求来进行定位	是
key		你的 API Key，运行示例前请填写	是

参数	备注	必选
address	填写结构化地址信息:省份+城市+区县+城镇+乡村+街道+门牌号码	是
city	查询城市，可选：城市中文、中文全拼、citycode、adcode	否
key	你的 API Key，运行示例前请填写	是

参数	备注	必选
location	经纬度坐标,最多支持50个坐标点;多个点之间用"\|"分割	是
poitype	支持传入POI TYPECODE及名称；支持传入多个POI类型，多值间用"\|"分隔	否
radius	查询POI的半径范围。取值范围：0~3000,单位：米	否
extensions	返回结果控制	否
roadlevel	可选值：1，当roadlevel=1时，过滤非主干道路，仅输出主干道路数据	否
key	你的 API Key，运行示例前请填写	是

参数	备注	必选
keywords	查询关键字	是
types	查询POI类型	否
location	经度,纬度;建议使用location参数，可在此location附近优先返回搜索关键词信息	否
city	查询城市。可选值：城市中文、中文全拼、citycode、adcode	否
datatype	多种数据类型用"\|"分隔，可选值：all-返回所有数据类型、poi-返回POI数据类型、bus-返回公交站点数据类型、busline-返回公交线路数据类型	否
key	你的 API Key，运行示例前请填写	是

参数	备注	必选
keywords	查询关键字	是
types	查询POI类型	否
city	城市名，可填：城市中文、中文全拼、citycode或adcode	否
children	按照层级展示子POI数据	否
offset	每页记录数据	否
page	当前页数	否
extensions	返回结果控制	否
key	你的 API Key，运行示例前请填写	是

参数	备注	必选
polygon	经纬度坐标对，矩形时可传入左上右下两顶点坐标对；其他情况首尾坐标对需相同	是
keywords	查询关键字	是
types	查询POI类型	否
offset	每页记录数据	否
page	当前页数	否
extensions	返回结果控制	否
key	你的 API Key，运行示例前请填写	是

参数	值	备注	必选
id		兴趣点id	是
key		你的 API Key，运行示例前请填写	是

参数	备注	必选
origin	lon,lat（经度,纬度），如 117.500244, 40.417801 经纬度小数点不超过6位	是
destination	lon,lat（经度,纬度），如 117.500244, 40.417801 经纬度小数点不超过6位	是
city	支持市内公交换乘/跨城公交的起点城市，规则：城市名称/citycode	是
cityd	跨城公交规划必填参数。规则：城市名称/citycode	否
strategy	0：最快捷模式;1：最经济模式;2：最少换乘模式;3：最少步行模式;5：不乘地铁模式	否
nightflag	是否计算夜班车 1:是；0：否	否
date	根据出发日期筛选，格式：date=2014-3-19	否
time	根据出发时间筛选，格式：time=22:34	否
key	你的 API Key，运行示例前请填写	是

参数	备注	必选
origin	lon,lat（经度,纬度），如 117.500244, 40.417801 经纬度小数点不超过6位	是
destination	lon,lat（经度,纬度），如 117.500244, 40.417801 经纬度小数点不超过6位	是
originid	当起点为POI时，建议填充此值	否
destinationid	当终点为POI时，建议填充此值	否
extensions	base:返回基本信息；all：返回全部信息	否
strategy	参见上方strategy的说明	否
waypoints	途经点，最大数目：16个坐标点	否
avoidpolygons	避让区域，如果是四边形则有四个坐标点，如果是五边形则有五个坐标点	否
avoidroad	只支持一条避让道路，如：广顺北大街	否
key	你的 API Key，运行示例前请填写	是

参数	备注	必选
locations	坐标点,经度和纬度用","分割，经度在前，纬度在后，经纬度小数点后不得超过6位。多个坐标对之间用"\|"进行分隔最多支持40对坐标	是
coordsys	原坐标系，可选值：gps;mapbar;baidu;autonavi(不进行转换) 默认autonavi	否
key	你的 API Key，运行示例前请填写	是

参数	备注	必选
keywords	规则：只支持单个关键词语搜索关键词支持：行政区名称、citycode、adcode 例如，在subdistrict=2且showbiz=false时，搜索省份（例如山东），能够显示市（例如济南），区（例如历下区）；在subdistrict=1且showbiz=false时，搜索区（例如历下区）能够显示街道信息（例如舜华路街道）	是
subdistrict	规则：设置显示下级行政区级数（行政区级别包括：国家、省/直辖市、市、区/县 4个级别）可选值：0、1、2、3 0：不返回下级行政区； 1：返回下一级行政区；2：返回下两级行政区； 3：返回下三级行政区；	否
showbiz	可选为true/false，为了能够精准的定位到街道，特别是在快递、物流、送餐等场景下，强烈建议将此设置为false	否
extensions	此项控制行政区信息中返回行政区边界坐标点。可选值：base、all; base:不返回行政区边界坐标点； all:只返回当前查询district的边界值，不返回子节点的边界值；	否
key	你的 API Key，运行示例前请填写	是

调用 Web服务 API 需要先申请应用 Key，流程如下：注册开发者账号、创建应用并添加「Web服务」类型的 Key、在请求中携带 key 参数。详细步骤可参考入门指南。

Web服务 API 各服务均存在调用量限制，包括每秒请求数（QPS）与每日/每月调用总量限制，不同服务的限制标准不同，超出限制将返回对应错误码。