百度地图API基本使用(一)

本文系作者 chaoCode原创,转载请私信并在文章开头附带作者和原文地址链接。

违者,作者保留追究权利。

前言

由于最近项目有需要,所以最近开始研究百度地图API的使用,简单的介绍一下百度地图JavaScript API它的使用,希望能够对小伙伴们有所帮助,后续有机会再做深入的研究。

有兴趣的小伙伴可以自行查找百度地图API

百度地图开放平台开发文档中的JavaScript API

准备工作

在使用百度地图之前,我们需要拥有一个自己的百度账号,申请注册成为百度开发者,然后我们需要创建一个浏览器端应用,就可以获取到一个唯一的服务秘钥(AK)

申请秘钥

申请秘钥(AK)

1. 首先我们在我的应用中,点击创建应用

image.png

2. 在创建应用的时候我们需要注意应用类型需要我们需要的类型,因为我的是web项目需要,所以这个应用类型我选择的是浏览器端,还有其他应用类型,根据自己的需要自行选择。还有就是这个Referer白名单的设置,根据自己的需求,按照下面的提示,自行配置,这里我为了方便是没有对任何域名做限制,使用的是*

image.png

3. 提交之后会在我的应用看到我们需要的秘钥(AK)

image.png

  • 到这里我们的准备工作已经完成了,此时我们已经有了属于自己专属的一个访问秘钥(AK),所以我们接下来就可以通过简单的一个html来使用到我们百度API,去看一看百度地图API的一些使用,废话不多说,我们开始。

百度地图的实现

1. 首先我们创建一个Hello.html文件

2. 在html中引用百度API(请将自己申请的秘钥(AK)填充一下)

<script type="text/javascript" src="//api.map.baidu.com/api?v=3.0&ak=您的密钥"></script>

3. 创建一个地图容器元素

<div id="container"></div>

4. 设置一下页面以及容器的一些样式

<style type="text/css"> 
html{height:100%} 
body{height:100%;margin:0px;padding:0px} 
#container{height:100%} 
</style> 

5. 创建一个地图实例

<script type="text/javascript">

// 创建地图实例 
var map = new BMap.Map("container");

// 创建点坐标 (北京天安门坐标)
var point = new BMap.Point(116.404, 39.915);

// 初始化地图,设置中心点坐标和地图级别 
map.centerAndZoom(point, 15);

</script> 

最终html中的内容如下:

<!DOCTYPE html> 
<html>
<head> 
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" /> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
<title>Hello, World</title> 
<style type="text/css"> 
html{height:100%} 
body{height:100%;margin:0px;padding:0px} 
#container{height:100%} 
</style> 
<script type="text/javascript" src="//api.map.baidu.com/api?v=3.0&ak=您的密钥"></script>
</head> 
  
<body> 
<div id="container"></div>
<script type="text/javascript">

// 创建地图实例 
var map = new BMap.Map("container");

// 创建点坐标 (北京天安门坐标)
var point = new BMap.Point(116.404, 39.915);

// 初始化地图,设置中心点坐标和地图级别 
map.centerAndZoom(point, 15);

</script> 
</body> 
</html>

6. 百度地图的简单实现

实现效果如下:可以进行移动和放大

image.png

百度地图API详解

1. 创建容器

根据id去获取对应的元素就是我们后续百度地图所要去填充的元素,其实创建容器的时候还有一个coordsType属性去控制坐标的类型,不过我们不配置的话一般都是默认配置为5也就是bd0ll坐标类型,感兴趣的小伙伴可以去看一看这些坐标类型都有哪些?可以来评论区交流学习

var map = new BMap.Map('container');

// coordsType指定输入输出的坐标类型,3为gcj02坐标,5为bd0ll坐标,默认为5。
// 指定完成后API将以指定的坐标类型处理您传入的坐标 
var map = new BMap.Map("container", {
       coordsType: 5 
}); 
 

2. 设置中心点

有两种设置中心点的方式,一种是通过上面那样根据经纬度去设置中心点坐标,第二种就是根据城市名作为中心点

Ps:map是我们的容器不要忘了

// 1.根据经纬度设置中心点
// 创建点坐标 (北京天安门坐标)
var point = new BMap.Point(116.404, 39.915);
map.centerAndZoom(point, 15);

