Actions16
Overview
This node integrates with the 高德地图 (Amap) API, specifically providing access to its 基础API (Basic API) resource for 行政区域查询 (Administrative Region Query). It allows users to search and retrieve detailed administrative region information based on keywords such as district names, city codes, or administrative codes. This is useful in scenarios where geographic or administrative boundary data is needed, such as mapping applications, location-based services, or regional data analysis.
For example, a user can input a city name or an administrative code to get detailed information about that area, including subregions and boundary coordinates if desired.
Properties
| Name | Meaning |
|---|---|
| 查询关键字 | A single keyword to search for an administrative region. Supported keywords include district name, citycode, or adcode. |
| 根据区划过滤 | Filter results by a specific administrative division using its adcode. Only returns information for that province/municipality. |
| 子级行政区 | Number of levels of sub-administrative regions to return: 0 (none), 1 (one level), 2 (two levels), or 3 (three levels). |
| 返回结果控制 | Controls whether to return boundary coordinate points: "不返回行政区边界坐标点" (no boundaries) or "只返回当前查询District的边界值" (only current district boundaries). |
| 页码 | Page number of the results to return, starting from 1. |
| 每页行数 | Number of records to return per page (outermost data count). |
Output
The node outputs JSON data containing administrative region details matching the query. The structure typically includes:
- Administrative region names and codes.
- Hierarchical subregion information depending on the selected subdistrict level.
- Optionally, boundary coordinate points of the queried districts if requested.
If boundary coordinates are included, they provide polygonal data representing the geographic shape of the administrative areas.
No binary data output is indicated.
Dependencies
- Requires an API key credential for the 高德地图 (Amap) service.
- The base URL for API requests is configured via credentials.
- Network connectivity to the Amap API endpoint is necessary.
Troubleshooting
- Empty or no results: Ensure the query keyword is valid and correctly spelled. Using an incorrect adcode filter may result in no data.
- Invalid adcode filter: The filter must be a valid administrative code; otherwise, the API may return errors or empty results.
- API authentication errors: Verify that the API key credential is correctly set up and has permissions for the Basic API.
- Pagination issues: If requesting pages beyond available data, results may be empty.
- Boundary data not returned: Check the "返回结果控制" option; selecting "base" will omit boundary coordinates.
Links and References
- 高德地图开放平台 - 行政区划查询 (Official documentation for administrative district queries)
- 高德地图开放平台 (General Amap API platform)