Amap Maps Get V3 Geocode Geo
1 credits/call
ae_amap_maps_get_v3_geocode_geo
Convert Chinese addresses, landmarks, and place names in mainland China into latitude and longitude coordinates using Amap.
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 |
|---|---|---|---|---|
city | string | No | 指定查询的城市 可选输入内容包括:指定城市的中文(如北京)、指定城市的中文全拼(beijing)、citycode(010)、adcode(110000),不支持县级市。当指定城市查询内容为空时,会进行全国范围内的地址转换检索。 adcode信息可参考城市编码表获取 | — |
output | enum (JSON | XML) | No | 返回数据格式类型 可选输入内容包括:JSON,XML。设置 JSON 返回结果数据将会以JSON结构构成;如果设置 XML 返回结果数据将以 XML 结构构成。 | JSON |
address | string | Yes | 结构化地址信息 规则遵循:国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦,如:北京市朝阳区阜通东大街6号。如果需要解析多个地址的话,请用"|"进行间隔,并且将 batch 参数设置为 true,最多支持 10 个地址进进行"|"分割形式的请求。 | — |
callback | string | No | 回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。 | — |
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_geo' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"address": "连云港市海州区新孔南路46号海洲数字科技大厦",
"city": "连云港",
"output": "JSON"
}
}'Response exampleresponse.json
{
"count": "1",
"geocodes": [
{
"adcode": "320706",
"building": {
"name": [],
"type": []
},
"city": "连云港市",
"citycode": "0518",
"country": "中国",
"district": "海州区"
}
],
"info": "OK",
"infocode": "10000",
"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

