Actions16
Overview
This node integrates with the 高德地图 (Amap) API, specifically providing geocoding functionality under the "基础API" resource and the "地理编码" operation. It converts structured address information into geographic coordinates (latitude and longitude). This is useful in scenarios such as mapping addresses on a map, location-based services, logistics planning, or any application requiring conversion from human-readable addresses to precise geographic points.
For example, given an address like "北京市朝阳区阜通东大街6号", the node will return its corresponding latitude and longitude coordinates.
Properties
| Name | Meaning |
|---|---|
| 结构化地址信息 | The structured address string to be geocoded. The format should follow the order: country, province, city, district/county, town, village, street, house number, estate, building. Example: "北京市朝阳区阜通东大街6号". This is required. |
| 选项 | Additional optional parameters to refine the query. |
The "选项" collection includes:
| Name | Meaning |
|---|---|
| 指定查询的城市 | Optional city specification to limit the search scope. Can be a city name in Chinese (e.g., 北京), full pinyin (beijing), city code (010), or administrative code (110000). County-level cities are not supported. If left empty, the search covers the entire country. Reference for codes: 城市编码表. Only shown for geocoding operation. |
| 搜索半径 | Search radius in meters (0-3000, default 1000). Only applicable for reverse geocoding operation. |
| 返回结果 | Specifies the detail level of returned data: "基本地址信息" (basic address info) or "附近POI内容等" (nearby POI, road info, intersections). Only for reverse geocoding. |
| POI 类型 | Filter POIs by type code(s), multiple codes separated by " |
| 道路等级 | Road level filter for returned data: "显示所有道路" (show all roads) or "仅输出主干道路数据" (only main roads). Only for reverse geocoding with "all" extensions option. |
Output
The node outputs JSON data containing the geocoding results from the Amap API. Typically, this includes:
- Geographic coordinates (latitude and longitude) corresponding to the input address.
- Formatted address details as returned by the API.
If binary data were involved (not indicated here), it would represent media or files related to the location, but this node focuses on JSON geocoding responses.
Dependencies
- Requires an API key credential for the 高德地图 (Amap) service.
- The base URL for API requests is configured via credentials.
- No other external dependencies are indicated.
Troubleshooting
- Invalid or missing address: Ensure the "结构化地址信息" property is correctly formatted and not empty.
- City code errors: When specifying the city option, use valid city names or codes as per the official coding table; county-level cities are unsupported.
- API authentication failures: Verify that the API key credential is correctly set up and has permissions for geocoding.
- Rate limiting or quota exceeded: The Amap API may limit request rates; handle errors accordingly.
- Unexpected empty results: Check if the address is too vague or incorrectly formatted; try adding the city option to narrow the search.