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.

Maps
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
citystringNo指定查询的城市 可选输入内容包括:指定城市的中文(如北京)、指定城市的中文全拼(beijing)、citycode(010)、adcode(110000),不支持县级市。当指定城市查询内容为空时,会进行全国范围内的地址转换检索。 adcode信息可参考城市编码表获取—
outputenum (JSON | XML)No返回数据格式类型 可选输入内容包括:JSON,XML。设置 JSON 返回结果数据将会以JSON结构构成;如果设置 XML 返回结果数据将以 XML 结构构成。JSON
addressstringYes结构化地址信息 规则遵循:国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦,如:北京市朝阳区阜通东大街6号。如果需要解析多个地址的话,请用"|"进行间隔,并且将 batch 参数设置为 true,最多支持 10 个地址进进行"|"分割形式的请求。—
callbackstringNo回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。—

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_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
JSONPartial content
{
  "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