AgentEarth
登录

Ae · Amap · Maps · Get · V5 · Place · Text

1.00积分/次
ae_amap_maps_get_v5_place_text

使用高德地图搜索中国大陆地区的地点、商户和地标。支持通过关键词、类别或城市查找地址、坐标及联系方式。

地图
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_v5_place_text",
  "input": {
    "types": "xxx",
    "output": "json",
    "region": "xxx",
    "callback": "xxx",
    "keywords": "xxx",
    "page_num": "1",
    "page_size": "10",
    "city_limit": "false",
    "show_fields": "xxx"
  }
}'
请求方式
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"
  }
}

工具参数

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

参数类型必填说明默认值
typesstring否指定地点类型 地点文本搜索接口支持按照设定的POI类型限定地点搜索结果；地点类型与poi typecode是同类内容，可以传入多个poi typecode，相互之间用“|”分隔，内容可以参考[POI分类码表](https://lbs.amap.com/api/webservice/download)；地点（POI）列表的排序会按照高德搜索能力进行综合权重排序；—
outputenum (json)否返回结果格式类型 默认格式为json，目前只支持json格式；json
regionstring否搜索区划 增加指定区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用city_limit参数，可输入citycode，adcode，cityname；cityname仅支持到城市级别，如“北京市”。—
callbackstring否回调函数 callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。—
keywordsstring否地点关键字 需要被检索的地点文本信息。 多个关键字用“|”分割，文本总长度不可超过80字符—
page_numstring否请求第几分页 page_num的取值1-100 注意：该参数在 schema 中定义为 string，即使含义是数字或数字枚举，也请按字符串传入，例如 "1"、"20"，不要传裸数字 1、20。1
page_sizestring否当前分页展示的数据条数 page_size的取值1-25 注意：该参数在 schema 中定义为 string，即使含义是数字或数字枚举，也请按字符串传入，例如 "1"、"20"，不要传裸数字 1、20。10
city_limitboolean否指定城市数据召回限制 可选值：true/false 为true时，仅召回region对应区域内数据。false
show_fieldsstring否返回结果控制 show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则： 1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型； 2、多个字段间采用“,”进行分割； 3、show_fields未设置时，只返回基础信息类内字段。—