为天地图 JavaScript API v4.0 提供 TypeScript 类型支持 —— tianditu-v4-types 正式发布！

如果你正在使用 天地图（Tianditu）JavaScript API v4.0 开发 Web 地图应用，并且希望获得更好的开发体验（比如自动补全、类型检查、减少运行时错误），那么你一定会喜欢这个新工具包 👉 tianditu-v4-types

简介

tianditu-v4-types 是一个 纯 TypeScript 类型定义包 ，专为 天地图官方 JavaScript API v4.0 设计。它完整覆盖了天地图 API 中的核心类、方法、事件和配置项，包括但不限于：

• T.Map：地图实例
• T.LngLat：经纬度坐标
• T.Marker / T.Polyline / T.Polygon：覆盖物
• T.InfoWindow：信息窗口
• T.TileLayer / T.MapType：图层与底图类型
• 事件监听器（如 click, zoomend 等）
• 地理编码、行政区划查询等高级功能的回调结构

✅ 无需修改原有代码，只需安装类型包，即可在 TypeScript 项目中享受完整的类型提示！

快速开始

npm install tianditu-v4-types --save-dev

or

pnpm add tianditu-v4-types -D

为什么需要它？

天地图官方 API 虽然功能强大，但仅提供 无类型的 JavaScript 库，在现代前端工程化开发中存在以下痛点：

• ❌ 没有类型提示，开发效率低
• ❌ 容易拼错方法名或传错参数
• ❌ 团队协作时缺乏接口契约

而 tianditu-v4-types 正是为解决这些问题而生------零运行时开销，纯开发期增强！

🌟 特点

• ✅ 100% 覆盖天地图 JS API v4.0 官方文档
• ✅ 支持主流框架（Vue、React、Angular、原生 TS）
• ✅ 严格遵循 TypeScript 最佳实践
• ✅ 开源免费，MIT 协议
• ✅ 持续维护，欢迎 PR 和 Issue！

🔗 资源链接

• 📦 NPM : www.npmjs.com/package/tia...
• 📁 GitHub : tianditu-v4-types: 天地图v4版本typescript 类型文件
• 📚 天地图官方文档 : 天地图API