QWeather Geo POI Range
1 credits/call
ae_qweather_geo_poi_range
Find points of interest, such as scenic spots or tide stations, near a specific location.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
lang | string | No | Language setting. See [Language](https://dev.qweather.com/en/docs/resource/language/) for behavior, configuration, and data availability | — |
type | enum (scenic | TSTA) | Yes | Choose the POI type: `scenic` for scenic spots or `TSTA` for tide stations. | — |
number | integer | No | Number of the results in response, from 1 to 20, 10 is the default. | 10 |
radius | integer | No | Search radius from 1 to 50 kilometers. The default is 5 kilometers; integer values only. | 5 |
location | string | Yes | The comma-separated [longitude and latitude](https://dev.qweather.com/en/docs/resource/glossary/#coordinate) (decimal, up to 2 decimal places) of the location to be queried. For example `location=116.41,39.92` | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_qweather_geo_poi_range' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"location": "116.41,39.92",
"number": 10,
"radius": 5,
"type": "scenic"
}
}'Response exampleresponse.json
{
"code": "200",
"poi": [
{
"adm1": "北京",
"adm2": "北京",
"country": "中国",
"id": "10101010005A",
"name": "南锣鼓巷",
"type": "scenic"
}
],
"refer": {
"license": [
"QWeather Developers License"
],
"sources": [
"QWeather"
]
}
}This example shows part of the response. Copied content is valid JSON.
