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.
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 |
|---|---|---|---|---|
size | string | No | 地图大小 图片宽度*图片高度。最大值为1024*1024 | 400*400 |
zoom | string | No | 地图级别 地图缩放级别:[1,17] 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。 | — |
paths | string | No | 折线 使用规则见paths详细说明,折线和多边形最大数4个 | — |
scale | enum (1 | 2) | No | 普通/高清 1:返回普通图; 2:调用高清图,图片高度和宽度都增加一倍,zoom也增加一倍(当zoom为最大值时,zoom不再改变)。 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。 | 1 |
labels | string | No | 标签 使用规则见labels详细说明,标签最大数10个 | — |
markers | string | No | 标注 使用规则见markers详细说明,标注最大数10个 | — |
traffic | enum (0 | 1) | No | 交通路况标识 底图是否展现实时路况。 可选值: 0,不展现;1,展现。 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。 | 0 |
location | string | No | 地图中心点 中心点坐标。 规则:经度和纬度用","分隔 经纬度小数点后不得超过6位。 | — |
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_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
{
"info": "INVALID_PARAMS",
"infocode": "20000",
"status": "0"
}Guides using this tool
See how this tool fits into real workflows

