Spring Data JPA+MySQL空间查询：查找指定半径内的TouchPoint

嘿，我来帮你搞定这个空间范围查询的问题！你已经把Hibernate Spatial依赖和MySQL空间方言配置好了，这步走对了～接下来只需要在Spring Data JPA的Repository里定义对应的查询逻辑就行，下面给你两种实用的方案，按需选择：

方案一：用JPQL结合Hibernate Spatial函数（平面距离计算） #

如果你的场景是小范围查询，或者不需要严格的球面距离计算，可以用Hibernate Spatial提供的distance函数来实现。在你的Repository接口里定义如下方法：

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.CrudRepository;
import org.springframework.data.repository.query.Param;
import com.vividsolutions.jts.geom.Point;
import java.util.List;

public interface TouchPointRepository extends CrudRepository<TouchPoint, Long> {

    @Query("SELECT tp FROM TouchPoint tp WHERE distance(tp.location, :center) <= :radius")
    List<TouchPoint> findByLocationWithinRadius(@Param("center") Point center, @Param("radius") double radius);
}

调用方式： #

在业务代码里，你需要用用户的经纬度创建JTS的Point对象（注意坐标顺序：经度在前，纬度在后，和MySQL的POINT存储规则一致）：

import com.vividsolutions.jts.geom.Coordinate;
import com.vividsolutions.jts.geom.GeometryFactory;
import com.vividsolutions.jts.geom.Point;

// 可以把GeometryFactory做成单例或者注入到Spring容器里
GeometryFactory geometryFactory = new GeometryFactory();
Coordinate userCoordinate = new Coordinate(userLongitude, userLatitude);
Point centerPoint = geometryFactory.createPoint(userCoordinate);

// 注：如果用WGS84经纬度坐标系，平面距离的单位是度，500米大约对应0.0045度
List<TouchPoint> nearbyPoints = touchPointRepository.findByLocationWithinRadius(centerPoint, 0.0045);

方案二：用原生SQL结合MySQL的球面距离函数（推荐经纬度场景） #

如果是基于地球经纬度的查询，MySQL的ST_Distance_Sphere函数会更准确，它直接计算两个点之间的球面距离，单位是米。这种方式更适合实际的地理位置查询：

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.CrudRepository;
import org.springframework.data.repository.query.Param;
import java.util.List;

public interface TouchPointRepository extends CrudRepository<TouchPoint, Long> {

    @Query(value = "SELECT * FROM touch_point tp WHERE ST_Distance_Sphere(tp.location, POINT(:lon, :lat)) <= :radius", nativeQuery = true)
    List<TouchPoint> findByLocationWithinRadius(@Param("lon") double longitude, @Param("lat") double latitude, @Param("radius") double radius);
}

调用方式： #

直接传入用户的经纬度和半径（米）就行，比如查1公里范围内的点：

List<TouchPoint> nearbyPoints = touchPointRepository.findByLocationWithinRadius(userLongitude, userLatitude, 1000);

优化建议： #

为了让空间查询更高效，记得给location字段创建空间索引：

CREATE SPATIAL INDEX idx_touchpoint_location ON touch_point(location);

另外要注意：

• 确保你的Hibernate Spatial版本和Spring Boot自带的Hibernate版本兼容，避免依赖冲突；
• 存储TouchPoint的location时，坐标顺序要和查询时一致（经度X，纬度Y）。

内容的提问来源于stack exchange，提问作者Abhishek Ranjan