Actions16
Overview
This node integrates with a map service API to perform coordinate system conversions. It allows users to input one or multiple geographic coordinates (latitude and longitude) in a specified source coordinate system and converts them into the target coordinate system used internally by the map service.
Common scenarios include:
- Converting GPS coordinates collected from devices into the map provider's coordinate system for accurate mapping.
- Transforming coordinates from other map services (e.g., Baidu, Mapbar) to the standard used by this map API.
- Preparing location data for further geospatial operations like routing or POI searches within the same coordinate reference frame.
Practical example:
- A user has a list of GPS coordinates from a tracking device and wants to convert them to the map provider’s coordinate system before displaying them on a map or performing spatial queries.
Properties
| Name | Meaning |
|---|---|
| 坐标点 | One or more coordinate points to convert. Each point is a string of latitude and longitude separated by a comma (e.g., "39.909604,116.397228"). Up to 40 points can be provided. |
| 原坐标系 | The source coordinate system of the input coordinates. Options are: 高德 (autonavi), GPS (gps), 百度地图 (baidu), 图吧地图 (mapbar). |
Output
The node outputs JSON data containing the converted coordinates corresponding to the input points. The exact structure depends on the API response but typically includes the transformed latitude and longitude values in the target coordinate system.
If binary data output is supported, it would represent map images or related media, but based on the provided code and properties, the output is primarily JSON with coordinate conversion results.
Dependencies
- Requires an API key credential for the map service to authenticate requests.
- The base URL for the API is configured via credentials.
- Network access to the map service endpoint is necessary.
Troubleshooting
- Invalid coordinate format: Ensure each coordinate is a string with latitude and longitude separated by a comma, e.g., "39.909604,116.397228".
- Exceeding maximum points: The node supports up to 40 coordinate points per request; sending more may cause errors.
- Incorrect source coordinate system: Selecting the wrong original coordinate system will result in inaccurate conversions.
- Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- API rate limits or network issues: May cause request failures; check connectivity and API usage quotas.
Links and References
- Gaode (Amap) Coordinate Conversion API Documentation
- General information on coordinate systems and transformations in GIS contexts.