mirror of
https://github.com/smittix/intercept.git
synced 2026-04-24 06:40:00 -07:00
Add distributed agent architecture for multi-node signal intelligence
Features: - Standalone agent server (intercept_agent.py) for remote sensor nodes - Controller API blueprint for agent management and data aggregation - Push mechanism for agents to send data to controller - Pull mechanism for controller to proxy requests to agents - Multi-agent SSE stream for combined data view - Agent management page at /controller/manage - Agent selector dropdown in main UI - GPS integration for location tagging - API key authentication for secure agent communication - Integration with Intercept's dependency checking system New files: - intercept_agent.py: Remote agent HTTP server - intercept_agent.cfg: Agent configuration template - routes/controller.py: Controller API endpoints - utils/agent_client.py: HTTP client for agents - utils/trilateration.py: Multi-agent position calculation - static/js/core/agents.js: Frontend agent management - templates/agents.html: Agent management page - docs/DISTRIBUTED_AGENTS.md: System documentation Modified: - app.py: Register controller blueprint - utils/database.py: Add agents and push_payloads tables - templates/index.html: Add agent selector section
This commit is contained in:
688
routes/controller.py
Normal file
688
routes/controller.py
Normal file
@@ -0,0 +1,688 @@
|
||||
"""
|
||||
Controller routes for managing remote Intercept agents.
|
||||
|
||||
This blueprint provides:
|
||||
- Agent CRUD operations
|
||||
- Proxy endpoints to forward requests to agents
|
||||
- Push data ingestion endpoint
|
||||
- Multi-agent SSE stream
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import logging
|
||||
import queue
|
||||
import time
|
||||
from datetime import datetime, timezone
|
||||
from typing import Generator
|
||||
|
||||
from flask import Blueprint, jsonify, request, Response
|
||||
|
||||
from utils.database import (
|
||||
create_agent, get_agent, get_agent_by_name, list_agents,
|
||||
update_agent, delete_agent, store_push_payload, get_recent_payloads
|
||||
)
|
||||
from utils.agent_client import (
|
||||
AgentClient, AgentHTTPError, AgentConnectionError, create_client_from_agent
|
||||
)
|
||||
from utils.sse import format_sse
|
||||
from utils.trilateration import (
|
||||
DeviceLocationTracker, PathLossModel, Trilateration,
|
||||
AgentObservation, estimate_location_from_observations
|
||||
)
|
||||
|
||||
logger = logging.getLogger('intercept.controller')
|
||||
|
||||
controller_bp = Blueprint('controller', __name__, url_prefix='/controller')
|
||||
|
||||
# Multi-agent data queue for combined SSE stream
|
||||
agent_data_queue: queue.Queue = queue.Queue(maxsize=1000)
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# Agent CRUD
|
||||
# =============================================================================
|
||||
|
||||
@controller_bp.route('/agents', methods=['GET'])
|
||||
def get_agents():
|
||||
"""List all registered agents."""
|
||||
active_only = request.args.get('active_only', 'true').lower() == 'true'
|
||||
agents = list_agents(active_only=active_only)
|
||||
|
||||
# Optionally refresh status for each agent
|
||||
refresh = request.args.get('refresh', 'false').lower() == 'true'
|
||||
if refresh:
|
||||
for agent in agents:
|
||||
try:
|
||||
client = create_client_from_agent(agent)
|
||||
agent['healthy'] = client.health_check()
|
||||
except Exception:
|
||||
agent['healthy'] = False
|
||||
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'agents': agents,
|
||||
'count': len(agents)
|
||||
})
|
||||
|
||||
|
||||
@controller_bp.route('/agents', methods=['POST'])
|
||||
def register_agent():
|
||||
"""
|
||||
Register a new remote agent.
|
||||
|
||||
Expected JSON body:
|
||||
{
|
||||
"name": "sensor-node-1",
|
||||
"base_url": "http://192.168.1.50:8020",
|
||||
"api_key": "optional-shared-secret",
|
||||
"description": "Optional description"
|
||||
}
|
||||
"""
|
||||
data = request.json or {}
|
||||
|
||||
# Validate required fields
|
||||
name = data.get('name', '').strip()
|
||||
base_url = data.get('base_url', '').strip()
|
||||
|
||||
if not name:
|
||||
return jsonify({'status': 'error', 'message': 'Agent name is required'}), 400
|
||||
if not base_url:
|
||||
return jsonify({'status': 'error', 'message': 'Base URL is required'}), 400
|
||||
|
||||
# Check if agent already exists
|
||||
existing = get_agent_by_name(name)
|
||||
if existing:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': f'Agent with name "{name}" already exists'
|
||||
}), 409
|
||||
|
||||
# Try to connect and get capabilities
|
||||
api_key = data.get('api_key', '').strip() or None
|
||||
client = AgentClient(base_url, api_key=api_key)
|
||||
|
||||
capabilities = None
|
||||
interfaces = None
|
||||
try:
|
||||
caps = client.get_capabilities()
|
||||
capabilities = caps.get('modes', {})
|
||||
interfaces = {'devices': caps.get('devices', [])}
|
||||
except (AgentHTTPError, AgentConnectionError) as e:
|
||||
logger.warning(f"Could not fetch capabilities from {base_url}: {e}")
|
||||
|
||||
# Create agent
|
||||
try:
|
||||
agent_id = create_agent(
|
||||
name=name,
|
||||
base_url=base_url,
|
||||
api_key=api_key,
|
||||
description=data.get('description'),
|
||||
capabilities=capabilities,
|
||||
interfaces=interfaces
|
||||
)
|
||||
|
||||
# Update last_seen since we just connected
|
||||
if capabilities is not None:
|
||||
update_agent(agent_id, update_last_seen=True)
|
||||
|
||||
agent = get_agent(agent_id)
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'message': 'Agent registered successfully',
|
||||
'agent': agent
|
||||
}), 201
|
||||
|
||||
except Exception as e:
|
||||
logger.exception("Failed to create agent")
|
||||
return jsonify({'status': 'error', 'message': str(e)}), 500
|
||||
|
||||
|
||||
@controller_bp.route('/agents/<int:agent_id>', methods=['GET'])
|
||||
def get_agent_detail(agent_id: int):
|
||||
"""Get details of a specific agent."""
|
||||
agent = get_agent(agent_id)
|
||||
if not agent:
|
||||
return jsonify({'status': 'error', 'message': 'Agent not found'}), 404
|
||||
|
||||
# Optionally refresh from agent
|
||||
refresh = request.args.get('refresh', 'false').lower() == 'true'
|
||||
if refresh:
|
||||
try:
|
||||
client = create_client_from_agent(agent)
|
||||
metadata = client.refresh_metadata()
|
||||
if metadata['healthy']:
|
||||
update_agent(
|
||||
agent_id,
|
||||
capabilities=metadata['capabilities'].get('modes') if metadata['capabilities'] else None,
|
||||
interfaces={'devices': metadata['capabilities'].get('devices', [])} if metadata['capabilities'] else None,
|
||||
update_last_seen=True
|
||||
)
|
||||
agent = get_agent(agent_id)
|
||||
agent['healthy'] = True
|
||||
else:
|
||||
agent['healthy'] = False
|
||||
except Exception:
|
||||
agent['healthy'] = False
|
||||
|
||||
return jsonify({'status': 'success', 'agent': agent})
|
||||
|
||||
|
||||
@controller_bp.route('/agents/<int:agent_id>', methods=['PUT', 'PATCH'])
|
||||
def update_agent_detail(agent_id: int):
|
||||
"""Update an agent's details."""
|
||||
agent = get_agent(agent_id)
|
||||
if not agent:
|
||||
return jsonify({'status': 'error', 'message': 'Agent not found'}), 404
|
||||
|
||||
data = request.json or {}
|
||||
|
||||
# Update allowed fields
|
||||
update_agent(
|
||||
agent_id,
|
||||
base_url=data.get('base_url'),
|
||||
description=data.get('description'),
|
||||
api_key=data.get('api_key'),
|
||||
is_active=data.get('is_active')
|
||||
)
|
||||
|
||||
agent = get_agent(agent_id)
|
||||
return jsonify({'status': 'success', 'agent': agent})
|
||||
|
||||
|
||||
@controller_bp.route('/agents/<int:agent_id>', methods=['DELETE'])
|
||||
def remove_agent(agent_id: int):
|
||||
"""Delete an agent."""
|
||||
agent = get_agent(agent_id)
|
||||
if not agent:
|
||||
return jsonify({'status': 'error', 'message': 'Agent not found'}), 404
|
||||
|
||||
delete_agent(agent_id)
|
||||
return jsonify({'status': 'success', 'message': 'Agent deleted'})
|
||||
|
||||
|
||||
@controller_bp.route('/agents/<int:agent_id>/refresh', methods=['POST'])
|
||||
def refresh_agent_metadata(agent_id: int):
|
||||
"""Refresh an agent's capabilities and status."""
|
||||
agent = get_agent(agent_id)
|
||||
if not agent:
|
||||
return jsonify({'status': 'error', 'message': 'Agent not found'}), 404
|
||||
|
||||
try:
|
||||
client = create_client_from_agent(agent)
|
||||
metadata = client.refresh_metadata()
|
||||
|
||||
if metadata['healthy']:
|
||||
caps = metadata['capabilities'] or {}
|
||||
update_agent(
|
||||
agent_id,
|
||||
capabilities=caps.get('modes'),
|
||||
interfaces={'devices': caps.get('devices', [])},
|
||||
update_last_seen=True
|
||||
)
|
||||
agent = get_agent(agent_id)
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'agent': agent,
|
||||
'metadata': metadata
|
||||
})
|
||||
else:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': 'Agent is not reachable'
|
||||
}), 503
|
||||
|
||||
except (AgentHTTPError, AgentConnectionError) as e:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': f'Failed to reach agent: {e}'
|
||||
}), 503
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# Proxy Operations - Forward requests to agents
|
||||
# =============================================================================
|
||||
|
||||
@controller_bp.route('/agents/<int:agent_id>/<mode>/start', methods=['POST'])
|
||||
def proxy_start_mode(agent_id: int, mode: str):
|
||||
"""Start a mode on a remote agent."""
|
||||
agent = get_agent(agent_id)
|
||||
if not agent:
|
||||
return jsonify({'status': 'error', 'message': 'Agent not found'}), 404
|
||||
|
||||
params = request.json or {}
|
||||
|
||||
try:
|
||||
client = create_client_from_agent(agent)
|
||||
result = client.start_mode(mode, params)
|
||||
|
||||
# Update last_seen
|
||||
update_agent(agent_id, update_last_seen=True)
|
||||
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'agent_id': agent_id,
|
||||
'mode': mode,
|
||||
'result': result
|
||||
})
|
||||
|
||||
except AgentConnectionError as e:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': f'Cannot connect to agent: {e}'
|
||||
}), 503
|
||||
except AgentHTTPError as e:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': f'Agent error: {e}'
|
||||
}), 502
|
||||
|
||||
|
||||
@controller_bp.route('/agents/<int:agent_id>/<mode>/stop', methods=['POST'])
|
||||
def proxy_stop_mode(agent_id: int, mode: str):
|
||||
"""Stop a mode on a remote agent."""
|
||||
agent = get_agent(agent_id)
|
||||
if not agent:
|
||||
return jsonify({'status': 'error', 'message': 'Agent not found'}), 404
|
||||
|
||||
try:
|
||||
client = create_client_from_agent(agent)
|
||||
result = client.stop_mode(mode)
|
||||
|
||||
update_agent(agent_id, update_last_seen=True)
|
||||
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'agent_id': agent_id,
|
||||
'mode': mode,
|
||||
'result': result
|
||||
})
|
||||
|
||||
except AgentConnectionError as e:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': f'Cannot connect to agent: {e}'
|
||||
}), 503
|
||||
except AgentHTTPError as e:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': f'Agent error: {e}'
|
||||
}), 502
|
||||
|
||||
|
||||
@controller_bp.route('/agents/<int:agent_id>/<mode>/status', methods=['GET'])
|
||||
def proxy_mode_status(agent_id: int, mode: str):
|
||||
"""Get mode status from a remote agent."""
|
||||
agent = get_agent(agent_id)
|
||||
if not agent:
|
||||
return jsonify({'status': 'error', 'message': 'Agent not found'}), 404
|
||||
|
||||
try:
|
||||
client = create_client_from_agent(agent)
|
||||
result = client.get_mode_status(mode)
|
||||
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'agent_id': agent_id,
|
||||
'mode': mode,
|
||||
'result': result
|
||||
})
|
||||
|
||||
except (AgentHTTPError, AgentConnectionError) as e:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': f'Agent error: {e}'
|
||||
}), 502
|
||||
|
||||
|
||||
@controller_bp.route('/agents/<int:agent_id>/<mode>/data', methods=['GET'])
|
||||
def proxy_mode_data(agent_id: int, mode: str):
|
||||
"""Get current data from a remote agent."""
|
||||
agent = get_agent(agent_id)
|
||||
if not agent:
|
||||
return jsonify({'status': 'error', 'message': 'Agent not found'}), 404
|
||||
|
||||
try:
|
||||
client = create_client_from_agent(agent)
|
||||
result = client.get_mode_data(mode)
|
||||
|
||||
# Tag data with agent info
|
||||
result['agent_id'] = agent_id
|
||||
result['agent_name'] = agent['name']
|
||||
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'agent_id': agent_id,
|
||||
'agent_name': agent['name'],
|
||||
'mode': mode,
|
||||
'data': result
|
||||
})
|
||||
|
||||
except (AgentHTTPError, AgentConnectionError) as e:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': f'Agent error: {e}'
|
||||
}), 502
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# Push Data Ingestion
|
||||
# =============================================================================
|
||||
|
||||
@controller_bp.route('/api/ingest', methods=['POST'])
|
||||
def ingest_push_data():
|
||||
"""
|
||||
Receive pushed data from remote agents.
|
||||
|
||||
Expected JSON body:
|
||||
{
|
||||
"agent_name": "sensor-node-1",
|
||||
"scan_type": "adsb",
|
||||
"interface": "rtlsdr0",
|
||||
"payload": {...},
|
||||
"received_at": "2024-01-15T10:30:00Z"
|
||||
}
|
||||
|
||||
Expected header:
|
||||
X-API-Key: shared-secret (if agent has api_key configured)
|
||||
"""
|
||||
data = request.json
|
||||
if not data:
|
||||
return jsonify({'status': 'error', 'message': 'No data provided'}), 400
|
||||
|
||||
agent_name = data.get('agent_name')
|
||||
if not agent_name:
|
||||
return jsonify({'status': 'error', 'message': 'agent_name required'}), 400
|
||||
|
||||
# Find agent
|
||||
agent = get_agent_by_name(agent_name)
|
||||
if not agent:
|
||||
return jsonify({'status': 'error', 'message': 'Unknown agent'}), 401
|
||||
|
||||
# Validate API key if configured
|
||||
if agent.get('api_key'):
|
||||
provided_key = request.headers.get('X-API-Key', '')
|
||||
if provided_key != agent['api_key']:
|
||||
logger.warning(f"Invalid API key from agent {agent_name}")
|
||||
return jsonify({'status': 'error', 'message': 'Invalid API key'}), 401
|
||||
|
||||
# Store payload
|
||||
try:
|
||||
payload_id = store_push_payload(
|
||||
agent_id=agent['id'],
|
||||
scan_type=data.get('scan_type', 'unknown'),
|
||||
payload=data.get('payload', {}),
|
||||
interface=data.get('interface'),
|
||||
received_at=data.get('received_at')
|
||||
)
|
||||
|
||||
# Emit to SSE stream
|
||||
try:
|
||||
agent_data_queue.put_nowait({
|
||||
'type': 'agent_data',
|
||||
'agent_id': agent['id'],
|
||||
'agent_name': agent_name,
|
||||
'scan_type': data.get('scan_type'),
|
||||
'interface': data.get('interface'),
|
||||
'payload': data.get('payload'),
|
||||
'received_at': data.get('received_at') or datetime.now(timezone.utc).isoformat()
|
||||
})
|
||||
except queue.Full:
|
||||
logger.warning("Agent data queue full, data may be lost")
|
||||
|
||||
return jsonify({
|
||||
'status': 'accepted',
|
||||
'payload_id': payload_id
|
||||
}), 202
|
||||
|
||||
except Exception as e:
|
||||
logger.exception("Failed to store push payload")
|
||||
return jsonify({'status': 'error', 'message': str(e)}), 500
|
||||
|
||||
|
||||
@controller_bp.route('/api/payloads', methods=['GET'])
|
||||
def get_payloads():
|
||||
"""Get recent push payloads."""
|
||||
agent_id = request.args.get('agent_id', type=int)
|
||||
scan_type = request.args.get('scan_type')
|
||||
limit = request.args.get('limit', 100, type=int)
|
||||
|
||||
payloads = get_recent_payloads(
|
||||
agent_id=agent_id,
|
||||
scan_type=scan_type,
|
||||
limit=min(limit, 1000)
|
||||
)
|
||||
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'payloads': payloads,
|
||||
'count': len(payloads)
|
||||
})
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# Multi-Agent SSE Stream
|
||||
# =============================================================================
|
||||
|
||||
@controller_bp.route('/stream/all')
|
||||
def stream_all_agents():
|
||||
"""
|
||||
Combined SSE stream for data from all agents.
|
||||
|
||||
This endpoint streams push data as it arrives from agents.
|
||||
Each message is tagged with agent_id and agent_name.
|
||||
"""
|
||||
def generate() -> Generator[str, None, None]:
|
||||
last_keepalive = time.time()
|
||||
keepalive_interval = 30.0
|
||||
|
||||
while True:
|
||||
try:
|
||||
msg = agent_data_queue.get(timeout=1.0)
|
||||
last_keepalive = time.time()
|
||||
yield format_sse(msg)
|
||||
except queue.Empty:
|
||||
now = time.time()
|
||||
if now - last_keepalive >= keepalive_interval:
|
||||
yield format_sse({'type': 'keepalive'})
|
||||
last_keepalive = now
|
||||
|
||||
response = Response(generate(), mimetype='text/event-stream')
|
||||
response.headers['Cache-Control'] = 'no-cache'
|
||||
response.headers['X-Accel-Buffering'] = 'no'
|
||||
response.headers['Connection'] = 'keep-alive'
|
||||
return response
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# Agent Management Page
|
||||
# =============================================================================
|
||||
|
||||
@controller_bp.route('/manage')
|
||||
def agent_management_page():
|
||||
"""Render the agent management page."""
|
||||
from flask import render_template
|
||||
from config import VERSION
|
||||
return render_template('agents.html', version=VERSION)
|
||||
|
||||
|
||||
@controller_bp.route('/monitor')
|
||||
def network_monitor_page():
|
||||
"""Render the network monitor page for multi-agent aggregated view."""
|
||||
from flask import render_template
|
||||
return render_template('network_monitor.html')
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# Device Location Estimation (Trilateration)
|
||||
# =============================================================================
|
||||
|
||||
# Global device location tracker
|
||||
device_tracker = DeviceLocationTracker(
|
||||
trilateration=Trilateration(
|
||||
path_loss_model=PathLossModel('outdoor'),
|
||||
min_observations=2
|
||||
),
|
||||
observation_window_seconds=120.0, # 2 minute window
|
||||
min_observations=2
|
||||
)
|
||||
|
||||
|
||||
@controller_bp.route('/api/location/observe', methods=['POST'])
|
||||
def add_location_observation():
|
||||
"""
|
||||
Add an observation for device location estimation.
|
||||
|
||||
Expected JSON body:
|
||||
{
|
||||
"device_id": "AA:BB:CC:DD:EE:FF",
|
||||
"agent_name": "sensor-node-1",
|
||||
"agent_lat": 40.7128,
|
||||
"agent_lon": -74.0060,
|
||||
"rssi": -55,
|
||||
"frequency_mhz": 2400 (optional)
|
||||
}
|
||||
|
||||
Returns location estimate if enough data, null otherwise.
|
||||
"""
|
||||
data = request.json or {}
|
||||
|
||||
required = ['device_id', 'agent_name', 'agent_lat', 'agent_lon', 'rssi']
|
||||
for field in required:
|
||||
if field not in data:
|
||||
return jsonify({'status': 'error', 'message': f'Missing required field: {field}'}), 400
|
||||
|
||||
# Look up agent GPS from database if not provided
|
||||
agent_lat = data.get('agent_lat')
|
||||
agent_lon = data.get('agent_lon')
|
||||
|
||||
if agent_lat is None or agent_lon is None:
|
||||
agent = get_agent_by_name(data['agent_name'])
|
||||
if agent and agent.get('gps_coords'):
|
||||
coords = agent['gps_coords']
|
||||
agent_lat = coords.get('lat') or coords.get('latitude')
|
||||
agent_lon = coords.get('lon') or coords.get('longitude')
|
||||
|
||||
if agent_lat is None or agent_lon is None:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': 'Agent GPS coordinates required'
|
||||
}), 400
|
||||
|
||||
estimate = device_tracker.add_observation(
|
||||
device_id=data['device_id'],
|
||||
agent_name=data['agent_name'],
|
||||
agent_lat=float(agent_lat),
|
||||
agent_lon=float(agent_lon),
|
||||
rssi=float(data['rssi']),
|
||||
frequency_mhz=data.get('frequency_mhz')
|
||||
)
|
||||
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'device_id': data['device_id'],
|
||||
'location': estimate.to_dict() if estimate else None
|
||||
})
|
||||
|
||||
|
||||
@controller_bp.route('/api/location/estimate', methods=['POST'])
|
||||
def estimate_location():
|
||||
"""
|
||||
Estimate device location from provided observations.
|
||||
|
||||
Expected JSON body:
|
||||
{
|
||||
"observations": [
|
||||
{"agent_lat": 40.7128, "agent_lon": -74.0060, "rssi": -55, "agent_name": "node-1"},
|
||||
{"agent_lat": 40.7135, "agent_lon": -74.0055, "rssi": -70, "agent_name": "node-2"},
|
||||
{"agent_lat": 40.7120, "agent_lon": -74.0050, "rssi": -62, "agent_name": "node-3"}
|
||||
],
|
||||
"environment": "outdoor" (optional: outdoor, indoor, free_space)
|
||||
}
|
||||
"""
|
||||
data = request.json or {}
|
||||
|
||||
observations = data.get('observations', [])
|
||||
if len(observations) < 2:
|
||||
return jsonify({
|
||||
'status': 'error',
|
||||
'message': 'At least 2 observations required'
|
||||
}), 400
|
||||
|
||||
environment = data.get('environment', 'outdoor')
|
||||
|
||||
try:
|
||||
result = estimate_location_from_observations(observations, environment)
|
||||
return jsonify({
|
||||
'status': 'success' if result else 'insufficient_data',
|
||||
'location': result
|
||||
})
|
||||
except Exception as e:
|
||||
logger.exception("Location estimation failed")
|
||||
return jsonify({'status': 'error', 'message': str(e)}), 500
|
||||
|
||||
|
||||
@controller_bp.route('/api/location/<device_id>', methods=['GET'])
|
||||
def get_device_location(device_id: str):
|
||||
"""Get the latest location estimate for a device."""
|
||||
estimate = device_tracker.get_location(device_id)
|
||||
|
||||
if not estimate:
|
||||
return jsonify({
|
||||
'status': 'not_found',
|
||||
'device_id': device_id,
|
||||
'location': None
|
||||
})
|
||||
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'device_id': device_id,
|
||||
'location': estimate.to_dict()
|
||||
})
|
||||
|
||||
|
||||
@controller_bp.route('/api/location/all', methods=['GET'])
|
||||
def get_all_locations():
|
||||
"""Get all current device location estimates."""
|
||||
locations = device_tracker.get_all_locations()
|
||||
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'count': len(locations),
|
||||
'devices': {
|
||||
device_id: estimate.to_dict()
|
||||
for device_id, estimate in locations.items()
|
||||
}
|
||||
})
|
||||
|
||||
|
||||
@controller_bp.route('/api/location/near', methods=['GET'])
|
||||
def get_devices_near():
|
||||
"""
|
||||
Find devices near a location.
|
||||
|
||||
Query params:
|
||||
lat: latitude
|
||||
lon: longitude
|
||||
radius: radius in meters (default 100)
|
||||
"""
|
||||
try:
|
||||
lat = float(request.args.get('lat', 0))
|
||||
lon = float(request.args.get('lon', 0))
|
||||
radius = float(request.args.get('radius', 100))
|
||||
except (ValueError, TypeError):
|
||||
return jsonify({'status': 'error', 'message': 'Invalid coordinates'}), 400
|
||||
|
||||
results = device_tracker.get_devices_near(lat, lon, radius)
|
||||
|
||||
return jsonify({
|
||||
'status': 'success',
|
||||
'center': {'lat': lat, 'lon': lon},
|
||||
'radius_meters': radius,
|
||||
'count': len(results),
|
||||
'devices': [
|
||||
{'device_id': device_id, 'location': estimate.to_dict()}
|
||||
for device_id, estimate in results
|
||||
]
|
||||
})
|
||||
Reference in New Issue
Block a user