# @facilitronworks/react-native-windows-maps 中文文档

规范地址：https://npmcn.com/package/%40facilitronworks/react-native-windows-maps/

版本：0\.1\.0-pre\.0
npm 元数据更新时间：2026-08-24T21:29:01.737Z
中文译文更新时间：2026-11-14T08:18:13.293Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40facilitronworks/react-native-windows-maps
原文对照：https://npmcn.com/package/%40facilitronworks/react-native-windows-maps/?lang=original
项目主页：https://github.com/FacilitronWorks/react-native-windows-maps#readme
源码仓库：https://github.com/FacilitronWorks/react-native-windows-maps

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：23.7 kB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：maplibre-gl ^4\.7\.1
- 首次发布：2026-08-24T21:29:01.106Z
- 最新版本发布：2026-08-24T21:29:01.468Z
- 近 30 天下载量：4244（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

反应-本土-窗口地图的应用-不可知半:Web Mercator投影数学,以及一个在WebView2岛内制作的maplibre-gl页面的构建器. 零运行时间依赖关系.

## 安装

```sh
npm install @facilitronworks/react-native-windows-maps
```

也可以使用：`pnpm add @facilitronworks/react-native-windows-maps`、`yarn add @facilitronworks/react-native-windows-maps`、`bun add @facilitronworks/react-native-windows-maps`

## README

# @facilitronworks/ react-native-windows-maps (英语)

应用不可知半个 [反应-内生-窗口](https://github.com/microsoft/react-native-windows) 映射地平面: Web Mercator 投影数学, 以及用于映射- gl HTML 页面的构建器 在WebView2岛上.

**零运行时间依赖关系.** 这两个模块都是纯TypeScript,没有导入.

## 这不是什么

这个包是故意的 **没有** 船舶a `<MapView>` 组件或任何基图样式分辨率.

样式解析为 `EXPO_PUBLIC_*` 环境变量,以及 `babel-preset-expo` 仅内含 用于文件的文件 **外部** `node_modules`。生活在这一包中的解决方案者将默默读取 `''` 在每块建筑中: 地图会倒回原始的 OSM 瓦片, 深模切换会注入 字节相同的样式,无所事事,没有出错,也没有失败的测试. 主机应用程序拥有样式和 将解析的样式移入.

## 使用量

```ts
import {
  buildMapPage,
  projectToViewport,
  regionToZoom,
  viewportToRegion,
  type LatLng,
  type Region,
} from '@facilitronworks/react-native-windows-maps';
```

`buildMapPage(options)` 返回完整的 HTML 文档。 在注入的网络视频中渲染 `window.ReactNativeWebView.postMessage` **在此之前** 内容负载.

### 桥梁协议

页=主机,通过 `window.ReactNativeWebView.postMessage`数字 :

| 消息 | 含义 |
| --- | --- |
| `{type:'ready'}` | 已构建地图, 第一个样式已装入 |
| `{type:'viewport', center, zoom, css}` | 移动和调整大小 |
| `{type:'press', coordinate}` | 在地图表面单击 |
| `{type:'markerPress', id}` | 点击了页内标记元素 |
| `{type:'error', message}` | 脚本 / 样式 / 瓦片失败 |

主机 – 页面,通过 `injectJavaScript` 反对 `window.__worksMap`数字 :

| 调用 | 含义 |
| --- | --- |
| `setRegion({center, zoom}, durationMs)` | 相机移动( e)`0` = 跳动) |
| `setStyle(styleJsonOrUrl)` | 外观变化 |
| `setMarkers(list)` | 替换页内标记层 |

### 标记在页面上渲染,而不是在页面上

上面的WebView2岛复合材料 **全部** 反应内含物 界限,不论兄弟间命令或 `zIndex` (对照三个独立层进行核查) (战略) 因此,无法看到RN重叠。 主机仍然计算集群和拥有 每个处理器; 页面只画出它通过 `setMarkers` 和报道 回来 每个条目都是简单的数据—— `{id, latitude, longitude, kind:'cluster'|'pin', label, bg, fg, border, size}` ——由主办方主讲.

## maplibre-gl 被版本和SRI所粘住

页面从 unpkg 上装入 maplibre- gl 的版本 **财务报告和审定财务报表** 以 `sha384` 分资源完整性. `MAPLIBRE_JS_SRI` 编号 : `MAPLIBRE_CSS_SRI` 确切的艺术品的花序 `maplibre-gl@4.7.1`。 。 。 . 被篡改或被替换的文件失败检查, 脚本不执行, 页面报告 `{type:'error'}` 这样宿主就可以倒地了.

`maplibre-gl` 被宣布为 **可选同伴依赖** 所以一个不同版本的主机得到一个 安装时间信号。 如果碰到它,两个SRI常数必须在同一个变化中再生成,或者 地图上什么也没有.

## 平台

仅在 `windows` 平台,其中地铁重定向 `react-native` 改为 `react-native-windows`。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @facilitronworks/react-native-windows-maps 是什么？

反应-本土-窗口地图的应用-不可知半:Web Mercator投影数学,以及一个在WebView2岛内制作的maplibre-gl页面的构建器\. 零运行时间依赖关系\.

### 如何安装 @facilitronworks/react-native-windows-maps？

在项目目录运行 npm install @facilitronworks/react-native-windows-maps，或使用 pnpm add / yarn add / bun add。

### @facilitronworks/react-native-windows-maps 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @facilitronworks/react-native-windows-maps 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @facilitronworks/react-native-windows-maps 可以商用吗？

@facilitronworks/react-native-windows-maps 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @facilitronworks/react-native-windows-maps 的下载量有多少？

根据 npm 官方下载统计，@facilitronworks/react-native-windows-maps 在 2026/10/14 – 2026/11/12 这 30 天内被下载 4,244 次，日均约 141 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @facilitronworks/react-native-windows-maps 还在维护吗？

最新版本 0\.1\.0-pre\.0 发布于 2026/08/25（2 个月前）；至今共发布 1 个版本，其中过去 12 个月发布了 1 个；首次发布于 2026/08/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。