Node.js 地理定位与地图 | 库

JavaScript (Node.js) 中的地理定位与地图

处理地理数据与地图显示是现代 Web 应用的关键任务之一。在 Node.js 生态系统中，存在大量库，可用于处理坐标、构建路线、执行反向地理编码以及渲染交互式地图。在本文中，我们将介绍主要工具，并提供服务器端 (Node.js) 的实用代码示例。

1. 处理地理数据的主要库

1.1. Leaflet（客户端）与 node-leaflet

Leaflet 是最流行的用于交互式地图的 JavaScript 库。它在浏览器端运行，但对于 Node.js，存在 leaflet 包（通过 npm install leaflet），它允许使用 leaflet-headless 在服务器上渲染地图，或使用 GeoJSON 格式的数据。

在服务器上生成地图图像（使用 leaflet-static）的示例：

const L = require('leaflet');const { createCanvas } = require('canvas');

const map = L.map(createCanvas(800, 600), {    center: [55.751244, 37.618423], // 莫斯科    zoom: 10});

L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png', {    attribution: '© OpenStreetMap contributors'}).addTo(map);

// 导出为 PNG（简化版）const buffer = map.getCanvas().toBuffer();require('fs').writeFileSync('map.png', buffer);

1.2. OpenStreetMap (OSM) 与 Overpass API

OpenStreetMap 提供免费的瓦片和用于搜索对象的 API。在 Node.js 中，通常使用 osmosis 包或直接向 https://nominatim.openstreetmap.org 发送 HTTP 请求来处理 OSM。

反向地理编码（根据坐标获取地址）的示例：

const fetch = require('node-fetch');

async function reverseGeocode(lat, lon) {    const url = `https://nominatim.openstreetmap.org/reverse?format=json&lat=${lat}&lon=${lon}`;    const response = await fetch(url, {        headers: { 'User-Agent': 'PythonLibExample/1.0' }    });    const data = await response.json();    return data.display_name;}

reverseGeocode(55.751244, 37.618423).then(addr => console.log(addr));// 结果: "莫斯科, 俄罗斯, 红场"

1.3. Turf.js — 地理空间分析

Turf.js — 一个用于执行几何运算的强大库：缓冲区分析、多边形合并、距离计算、面积计算等。它既可在浏览器中运行，也可在 Node.js 中运行。

计算两点之间距离（以公里为单位）的示例：

const turf = require('@turf/turf');

const point1 = turf.point([37.618423, 55.751244]); // [经度, 纬度]const point2 = turf.point([30.315868, 59.939095]); // 圣彼得堡

const distance = turf.distance(point1, point2, { units: 'kilometers' });console.log(`距离: ${distance.toFixed(2)} 公里`); // ≈ 634.5 公里

1.4. GeoJSON 与 shapefile

GeoJSON — 一种用于存储地理结构（点、线、多边形）的格式。在 Node.js 中，使用内置的 JSON.parse 即可处理它，而读取 shape 文件则使用 shapefile 包。

const shapefile = require('shapefile');

shapefile.open('path/to/file.shp')    .then(source => source.read()        .then(function log(result) {            if (result.done) return;            console.log(result.value); // GeoJSON Feature            return source.read().then(log);        }))    .catch(error => console.error(error));