GMap.NET 使用教程

GMap.NET是一个强大、免费、跨平台、开源的.NET控件,它在Windows Forms和WPF环境中能够通过Google, Yahoo!, Bing, OpenStreetMap, ArcGIS, Pergo, SigPac等实现路径规划、地理编码以及地图展示功能,并支持缓存和运行在Mobile环境中。
本文介绍了从下载安装到如何使用GMap.NET。

本文所使用的GMap.NET版本为1.7稳定版。

下载和安装

下载库文件安装

这里下载,解压后得到两个文件(GMap.NET.Core.dll 和 GMap.NET.WindowsForms.dll)。
然后在项目中添加引用。
添加引用
添加GMapControl到工具箱。在“选择项”时,选择“GMap.NET.WindowsForms.dll”文件即可添加。
添加GMapControl到工具箱

使用NuGet安装

使用NuGet安装

添加地图控件

拖拽GMapControl到Windows Form中,可看到控件中心有个小十字。查看属性,你会发现GMap.NET的一些特有属性。通过设置这些属性可以配置地图的行为,但是不能设置其内容。
创建地图

  • Bearing - 按照指定的度数向左旋转地图
  • CanDragMap – 是否启用鼠标右键拖动(平移)地图
  • EmptyTileColor – 设置没有数据的切片所显示的颜色
  • MarkersEnabled – 是否显示定义的标记,同PolygonsEnabled和RoutesEnabled
  • ShowTileGridLines – 显示网格线
  • Zoom,MinZoom和MaxZoom - 缩放级别

GMap.NET支持多种地图源,定义地图源需要在代码中去设置。可以在GMapControl的 Load 事件中添加如下代码:

1
2
3
4
5
6
this.gMapControl1.MapProvider = OpenStreet4UMapProvider.Instance; // 设置地图源
GMaps.Instance.Mode = AccessMode.ServerAndCache; // GMap工作模式
this.gMapControl1.SetPositionByKeywords("北京"); // 地图中心位置

//使用经纬度设置地图中心
//this.gMapControl1.Position = new GMap.NET.PointLatLng(39.923518, 116.539009);

① MapProvider:设置地图源,输入GMapProviders可以看到GMap所支持的所有地图源。
设置地图源
② GMaps.Instance.Mode: GMap可以从服务器、本地缓存、服务器或本地缓存获取数据。这适用于在应用程序中创建的所有GMap控件实例,只需要设置一次该值。
设置缓存模式
③ 设置地图中心位置可以使用关键字或者经纬度。
④ 地图显示结果。按住鼠标右键可以拖拽地图,当然也可以设置其他键来拖拽。

1
this.gMapControl1.DragButton = MouseButtons.Left;

简单的地图显示

添加标记

1
2
3
4
5
6
7
8
//创建一个名为“markers”的图层
GMapOverlay markers = new GMapOverlay("markers");
//创建标记,并设置位置及样式
GMapMarker marker = new GMarkerGoogle(new PointLatLng(39.923518, 116.539009), GMarkerGoogleType.blue_pushpin);
//将标记添加到图层
markers.Markers.Add(marker);
//将图层添加到地图
this.gMapControl1.Overlays.Add(markers);

① GMapOverlay:图层。添加的标记、图形、路径等都是在图层上操作的。
② GMapMarker:GMarkerGoogle,提供标记位置(PointLatLng)和标记样式。 它有两个重载,可以使用GMarkerGoogleType和位图。GMap.NET还提供了GMarkerCross,这是一个简单的十字,不允许使用图标。

1
2
public GMarkerGoogle(PointLatLng p, GMarkerGoogleType type);
public GMarkerGoogle(PointLatLng p, Bitmap Bitmap);

GMapMarker还可以设置ToolTip。

1
2
3
4
marker.ToolTipText = "我在这里";
marker.ToolTip.Fill = new SolidBrush(Color.FromArgb(100, Color.Black));
marker.ToolTip.Foreground = Brushes.White;
marker.ToolTip.TextPadding = new Size(20, 20);

③ 地图显示结果。(发现中心的小十字没了吗,因为这是可以设置的)
添加标记 添加标记(ToolTip)

1
this.gMapControl1.ShowCenter = false; //隐藏中心十字

