@caoguo/maplibre-ai 0.0.2 → 0.0.4

package/dist/geoai/index.d.cts

@@ -0,0 +1,212 @@
+/**
+ * GeoAI 中文地址解析（PRD phase-0 §5.6 G-2）
+ *
+ * 将非标准中文地址（含口语化、简称）解析为标准化结构：
+ *   province / city / district / street / poi / number
+ *
+ * 采用「词典匹配 + 规则」的传统 NLP 方案（不依赖大模型），保证速度与可控性。
+ */
+interface ParsedAddress {
+    /** 原始输入 */
+    raw: string;
+    /** 省 */
+    province?: string;
+    /** 市 */
+    city?: string;
+    /** 区/县 */
+    district?: string;
+    /** 街道/路/道 */
+    street?: string;
+    /** 门牌号 */
+    number?: string;
+    /** 地标/POI（如"光谷""汉口火车站"） */
+    poi?: string;
+    /** 标准化地址（可读拼接） */
+    normalized: string;
+    /** 解析置信度 0-1 */
+    confidence: number;
+}
+/**
+ * 解析中文地址。
+ *
+ * 覆盖：
+ * - 完整地址："湖北省武汉市洪山区光谷大道 1 号"
+ * - 简称："武汉光谷"、"洪山区"
+ * - 口语化："光谷那边"、"汉口火车站附近"
+ */
+declare function parseAddress(raw: string): ParsedAddress;
+/** 判断是否为有效地址（至少命中省/市/区/POI 之一） */
+declare function isValidAddress(parsed: ParsedAddress): boolean;
+
+/**
+ * GeoAI 表头自动识别（PRD phase-0 §5.6 G-1）
+ *
+ * 从 CSV/Excel 表头中自动识别：
+ *   - 地址列（addressCol）
+ *   - 名称列（nameCol）
+ *   - 分类列（categoryCol）
+ *   - 经度列（lngCol）/ 纬度列（latCol）
+ *
+ * 采用「列名语义 + 正则匹配」方案，命中率目标 ≥ 90%。
+ */
+interface HeaderDetection {
+    /** 地址列索引（-1 表示未识别） */
+    addressCol: number;
+    /** 名称列索引 */
+    nameCol: number;
+    /** 分类列索引 */
+    categoryCol: number;
+    /** 经度列索引 */
+    lngCol: number;
+    /** 纬度列索引 */
+    latCol: number;
+    /** 识别详情（供上层展示/纠错） */
+    detail: Record<string, string>;
+}
+/**
+ * 识别表头。
+ * @param headers 表头数组（CSV 首行 / Excel 首行）
+ */
+declare function detectHeaders(headers: string[]): HeaderDetection;
+
+/**
+ * GeoAI 坐标系判断（PRD phase-0 §5.6 G-3）
+ *
+ * 判断数据坐标所属坐标系：WGS84 / GCJ-02 / CGCS2000。
+ *
+ * 说明：单点无法 100% 判定坐标系（GCJ-02 偏移仅数百米），
+ * 本模块采用「范围校验 + 数据来源推断 + 中国境外判定」的组合启发式，
+ * 并提供 GCJ-02 ↔ WGS84 双向纠偏转换。
+ */
+type DetectedCRS = 'wgs84' | 'gcj02' | 'cgcs2000' | 'unknown';
+/** 中国经纬度范围（粗判） */
+declare const CHINA_BOUNDS: {
+    lngMin: number;
+    lngMax: number;
+    latMin: number;
+    latMax: number;
+};
+/** WGS84 → GCJ-02（加密偏移） */
+declare function wgs84ToGcj02(lng: number, lat: number): [number, number];
+/** GCJ-02 → WGS84（纠偏，迭代逼近） */
+declare function gcj02ToWgs84(lng: number, lat: number): [number, number];
+/** 坐标是否在中国境内 */
+declare function isInChina(lng: number, lat: number): boolean;
+/**
+ * 判断坐标系。
+ * @param source 数据来源标注（如 '高德' / '腾讯' / '天地图' / 'GPS' / undefined）
+ * @param sample 抽样坐标对
+ */
+declare function detectCRS(source: string | undefined, sample?: Array<[number, number]>): DetectedCRS;
+
+/**
+ * GeoAI 批量地理编码（PRD phase-0 §5.6 G-4）
+ *
+ * 将解析后的中文地址编码为坐标 [lng, lat]。
+ * v1 使用「本地坐标库 + 模糊匹配」（离线、不依赖天地图/高德 API），
+ * 命中率目标：标准地址 ≥ 90%，口语化地址 ≥ 60%。
+ */
+
+/** 本地地理坐标库：地名 → [lng, lat]（WGS84） */
+declare const LOCAL_GEO_DB: Record<string, [number, number]>;
+interface GeocodeResult {
+    lng: number;
+    lat: number;
+    /** 匹配到的地名 */
+    matched: string;
+    /** 置信度 0-1 */
+    confidence: number;
+}
+/**
+ * 地理编码：地址 → 坐标。
+ *
+ * 匹配优先级：
+ *  1. POI（最精确）
+ *  2. 区/县
+ *  3. 城市
+ *  4. 省（降级）
+ *
+ * 无法匹配返回 null。
+ */
+declare function geocode(parsed: ParsedAddress): GeocodeResult | null;
+/** 查询本地库是否存在某地名 */
+declare function hasLocalGeo(name: string): boolean;
+interface BatchGeocodeInput {
+    /** 原始地址字符串 */
+    address: string;
+    /** 已有经度（可选，优先级最高） */
+    lng?: number;
+    /** 已有纬度（可选） */
+    lat?: number;
+}
+interface BatchGeocodeOutput {
+    lng: number;
+    lat: number;
+    /** 坐标来源：'provided' | 'geocoded' | 'failed' */
+    source: 'provided' | 'geocoded' | 'failed';
+    matched?: string;
+    confidence: number;
+}
+/**
+ * 批量地理编码：对一批记录并行编码。
+ *
+ * 优先级：已有经纬度 > 地址解析 + 本地库编码。
+ */
+declare function batchGeocode(rows: BatchGeocodeInput[], parse: (raw: string) => ParsedAddress): BatchGeocodeOutput[];
+
+/**
+ * GeoAI 数据入图主入口（PRD phase-0 §5.6）
+ *
+ * 完整管线：
+ *   CSV/Excel 表头 → 表头识别 → 逐行地址解析 → 地理编码 / 坐标纠偏 → GeoJSON
+ *
+ * 用法：
+ *   const result = importToGeoJSON(headers, rows);
+ *   result.features  // GeoJSON FeatureCollection
+ *   result.stats     // 命中率 / 编码耗时等
+ */
+
+interface ImportedFeature {
+    type: 'Feature';
+    geometry: {
+        type: 'Point';
+        coordinates: [number, number];
+    } | {
+        type: 'Point';
+        coordinates: [];
+    };
+    properties: Record<string, unknown>;
+}
+interface ImportStats {
+    /** 总记录数 */
+    total: number;
+    /** 成功编码数 */
+    success: number;
+    /** 失败数 */
+    failed: number;
+    /** 成功率 0-1 */
+    successRate: number;
+    /** 识别出的表头 */
+    headers: HeaderDetection;
+    /** 编码耗时（ms） */
+    durationMs: number;
+}
+interface ImportResult {
+    type: 'FeatureCollection';
+    features: ImportedFeature[];
+    stats: ImportStats;
+}
+interface ImportOptions {
+    /** 数据来源标注（用于坐标系判断，如 '高德'/'GPS'） */
+    source?: string;
+    /** 自定义地址解析函数（默认内置 parseAddress） */
+    parse?: (raw: string) => ParsedAddress;
+}
+/**
+ * 表格式数据 → GeoJSON。
+ * @param headers 表头数组
+ * @param rows 数据行（二维数组，与 headers 对齐）
+ */
+declare function importToGeoJSON(headers: string[], rows: Array<Array<string | number>>, opts?: ImportOptions): ImportResult;
+
+export { type BatchGeocodeInput, type BatchGeocodeOutput, CHINA_BOUNDS, type DetectedCRS, type GeocodeResult, type HeaderDetection, type ImportOptions, type ImportResult, type ImportStats, type ImportedFeature, LOCAL_GEO_DB, type ParsedAddress, batchGeocode, detectCRS, detectHeaders, gcj02ToWgs84, geocode, hasLocalGeo, importToGeoJSON, isInChina, isValidAddress, parseAddress, wgs84ToGcj02 };

