Amap Maps Get V3 Geocode Regeo
1 credits/call
ae_amap_maps_get_v3_geocode_regeo
Convert mainland China GPS coordinates into a structured address and nearby landmarks using Amap (Gaode).
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 |
|---|---|---|---|---|
batch | boolean | No | batch=true为批量查询,batch=false为单点查询。 | false |
output | enum (JSON | XML) | No | 返回数据格式类型 可选输入内容包括:JSON,XML。设置 JSON 返回结果数据将会以JSON结构构成;如果设置 XML 返回结果数据将以 XML 结构构成。 | JSON |
radius | string | No | 搜索半径 radius取值范围在0~3000,默认是1000。单位:米 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。 | 1000 |
poitype | string | No | 以下内容需要 extensions 参数为 all 时才生效。 逆地理编码在进行坐标解析之后不仅可以返回地址描述,也可以返回经纬度附近符合限定要求的POI内容(在 extensions 字段值为 all 时才会返回POI内容)。设置 POI 类型参数相当于为上述操作限定要求。参数仅支持传入POI TYPECODE,可以传入多个POI TYPECODE,相互之间用“|”分隔。该参数在 batch 取值为 true 时不生效。获取 POI TYPECODE 可以参考[POI分类码表](https://a.amap.com/lbs/static/amap_3dmap_lite/amap_poicode.zip) | — |
callback | string | No | 回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。 | — |
location | string | Yes | 传入内容规则:经度在前,纬度在后,经纬度间以“,”分割,经纬度小数点后不要超过 6 位。如果需要解析多个经纬度的话,请用"|"进行间隔,并且将 batch 参数设置为 true,最多支持传入 20 对坐标点。每对点坐标之间用"|"分割。 | — |
roadlevel | enum (0 | 1) | No | 道路等级 以下内容需要 extensions 参数为 all 时才生效。 可选值:0,1 当roadlevel=0时,显示所有道路 当roadlevel=1时,过滤非主干道路,仅输出主干道路数据 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。 | — |
extensions | enum (base | all) | No | 返回结果控制 extensions 参数默认取值是 base,也就是返回基本地址信息; extensions 参数取值为 all 时会返回基本地址信息、附近 POI 内容、道路信息以及道路交叉口信息。 | base |
homeorcorp | enum (0 | 1 | 2) | No | 是否优化POI返回顺序 以下内容需要 extensions 参数为 all 时才生效。 homeorcorp 参数的设置可以影响召回 POI 内容的排序策略,目前提供三个可选参数: 0:不对召回的排序策略进行干扰。 1:综合大数据分析将居家相关的 POI 内容优先返回,即优化返回结果中 pois 字段的poi顺序。 2:综合大数据分析将公司相关的 POI 内容优先返回,即优化返回结果中 pois 字段的poi顺序。 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。 | 0 |
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_v3_geocode_regeo' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"batch": true,
"extensions": "base",
"location": "114.830526,22.824152|114.611023,22.909222|114.351584,22.838345|114.447732,23.181204|113.144601,22.194803",
"output": "JSON"
}
}'Response exampleresponse.json
{
"info": "OK",
"infocode": "10000",
"regeocodes": [
{
"addressComponent": {
"adcode": "441323",
"building": {
"name": [],
"type": []
},
"businessAreas": [
[]
],
"city": "惠州市",
"citycode": "0752",
"country": "中国"
},
"formatted_address": "广东省惠州市惠东县稔山镇公背水库"
}
],
"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

