Express.js中基于地理位置的搜索实现-FunTeaLearn Online Web Tutorials

在Web应用程序中，地理位置的搜索是非常重要的，因为它可以帮助用户找到特定地点附近的信息，例如周围的餐厅、酒店、犬舍等等。为了达到这一目的，我们需要对用户的位置和搜索结果进行地理定位和匹配。在这篇文章中，我们将介绍如何在Express.js中实现基于地理位置的搜索。

背景知识

在开始之前，让我们先了解一些基础知识。

GeoJSON

GeoJSON是一种基于JSON格式的地理数据表示方法，它是一种开放的数据标准，可以用于描述地理对象的几何形状、坐标系和属性。GeoJSON可以表示各种类型的几何形状，例如点、线，以及多边形等等。

地球表面距离计算

地球是一个球体，因此在计算两个点之间的表面距离时，需要考虑地球曲率和纬度等因素。有很多公式可以计算地球上两点之间的距离，其中最常用的是Haversine公式。

安装依赖

首先，我们需要安装依赖。在Express.js中，我们可以使用npm包管理器来安装模块。

npm install --save express body-parser mongoose geolib

其中，express用于搭建Web应用程序，body-parser用于解析POST请求，mongoose用于连接MongoDB数据库，geolib用于计算地球上两点之间的距离。

数据库设计

在进行基于地理位置的搜索时，我们需要存储每个地点的地理坐标信息。为了实现这一功能，我们可以使用MongoDB数据库和Mongoose库来保存地理位置点的数据。下面是一个简单的地理位置点的数据模型：

// www.javascriptcn.com code example
const mongoose = require('mongoose');

const PointSchema = new mongoose.Schema({
    name: String,
    location: {
        type: {
            type: String,  // 坐标类型，固定写法“Point”
            enum: ['Point'],
            required: true
        },
        coordinates: {   // 坐标
            type: [Number],
            required: true
        }
    }
});

PointSchema.index({ location: '2dsphere' });  // 为location字段添加地理索引 

module.exports = mongoose.model('Point', PointSchema);

在上面的代码中，我们定义了一个地理位置点的数据模型，其中包括名称和位置两个字段。位置字段是一个必需字段，它包含了地理坐标数据，其中type字段表示坐标类型，该字段应为“Point”，coordinates字段是实际的地理坐标。

为了在Mongoose中支持地理索引，在模型定义中我们还需要为location字段添加地理索引。

路由实现

接下来，我们需要在Express.js应用程序中实现API路由。具体实现如下：

// www.javascriptcn.com code example
const express = require('express');
const bodyParser = require('body-parser');
const Point = require('./models/point');
const geolib = require('geolib');

const app = express();
app.use(bodyParser.urlencoded({ extended: true }));
app.use(bodyParser.json());

app.post('/search', function(req, res) {

    let maxDistance = req.body.maxDistance;   // 最大查找半径
    let longitude = parseFloat(req.body.longitude);  // 用户的地理经度
    let latitude = parseFloat(req.body.latitude);    // 用户的地理纬度

    // 构建一个GeoJSON点对象
    let userLocation = {
        type: "Point",
        coordinates: [longitude, latitude]
    };

    // 在数据库中查询所有距离该点小于等于查找半径的位置点
    Point.find({
        location: {
            $near: {
                $geometry: userLocation,
                $maxDistance: maxDistance
            }
        }
    }, function(err, results) {
        if (err) {
            return res.status(500).json({
                message: err.message
            });
        }

        // 计算每个结果点到用户位置点的距离
        let resultsWithDistance = results.map(function(result) {
            let distance = geolib.getDistance(userLocation, result.location);
            result.distance = distance;
            result.distanceFormatted = (distance / 1000).toFixed(2) + " km";
            return result;
        });

        return res.status(200).json(resultsWithDistance);
    });
});

app.listen(3000, function() {
    console.log('Server started on port 3000');
});

在上述代码中，我们定义了一个使用POST方法的API路由，在该路由中，我们获取了用户的地理坐标、最大查找半径，并使用Mongoose库中的$near查询条件查询所有距离用户位置小于等于查找半径的位置点。

接下来，我们将计算每个结果点到用户位置点的距离，并将其添加到结果中。这里使用了geolib库来计算地球表面距离。

最后，我们以JSON格式返回所有查询结果和距离信息。

示例API调用

最后，我们来看一个使用这个API的示例。我们将使用POSTMAN来进行HTTP请求。

首先，我们需要启动服务器，可以使用以下命令：

node app.js

然后，我们将使用POSTMAN创建一个POST请求，将以下JSON数据作为请求体：

{
    "maxDistance": 10000,
    "longitude": -122.3301,
    "latitude": 47.6038
}

在这个请求中，我们设置最大查找半径为10公里，用户的地理经度为-122.3301，纬度为47.6038。

接下来，我们将请求发送到API路由中，在返回的结果中，我们将看到所有距离查询点小于10公里的位置点数，并且每个结果点的距离信息都已经计算出来。例如：

// www.javascriptcn.com code example
[
    {
        "_id": "5f8d2bd2c3d7b9f30b720db7",
        "name": "餐厅A",
        "location": {
            "type": "Point",
            "coordinates": [
                -122.328732,
                47.60387
            ]
        },
        "distance": 768,
        "distanceFormatted": "0.77 km"
    },
    {
        "_id": "5f8d2bd2c3d7b9f30b720db8",
        "name": "餐厅B",
        "location": {
            "type": "Point",
            "coordinates": [
                -122.329050,
                47.604418
            ]
        },
        "distance": 805,
        "distanceFormatted": "0.81 km"
    }
]

这些信息将有助于用户更好地了解附近的地理位置。

总结

在这篇文章中，我们介绍了如何在Express.js中实现地理位置搜索功能。我们了解了GeoJSON格式、地球表面距离计算和如何在MongoDB数据库中保存地理位置点的数据模型。我们还通过实现一个使用Express.js和Mongoose的API路由示例来演示了如何在服务器端执行基于地理位置的搜索。此外，我们还使用了geolib库来计算地球表面距离，并将每个搜索结果的距离信息格式化为更容易理解的单位，以帮助用户更好地了解附近的地理位置。

Source: FunTeaLearn,Please indicate the source for reprints https://funteas.com/post/64687ac2968c7c53b08ade20

Express.js中基于地理位置的搜索实现