开发 Web服务 API 概述

概述 最后更新时间: 2023年08月03日

Web服务API简介 

高德Web服务API向开发者提供HTTP接口,开发者可通过这些接口使用各类型的地理数据服务,返回结果支持JSON和XML格式。

Web服务API对所有用户开放。使用本组服务之前,需要申请应用Key。不同类型用户可获取不同的数据访问能力。

功能介绍及体验

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

参数 备注 必选
ip 需要搜索的IP地址(仅支持国内)
若用户不填写IP,则取客户HTTP之中的请求来进行定位
参数 备注 必选
city 需要查询天气的城市编码。
参数 备注 必选
address 填写结构化地址信息:省+市+区+街道+门牌号
city 查询城市,可选:城市中文、中文全拼、citycode、adcode
参数 备注 必选
location 经纬度坐标;最多支持20个坐标点;多个点之间用"|"分割。
poitype 支持传入POI TYPECODE及名称;支持传入多个POI类型,多值间用“|”分隔
radius 查询POI的半径范围。取值范围:0~3000,单位:米
extensions 返回结果控制
roadlevel 可选值:1,当roadlevel=1时,过滤非主干道路,仅输出主干道路数据
参数 备注 必选
keywords 查询关键词
types 查询POI类型
location 经度,纬度;建议使用location参数,可在此location附近优先返回搜索关键词信息
city 查询城市。可选值:城市中文、中文全拼、citycode、adcode
datatype 多种数据类型用“|”分隔,可选值:all-返回所有数据类型、poi-返回POI数据类型、bus-返回公交站点数据类型、busline-返回公交线路数据类型
参数 备注 必选
keywords 查询关键词
types 查询POI类型
city 城市名,可填:城市中文、中文全拼、citycode或adcode
children 按照层级展示子POI数据
offset 每页记录数据
page 当前页数
extensions 返回结果控制
参数 备注 必选
location 中心点坐标
keywords 查询关键词
types 查询POI类型
offset 每页记录数据
page 当前页数
extensions 返回结果控制
参数 备注 必选
polygon 经纬度坐标对,矩形时可传入左上右下两顶点坐标对;其他情况首尾坐标对需相同。
keywords 查询关键词
types 查询POI类型
offset 每页记录数据
page 当前页数
extensions 返回结果控制
参数 备注 必选
id 兴趣点id
参数 备注 必选
origin lon,lat(经度,纬度),如117.500244, 40.417801 经纬度小数点不超过6位
destination lon,lat(经度,纬度),如117.500244, 40.417801 经纬度小数点不超过6位
参数 备注 必选
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
参数 备注 必选
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 只支持一条避让道路,如:广顺北大街
参数 备注 必选
locations 坐标点,经度和纬度用“,”分割,经度在前,纬度在后,经纬度小数点后不得超过6位。多个坐标对之间用“|”进行分隔最多支持40对坐标。
coordsys 原坐标系,可选值:gps;mapbar;baidu;autonavi(不进行转换)
默认autonavi
参数 备注 必选
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的申请

注册成为高德开发者需要分三步:

第一步,注册高德开发者;

第二步,去控制台创建应用;

第三步,获取Key。

具体步骤可参看下图

获取 API Key

给开发者的建议

针对个人认证开发者和企业认证开发者,提供的服务调用量有差别,可参考流量限制说明。如果您需要更高服务调用,可到控制台升级您的账号。

调用协议,可参考《高德地图 API 使用条款》获得详细信息。

返回顶部 示例中心 常见问题 智能客服 公众号
二维码