package/dist/geoai/index.d.ts

@@ -0,0 +1,212 @@
+/**
+ * GeoAI 中文地址解析（PRD phase-0 §5.6 G-2）
+ *
+ * 将非标准中文地址（含口语化、简称）解析为标准化结构：
+ *   province / city / district / street / poi / number
+ *
+ * 采用「词典匹配 + 规则」的传统 NLP 方案（不依赖大模型），保证速度与可控性。
+ */
+interface ParsedAddress {
+    /** 原始输入 */
+    raw: string;
+    /** 省 */
+    province?: string;
+    /** 市 */
+    city?: string;
+    /** 区/县 */
+    district?: string;
+    /** 街道/路/道 */
+    street?: string;
+    /** 门牌号 */
+    number?: string;
+    /** 地标/POI（如"光谷""汉口火车站"） */
+    poi?: string;
+    /** 标准化地址（可读拼接） */
+    normalized: string;
+    /** 解析置信度 0-1 */
+    confidence: number;
+}
+/**
+ * 解析中文地址。
+ *
+ * 覆盖：
+ * - 完整地址："湖北省武汉市洪山区光谷大道 1 号"
+ * - 简称："武汉光谷"、"洪山区"
+ * - 口语化："光谷那边"、"汉口火车站附近"
+ */
+declare function parseAddress(raw: string): ParsedAddress;
+/** 判断是否为有效地址（至少命中省/市/区/POI 之一） */
+declare function isValidAddress(parsed: ParsedAddress): boolean;
+
+/**
+ * GeoAI 表头自动识别（PRD phase-0 §5.6 G-1）
+ *
+ * 从 CSV/Excel 表头中自动识别：
+ *   - 地址列（addressCol）
+ *   - 名称列（nameCol）
+ *   - 分类列（categoryCol）
+ *   - 经度列（lngCol）/ 纬度列（latCol）
+ *
+ * 采用「列名语义 + 正则匹配」方案，命中率目标 ≥ 90%。
+ */
+interface HeaderDetection {
+    /** 地址列索引（-1 表示未识别） */
+    addressCol: number;
+    /** 名称列索引 */
+    nameCol: number;
+    /** 分类列索引 */
+    categoryCol: number;
+    /** 经度列索引 */
+    lngCol: number;
+    /** 纬度列索引 */
+    latCol: number;
+    /** 识别详情（供上层展示/纠错） */
+    detail: Record<string, string>;
+}
+/**
+ * 识别表头。
+ * @param headers 表头数组（CSV 首行 / Excel 首行）
+ */
+declare function detectHeaders(headers: string[]): HeaderDetection;
+
+/**
+ * GeoAI 坐标系判断（PRD phase-0 §5.6 G-3）
+ *
+ * 判断数据坐标所属坐标系：WGS84 / GCJ-02 / CGCS2000。
+ *
+ * 说明：单点无法 100% 判定坐标系（GCJ-02 偏移仅数百米），
+ * 本模块采用「范围校验 + 数据来源推断 + 中国境外判定」的组合启发式，
+ * 并提供 GCJ-02 ↔ WGS84 双向纠偏转换。
+ */
+type DetectedCRS = 'wgs84' | 'gcj02' | 'cgcs2000' | 'unknown';
+/** 中国经纬度范围（粗判） */
+declare const CHINA_BOUNDS: {
+    lngMin: number;
+    lngMax: number;
+    latMin: number;
+    latMax: number;
+};
+/** WGS84 → GCJ-02（加密偏移） */
+declare function wgs84ToGcj02(lng: number, lat: number): [number, number];
+/** GCJ-02 → WGS84（纠偏，迭代逼近） */
+declare function gcj02ToWgs84(lng: number, lat: number): [number, number];
+/** 坐标是否在中国境内 */
+declare function isInChina(lng: number, lat: number): boolean;
+/**
+ * 判断坐标系。
+ * @param source 数据来源标注（如 '高德' / '腾讯' / '天地图' / 'GPS' / undefined）
+ * @param sample 抽样坐标对
+ */
+declare function detectCRS(source: string | undefined, sample?: Array<[number, number]>): DetectedCRS;
+
+/**
+ * GeoAI 批量地理编码（PRD phase-0 §5.6 G-4）
+ *
+ * 将解析后的中文地址编码为坐标 [lng, lat]。
+ * v1 使用「本地坐标库 + 模糊匹配」（离线、不依赖天地图/高德 API），
+ * 命中率目标：标准地址 ≥ 90%，口语化地址 ≥ 60%。
+ */
+
+/** 本地地理坐标库：地名 → [lng, lat]（WGS84） */
+declare const LOCAL_GEO_DB: Record<string, [number, number]>;
+interface GeocodeResult {
+    lng: number;
+    lat: number;
+    /** 匹配到的地名 */
+    matched: string;
+    /** 置信度 0-1 */
+    confidence: number;
+}
+/**
+ * 地理编码：地址 → 坐标。
+ *
+ * 匹配优先级：
+ *  1. POI（最精确）
+ *  2. 区/县
+ *  3. 城市
+ *  4. 省（降级）
+ *
+ * 无法匹配返回 null。
+ */
+declare function geocode(parsed: ParsedAddress): GeocodeResult | null;
+/** 查询本地库是否存在某地名 */
+declare function hasLocalGeo(name: string): boolean;
+interface BatchGeocodeInput {
+    /** 原始地址字符串 */
+    address: string;
+    /** 已有经度（可选，优先级最高） */
+    lng?: number;
+    /** 已有纬度（可选） */
+    lat?: number;
+}
+interface BatchGeocodeOutput {
+    lng: number;
+    lat: number;
+    /** 坐标来源：'provided' | 'geocoded' | 'failed' */
+    source: 'provided' | 'geocoded' | 'failed';
+    matched?: string;
+    confidence: number;
+}
+/**
+ * 批量地理编码：对一批记录并行编码。
+ *
+ * 优先级：已有经纬度 > 地址解析 + 本地库编码。
+ */
+declare function batchGeocode(rows: BatchGeocodeInput[], parse: (raw: string) => ParsedAddress): BatchGeocodeOutput[];
+
+/**
+ * GeoAI 数据入图主入口（PRD phase-0 §5.6）
+ *
+ * 完整管线：
+ *   CSV/Excel 表头 → 表头识别 → 逐行地址解析 → 地理编码 / 坐标纠偏 → GeoJSON
+ *
+ * 用法：
+ *   const result = importToGeoJSON(headers, rows);
+ *   result.features  // GeoJSON FeatureCollection
+ *   result.stats     // 命中率 / 编码耗时等
+ */
+
+interface ImportedFeature {
+    type: 'Feature';
+    geometry: {
+        type: 'Point';
+        coordinates: [number, number];
+    } | {
+        type: 'Point';
+        coordinates: [];
+    };
+    properties: Record<string, unknown>;
+}
+interface ImportStats {
+    /** 总记录数 */
+    total: number;
+    /** 成功编码数 */
+    success: number;
+    /** 失败数 */
+    failed: number;
+    /** 成功率 0-1 */
+    successRate: number;
+    /** 识别出的表头 */
+    headers: HeaderDetection;
+    /** 编码耗时（ms） */
+    durationMs: number;
+}
+interface ImportResult {
+    type: 'FeatureCollection';
+    features: ImportedFeature[];
+    stats: ImportStats;
+}
+interface ImportOptions {
+    /** 数据来源标注（用于坐标系判断，如 '高德'/'GPS'） */
+    source?: string;
+    /** 自定义地址解析函数（默认内置 parseAddress） */
+    parse?: (raw: string) => ParsedAddress;
+}
+/**
+ * 表格式数据 → GeoJSON。
+ * @param headers 表头数组
+ * @param rows 数据行（二维数组，与 headers 对齐）
+ */
+declare function importToGeoJSON(headers: string[], rows: Array<Array<string | number>>, opts?: ImportOptions): ImportResult;
+
+export { type BatchGeocodeInput, type BatchGeocodeOutput, CHINA_BOUNDS, type DetectedCRS, type GeocodeResult, type HeaderDetection, type ImportOptions, type ImportResult, type ImportStats, type ImportedFeature, LOCAL_GEO_DB, type ParsedAddress, batchGeocode, detectCRS, detectHeaders, gcj02ToWgs84, geocode, hasLocalGeo, importToGeoJSON, isInChina, isValidAddress, parseAddress, wgs84ToGcj02 };

package/dist/geoai/index.js

@@ -0,0 +1,3 @@
+export { CHINA_BOUNDS, LOCAL_GEO_DB, batchGeocode, detectCRS, detectHeaders, gcj02ToWgs84, geocode, hasLocalGeo, importToGeoJSON, isInChina, isValidAddress, parseAddress, wgs84ToGcj02 } from '../chunk-HF3HJPXD.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/geoai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}