Amap Maps Get V3 Place Text

1 credits/call
ae_amap_maps_get_v3_place_text

Search for places, businesses, and landmarks in mainland China using Amap (Gaode Maps). Find locations by keyword, city, or category to get addresses, coordinates, and contact details.

Maps
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
citystringNo查询城市 可选值:城市中文、中文全拼、citycode、adcode 如:北京/beijing/010/110000 填入此参数后,会尽量优先返回此城市数据,但是不一定仅局限此城市结果,极需要某个城市数据清调用citylimit参数。 如:在深圳市找天安门,返回北京天安门结果。—
pagestringNo当前页数 最大翻页数100 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。1
typesstringNo查询POI类型 可选值:分类代码 或 汉字(若用汉字,请严格按照附件之中的汉字填写) 分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。 若指定了某个大类,则所属的中类、小类都会被显示。 例如:010000为汽车服务(大类) ​ 010100为加油站(中类) ​ 010101为中国石化(小类) ​ 010900为汽车租赁(中类) ​ 010901为汽车租赁还车(小类) 当指定010000,则010100等中类、010101等小类都会被包含,当指定010900,则010901等小类都会被包含。 下载[POI分类编码和城市编码表 ](https://lbs.amap.com/api/webservice/download) 若不指定city,返回的内容为城市列表以及此城市内有多少结果符合要求。 **当您的keywords和types都是空时,默认指定types为120000(商务住宅)&150000(交通设施服务)**—
offsetstringNo每页记录数据 强烈建议不超过25,若超过25可能造成访问报错 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。20
outputenum (JSON | XML)No返回数据格式类型 可选值:JSON,XMLJSON
callbackstringNo回调函数 callback值是用户定义的函数名称,此参数只在output=JSON时有效—
childrenenum (0 | 1)No是否按照层级展示子POI数据 可选值:children=1 当为0的时候,子POI都会显示。 当为1的时候,子POI会归类到父POI之中。 仅在extensions=all的时候生效 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。0
keywordsstringYes查询关键字 规则: 多个关键字用“|”分割 若不指定city,并且搜索的为泛词(例如“美食”)的情况下,返回的内容为城市列表以及此城市内有多少结果符合要求。—
citylimitbooleanNo仅返回指定城市数据 可选值:true/falsefalse
extensionsenum (base | all)No返回结果控制 此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。base

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_amap_maps_get_v3_place_text' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "city": "南通",
    "citylimit": true,
    "keywords": "大有境",
    "offset": "10",
    "output": "JSON",
    "page": "1"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "count": "100",
  "info": "OK",
  "infocode": "10000",
  "pois": [
    {
      "address": "观畅路38号",
      "adname": "崇川区",
      "atag": [],
      "id": "B0GULZT7KP",
      "name": "崇川大有境",
      "type": "购物服务;商场;购物中心"
    }
  ],
  "status": "1",
  "suggestion": {
    "cities": [],
    "keywords": []
  }
}

This example shows part of the response. Copied content is valid JSON.