Actions16
Overview
The node provides integration with a map service API to perform Point of Interest (POI) searches, specifically supporting the "周边搜索" (Nearby Search) operation under the "POI搜索" (POI Search) resource. This operation allows users to find POIs around a specified geographic coordinate within a given radius, filtered by keywords and POI types.
This node is beneficial in scenarios such as:
- Finding nearby restaurants, gas stations, or other facilities around a user's current location.
- Building location-based services that require dynamic retrieval of nearby points of interest.
- Enhancing applications with geospatial search capabilities for user convenience.
For example, a delivery app could use this node to find all coffee shops within 3 km of a customer's address.
Properties
| Name | Meaning |
|---|---|
| 经纬度坐标 (location) | The longitude and latitude coordinates specifying the center point for the nearby search. Format: "longitude,latitude" with up to 6 decimal places. Required. |
| 查询关键字 (keywords) | A single keyword to filter POIs by name or category. Required. |
| 查询POI类型 (types) | One or more POI categories to filter results. Categories can be specified by code or exact Chinese names according to the official classification table. Multiple categories are joined by " |
| 查询城市 (city) | Optional city filter by city name (Chinese), city code, or administrative code. Helps narrow down search scope. |
| 查询半径 (radius) | Search radius in meters around the specified location. Range: 0 to 50000 meters. Values above 50000 default to 50000. Default is 5000 meters. |
| 选项 (options) | Additional optional parameters: - 按照层级展示子POI数据 (children): Whether to display child POIs hierarchically ("1") or flat ("0"). - 页码 (page): Page number starting from 1. - 每页行数 (offset): Number of results per page. - 返回结果详略 (extensions): Level of detail in results, either "基本信息" (base) or "全部信息" (all). - 排序规则 (sortrule): Sorting rule, either by distance or comprehensive weight. |
Output
The node outputs JSON data containing the list of POIs matching the search criteria. Each POI entry typically includes details such as name, location coordinates, address, type, and other metadata depending on the "返回结果详略" (extensions) setting.
If binary data output is supported (not indicated here), it would represent associated media or files related to POIs, but this node primarily returns structured JSON data.
Dependencies
- Requires an API key credential for the map service provider to authenticate requests.
- The base URL for API requests is configured via credentials.
- Network access to the map service API endpoint is necessary.
Troubleshooting
- Invalid Coordinates: Ensure the "经纬度坐标" property is correctly formatted as "longitude,latitude" with valid numeric values and no more than 6 decimal places.
- Empty Results: If no POIs are returned, verify that the keyword, types, and city filters are appropriate and that the radius is sufficient.
- API Authentication Errors: Confirm that the API key credential is correctly set up and has permissions for POI search operations.
- Rate Limits or Quotas: The map service may enforce usage limits; exceeding these will cause errors. Monitor usage and upgrade plans if needed.
- Parameter Conflicts: Some parameters like city and keywords might affect each other; consult the API documentation for correct combinations.
Links and References
- Official POI Classification Codes and City Codes (in Chinese)
- Map Service API Documentation (refer to your specific provider's docs for detailed parameter descriptions and examples)