Amap POI Search & Geocoding for AI Agents
Let an AI agent run the full geo-data chain with Amap — search POIs, pull details, do forward and reverse geocoding, and export a static map from one plain-English prompt, no stitching of multiple map APIs.

Tool names in this guide are for reference only and may have changed or been renamed. Please use the latest tools in the tool marketplace when implementing.
Key takeaways
- Search POIs, pull details, geocode both ways and export a static map in one flow
- Convert freely between addresses and coordinates for siting and logistics
- Hand the whole chain to one agent instead of wiring several map APIs
Tools used
Why geo data is so fragmented
Local services, site selection, logistics — almost all of them run on geo data: find candidate places by keyword, inspect their details, turn an address into coordinates (or the reverse), and often draw the result on a map. The hard part isn't any single capability; it's that they live behind separate endpoints. POI search is one API, geocoding another, static maps a third, each with its own parameters. You apply for keys, read docs, handle pagination, and align coordinate systems — a simple "find nearby stores and draw them" turns into a pile of glue code.
An AI agent flattens that chain. You describe the task in plain language, and the agent picks the matching map-data tools (such as ae_amap_maps_get_v5_place_text), calls them in order, threads the results together, and hands back the POI list, coordinates or image you asked for — all without leaving your editor or chat window.
The workflow in four steps
- Search POIs — give a keyword and a city or area, get a list of candidate places.
- Pull details — fetch richer information for a chosen place.
- Geocode both ways — address to coordinates, coordinates to address.
- Export a static map — render the results as a ready-to-use static map.
How to run each step
Step 1 — Search places by keyword
Tell the agent plainly: use ae to search for places matching example keyword in example city, and give me names and coordinates. The agent calls a POI-search tool (such as ae_amap_maps_get_v5_place_text) and returns a matching list of places, handling pagination and parameters for you.
Step 2 — Inspect place details
Once you pick a POI, the agent calls a POI-detail tool (such as ae_amap_maps_get_v5_place_detail) to pull fuller information — address, category, coordinates and so on — for downstream decisions.
Step 3 — Convert between addresses and coordinates
When you need a text address as latitude/longitude, the agent calls a forward-geocoding tool (such as ae_amap_maps_get_v3_geocode_geo) to turn example address into coordinates. Going the other way, to recover a readable address from a set of coordinates, it calls a reverse-geocoding tool (such as ae_amap_maps_get_v3_geocode_regeo). This is what lets geo data line up with your existing orders, stores or user records.
Step 4 — Export a static map
Finally, the agent calls a static-map tool (such as ae_amap_maps_get_v3_staticmap) to plot the coordinates from your search or geocoding onto a static map, ready to drop into a report, page or notification.
Stitching map APIs vs. using one agent
| Step | Wiring several map APIs | With an AI agent |
|---|---|---|
| POI search | Separate key, docs, pagination | One prompt returns the place list |
| Place details | Another endpoint, another schema | Follow up in the same flow |
| Geocoding | Integrate forward and reverse APIs | Convert address/coords in plain language |
| Static map | Build URLs, align coord systems | Export an annotated map in one prompt |
| Maintenance | Track each API's changes | Tool updates stay transparent to you |
How to get started
- Sign up — new users get 1,000 free credits.
- Connect in-app inside an agent like WorkBuddy or Trae, or paste a one-line MCP config into Claude Code, Cursor or VSCode.
- Give the instruction in natural language and let the agent search, inspect, geocode and draw.
FAQ
Does it support forward and reverse geocoding? Yes. Use a forward-geocoding tool for address-to-coordinates and a reverse-geocoding tool for coordinates-to-address; both directions run in the same flow.
Can it export a static map? Yes. The agent passes the coordinates from your search or geocoding to a static-map tool and returns a ready-to-use static map.
Are there coverage limits? The supported regions and capabilities follow each tool's description on the tools page; just specify the area in your prompt.
