Outdoor places in an area
GET https://api.trailsplits.com/pois/v1/bbox
Checked by a live probe Key optional · 500 credits a day without one Daily area ceiling: 3,000 on Free
Huts, shelters, water, viewpoints, passes, parking and transport stops in a small box, as flat records (lat, lon, ele and OSM tags), not GeoJSON Features. Each side of the box may be at most 2°. artifact_version names the weekly release used.
Example
# Without a key, leave out the Authorization line (500 credits a day per address).
curl --fail-with-body 'https://api.trailsplits.com/pois/v1/bbox?min_lat=46&min_lon=7.7&max_lat=46.05&max_lon=7.8&kind=hut&limit=5' \
-H "Authorization: Bearer $TRAILSPLITS_API_KEY" Parameters
| Name | In | Description |
|---|---|---|
min_latrequired | query | South. |
min_lonrequired | query | West. |
max_latrequired | query | North. |
max_lonrequired | query | East. |
kind | query | Comma-separated kinds, for example hut,shelter,drinking_water. |
limit | query | Records. |
Response
| Field | Type | Description |
|---|---|---|
type | string: FeatureCollection | |
count | integer | |
artifact_version | string | |
features | array |
Full response schema (JSON Schema)
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"FeatureCollection"
]
},
"count": {
"type": "integer"
},
"artifact_version": {
"type": "string"
},
"features": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"name": {
"type": "string",
"nullable": true
},
"ele": {
"type": "number",
"nullable": true
},
"lat": {
"type": "number"
},
"lon": {
"type": "number"
},
"osm_id": {
"type": "string",
"nullable": true
},
"tags": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"kind",
"lat",
"lon"
]
}
}
},
"required": [
"type",
"features"
]
}Errors
400, plus the gateway's 401, 429 and 503 (error conventions). A refused request costs no credits.