概述 最后更新时间: 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的边界值，不返回子节点的边界值； | 否 |
给开发者的建议
针对个人认证开发者和企业认证开发者，提供的服务调用量有差别，可参考流量限制说明。如果您需要更高服务调用，可到控制台升级您的账号。
调用协议，可参考《高德地图 API 使用条款》获得详细信息。