④ 标记点击事件
标记本身没有任何事件钩子,GMapControl的OnMarkerClick事件即为标记点击事件。在下面的示例中,点击标记会弹出提示框显示ToolTip的文本内容。当然GMap.NET不只有点击事件,还有OnMarkerEnter、OnMarkerLeave。

1
2
3
4
private void gMapControl1_OnMarkerClick(GMapMarker item, MouseEventArgs e)
{
MessageBox.Show(String.Format("Marker:{0} 被点了。", item.ToolTipText));
}

添加多边形

添加多边形和添加标记的原理是一样的。

1
2
3
4
5
6
7
8
9
10
11
12
GMapOverlay polygons = new GMapOverlay("polygons");
// 多边形的顶点
List<PointLatLng> points = new List<PointLatLng>();
points.Add(new PointLatLng(39.92244, 116.3922));
points.Add(new PointLatLng(39.92280, 116.4015));
points.Add(new PointLatLng(39.91378, 116.4019));
points.Add(new PointLatLng(39.91346, 116.3926));
GMapPolygon polygon = new GMapPolygon(points, "故宫");
polygon.Fill = new SolidBrush(Color.FromArgb(50, Color.Red));
polygon.Stroke = new Pen(Color.Red, 1);
polygons.Polygons.Add(polygon);
this.gMapControl1.Overlays.Add(polygons);

显示结果。
添加多边形

路径规划

GMap.NET中路径规划主要用RoutingProvider类的以下两种方法:

1
2
3
4
5
6
7
8
//avoidHighways:是否避免走高速公路
//walkingMode:是否步行
//zoom:查找路径时的zoom

//根据起止点经纬度查找路径
MapRoute GetRoute(PointLatLng start, PointLatLng end, bool avoidHighways, bool walkingMode, int Zoom);
//根据起止点地址查找路径
MapRoute GetRoute(string start, string end, bool avoidHighways, bool walkingMode, int Zoom);

通过点击地图,添加起止点。

添加地图标记之前,需要先清除(Clear)以下,这样可以避免重复点击地图时,显示多个标记。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
int isSetPoint;  //设置起止点,1为起点,2为终点
PointLatLng startPoint; //起点
PointLatLng endPoint; //终点

private void btn_SetStart_Click(object sender, EventArgs e)
{
isSetPoint = 1;
}

private void btn_SetEnd_Click(object sender, EventArgs e)
{
isSetPoint = 2;
}

//点击地图添加起止点
private void gMapControl1_MouseClick(object sender, MouseEventArgs e)
{
PointLatLng point = this.gMapControl1.FromLocalToLatLng(e.X, e.Y);
switch (isSetPoint)
{
case 1:
//起点
startPoint = point;
GMapMarker marker1 = new GMarkerGoogle(startPoint, GMarkerGoogleType.red_pushpin);
//清除上一次添加的起点
markerStart.Markers.Clear();
markerStart.Markers.Add(marker1);
break;
case 2:
//终点
endPoint = point;
GMapMarker marker2 = new GMarkerGoogle(endPoint, GMarkerGoogleType.blue_pushpin);
markerEnd.Markers.Clear();
markerEnd.Markers.Add(marker2);
break;
default:
break;
}
}

查找路径

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
private void btn_FindRoute_Click(object sender, EventArgs e)
{
//点击查找路径后,不再添加点
isSetPoint = 0;
RoutingProvider rp = this.gMapControl1.MapProvider as RoutingProvider;
//获取路径
MapRoute route = rp.GetRoute(startPoint, endPoint, false, false, (int)this.gMapControl1.Zoom);
if (route != null)
{
//添加routes图层
GMapOverlay routes = new GMapOverlay("routes");
GMapRoute r = new GMapRoute(route.Points, route.Name);
r.Stroke = new Pen(Color.Red, 3);
routes.Routes.Add(r);
//添加到地图
this.gMapControl1.Overlays.Add(routes);
this.gMapControl1.ZoomAndCenterRoute(r);
}
else
{
MessageBox.Show("未能找到路线");
}
}

查找路径结果。

路径规划

如果路径查找结果(route)为null,要么时确实没有结果,要么是GMap封装的地址搜索服务失效。我在写这篇文章时,就无法使用GoogleChinaMap,上图是使用OpenStreetMap的搜索结果。


0%