Amap Maps Get V5 Place Text
1 credits/call
ae_amap_maps_get_v5_place_text
Search for places, businesses, and landmarks in mainland China using Amap (Gaode Maps). Find addresses, coordinates, and contact details by keyword, category, or city.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
types | string | No | 指定地点类型 地点文本搜索接口支持按照设定的POI类型限定地点搜索结果;地点类型与poi typecode是同类内容,可以传入多个poi typecode,相互之间用“|”分隔,内容可以参考[POI分类码表](https://lbs.amap.com/api/webservice/download);地点(POI)列表的排序会按照高德搜索能力进行综合权重排序; | — |
output | enum (json) | No | 返回结果格式类型 默认格式为json,目前只支持json格式; | json |
region | string | No | 搜索区划 增加指定区域内数据召回权重,如需严格限制召回数据在区域内,请搭配使用city_limit参数,可输入citycode,adcode,cityname;cityname仅支持到城市级别,如“北京市”。 | — |
callback | string | No | 回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。 | — |
keywords | string | No | 地点关键字 需要被检索的地点文本信息。 多个关键字用“|”分割,文本总长度不可超过80字符 | — |
page_num | string | No | 请求第几分页 page_num的取值1-100 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。 | 1 |
page_size | string | No | 当前分页展示的数据条数 page_size的取值1-25 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。 | 10 |
city_limit | boolean | No | 指定城市数据召回限制 可选值:true/false 为true时,仅召回region对应区域内数据。 | false |
show_fields | string | No | 返回结果控制 show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则: 1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型; 2、多个字段间采用“,”进行分割; 3、show_fields未设置时,只返回基础信息类内字段。 | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_amap_maps_get_v5_place_text' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"city_limit": true,
"keywords": "电子元器件厂",
"output": "json",
"page_num": "1",
"page_size": "25",
"region": "上海市",
"show_fields": "business"
}
}'Response exampleresponse.json
{
"count": "5",
"info": "OK",
"infocode": "10000",
"pois": [
{
"adcode": "310114",
"address": "园大路398号",
"adname": "嘉定区",
"id": "B0LB9RYCLP",
"name": "上海绿意废旧物资回收有限公司",
"type": "生活服务;生活服务场所;生活服务场所"
}
],
"status": "1"
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows
Local Business Lead Generation with AI AgentsLet an AI agent run local lead gen end to end: give it a location and industry, search local businesses at scale, pull names, addresses and contact details, then dedupe into a ready-to-use lead list.Local Recommendation Agent: Places + Details in One PromptBuild a local recommendation flow with an AI agent — search places by city and category, pull details and ratings, then rank by your preferences, all from one plain-English prompt.
Amap POI Search & Geocoding for AI AgentsLet an AI agent run the full geo-data chain with Amap — search POIs, pull details, do forward and reverse geocoding, and export a static map from one plain-English prompt, no stitching of multiple map APIs.

