Rivers & Lakes
Add water features to your maps.
Rivers & Lakes
Add rivers, lakes, and water features to your maps.
Enable All Features
Show all available water features for a location:
{
"location_id": "bdd56f14-e776-418a-ab18-89c8138df978",
"theme": "modern",
"configuration": {
"show_features": true
}
}
Show Labels
Display names on water features:
{
"configuration": {
"show_features": true,
"show_river_labels": true,
"show_lake_labels": true
}
}
Position Labels
Control where labels appear relative to the feature:
{
"configuration": {
"show_features": true,
"show_river_labels": true,
"show_lake_labels": true,
"river_label_position": "right",
"lake_label_position": "right"
}
}
| Position | Description |
|---|---|
center | Centered on feature (default) |
left | Left of feature center |
right | Right of feature center |
top | Above feature center |
bottom | Below feature center |
Select Specific Features
Display only specific features:
{
"configuration": {
"show_features": true,
"selected_features": [
"river-mississippi-2-0",
"river-columbia-3-0"
]
}
}
Discover Features
Find available features for a location. Requires API key.
curl 'https://api.smavatar.com/api/mcp/tools/list-features?location_id=bdd56f14-e776-418a-ab18-89c8138df978&type=river' \
-H 'Authorization: Bearer sma_your_key'
Response:
{
"success": true,
"data": [
{
"id": "river-network-uuid",
"name": "Mississippi River",
"code": "river-mississippi-2-0",
"type": "river",
"importance": 2
}
]
}
Feature Types
| Type | Description |
|---|---|
river | Rivers and streams |
lake | Lakes and reservoirs |
river_system | Complete river networks |
lake_system | Lake systems |
Importance Levels
Features have importance levels (1–5), where 1 is most important:
| Level | Examples |
|---|---|
| 1 | Mississippi, Great Lakes |
| 2 | Columbia, Colorado |
| 3 | Sacramento, Ohio |
| 4–5 | Smaller tributaries |
Filter by importance:
curl '.../list-features?location_id=...&max_importance=2'
Complete Example
California with major rivers and positioned labels:
curl -X POST '.../jobs/maps' \
-H 'Authorization: Bearer {api_key}' \
-H 'Content-Type: application/json' \
-d '{
"location_id": "{california-id}",
"width": 1080,
"height": 1920,
"theme": "modern",
"output_format": "png",
"configuration": {
"show_features": true,
"show_river_labels": true,
"show_lake_labels": true,
"river_label_position": "right",
"lake_label_position": "right"
}
}'
The
list-features endpoint requires an API key.