Java/Spring后端实现用户位置与地理围栏坐标匹配校验

针对Spring后端校验坐标是否在多边形地理围栏内的需求，下面提供几种无需依赖移动端API的后端实现方案：

一、纯Java实现：射线法（Ray Casting Algorithm） #

这是最轻量化的方案，无需引入任何外部依赖，通过核心几何算法直接判断点是否在多边形内部。

实现代码 #

import java.util.List;

// 定义坐标点实体
class Point {
    private double lat; // 纬度
    private double lng; // 经度

    public Point(double lat, double lng) {
        this.lat = lat;
        this.lng = lng;
    }

    // getter方法
    public double getLat() { return lat; }
    public double getLng() { return lng; }
}

// 地理围栏校验工具类
public class GeofenceChecker {
    /**
     * 判断点是否在多边形内部
     * @param point 待校验的用户位置点
     * @param polygon 地理围栏的多边形顶点列表（按顺时针/逆时针顺序排列）
     * @return true=在围栏内，false=在围栏外
     */
    public static boolean isPointInPolygon(Point point, List<Point> polygon) {
        int intersections = 0;
        int n = polygon.size();

        for (int i = 0; i < n; i++) {
            Point p1 = polygon.get(i);
            Point p2 = polygon.get((i + 1) % n);

            // 检查射线与当前边是否相交
            if (((p1.getLat() > point.getLat()) != (p2.getLat() > point.getLat())) &&
                (point.getLng() < (p2.getLng() - p1.getLng()) * (point.getLat() - p1.getLat()) / (p2.getLat() - p1.getLat()) + p1.getLng())) {
                intersections++;
            }
        }

        // 交点数为奇数则在内部
        return (intersections % 2) == 1;
    }

    // 测试示例（使用你提供的坐标）
    public static void main(String[] args) {
        // 地理围栏顶点
        List<Point> fence = List.of(
            new Point(42.43588461182335, -71.6158054921875),
            new Point(42.448988452992175, -71.61402648035278),
            new Point(42.44936844757593, -71.5879339510559),
            new Point(42.43299861648753, -71.59088339349671)
        );
        // 用户当前位置
        Point userPoint = new Point(42.440593799089996, -71.60585993854373);

        boolean isInside = isPointInPolygon(userPoint, fence);
        System.out.println("用户是否在围栏内：" + isInside); // 输出应为true
    }
}

在Spring项目中，你可以将这个工具类封装成@Component，在Service层直接调用。

二、使用专业GIS库：JTS Topology Suite #

如果需要处理更复杂的空间场景（比如曲线围栏、坐标投影转换），可以使用JTS库，这是Java生态中最成熟的GIS工具包。

步骤1：引入依赖（Maven） #

<dependency>
    <groupId>org.locationtech.jts</groupId>
    <artifactId>jts-core</artifactId>
    <version>1.19.0</version>
</dependency>

步骤2：实现校验逻辑 #

import org.locationtech.jts.geom.Coordinate;
import org.locationtech.jts.geom.GeometryFactory;
import org.locationtech.jts.geom.Point;
import org.locationtech.jts.geom.Polygon;

import java.util.List;

public class JTSGeofenceChecker {
    private static final GeometryFactory GEOMETRY_FACTORY = new GeometryFactory();

    public static boolean isPointInPolygon(Point userPoint, List<Coordinate> fenceCoordinates) {
        // 构建多边形
        Coordinate[] coords = fenceCoordinates.toArray(new Coordinate[0]);
        Polygon polygon = GEOMETRY_FACTORY.createPolygon(coords);
        
        // 判断包含关系
        return polygon.contains(userPoint);
    }

    // 测试示例
    public static void main(String[] args) {
        // 围栏坐标转换为JTS Coordinate（JTS坐标顺序：经度, 纬度）
        List<Coordinate> fenceCoords = List.of(
            new Coordinate(-71.6158054921875, 42.43588461182335),
            new Coordinate(-71.61402648035278, 42.448988452992175),
            new Coordinate(-71.5879339510559, 42.44936844757593),
            new Coordinate(-71.59088339349671, 42.43299861648753)
        );
        // 用户位置转换为JTS Point
        Point userPoint = GEOMETRY_FACTORY.createPoint(
            new Coordinate(-71.60585993854373, 42.440593799089996)
        );

        boolean isInside = isPointInPolygon(userPoint, fenceCoords);
        System.out.println("用户是否在围栏内：" + isInside); // 输出应为true
    }
}

三、数据库层面空间查询 #

如果你的数据库支持空间类型（比如PostgreSQL+PostGIS、MySQL 8.0+），可以直接将地理围栏存储为空间对象，通过SQL语句完成校验，减少后端计算开销。

示例（PostGIS） #

1. 将围栏存储为POLYGON类型：

-- 创建带空间字段的表
CREATE TABLE geofences (
    id SERIAL PRIMARY KEY,
    fence_name VARCHAR(100),
    polygon GEOMETRY(POLYGON, 4326) -- 4326代表WGS84坐标系（GPS常用）
);

-- 插入你的围栏数据
INSERT INTO geofences (fence_name, polygon)
VALUES ('用户围栏', ST_GeomFromText('POLYGON((
    -71.6158054921875 42.43588461182335,
    -71.61402648035278 42.448988452992175,
    -71.5879339510559 42.44936844757593,
    -71.59088339349671 42.43299861648753,
    -71.6158054921875 42.43588461182335
))', 4326));

2. 查询用户位置是否在围栏内：

SELECT id, fence_name
FROM geofences
WHERE ST_Contains(polygon, ST_SetSRID(ST_MakePoint(-71.60585993854373, 42.440593799089996), 4326));

在Spring中可以通过JPA的@Query注解直接执行该SQL，或者使用Spring Data JDBC的空间扩展支持。

内容的提问来源于stack exchange，提问作者Darshan Dalwadi