Amap Maps Get V3 Staticmap

1 credits/call
ae_amap_maps_get_v3_staticmap

Generate a static map image with custom markers, labels, and route lines.

MapsImage
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
sizestringNo地图大小 图片宽度*图片高度。最大值为1024*1024400*400
zoomstringNo地图级别 地图缩放级别:[1,17] 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。—
pathsstringNo折线 使用规则见paths详细说明,折线和多边形最大数4个—
scaleenum (1 | 2)No普通/高清 1:返回普通图; 2:调用高清图,图片高度和宽度都增加一倍,zoom也增加一倍(当zoom为最大值时,zoom不再改变)。 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。1
labelsstringNo标签 使用规则见labels详细说明,标签最大数10个—
markersstringNo标注 使用规则见markers详细说明,标注最大数10个—
trafficenum (0 | 1)No交通路况标识 底图是否展现实时路况。 可选值: 0,不展现;1,展现。 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。0
locationstringNo地图中心点 中心点坐标。 规则:经度和纬度用","分隔 经纬度小数点后不得超过6位。—

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_staticmap' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "labels": "酒店,14,0xFFFFFF,0x2E6FA8,116.4076,39.9152;故宫,14,0xFFFFFF,0xB85C4C,116.3972,39.9163;国博,14,0xFFFFFF,0xB85C4C,116.4013,39.9047;军博,14,0xFFFFFF,0xB85C4C,116.3236,39.9073;考古博物馆,14,0xFFFFFF,0x3E8967,116.3906,39.9994;北京朝阳站,14,0xFFFFFF,0xB4772A,116.5043,39.9515",
    "location": "116.398,39.945",
    "markers": "large,0x2E6FA8,A:116.4076,39.9152|large,0xB85C4C,B:116.3972,39.9163|large,0xB85C4C,C:116.4013,39.9047|large,0xB85C4C,D:116.3236,39.9073|large,0x3E8967,E:116.3906,39.9994|large,0xB4772A,F:116.5043,39.9515",
    "scale": "2",
    "size": "1024*720",
    "traffic": "0",
    "zoom": "12"
  }
}'
Response exampleresponse.json
JSON
{
  "info": "INVALID_PARAMS",
  "infocode": "20000",
  "status": "0"
}

Guides using this tool

See how this tool fits into real workflows