我们在一些WEB项目中需要应用简单的地图,而且最好是可以自定义标注地点,最好是可以从本地数据库中读取并在地图上展示地点,那么谷歌地图插件Mapsed.js是比较好的选择,使用起来简单,无需注册地图接口之类的复杂过程,就能轻松的在网页上展示地图效果。
Mappy.js 是一款基于jQuery的地图插件,我们来看下如何使用它。
首先需要将必要的js和css文件加载到html页面,当然这些文件在我们提供的下载包里已经打包好,请放心下载使用。
<script src="com/maps/api/js?libraries=places&sensor=false"></script>
<script src="jquery-1.10.2.js"></script>
<script src="mapsed.js"></script>
<link href="mapsed.css" rel="stylesheet">
首先我们要在html中放置一个div用作地图容器,我们可以在css中定义容器的高度和宽度。
<div id="custom_places" class="maps"></div>
现在需要调用google地图,并且把具体的地点位置也显示在地图上面,mapsed.js提供了很多接口。showOnLoad:即加载显示数据,json格式,我们可以从数据库中读取然后通过程序转换成json格式即可,本文不涉及数据库,有兴趣的朋友可以自己动手试下。参数autoShow:是否自动显示,lat:纬度,lng:经度,name:名称,street:街区说明信息,userData:数据id。
$(function(){
$("#custom_places").mapsed({
showOnLoad:
[
{
autoShow: true,
lat: 22.540053,
lng: 113.983225,
name: "欢乐谷",
street: "参与性、观赏性、娱乐性、趣味性现代主题乐园。",
userData: 1
},
{
autoShow: true,
lat: 22.536113,
lng: 113.972569,
name: "世界之窗",
street: "荟萃世界几千年人类文明精华,历史遗迹、名胜、自然风光、世界奇观!",
userData: 2
},
{
autoShow: true,
//canEdit: false,
lat: 22.530041,
lng: 113.982479,
name: "锦绣中华民俗文化村",
street: "邀你遨游最美赛花节!",
userData: 3
}
]
});
});
加载地图后,我们想在地图中标注地点,只需要在地图右上角点击+号,然后定位移动地图中的气泡锚点,点击可以弹出表单输入,输入信息后即可保存,当然你可以通过接口将数据写入数据库中。
<div id="add_places" class="maps"></div>
将allowAdd设置为true即允许添加标注地点,这时地图右上角会出现一个+号。onSave回调函数即点击保存时需要做的事情。
$(function(){
$("#add_places").mapsed({
allowAdd: true,
onSave: function(m, newPlace) {
var missing = [];
// detect errors starting at bottom
// ... we only have space for one error at a time, so this way we'll report
// ... from the top down
if (newPlace.postCode === "") missing.push("postcode");
if (newPlace.street === "") missing.push("street");
if (newPlace.name === "") missing.push("name");
// anything missing?
if (missing.length > 0) {
// return the error message so the callback doesn't progress
return "Required: " + missing.join();
}
if (newPlace) {
if (newPlace.markerType == "new") {
// simulate a primary key being save to a db
newPlace.userData = parseInt(Math.random() * 100000);
var n_name = newPlace.name;
var n_street = newPlace.street;
var n_postCode = newPlace.postCode;
$.post('do.php',{name:n_name,street:n_street,postcode:n_postCode},function(msg){
alert(msg);
});
}
}
// indicate form was OK and saved
return "";
},
showOnLoad: [
{
autoShow: false,
//canEdit: false,,
lat: 22.530041,
lng: 113.982479
}
]
});
});
地图搜索功能当然是必不可少的,在你的地图中加入一个搜索条那是相当酷的。
<div id="search_places" class="maps"></div>
searchOptions可以设置搜索的相关参数,其中enabled是开启搜索条,initSearch是初始搜索内容,placeholder是如果未设置初始内容,则显示placeholder内容。
$(function(){
$("#search_places").mapsed({
searchOptions: {
enabled: true,
initSearch: "深圳世界之窗",
placeholder: "搜索 ..."
}
});
});
mapsed.js还提供了很多google地图相关的功能和接口,本文只做简单介绍,如果你觉得mapsed.js对你的项目有用,并且打算使用它,那么请移步官方教程:https://github.com/toepoke/mapsed/blob/master/README.md