Maplat
关于Maplat
Maplat是一个很酷的历史地图/插图地图查看器。 它可以用非线性但同胚的方式变换每个映射的坐标 投影，它可以让地图与GPS和精确地图协作，而不需要 扭曲原始地图图像。 配套的数据编辑器作为另一个项目提供， MaplatEditor. 该项目获得特等奖/教育效果奖/参观奖 国土资源部地质活动竞赛2018优秀奖； 基础设施、交通和旅游。
Maplat是在Apache许可证2.0下开源的（从0.12.2版本开始）。
关键特性
- 具有非线性但同胚坐标变换的历史地图/图解地图查看器
- GPS /精确地图协作，不扭曲原始地图图像
- 可插入的基础地图（基于openlayers；矢量贴图可选Mapbox GL JS / mapplibre GL JS）
- PWA-ready应用程序shell （manifest、Service Worker、share、URL state）
- 查看器UI支持11种语言：英语、日语、德语、西班牙语、 法语、印尼语、韩语、泰语、越南语、中文（简体）和 中文(繁体)
- 开源（Apache 2.0从0.12.2版本开始），带有配套的桌面编辑器（MaplatEditor）
快速入门
当前版本:
1.2.0． 这个街区是唯一一个 这个存储库携带一个发布版本（ADR-0012）；外面的一切都是 针对1.0版本编写的。 npm:@maplat/ui
安装
# pnpm (recommended)
pnpm add @maplat/ui
# npm
npm install @maplat/ui
最小的使用
import { MaplatUi } from '@maplat/ui';
import '@maplat/ui/dist/maplat_ui.css'; // Import styles
const option = {
appid: 'myMark',
// ...
};
MaplatUi.createObject(option).then(app => {
// Application initialized
});
CDN (jsDelivr)
要在浏览器中直接使用而不需要绑定器，你必须加载OpenLayers 加载mapplat UI之前。Maplat Core是捆绑的，所以你不需要加载它 分开。
<!-- OpenLayers -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/ol@10/ol.min.css">
<script src="https://cdn.jsdelivr.net/npm/ol@10/dist/ol.min.js"></script>
<!-- Maplat UI -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@maplat/[email protected]/dist/maplat_ui.css">
<script src="https://cdn.jsdelivr.net/npm/@maplat/[email protected]/dist/maplat_ui.umd.js"></script>
<div id="map_div"></div>
<script>
var appOption = {
appid: "tm",
// ... options
};
MaplatUi.createObject(appOption).then(function(app) {
console.log("Maplat initialized");
});
</script>
注意：请确保使用最新的兼容版本。
POI规格(setting.pois）
mapplat UI传递 pois 一个应用程序/地图设置的字段直接到
MaplatApp.createObject，所以这里接受MaplatCore接受的所有表单
不变。指向POI数据的常用方法有：
- URL字符串 - - - - - -
"pois/landmarks.geojson"，初始化时获取 - Map-embedded POI -内联
FeatureCollection直接写在 设置 - Layer ref （wrapper） - - - - - -
{ layer: <URL|FeatureCollection>, hide?, title?, icon?, selectedIcon? }，它引用一个层并只覆盖它的 此应用程序的演示文稿，而无需编辑引用的文件
可接受表单的完整列表、重写优先级和用于的规则
未知密钥在mapplatcore中记录一次；看到
POI规格(setting.pois）
在mapplatcore README中。
生命周期
- 看到 文档/ ui-core-lifecycle.md 生命周期阶段和uihook。
API参考
- API签名 (release-dependent):明白了
docs/api/ - 概念性指南 （release-independent）：参见 Wiki api参考
开发
设置
克隆存储库并安装依赖项。
git clone https://github.com/code4history/Maplat.git
cd Maplat
pnpm install
开发服务器
使用热重新加载启动开发服务器。
pnpm dev
访问 http://localhost:5173/ 在浏览器中。
构建
pnpm build # Build npm package (dist/)
pnpm build:demo # Build demo application (dist-demo/)
测试
pnpm test # Run tests (Vitest)
pnpm typecheck # Run type checks (TypeScript)
pnpm lint # Run linter and formatter (ESLint/Prettier)
先决条件
源自
engines场package.json(adr - 0012: release-dependent)。
- Node.js: v20或v22（通过GitHub Actions进行LTS测试）
- 规划:
>=9.0.0(要求;package.json实施规划)
同行依赖性
mapplat UI依赖于以下库作为对等依赖项。你必须 手动安装。
- OpenLayers (
ol） - - - - - -^9.0.0 || ^10.0.0(Maplat的对等依赖@maplat/ui和MaplatCore@maplat/core）
pnpm add ol
如果你使用矢量贴图，你可能还需要Mapbox GL JS或mapplibre GL JS：
mapbox-gl：^2.0.0 || ^3.0.0maplibre-gl：^5.0.0 || ^6.0.0
生态系统
Maplat是Maplat生态系统的一部分 历史代码. 查看完整的生态系统地图（8个存储库+产品/企业网站）：
📖 生态系统图 - - - - - - (该图目前保存在一个私人规划中 库;下面的姊妹存储库表是公共替代品)
妹妹存储库
| 存储库 | 许可证 | npm | 角色 |
|---|---|---|---|
| Maplat | Apache 2.0 | @maplat/ui | 主要查看器 |
| MaplatCore | Apache 2.0 | @maplat/core | 核心库 |
| MaplatTin | Apache 2.0 | @maplat/tin | 锡转换 |
| MaplatTransform | Apache 2.0 | @maplat/transform | 坐标变换 |
| MaplatEditor | Apache 2.0 | - - - - - - | 数据创作工具（桌面） |
| 楚辞 | 麻省理工学院 | @c4h/chuci | 多媒体滑动器和查看器Web组件 |
| 屈原 | 麻省理工学院 | @c4h/quyuan | GeoJSON模板引擎+多媒体浏览器Web组件 |
| Weiwudi | 麻省理工学院 | @c4h/weiwudi | Service Worker用于tile缓存 |
mapplateditor是用于创建地图和poi的数据创作工具 上面的观众渲染。Maplat生态系统是端到端的： 作者与mapplateditor，服务于任何查看器库。
链接
| 观众 | 链接 | 目的 |
|---|---|---|
| 项目信息/功能/案例 | https://www.maplat.jp/en/ | 产品网站 |
| 赞助商/业务查询 | https://www.nayuta-inc.co.jp/en/ | 公司网站（Nayuta, Inc.） |
ADR-0013: apache许可的存储库（这个）链接到两个站点。 麻省理工学院授权的姊妹reppos （Weiwudi / Quyuan / chui）没有Nayuta链接。
许可证
Apache License 2.0 -参见 许可证.
Copyright 2019-2026 Kohei Otsuka, Code for History / Nayuta, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
专利的通知： Maplat坐标变换技术获得专利 日本（专利号：6684776）。
过去的版本： 0.12.2之前的版本在 Maplat有限许可1.1。license恢复到Apache 2.0需要 1.0.0-rc1版本生效。早期版本可在npmjs.com上获得 保持在原始的有限许可条款下。
贡献者
这个项目的存在要感谢所有做出贡献的人。
赞助商
支持Maplat
感谢我们所有的支持者！🙏[成为支持者］
通过成为赞助者来支持这个项目。您的标志将显示在这里与链接到您的网站。［成为赞助商］