7 海图GIS平台开发 总览
适用版本：ElaneMap H5 API 3.5
适用读者：需要在自有系统中接入船讯网海图GIS平台的前端/全栈开发接入人员
官方示例：https://api.shipxy.com/h5s/api/3.5/demo/
一、平台简介
| 能力分类 | 主要内容 | 对应文档 |
|---|---|---|
| 地图基础 | 海图/谷歌/卫星图源、缩放、拖动、测距、鹰眼、坐标显示、比例尺 | 7.2 |
| 标注绘制 | 点、线、面标注，交互式绘制 | 7.2 |
| 船位服务 | 区域船、船队船（多船）、D+船、单船搜索/定位、筛选、选中事件 | 7.3 |
| 轨迹服务 | 轨迹查询、自定义轨迹、航速曲线、轨迹回放 | 7.4 |
| 业务图层 | 港口、浮标/航标、特殊区域、长江航道、经纬度网格、自定义瓦片、月更新海图 | 7.5 |
| 气象服务 | 气温、气压、风、浪、流、降雨、海区预报、台风、潮汐 | 7.5 |
| 航线与回放 | 航线绘制、区域船位回放、区域轨迹回放、船舶检索、历史航次 | 7.6 |
| 工程接入 | 原生HTML接入、Vue项目接入 | 7.7 |
| 安全实践 | API Key 保护、后端代理接入 | 7.8 |
二、文档目录与阅读路径
| 序号 | 文档 | 内容说明 |
|---|---|---|
| 7.0 | 总览与目录（本篇） | 平台简介、文档导航、阅读路径 |
| 7.1 | 快速入门：从注册到接入 | 注册与密钥申请、引入JS API、Hello World、常见问题 |
| 7.2 | 地图引擎基础：地图控制与业务绘制 | 地图初始化参数、内置控件、图源切换、点/线/面标注绘制 |
| 7.3 | 船位展示服务 | 区域船/船队船/单船搜索定位、筛选与事件、方法速查 |
| 7.4 | 历史轨迹服务 | 轨迹查询、自定义轨迹、航速曲线、轨迹回放 |
| 7.5 | 图层与气象服务 | 港口/航标/特殊区域/网格/自定义瓦片/月更新海图、全套气象图层 |
| 7.6 | 航线绘制与区域回放服务 | 航线绘制、区域船位回放、区域轨迹回放、船舶检索、历史航次 |
| 7.7 | Vue项目接入指南 | 老版本JS库在 Vue2/Vue3 工程中的集成方案 |
| 7.8 | API Key安全实践：后端代理接入 | 密钥泄露风险、域名绑定、后端代理与Nginx方案 |
| 7.9 | 坐标系转换指南 | 坐标系转换和代码应用示例 |
1.
2.
3.
4.
三、接入前置条件
1.
2.
3.
四、全局通用约定
1.
<script> 标签引入，全局命名空间为 ShipxyAPI，同时暴露 Leaflet 全局对象 L。引入时必须先引入平台提供的 jQuery，再通过 ?k=您的密钥 加载 API 主文件。2.
您的密钥 均需替换为实际申请到的 API Key。3.
[纬度, 经度] 顺序（与 Leaflet 一致）。4.
ShipxyAPI.ShipService(map, options) 创建后可通过 map.shipsService 访问，ShipxyAPI.TrackService(map) 创建后可通过 map.trackService 访问。5.
seachShipService、isVisiableWithNoSignal）。