Metadata-Version: 2.4
Name: geokits
Version: 0.5.1
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

海事地理计算库

## 港口属性判定（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），用于排查新旧不一致
- 实例无状态、线程安全，可全局共享

### 编译

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

## 区域价格查询（PriceQuery）

两个经纬度 + via 码 → 报价。内部自动判定两点所在海区（zone），再查 zone×zone×via 价格表：

```python
import geokits

pq = geokits.PriceQuery()
pq.price(4.4, 51.9, -74.0, 40.7, "DIR")   # 鹿特丹 → 纽约，直航
# {'departure': 'Europe', 'destination': 'North America East Coast',
#  'via': 'DIR', 'amount': 600.0}

pq.price(121.5, 31.4, 4.4, 51.9, "SUE")  # 上海 → 鹿特丹，走苏伊士
pq.via_codes   # ['CGH', 'CHC', 'DIR', 'PMP', 'SGP', 'SUE']
```

- 无匹配条目（zone 组合或 via 不在表内）返回 `None`
- `via` 大小写不敏感；via 码含义（PASS_VIA 枚举）：DIR 直航 / SUE 苏伊士运河 / PAN(PMP) 巴拿马运河 / CGH 好望角 / CHC(CHO) 合恩角 / SGP 新加坡 
