Metadata-Version: 2.4
Name: geokits
Version: 0.5.0
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Rust
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Oceanography
Classifier: Operating System :: OS Independent
Summary: Professional geospatial & maritime computational utilities
Author-email: GeoKit Dev Team <dev@geokit.tech>
Requires-Python: >=3.12
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM

# geokits

海事地理计算库（Rust + PyO3，Python 3.12+）。

## 港口属性判定（PortAttrs）

给定港口经纬度，一步算出全部管辖属性——建港时只需经纬度和名称：

```python
from geokits import PortAttrs

pa = PortAttrs()  # 进程内建一个实例反复用（构造即加载内嵌边界，~毫秒级）
pa.lookup(121.5, 31.4)
# {'zone_name': 'North China & Far East', 'is_eu_mrv': False,
#  'is_fueleu_exclude': False, 'continent': 'ASIA'}
```

| 字段 | 类型 | 说明 |
|------|------|------|
| `zone_name` | `str \| None` | 海区名（12 海区词表，与 port.zone_name 一致） |
| `is_eu_mrv` | `bool` | 是否在 EU MRV 管辖边界内 |
| `is_fueleu_exclude` | `bool` | 是否属 FuelEU 豁免区域（挪威/冰岛） |
| `continent` | `str \| None` | 大洲（大写下划线词表：ASIA/EUROPE/…） |

- 边界多边形内嵌于 crate（`data/*.geojson`），无需外部数据源、无网络请求；单次 lookup 微秒级
- `pa.data_version` 返回边界数据版本（YYYYMMDD），用于排查新旧不一致
- 已处理跨 ±180° 经度环（PostGIS 导出会把 >180° 经度归一化为负值）
- 实例无状态、线程安全，可全局共享

### 编译

```bash
maturin develop --release
```

## 数据更新

边界数据来自 weather-routing 库（`zone` + `eu_geo_boundary` 表），可再生成：

```bash
python scripts/export_boundaries.py   # 需本地 postgis 容器
cargo test                            # 回归
```

