139 lines
3.8 KiB
Python
139 lines
3.8 KiB
Python
"""
|
|
Location Service - 位置数据服务
|
|
Provides query operations for GPS / LBS / WIFI location records.
|
|
"""
|
|
|
|
from datetime import datetime
|
|
|
|
from sqlalchemy import func, select
|
|
from sqlalchemy.ext.asyncio import AsyncSession
|
|
|
|
from app.models import LocationRecord
|
|
|
|
|
|
async def get_locations(
|
|
db: AsyncSession,
|
|
device_id: int | None = None,
|
|
location_type: str | None = None,
|
|
start_time: datetime | None = None,
|
|
end_time: datetime | None = None,
|
|
page: int = 1,
|
|
page_size: int = 20,
|
|
) -> tuple[list[LocationRecord], int]:
|
|
"""
|
|
获取位置记录列表（分页）/ Get paginated location records.
|
|
|
|
Parameters
|
|
----------
|
|
db : AsyncSession
|
|
Database session.
|
|
device_id : int, optional
|
|
Filter by device ID.
|
|
location_type : str, optional
|
|
Filter by location type (gps, lbs, wifi, gps_4g, lbs_4g, wifi_4g).
|
|
start_time : datetime, optional
|
|
Filter records after this time.
|
|
end_time : datetime, optional
|
|
Filter records before this time.
|
|
page : int
|
|
Page number (1-indexed).
|
|
page_size : int
|
|
Number of items per page.
|
|
|
|
Returns
|
|
-------
|
|
tuple[list[LocationRecord], int]
|
|
(list of location records, total count)
|
|
"""
|
|
query = select(LocationRecord)
|
|
count_query = select(func.count(LocationRecord.id))
|
|
|
|
if device_id is not None:
|
|
query = query.where(LocationRecord.device_id == device_id)
|
|
count_query = count_query.where(LocationRecord.device_id == device_id)
|
|
|
|
if location_type:
|
|
query = query.where(LocationRecord.location_type == location_type)
|
|
count_query = count_query.where(LocationRecord.location_type == location_type)
|
|
|
|
if start_time:
|
|
query = query.where(LocationRecord.recorded_at >= start_time)
|
|
count_query = count_query.where(LocationRecord.recorded_at >= start_time)
|
|
|
|
if end_time:
|
|
query = query.where(LocationRecord.recorded_at <= end_time)
|
|
count_query = count_query.where(LocationRecord.recorded_at <= end_time)
|
|
|
|
total_result = await db.execute(count_query)
|
|
total = total_result.scalar() or 0
|
|
|
|
offset = (page - 1) * page_size
|
|
query = query.order_by(LocationRecord.recorded_at.desc()).offset(offset).limit(page_size)
|
|
result = await db.execute(query)
|
|
records = list(result.scalars().all())
|
|
|
|
return records, total
|
|
|
|
|
|
async def get_latest_location(
|
|
db: AsyncSession, device_id: int
|
|
) -> LocationRecord | None:
|
|
"""
|
|
获取设备最新位置 / Get the most recent location for a device.
|
|
|
|
Parameters
|
|
----------
|
|
db : AsyncSession
|
|
Database session.
|
|
device_id : int
|
|
Device ID.
|
|
|
|
Returns
|
|
-------
|
|
LocationRecord | None
|
|
"""
|
|
result = await db.execute(
|
|
select(LocationRecord)
|
|
.where(LocationRecord.device_id == device_id)
|
|
.order_by(LocationRecord.recorded_at.desc())
|
|
.limit(1)
|
|
)
|
|
return result.scalar_one_or_none()
|
|
|
|
|
|
async def get_device_track(
|
|
db: AsyncSession,
|
|
device_id: int,
|
|
start_time: datetime,
|
|
end_time: datetime,
|
|
) -> list[LocationRecord]:
|
|
"""
|
|
获取设备轨迹 / Get device movement track within a time range.
|
|
|
|
Parameters
|
|
----------
|
|
db : AsyncSession
|
|
Database session.
|
|
device_id : int
|
|
Device ID.
|
|
start_time : datetime
|
|
Start of time range.
|
|
end_time : datetime
|
|
End of time range.
|
|
|
|
Returns
|
|
-------
|
|
list[LocationRecord]
|
|
Location records ordered by recorded_at ascending (chronological).
|
|
"""
|
|
result = await db.execute(
|
|
select(LocationRecord)
|
|
.where(
|
|
LocationRecord.device_id == device_id,
|
|
LocationRecord.recorded_at >= start_time,
|
|
LocationRecord.recorded_at <= end_time,
|
|
)
|
|
.order_by(LocationRecord.recorded_at.asc())
|
|
)
|
|
return list(result.scalars().all())
|