AgentEarth
登录

Ae · Amap · Maps · Get · V3 · Place · Around

1.00积分/次
ae_amap_maps_get_v3_place_around

使用高德地图搜索中国大陆地区的周边地点，查找特定位置附近的餐厅、酒店、商店及其他兴趣点。

地图
1.00积分/次

价格说明

1.00积分/次

API 调用

通过统一工具网关发起同步请求，鉴权和计费由 AgentEarth 处理。

cURL
curl --request POST \
  --url 'https://api.agentearth.ai/v1/tools/run' \
  --header 'Authorization: Bearer $AGENTEARTH_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tool": "ae_amap_maps_get_v3_place_around",
  "input": {
    "city": "xxx",
    "page": "1",
    "types": "xxx",
    "offset": "20",
    "output": "JSON",
    "radius": "5000",
    "callback": "xxx",
    "keywords": "xxx",
    "location": "xxx",
    "sortrule": "distance",
    "extensions": "base"
  }
}'
请求方式
POST
接口地址
/v1/tools/run
鉴权方式
Bearer Token
超时时间
60 秒
当前版本
—
响应示例
{
  "error_no": 0,
  "error_msg": "",
  "result": [
    {
      "type": "text",
      "text": "xxx"
    }
  ],
  "platform_annotations": {
    "source": "AgentEarth",
    "platform_note": "xxx",
    "platform_suggestion": "xxx"
  }
}

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
citystring否查询城市 可选值：城市中文、中文全拼、citycode、adcode 如：北京/beijing/010/110000 当用户指定的经纬度和city出现冲突，若范围内有用户指定city的数据，则返回相关数据，否则返回为空。 如：经纬度指定石家庄，而city却指定天津，若搜索范围内有天津的数据则返回相关数据，否则返回为空。—
pagestring否当前页数 最大翻页数100 注意：该参数在 schema 中定义为 string，即使含义是数字或数字枚举，也请按字符串传入，例如 "1"、"20"，不要传裸数字 1、20。1
typesstring否查询POI类型 多个类型用“|”分割； 可选值：分类代码 或 汉字 （若用汉字，请严格按照附件之中的汉字填写） 分类代码由六位数字组成，一共分为三个部分，前两个数字代表大类；中间两个数字代表中类；最后两个数字代表小类。 若指定了某个大类，则所属的中类、小类都会被显示。 例如：010000为汽车服务（大类） ​ 010100为加油站（中类） ​ 010101为中国石化（小类） ​ 010900为汽车租赁（中类） ​ 010901为汽车租赁还车（小类） 当指定010000，则010100等中类、010101等小类都会被包含。 当指定010900，则010901等小类都会被包含 [下载POI分类编码和城市编码表](https://lbs.amap.com/api/webservice/download) **当keywords和types均为空的时候，默认指定types为050000（餐饮服务）、070000（生活服务）、120000（商务住宅）** 注意：该参数在 schema 中定义为 string；如果传 POI 分类代码、城市编码或行政区划编码，请按字符串传入并保留前导 0，例如 "050301"，不要传数字 50301。—
offsetstring否每页记录数据 强烈建议不超过25，若超过25可能造成访问报错 注意：该参数在 schema 中定义为 string，即使含义是数字或数字枚举，也请按字符串传入，例如 "1"、"20"，不要传裸数字 1、20。20
outputenum (JSON | XML)否返回数据格式类型 可选值：JSON，XMLJSON
radiusstring否查询半径 取值范围:0-50000。规则：大于50000按默认值，单位：米 注意：该参数在 schema 中定义为 string，即使含义是数字或数字枚举，也请按字符串传入，例如 "1"、"20"，不要传裸数字 1、20。5000
callbackstring否回调函数 callback值是用户定义的函数名称，此参数只在output=JSON时有效—
keywordsstring否查询关键字 规则： 多个关键字用“|”分割—
locationstring是中心点坐标 规则： 经度和纬度用","分割，经度在前，纬度在后，经纬度小数点后不得超过6位—
sortruleenum (distance | weight)否排序规则 规定返回结果的排序规则。 按距离排序：distance；综合排序：weightdistance
extensionsenum (base | all)否返回结果控制 此项默认返回基本地址信息；取值为all返回地址信息、附近POI、道路以及道路交叉口信息。base