快速开始
本章介绍如何基于 EvoMap API 进行地图应用的开发,以一个简单的示例助您快速了解 EvoMap JS API 的基本使用。
Hello,EvoMap!
下面我们分步骤介绍如何快捷地开始地图开发:
准备页面
我们建议使用最新的符合 HTML5 规范的文档声明:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="initial-scale=1,maximum-scale=1,user-scalable=no" />
<title>基础地图展示</title>
</head>
<body></body>
</html>
加载 API 文件
引入方式一:
<link rel="stylesheet" href="evomap.css" />
<script src="evomap-depends.js"></script>
<script src="evomap.js"></script>
引入方式二:
<script type="text/javascript">
document.write("<link href='evomap.css' rel='stylesheet'/>");
document.write("<script type='text/javascript' src='evomap-depends.js'></script>");
document.write("<script type='text/javascript' src='evomap.js'></script>");
</script>
准备地图容器
地图需要一个 HTML 元素作为容器,这样才能展现到页面上。这里我们创建了一个 div 元素:
<div id="map"></div>
指定地图容器大小
必须要给地图容器指定大小,否则地图无法正常创建:
html,
body,
#map {
width: 100%;
height: 100%;
margin: 0;
padding: 0;
}
地图初始化
地图初始化时需要设置地图容器ID、地图中心点、地图级别等参数值,否则地图无法展示:
let map = new EM.Map("map", {
center: EM.lonLat(116.46, 39.92), //地图中心点
zoom: 10, //地图默认缩放等级
pitch: 0, //地图俯仰角度
roll: 0, //地图与正北方向的夹角
maxZoom: 17, //地图最大缩放等级
minZoom: 3 //地图最小缩放等级
});
地图配置与操作
一般情况下,我们会给地图按需设定中心点坐标、地图视角等属性,可以通过两种方式实现:
第一种方式,地图初始化时设置相应参数。
let map = new EM.Map("map", {
center: EM.lonLat(116.46, 39.92), //地图中心点
zoom: 10, //地图默认缩放等级
pitch: 0, //地图俯仰角度
roll: 0, //地图与正北方向的夹角
maxZoom: 17, //地图最大缩放等级
minZoom: 3 //地图最小缩放等级
});
第二种方式,地图初始化之后通过相应的 API 改变参数。
map.setView({
center: EM.lonLat(116.46, 39.92),
zoom: 10,
pitch: 0,
roll: 0,
});
同时还可以添加一些地图控件,比如指北针控件、鼠标提示控件等:
//指北针控件
let compass = new EM.control.Compass();
map.addControl(compass);
//二三维切换控件
let switchBar = new EM.control.MapSwitch();
map.addControl(switchBar);