当前位置：首页 > news >正文

Leaflet.Graticule源码分析以及经纬度汉化展示

news 2025/7/7 14:20:20

前言

一、源码分析

1、类图设计

2、时序调用

3、调用说明

二、经纬度汉化

1、改造前

2、汉化

3、改造效果

总结

前言

在之前的博客基于Leaflet的Webgis经纬网格生成实践中，已经深入介绍了Leaflet.Graticule的实际使用方法和进行了简单的源码分析。认真看过实例效果的朋友一定会发现，在页面上生成的网格中，其边线的经度和维度都是英文的，如下图所示：

那如何进行汉化改造支持呢，这里需要进行显示支持。本文将重点详细分析这款经纬网生成的源码，以及其内在的调用逻辑，通过本文，可以让您知道经纬网的构造原理，做到知其然知其所以然。

一、源码分析

1、类图设计

相对来说，这种前端的工具型框架设计得还是比较简单的，没有过多的依赖。相当于后端的一个类，这里采用OOP的方式进行源码分析。众所周知，通常一个类，包含属性和方法。Leaflet.Graticule也无外乎如此，其属性定义如下图所示。

由于一张图的篇幅有限，我们暂且把方法给隐藏起来了。其具体的方法架构如下图：

2、时序调用

时序图可以用来很好的描述方法内部的流转和调用逻辑，方便对某一个方法的全生命进行跟踪和展示。这里也同样采用这种方法来进行调用流程的阐述。

3、调用说明

第一步：初始化配置参数，在这里会调用构造方法进行对象创建。其定义参考如下：

var obj = L.latlngGraticule({showLabel: true,color: 'red',zoomInterval: {latitude: [{start: 2, end: 4, interval: 30},{start: 5, end: 20, interval: 5}],longitude: [{start: 2, end: 4, interval: 30},{start: 5, end: 20, interval: 5}]}});

第二步、调用Layer.js的addTo方法进行地图添加。

addTo: function (map) {map.addLayer(this);return this;}

第三步、通过addLayer将地图添加到定义的leaflet地图中，代码如下：

_layerAdd: function (e) {var map = e.target;// check in case layer gets added and then removed before the map is readyif (!map.hasLayer(this)) { return; }this._map = map;this._zoomAnimated = map._zoomAnimated;if (this.getEvents) {var events = this.getEvents();map.on(events, this);this.once('remove', function () {map.off(events, this);}, this);}this.onAdd(map);if (this.getAttribution && map.attributionControl) {map.attributionControl.addAttribution(this.getAttribution());}this.fire('add');map.fire('layeradd', {layer: this});

第四步、通过reset触发绘制方法，进行基于Canvas的经纬度线的绘制。

 _reset: function () {var container = this._container,canvas = this._canvas,size = this._map.getSize(),lt = this._map.containerPointToLayerPoint([0, 0]);L.DomUtil.setPosition(container, lt);container.style.width = size.x + 'px';container.style.height = size.y + 'px';canvas.width  = size.x;canvas.height = size.y;canvas.style.width  = size.x + 'px';canvas.style.height = size.y + 'px';this.__calcInterval();this.__draw(true);},

第五步、绘制经纬线

function __draw_lon_line(self, lon_tick) {lngstr = self.__format_lng(lon_tick);txtWidth = ctx.measureText(lngstr).width;var bb = map.latLngToContainerPoint(L.latLng(_lat_b, lon_tick));if (curvedLon) {if (typeof(curvedLon) == 'number') {_lat_delta = curvedLon;}ctx.beginPath();ctx.moveTo(bb.x, bb.y);var _prev_p = null;for (var j=_lat_b; j<_lat_t; j+=_lat_delta) {var tt = map.latLngToContainerPoint(L.latLng(j, lon_tick));ctx.lineTo(tt.x, tt.y);if (self.options.showLabel && label && _prev_p != null) {if (_prev_p.y > 8 && tt.y <= 8) {ctx.fillText(lngstr, tt.x - (txtWidth/2), txtHeight);}else if (_prev_p.y >= hh && tt.y < hh) {ctx.fillText(lngstr, tt.x - (txtWidth/2), hh-2);}}_prev_p = {x:tt.x, y:tt.y, lon:lon_tick, lat:j};}ctx.stroke();}else {var __lat_top = _lat_t;var tt = map.latLngToContainerPoint(L.latLng(__lat_top, lon_tick));if (curvedLat) {__lat_top = map.containerPointToLatLng(L.point(tt.x, 0));__lat_top = __lat_top.lat;if (__lat_top > 90) { __lat_top = 90; }tt = map.latLngToContainerPoint(L.latLng(__lat_top, lon_tick));var __lat_bottom = map.containerPointToLatLng(L.point(bb.x, hh));__lat_bottom = __lat_bottom.lat;if (__lat_bottom < -90) { __lat_bottom = -90; }bb = map.latLngToContainerPoint(L.latLng(__lat_bottom, lon_tick));}ctx.beginPath();ctx.moveTo(tt.x, tt.y+1);ctx.lineTo(bb.x, bb.y-1);ctx.stroke();if (self.options.showLabel && label) {ctx.fillText(lngstr, tt.x - (txtWidth/2), txtHeight+1);ctx.fillText(lngstr, bb.x - (txtWidth/2), hh-3);}}};

第七步、将经过绘制的经纬网通过canvas渲染到html页面进行展示

经过以上的步骤，就完成了经纬网的生成。以上代码只是对源代码进行深入讲解，实际使用的过程中，不是为了调整相关参数或者调整运行逻辑，可以不必要进行代码改造，直接使用即可。

二、经纬度汉化

1、改造前

在上面的源码分析中，我们会进行经纬度的格式化，详细代码在__format_lat和__format_lng这两个方法中，这里我们以__format_lng为例：

__format_lng: function(lng) {if (this.options.lngFormatTickLabel) {return this.options.lngFormatTickLabel(lng);}// todo: format type of floatif (lng > 180) {return '' + (360 - lng) + 'W';}else if (lng > 0 && lng < 180) {return '' + lng + 'E';}else if (lng < 0 && lng > -180) {return '' + (lng*-1) + 'W';}else if (lng == -180) {return '' + (lng*-1);}else if (lng < -180) {return '' + (360 + lng) + 'W';}return '' + lng;}

可以看到，代码中仔细规定了经度的展示单位，W为西经，E表示东经。了解了以上知识就可以进行汉化改造，直接修改相应参数即可。

2、汉化

__format_lng: function(lng) {if (this.options.lngFormatTickLabel) {return this.options.lngFormatTickLabel(lng);}if (lng > 180) {return '' + (360 - lng) + '西经';}else if (lng > 0 && lng < 180) {return '' + lng + '东经';}else if (lng < 0 && lng > -180) {return '' + (lng*-1) + '西经';}else if (lng == -180) {return '' + (lng*-1);}else if (lng < -180) {return '' + (360 + lng) + '西经';}return '' + lng;}