高德地图 icon

高德地图

高德地图API，位置转换、定位等
Join our community

Actions16

Overview

This node integrates with the 高德地图 (Amap) API, specifically providing reverse geocoding functionality under the "基础API" resource. Reverse geocoding converts geographic coordinates (longitude and latitude) into a human-readable address or location information. This is useful in scenarios such as:

  • Mapping applications that need to display addresses based on GPS coordinates.
  • Location-based services that want to provide contextual information about a user's position.
  • Logistics and delivery systems requiring address details from GPS data.

For example, given a coordinate like 116.481488,39.990464, the node can return the corresponding street address, nearby points of interest (POIs), road information, and more depending on options selected.

Properties

Name Meaning
经纬度坐标 Longitude and latitude coordinates, separated by a comma, with longitude first and latitude second. Decimal precision should not exceed 6 digits. Example: 116.481488,39.990464. This is required.
选项 Additional optional parameters to customize the query:
- 搜索半径 Search radius in meters around the coordinate for nearby POI search. Range: 0 to 3000, default 1000.
- 返回结果 Type of result to return: either basic address info ("基本地址信息") or detailed info including nearby POIs, roads, and intersections ("附近POI内容等"). Default is basic info.
- POI 类型 When requesting detailed results, filter POIs by type codes. Multiple codes can be provided separated by "
- 道路等级 Road level filter when returning detailed info: show all roads (0) or only main roads (1). Default is all roads.

Note: There is also a "指定查询的城市" option listed but it applies only to the geocoding operation, not reverse geocoding.

Output

The node outputs JSON data containing the reverse geocoding results from the Amap API. The structure typically includes:

  • Formatted address string.
  • Address components such as province, city, district, street, and number.
  • Nearby POIs if requested, including their names, types, and locations.
  • Road and intersection information if detailed extensions are enabled.

If binary data were supported, it would represent map images or related media, but this node focuses on JSON location data.

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 Coordinates: Ensure the longitude and latitude are correctly formatted and within valid ranges. Errors may occur if coordinates are missing or malformed.
  • API Key Issues: Authentication errors will arise if the API key is missing, invalid, or lacks permissions. Verify the API key configuration.
  • Radius Out of Range: The radius must be between 0 and 3000 meters; values outside this range may cause errors.
  • Unsupported City Parameter: The city parameter is not applicable for reverse geocoding and should be omitted to avoid unexpected behavior.
  • Exceeding Rate Limits: The Amap API enforces usage limits; hitting these will result in errors. Monitor usage and apply for higher quotas if needed.

Links and References

Discussion