Add rivers, lakes, and other water features to your maps for more detailed geographic representation.
SMAvatar includes hydrological data for:
Add show_features: true to include all available water features:
{
"location_id": "bdd56f14-e776-418a-ab18-89c8138df978",
"theme": "modern",
"configuration": {
"show_features": true
}
}
For more control, specify exactly which features to display:
{
"configuration": {
"show_features": true,
"selected_features": [
"river-columbia-3-0",
"river-mississippi-2-0"
]
}
}
Use the MCP server to find available features for a location:
# Get features in a bounding box
curl 'https://api.smavatar.com/api/mcp/tools/list-features?location_id=bdd56f14-e776-418a-ab18-89c8138df978&type=river'
Response:
{
"success": true,
"data": [
{
"id": "river-network-uuid",
"name": "Mississippi River",
"code": "river-mississippi-2-0",
"type": "river",
"importance": 2
},
{
"id": "river-network-uuid-2",
"name": "Columbia River",
"code": "river-columbia-3-0",
"type": "river",
"importance": 3
}
]
}
Show labels on water features:
{
"configuration": {
"show_features": true,
"show_river_labels": true,
"show_lake_labels": true
}
}
| Type | Description |
|---|---|
river | Rivers and streams |
lake | Lakes and reservoirs |
river_system | Complete river networks |
lake_system | Lake systems |
Map of California with major rivers:
curl -X POST '.../jobs/maps' \
-H 'Authorization: Bearer {api_key}' \
-H 'Content-Type: application/json' \
-d '{
"location_id": "{california-location-id}",
"width": 1400,
"height": 900,
"theme": "modern",
"output_format": "png",
"configuration": {
"show_features": true,
"show_river_labels": true,
"show_lake_labels": true
}
}'
Features have importance levels (1-5) where lower is more important:
| Level | Description |
|---|---|
| 1 | Major features (Mississippi, Great Lakes) |
| 2 | Significant features |
| 3 | Notable features |
| 4 | Minor features |
| 5 | Small features |
Filter by importance:
curl 'https://api.smavatar.com/api/mcp/tools/list-features?location_id=...&max_importance=2'
list-features endpoint requires an API key. This protects our detailed geographic data.