// 2.根据城市设置
// 使用城市名称当做中间点
map.centerAndZoom('北京', 12);

3. 设置Zoom值

//Zoom值是控制地图放大和缩小的的一个范围,这个值我们是可以控制的

var map = new BMap.Map("mapContent",{minZoom:4,maxZoom:8}); map.centerAndZoom('北京', 15); 

4.开启鼠标滚轮缩放

// 默认的地图是只可以鼠标拖动的,鼠标滚轮不会修改Zoom值

map.enableScrollWheelZoom(true);

5.JSAPI商用授权挂件默认开启,关闭需要修改调用JSAPI的代码。方式有两种

1.初始化地图时,进行关闭配置

var map = new BMap.Map('container', {
    enableBizAuthLogo: false
});

2.使用地图的方法进行配置

var map = new BMap.Map('container');
map.disableBizAuthLogo(); //关闭
map.enableBizAuthLogo(); //开启

6.添加地图挂件

1.地图初始化

添加控件前,地图需要进行初始化。例如,要将标准地图控件添加到地图中,可在代码中添加如下内容:

var map = new BMap.Map("container");    
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11);    
map.addControl(new BMap.NavigationControl());

2.添加多个控件

在本例中我们向地图添加一个平移缩放控件、一个比例尺控件和一个缩略图控件。在地图中添加控件后,它们即刻生效。

map.addControl(new BMap.NavigationControl());    
map.addControl(new BMap.ScaleControl());    
map.addControl(new BMap.OverviewMapControl());    
map.addControl(new BMap.MapTypeControl());    
map.setCurrentCity("北京"); // 仅当设置城市信息时,MapTypeControl的切换功能才能可用   

image.png

初始化控件时,可提供一个可选参数,其中的anchor和offset属性共同控制控件在地图上的位置。 anchor表示控件的停靠位置,即控件停靠在地图的哪个角。当地图尺寸发生变化时,控件会根据停靠位置的不同来调整自己的位置。

var opts = {offset: new BMap.Size(150, 5)}
map.addControl(new BMap.ScaleControl(opts));

7.个性化地图

个性化地图样式编辑器

通过样式ID调用个性化地图样式(推荐)

1.创建个性化地图样式

进入地图开放平台控制台页面,在我的地图中,创建一个地图样式:

image.png
2.编辑样式

点击创建的地图样式,进入样式编辑器,根据您的需求自由编辑地图样式:
image.png
3.发布样式并获取样式ID

完成编辑后,在我的地图或者编辑器中发布该地图样式,获取发布后生成的样式ID:
image.png
4.在JavaScript API中应用地图样式

将第三步中获取的样式ID作为setMapStyleV2方法的参数。

相关代码如下:

map.setMapStyleV2({     
  styleId: '3d71dc5a4ce6222d3396801dee06622d'
});

注意:
1.使用个性化地图前,请参考Hello World构建基础地图;
2.setMapStyleV2方法需要在地图初始化(centerAndZoom)完成后执行;
3.样式更新不会改变样式ID。因此如果有更新样式的需求,重新编辑发布就可以完成更新。不需要修改JavaScript API调用代码;
4.如果样式ID在控制台中被删除,但JavaScript API还在继续调用。那么将会渲染默认样式的地图;

通过样式JSON调用个性化地图样式

1.获取样式JSON

前序流程和样式ID调用地图样式流程一致,进入我的地图,创建一个地图样式,进入编辑器编辑完成后,直接通过编辑器中的“下载JSON”功能获取JSON代码:

image.png

2.在JavaScript API中应用地图样式

将上一步中获取的样式JSON作为setMapStyleV2方法的参数。

相关代码如下:


var styleJson = [];

map.setMapStyleV2({styleJson:styleJson});

设置后地图效果如下:

image.png

上面这些都是一些简单的使用,后续我在使用的过程中遇到的一些问题以及解决过程,新的API的使用会持续更新分享,百度地图的API开发文档给的还是很全面的,不过就是目前他提供的都是一些在线开发,对于一些内网的公司就不太友好了,所以后续这块我需要去做一下离线开发的研究,等我把离线地图开发弄好之后,再给大家分享。

感谢诸君的观看,文中如有纰漏,欢迎在评论区来交流。如果这篇文章帮助到了你,欢迎点赞👍和关注。