Redis GEO 类型与 API 结合,地理位置优化的绝佳实践

这篇具有很好参考价值的文章主要介绍了Redis GEO 类型与 API 结合,地理位置优化的绝佳实践。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

🔭 嗨,您好 👋 我是 vnjohn,在互联网企业担任 Java 开发,CSDN 优质创作者
📖 推荐专栏:Spring、MySQL、Nacos、Java,后续其他专栏会持续优化更新迭代
🌲文章所在专栏:MySQL、Redis、业务设计
🤔 我当前正在学习微服务领域、云原生领域、消息中间件等架构、原理知识
💬 向我询问任何您想要的东西,ID:vnjohn
🔥觉得博主文章写的还 OK,能够帮助到您的,感谢三连支持博客🙏
😄 代词: vnjohn
⚡ 有趣的事实:音乐、跑步、电影、游戏

目录

前言

在企业开发中,例如:附近服务门店/网点查询、附近服务工人派单查询,若没有合理去设计地理位置的这块查询性能提升的功能时,都是会去数据库层面采用函数计算出来,这种方式本来就存在一定的弊端

1、数据库层面是性能瓶颈,将所有的压力放在数据库中,必然会给系统带来灾难级的响应,例如:当同时访问的用户量递增时,数据库连接池打满 > CPU 飘升 > 系统长时间停留在数据库层面无法及时响应给用户
2、当服务门店/网点数据量越来越大时、服务工人数据越来越庞大时,在使用函数计算筛选出附近的数据,必然会造成数据库的全表扫描 >explain type:ALL
3、当最近的服务门店/网点、服务工人不满足用户的需求对象时,会一直向下拉取下一页的数据,直至筛选到满足自己的服务对象才停止,每一段的筛选都是一次性能极差的 SELECT

故而言之,因为这种问题的出现,不得已而从其他方面去考虑来提升地理位置这块的筛选动作,由数据库「磁盘存储经纬度」改为缓存「内存存储经纬度」来提升重复的查询操作

该文会演示从数据库层面 > 缓存层面,地理位置的优化提升改造

MySQL 数据库

现大部分企业都采用 MySQL 作为数据库存储,所以以 MySQL 8.0 为例,演练在它里面如何采用函数来完成地理位置的计算

表结构

CREATE TABLE `shop` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '门店id',
  `shop_no` varchar(64) NOT NULL COMMENT '门店编码',
  `shop_name` varchar(50) NOT NULL COMMENT '门店名称',
  `status` tinyint(1) NOT NULL DEFAULT '0' COMMENT '启用状态:1-启用、0-',
  `logo` varchar(255) DEFAULT NULL COMMENT '门店Logo',
  `introduce` text COMMENT '门店介绍',
  `longitude` double NOT NULL COMMENT '经度',
  `latitude` double NOT NULL COMMENT '纬度',
  `trade_start_time` time DEFAULT NULL COMMENT '营业开始时间',
  `trade_end_time` time DEFAULT NULL COMMENT '营业结束时间',
  `contacts` varchar(20) DEFAULT NULL COMMENT '联系人',
  `telephone` varchar(50) DEFAULT NULL COMMENT '商家联系电话',
  `province_id` bigint DEFAULT NULL COMMENT '省id',
  `province` varchar(255) DEFAULT NULL COMMENT '省',
  `city_id` bigint DEFAULT NULL COMMENT '市id',
  `city` varchar(255) DEFAULT NULL COMMENT '市',
  `area_id` bigint DEFAULT NULL COMMENT '区id',
  `area` varchar(255) DEFAULT NULL COMMENT '区',
  `address` varchar(255) DEFAULT NULL COMMENT '门店详细地址',
  `created_time` datetime DEFAULT NULL COMMENT '创建时间',
  `updated_time` datetime DEFAULT NULL COMMENT '更新时间',
  `is_deleted` tinyint(1) DEFAULT '0' COMMENT '是否删除',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uni_shop_no` (`shop_no`) COMMENT '门店编码唯一索引'
) ENGINE=InnoDB AUTO_INCREMENT=45 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='商家信息';

首先创建一张商家表「门店/服务网点」涉及到地理位置比较重要的两个字段,longitude > 经度、latitude > 纬度

经度的最大值:180°
纬度的最大值:90°

模拟数据

使用存储函数,模拟生成十万条商家数据

CREATE DEFINER = `root` @`localhost` PROCEDURE `batchInsert` ( IN args INT ) BEGIN
	DECLARE
		-- 开启事务
		i INT DEFAULT 1;
	START TRANSACTION;
	WHILE
			i <= args DO
			INSERT INTO shop ( shop_no, shop_name, `status`, longitude, latitude ) 
		VALUE
			(
				ROUND( RAND() * 99999 ),
				concat( "商家-", i ),1,
				-- 随机生成经纬度
				(RAND() * ( 179.077090052913654 - 0.477040512464626 )) + 0.477040512464626,
				(RAND() * ( 89.9172823750000134 - - 1.8840792500000134 )) + - 1.8840792500000134 
			);
		SET i = i + 1;
	END WHILE;
	COMMIT;
END
call batchInsert(100000);

数据库查询

不加索引

先使用「经纬度」字段不加索引的方式执行 SQL

EXPLAIN SELECT
	* 
FROM
	( SELECT id, ST_DISTANCE_SPHERE ( POINT ( 114.112808, 22.544977 ), POINT ( longitude, latitude )) AS distance FROM shop WHERE `STATUS` = 1 ) temp 
WHERE
	ROUND( distance / 1000, 2 ) BETWEEN 0 AND 20 
ORDER BY distance ASC 
LIMIT 5 

执行计划结果如下:

Redis GEO 类型与 API 结合,地理位置优化的绝佳实践,Redis,MySQL,业务设计,redis,数据库,缓存

加索引

alter table shop add index `idx_location` (`longitude`,`latitude`) USING BTREE;

再次执行 SQL,如下:

```sql
EXPLAIN SELECT
	* 
FROM
	( SELECT id, ST_DISTANCE_SPHERE ( POINT ( 114.112808, 22.544977 ), POINT ( longitude, latitude )) AS distance FROM shop WHERE `STATUS` = 1 ) temp 
WHERE
	ROUND( distance / 1000, 2 ) BETWEEN 0 AND 20 
ORDER BY distance ASC 
LIMIT 5 

执行计划结果如下:

Redis GEO 类型与 API 结合,地理位置优化的绝佳实践,Redis,MySQL,业务设计,redis,数据库,缓存

直译函数

MySQL 官方直译 ST_DISTANCE_SPHERE 函数说明

语法:ST_Distance_Sphere(g1, g2 [, radius])
说明:

返回球体之间 Point 或 MultiPoint 参数之间的最小球面距离(以米为单位)可选 radius 参数应以米为单位给出
如果两个几何参数都是有效的笛卡尔参数 Point 或 MultiPoint SRID 0 中的值,则返回值是具有所提供半径的球体上两个几何之间的最短距离。如果省略,则默认半径为 6,370,986 米,点 X 和 Y 坐标分别解释为经度和纬度(以度为单位)

如果任何参数的经度或纬度超出范围,则会发生错误:

1、若经度值不在 (−180, 180] 范围内,则会发生 ER_GEOMETRY_PARAM_LONGITUDE_OUT_OF_RANGE 错误(在 MySQL 8.0.12 ER_LONGITUDE_OUT_OF_RANGE 之前)
2、若纬度值不在 [−90, 90] 范围内,则会发生 ER_GEOMETRY_PARAM_LATITUDE_OUT_OF_RANGE 错误(在 MySQL 8.0.12 ER_LATITUDE_OUT_OF_RANGE 之前)

小结

从以上数据库做地理位置筛选的结果来看,无论是否追加索引,似乎对数据库的查询性能来说,并没有提升

使用数据库做地理位置筛选,基于以下几种情况可以考虑使用该方式进行处理

商家「服务门店/网点」数据量不多
商家「服务门店/网点」模块提供给用户服务的入口较小

Redis 缓存

基于 Redis API 实现地理位置使用 GEO 有两种方式

1、org.springframework.data.redis.core.RedisTemplate
2、org.redisson.api.RedissonClient

Redis GEO 客户端

该篇节,先告知大家如何应用 Redis 客户端的 GEO 类型,API 会基于客户端的函数进行一次封装,先了解底层开始再到最后的高级 API 实践

1、查看 Redis 版本

redis-cli -v

2、连接 Redis 客户端

1、redis-cli
2、无密码直接登录,有密码通过:auth 明文密码

3、查看 GEO、ZSet 帮助文档

help @GEO
help @sorted-set

127.0.0.1:6379> help @GEO
  # GEO 指定的缓存 Key 追加 1~N 条经纬度地理位置信息	
  GEOADD key [NX|XX] [CH] longitude latitude member [longitude latitude member ...]
  summary: Add one or more geospatial items in the geospatial index represented using a sorted set
  since: 3.2.0
  # GEO 指定的缓存 Key 两个成员之间的距离
  # M|KM|FT|MI:米、公里、英里、英尺	
  GEODIST key member1 member2 [M|KM|FT|MI]
  summary: Returns the distance between two members of a geospatial index
  since: 3.2.0
  # GEO 指定缓存 Key 地理位置索引 > 标准地理散列字符串 
  GEOHASH key member [member ...]
  summary: Returns members of a geospatial index as standard geohash strings
  since: 3.2.0
  # GEO 指定缓存 Key 地理位置索引 > 成员对应的经纬度 
  GEOPOS key member [member ...]
  summary: Returns longitude and latitude of members of a geospatial index
  since: 3.2.0
  # GEO 指定缓存 Key:查询表示地理空间索引的排序集,以传入的经纬度来获取与点的给定最大距离匹配的成员,可按升序、降序排序
  GEORADIUS key longitude latitude radius M|KM|FT|MI [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count [ANY]] [ASC|DESC] [STORE key] [STOREDIST key]
  summary: Query a sorted set representing a geospatial index to fetch members matching a given maximum distance from a point
  since: 3.2.0
  # GEO 指定缓存 Key: 查询表示地理空间索引的排序集,以传入的指定成员经纬度来获取与点的给定最大距离匹配的成员,可按升序、降序排序
  GEORADIUSBYMEMBER key member radius M|KM|FT|MI [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count [ANY]] [ASC|DESC] [STORE key] [STOREDIST key]
  summary: Query a sorted set representing a geospatial index to fetch members matching a given maximum distance from a member
  since: 3.2.0
  # GEO 指定缓存 Key: 查询表示地理空间索引的排序集,以传入的指定成员经纬度来获取与点的给定最大距离匹配的成员,可按升序、降序排序,只支持可读
  GEORADIUSBYMEMBER_RO key member radius M|KM|FT|MI [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count [ANY]] [ASC|DESC]
  summary: A read-only variant for GEORADIUSBYMEMBER
  since: 3.2.10
  # GEO 指定缓存 Key:查询表示地理空间索引的排序集,以传入的经纬度来获取与点的给定最大距离匹配的成员,可按升序、降序排序,只支持可读
  GEORADIUS_RO key longitude latitude radius M|KM|FT|MI [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count [ANY]] [ASC|DESC]
  summary: A read-only variant for GEORADIUS
  since: 3.2.10
  # GEO 指定缓存 Key:查询表示地理空间索引的排序集,以获取「成员或指定经纬度」最大距离匹配的成员,可按升序、降低排序,不支持存储
  GEOSEARCH key FROMMEMBER member|FROMLONLAT longitude latitude BYRADIUS radius M|KM|FT|MI|BYBOX width height M|KM|FT|MI [ASC|DESC] [COUNT count [ANY]] [WITHCOORD] [WITHDIST] [WITHHASH]
  summary: Query a sorted set representing a geospatial index to fetch members inside an area of a box or a circle.
  since: 6.2.0
  # GEO 指定缓存 Key:查询表示地理空间索引的排序集,以「获取成员或指定经纬度」最大距离匹配的成员,可按升序、降低排序,支持存储至 ZSet Key 
  GEOSEARCHSTORE destination source FROMMEMBER member|FROMLONLAT longitude latitude BYRADIUS radius M|KM|FT|MI|BYBOX width height M|KM|FT|MI [ASC|DESC] [COUNT count [ANY]] [STOREDIST]
  summary: Query a sorted set representing a geospatial index to fetch members inside an area of a box or a circle, and store the result in another key.
  since: 6.2.0

引入 Spring、Redisson 配置

1、maven 依赖配置

<properties>
    <spring.boot.version>2.6.7</spring.boot.version>
    <redisson.version>3.17.5</redisson.version>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>${spring.boot.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
    		<groupId>org.redisson</groupId>
    		<artifactId>redisson-spring-boot-starter</artifactId>
    		<version>${redisson.version}</version>
		</dependency>
    </dependencies>
</dependencyManagement>

2、Redis 核心配置类,如下:

/**
 * Redis 核心配置类
 *
 * @author vnjohn
 * @since 2023
 */
@Configuration
public class RedisConfig {
    @Resource
    private RedisConnectionFactory factory;

    @Bean
    public RedisTemplate<String, Object> redisTemplate() {
        RedisTemplate<String, Object> redisTemplate = new RedisTemplate<>();
        redisTemplate.setKeySerializer(new StringRedisSerializer());
        redisTemplate.setHashKeySerializer(new StringRedisSerializer());
        redisTemplate.setHashValueSerializer(new StringRedisSerializer());
        redisTemplate.setValueSerializer(new JdkSerializationRedisSerializer());
        redisTemplate.setStringSerializer(new StringRedisSerializer());
        redisTemplate.setDefaultSerializer(new StringRedisSerializer());
        redisTemplate.setConnectionFactory(factory);
        return redisTemplate;
    }
    
    @Bean
    public HashOperations<String, String, Object> hashOperations(RedisTemplate<String, Object> redisTemplate) {
        return redisTemplate.opsForHash();
    }

    @Bean
    public ValueOperations<String, String> valueOperations(RedisTemplate<String, String> redisTemplate) {
        return redisTemplate.opsForValue();
    }

    @Bean
    public GeoOperations<String, String> geoOperations(RedisTemplate<String, String> redisTemplate) {
        return redisTemplate.opsForGeo();
    }

    @Bean
    public ListOperations<String, Object> listOperations(RedisTemplate<String, Object> redisTemplate) {
        return redisTemplate.opsForList();
    }

    @Bean
    public SetOperations<String, Object> setOperations(RedisTemplate<String, Object> redisTemplate) {
        return redisTemplate.opsForSet();
    }

    @Bean
    public ZSetOperations<String, String> zSetOperations(RedisTemplate<String, String> redisTemplate) {
        return redisTemplate.opsForZSet();
    }
}

在本文,我们会用到 GeoOperations、ZSetOperations 操作类去调用 API

RedisTemplate API 操作

RedisTemplate 操作工具类,如下:

	@Resource
    private GeoOperations<String, String> geoOperations;
	
	@Resource
    private ZSetOperations<String, String> zSetOperations;

// ============================ sorted-set =============================

	public ZSetOperations.TypedTuple<String> redisTemplateZSetPopMinScore(String key) {
        return zSetOperations.popMin(key);
    }
	
// ============================ Geo =============================

    /**
     * 新增 Geo 某个 Key 成员的经纬度信息
     *
     * @param key       Redis 缓存 Key
     * @param longitude 经度
     * @param latitude  纬度
     * @param member    成员
     */
    public void geoAdd(String key, Double longitude, Double latitude, String member) {
        Point point = new Point(longitude, latitude);
        geoOperations.add(key, point, member);
    }

    /**
     * 删除 Geo 某个 Key 成员的经纬度信息
     *
     * @param key    Redis 缓存 Key
     * @param member 成员
     */
    public void geoRemove(String key, String member) {
        geoOperations.remove(key, member);
    }

    /**
     * 以半径为单位,「千米」为计算单位展开,以倒序的方式展示对应的信息
     *
     * @param key         缓存 Key
     * @param longitude   经度
     * @param latitude    纬度
     * @param distanceNum 距离,单位:KM
     */
    public GeoResults<RedisGeoCommands.GeoLocation<String>> geoRadiusWithKilometers(String key, Double longitude,
                                                                                    Double latitude, Double distanceNum) {
        return geoRadiusWithKilometers(key, longitude, latitude, distanceNum, null, Boolean.TRUE);
    }

    /**
     * 以半径为单位,「千米」为计算单位展开,以倒序的方式展示对应的信息
     *
     * @param key         缓存 Key
     * @param longitude   经度
     * @param latitude    纬度
     * @param limit       筛选条数
     * @param distanceNum 距离,单位:KM
     */
    public GeoResults<RedisGeoCommands.GeoLocation<String>> geoRadiusWithKilometersLimit(String key, Double longitude, Double latitude,
                                                                                         Integer limit, Double distanceNum) {
        return geoRadiusWithKilometers(key, longitude, latitude, distanceNum, limit, Boolean.TRUE);
    }

    /**
     * 以半径为单位,「千米」为计算单位展开,以自定义顺序方式展示对应的信息
     *
     * @param key         缓存 Key
     * @param longitude   经度
     * @param latitude    纬度
     * @param limit       筛选条数
     * @param distanceNum 距离,单位:KM
     * @param ascOrder    是否按升序排
     */
    public GeoResults<RedisGeoCommands.GeoLocation<String>> geoRadiusWithKilometers(String key, Double longitude, Double latitude,
                                                                                    Double distanceNum, Integer limit, Boolean ascOrder) {
        Point point = new Point(longitude, latitude);
        Distance radius = new Distance(distanceNum, Metrics.KILOMETERS);
        Circle within = new Circle(point, radius);
        RedisGeoCommands.GeoRadiusCommandArgs geoRadiusCommandArgs = RedisGeoCommands.GeoRadiusCommandArgs.newGeoRadiusArgs().includeCoordinates().includeDistance();
        if (null != limit) {
            geoRadiusCommandArgs = geoRadiusCommandArgs.limit(limit);
        }
        geoRadiusCommandArgs = ascOrder ? geoRadiusCommandArgs.sortAscending() : geoRadiusCommandArgs.sortDescending();
        return geoOperations.radius(key, within, geoRadiusCommandArgs);
    }

    /**
     * 以半径为单位,「米」为计算单位展开,以倒序的方式展示对应的信息
     *
     * @param key         缓存 Key
     * @param longitude   经度
     * @param latitude    纬度
     * @param distanceNum 距离,单位:M
     */
    public GeoResults<RedisGeoCommands.GeoLocation<String>> geoRadiusWithMeters(String key, Double longitude,
                                                                                Double latitude, Double distanceNum) {
        return geoRadiusWithMeters(key, longitude, latitude, distanceNum, true);
    }

    /**
     * 以半径为单位,「米」为计算单位展开,以自定义顺序方式展示对应的信息
     *
     * @param key         缓存 Key
     * @param longitude   经度
     * @param latitude    纬度
     * @param distanceNum 距离,单位:M
     * @param ascOrder    是否按升序排
     */
    public GeoResults<RedisGeoCommands.GeoLocation<String>> geoRadiusWithMeters(String key, Double longitude,
                                                                                Double latitude, Double distanceNum,
                                                                                Boolean ascOrder) {
        Point point = new Point(longitude, latitude);
        Distance radius = new Distance(distanceNum, Metrics.NEUTRAL);
        Circle within = new Circle(point, radius);
        RedisGeoCommands.GeoRadiusCommandArgs geoRadiusCommandArgs = RedisGeoCommands.GeoRadiusCommandArgs.newGeoRadiusArgs().includeCoordinates().includeDistance();
        geoRadiusCommandArgs = ascOrder ? geoRadiusCommandArgs.sortAscending() : geoRadiusCommandArgs.sortDescending();
        return geoOperations.radius(key, within, geoRadiusCommandArgs);
    }

	public Long redisTemplateStoreSortedSearchTo(String destName, String key, Double longitude, Double latitude,
                                                 Double distanceNum, Integer limit, Boolean ascOrder) {

        Distance distance = new Distance(distanceNum, Metrics.KILOMETERS);
        RedisGeoCommands.GeoSearchStoreCommandArgs geoSearchStoreCommandArgs = RedisGeoCommands.GeoSearchStoreCommandArgs.newGeoSearchStoreArgs();
        geoSearchStoreCommandArgs.limit(limit);
        geoSearchStoreCommandArgs.sort(ascOrder ? Sort.Direction.ASC : Sort.Direction.DESC);
        GeoReference geoReference = GeoReference.fromCoordinate(longitude, latitude);
        Long searchAndStore = geoOperations.searchAndStore(key, destName, geoReference, distance, geoSearchStoreCommandArgs);
        return searchAndStore;
    }

1、geoAdd 方法 -> GEOADD 函数
2、geoRemove 方法 -> ZREM 函数

GEO 存储起来以后放在 Redis 中是以 ZSet 结构进行存储的,所以将 GEO 某个元素删除时,就调用 ZREM 函数进行删除即可

3、geoRadiusWithKilometers、geoRadiusWithMeters 方法操作的都是相同的函数,只是筛选距离的单位不同,一个是千米、一个是米,它们对应的函数有两个,GEORADIUS — 筛选附近距离的满足元素、GEORADIUS_RO — 筛选附近距离的满足元素,只支持可读

具体的方法执行逻辑可以查看以下方法源码:RedisGeoCommands#GeoRadiusCommandArgs,该方法主要对我们传入的参数进行一次封装,转换为 Redis 中可识别的函数参数可选项

public GeoResults<GeoLocation<byte[]>> geoRadius(byte[] key, Circle within, GeoRadiusCommandArgs args) {
   List<Object> params = new ArrayList<Object>();
   params.add(key);
   params.add(convert(within.getCenter().getX()));
   params.add(convert(within.getCenter().getY()));
   params.add(within.getRadius().getValue());
   params.add(getAbbreviation(within.getRadius().getMetric()));
   
   RedisCommand<GeoResults<GeoLocation<byte[]>>> command;
   if (args.getFlags().contains(GeoRadiusCommandArgs.Flag.WITHCOORD)) {
       command = new RedisCommand<GeoResults<GeoLocation<byte[]>>>("GEORADIUS_RO", postitionDecoder);
       params.add("WITHCOORD");
   } else {
       MultiDecoder<GeoResults<GeoLocation<byte[]>>> distanceDecoder = new ListMultiDecoder2(new GeoResultsDecoder(within.getRadius().getMetric()), new GeoDistanceDecoder());
       command = new RedisCommand<GeoResults<GeoLocation<byte[]>>>("GEORADIUS_RO", distanceDecoder);
       params.add("WITHDIST");
   }
   
   if (args.getLimit() != null) {
       params.add("COUNT");
       params.add(args.getLimit());
   }
   if (args.getSortDirection() != null) {
       params.add(args.getSortDirection().name());
   }
   
   return read(key, ByteArrayCodec.INSTANCE, command, params.toArray());
}

引入 RedisTemplate API 有一些特性,我们在实际应用中可能应用不到,如:

1、当 GEO 中某个成员不知道它是否存在,当不存在时可以直接新增,存在时不做任何变更,RedisTemplate API 需要操作两次函数:geoRemove、geoAdd,而下面要讲解的 Redisson API 直接可以通过一个函数搞定,好处:减少一次与 Redis 之间的连接,提高操作效率
2、使用 Redisson 客户端,实现「搜索满足距离条件的成员列表」功能时更加的便捷

若 Redisson 版本不对时,会在操作 redisTemplateZSetPopMinScore 方法时,出现如下异常:

java.lang.StackOverflowError: null at org.springframework.data.redis.connection.DefaultedRedisConnection.zPopMin(DefaultedRedisConnection.java:973)
解决办法:将 Redisson 版本降低到 3.15.6

Redisson API 操作

Redisson 操作工具类,如下:

private static final StringCodec REDISSON_CODE_C = new StringCodec();

@Resource
private RedissonClient redissonClient;

// ============================ ZSet Redisson =============================

public String redissonZSetPopMinScore(String key) {
    RScoredSortedSet<Object> scoredSortedSet = redissonClient.getScoredSortedSet(key, REDISSON_CODE_C);
    return (String) scoredSortedSet.pollFirst();
}

// ============================ Geo Redisson =============================

/**
 * 获取 Redisson GEO 类型客户端实例
 *
 * @param key 缓存 Key
 * @return 基于 Redisson GEO 操作的客户端实例
 */
private RGeo<String> getRGeoClient(String key) {
    return redissonClient.getGeo(key, REDISSON_CODE_C);
}

/**
 * 若存在的话,替换 Geo 某个 Key 成员的经纬度信息
 */
public Boolean redissonGeoAddIfExists(String key, Object member, Double longitude, Double latitude) {
    RGeo<String> geo = getRGeoClient(key);
    return geo.addIfExists(new GeoEntry(longitude, latitude, member)) > 0;
}

/**
 * 删除指定 Key > 多个 Member 元素
 *
 * @param key     缓存 Key
 * @param members 成员列表
 */
public void redissonGeoRemove(String key, List<Long> members) {
    RGeo<String> geo = getRGeoClient(key);
    geo.removeAll(members);
}

/**
 * 新增 Geo 某个 Key 成员的经纬度信息
 *
 * @param key       缓存 Key
 * @param member    成员
 * @param longitude 经度
 * @param latitude  纬度
 */
public void redissonGeoAdd(String key, Object member, Double longitude, Double latitude) {
    RGeo<String> geo = getRGeoClient(key);
    geo.add(new GeoEntry(longitude, latitude, member));
}

/**
 * 搜索满足距离条件的成员列表
 *
 * @param key         缓存 Key
 * @param longitude   经度
 * @param latitude    纬度
 * @param distanceNum 距离:KM
 * @return 匹配到的成员记录及距离
 * @see GeoUnit geoUnit
 * 以半径为中心距离,「geoUnit」为计算单位展开,以距离优先展示对应的信息
 */
public Map<String, Double> searchWithDistance(String key, Double longitude, Double latitude, Double distanceNum) {
    return searchWithDistance(key, longitude, latitude, distanceNum, GeoUnit.KILOMETERS, null);
}

/**
 * 搜索满足距离条件的成员列表
 *
 * @param key         缓存 Key
 * @param longitude   经度
 * @param latitude    纬度
 * @param distanceNum 距离:KM
 * @return 匹配到的成员记录及距离
 * @see GeoUnit geoUnit
 * 以半径为中心距离,「geoUnit」为计算单位展开,以距离优先展示对应的信息
 */
public Map<String, Double> searchWithDistance(String key, Double longitude, Double latitude, Double distanceNum, Integer limit) {
    return searchWithDistance(key, longitude, latitude, distanceNum, GeoUnit.KILOMETERS, limit);
}

/**
 * 搜索满足距离条件的成员列表
 *
 * @param key         缓存 Key
 * @param longitude   经度
 * @param latitude    纬度
 * @param distanceNum 距离
 * @param geoUnit     距离单位
 * @param limit       筛选条数
 * @return 匹配到的成员记录及距离
 * @see GeoUnit geoUnit
 * 以半径为中心距离,「geoUnit」为计算单位展开,以距离优先展示对应的信息
 */
public Map<String, Double> searchWithDistance(String key, Double longitude, Double latitude, Double distanceNum, GeoUnit geoUnit, Integer limit) {
    RGeo<String> geo = getRGeoClient(key);
    GeoSearchArgs args;
    if (null != limit) {
        args = GeoSearchArgs.from(longitude, latitude).radius(distanceNum, geoUnit).order(GeoOrder.ASC).count(limit);
    } else {
        args = GeoSearchArgs.from(longitude, latitude).radius(distanceNum, geoUnit).order(GeoOrder.ASC);
    }
    return geo.searchWithDistance(args);
}

/**
 * 存储搜索满足条件的成员列表
 *
 * @param destName    存储 ZSet Key
 * @param key         搜索目标 Key
 * @param longitude   经度
 * @param latitude    纬度
 * @param distanceNum 距离
 */
public Boolean storeSortedSearchTo(String destName, String key, Double longitude, Double latitude,
                                   Double distanceNum) {
    return storeSortedSearchTo(destName, key, longitude, latitude, distanceNum, GeoUnit.KILOMETERS, null);
}

/**
 * 此处的应用场景:
 * 1、当用户下单以后,通过该方法将用户下单所在经纬度最近的工人都统计出来
 * 2、统计出来的数据再次进行一次比对,若工人未开启接单,那么该工人所在元素会被移除掉
 * 3、当工人端拒绝接单,那么该工人所在元素从 ZSET 中移除
 * 4、当工人端已接单并且开始服务,那么该用户所在的统计数据可被移除
 *
 * @param destName    存储 ZSet Key
 * @param key         搜索目标 Key
 * @param longitude   经度
 * @param latitude    纬度
 * @param distanceNum 距离
 * @param geoUnit     距离单位
 * @param limit       条数
 */
public Boolean storeSortedSearchTo(String destName, String key, Double longitude, Double latitude,
                                   Double distanceNum, GeoUnit geoUnit, Integer limit) {
    RGeo<String> geo = getRGeoClient(key);
    GeoSearchArgs args;
    if (null != limit) {
        args = GeoSearchArgs.from(longitude, latitude)
                            .radius(distanceNum, geoUnit)
                            .order(GeoOrder.ASC)
                            .count(limit);
    } else {
        args = GeoSearchArgs.from(longitude, latitude)
                            .radius(distanceNum, geoUnit)
                            .order(GeoOrder.ASC);
    }
    return geo.storeSortedSearchTo(destName, args) > 0;
}

Redisson 中对不同的编码还进行了优化,若知道当前存储或查询的元素属于非字符类型,可以通过以下类型来指定:

1、字符型:StringCodec,默认使用 UTF-8 编码方式
2、字节数组型:ByteArrayCodec
3、整型:IntegerCodec
4、浮点型:DoubleCodec

它们共同的父类为 BaseCodec,除了字符型,其他的编码类型都有实现各自的解码器

1、redissonGeoAdd 方法 -> GEOADD 函数
2、redissonGeoRemove 方法 -> ZREM 函数

与 RedisTemplate API 一致,GEO 存储起来以后放在 Redis 中是以 ZSet 结构进行存储的,所以将 GEO 某个元素删除时,就调用 ZREM 函数进行删除即可

3、redissonGeoAddIfExists -> GEOPOS、GEOADD 函数一起组合使用的

可观察该方法的实现:RedissonGeo#addIfExistsAsync,内部使用 Redis Lua 脚本实现了这两个函数的组合运用,当 GEOPOS 返回的数据为真时,那么就调用 GEOADD 函数将当前元素存入 GEO Key 中

4、searchWithDistance 方法,它对应的函数有两个,GEORADIUS — 筛选附近距离的满足元素、GEORADIUS_RO — 筛选附近距离的满足元素,只支持可读
5、storeSortedSearchTo 方法,将筛选出来的内容存储到一个新的 ZSet Key 中

应用场景如下:当用户在某个地点下单以后,需要筛选它附近可派单的工人,可筛选指定人数(只要满足服务距离条件)存储到新的 Key 中,当存储完成以后,即使第一个被派单的工人取消服务了,可以利用 ZSet 作为一个栈的结构,按照最近或最远的方式进行一个一个的弹出来 > Pop,结合 redissonZSetPopMinScore 方法天衣无缝!!

小结

1、若要使用 RedisTemplate API 中的 redisTemplateStoreSortedSearchTo 方法或者使用 Redisson API 中的 storeSortedSearchTo 方法,Redis 服务端的版本必须高于或等于 6.2.0

Redis GEO 类型与 API 结合,地理位置优化的绝佳实践,Redis,MySQL,业务设计,redis,数据库,缓存

这两个方法对应 Redis 中的 GEOSEARCHSTORE 函数,可以使用 help GEOSEARCHSTORE 命令,结合帮助文档运用起来

2、在如何考虑是否引入一个新的组件,来减少对数据库造成的压力,就需要看地理位置这块筛选的工作数据量有多大了,数据量大的话,宁愿基于内存来完成地理位置筛选,也不要将查询数据压力放在基于磁盘的数据库

3、引入一个新的组件,必然而然会考虑到引入这个组件会带来哪些问题,那么又要解决好组件给我们的问题了,数据存储到内存中并不可靠,所以在对引入 Redis 组件时,我们要把它的持久化机制考虑进去,结合 Redis 保证地理位置查询性能高效、持久化机制保证数据可靠

Redis 持久化机制类型:AOF、RDB
1、采用 AOF 方式进行持久化,一行一行 Redis 命令会入文件,会导致文件过大,从而造成恢复数据速度会很慢,也会给机器磁盘带来存储压力,好处就是能保证数据基本不丢失
2、采用 RDB 方式进行持久化,会导致一部分数据在瞬时丢失,从而就导致了数据存储不可靠,好处就是恢复速率快
3、结合以上两种方式都有缺点,AOF+RDB 结合作为持久化方式,不仅仅用到了 AOF 数据可靠性也用到了 RDB 恢复数据的效率性

Redis 持久化机制 AOF、RDB、AOF+RDB 方式的详细内容,会在后续有文章进行介绍,敬请期待!!

总结

该篇博文,主要先是进行「地理位置」生产性能问题的全流程演化,从 MySQL -> +索引 -> 不 + 索引,使用了案例 SQL 进行执行计划的分析,从而得出了 MySQL 在特殊场景下不适用于做地理位置的筛选工作「因为它本身基于磁盘的,在大数据量情况下,不能肆意打压瓶颈」;随即采用了 Redis GEO 类型来优化了地理位置的筛选工作,结合 RedisTemplate、Redisson 客户端 API 实战函数进行讲解,从零到一教你如何运用程序结合 Redis GEO 数据类型完成地理位置的优化工程,希望此博文你能够喜欢!

🌟🌟🌟愿你我都能够在寒冬中相互取暖,互相成长,只有不断积累、沉淀自己,后面有机会自然能破冰而行!

博文放在 Redis 专栏里,欢迎订阅,会持续更新!

如果觉得博文不错,关注我 vnjohn,后续会有更多实战、源码、架构干货分享!

推荐专栏:Spring、MySQL,订阅一波不再迷路

大家的「关注❤️ + 点赞👍 + 收藏⭐」就是我创作的最大动力!谢谢大家的支持,我们下文见!文章来源地址https://www.toymoban.com/news/detail-714461.html

到了这里,关于Redis GEO 类型与 API 结合,地理位置优化的绝佳实践的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • uniapp获取地理位置的API是什么?

    UniApp获取地理位置的API是 uni.getLocation 。它的作用是获取用户的当前地理位置信息,包括经纬度、速度、高度等。通过该API,开发者能够实现基于地理位置的功能,如显示用户所在位置附近的商家、导航服务、天气查询等。 以下是一个示例,展示如何使用uni.getLocation来获取用

    2024年02月07日
    浏览(34)
  • 分享几个IP获取地理位置的API

    一、请求接口(GET): https://ip.taobao.com/outGetIpInfo?ip=IP地址accessKey=alibaba-inc 二、返回数据格式: 三、频次限制: 每个用户的访问频率需小于1qps 四、文档说明: http://ip.taobao.com/instructions.html 五、代码片段: 一 、请求接口(GET): http://freeapi.ipip.net/ip地址字串 二、返回数据

    2024年02月03日
    浏览(35)
  • 探索Redis特殊数据结构:Geospatial(地理位置)在实际中的应用

    Redis官方提供了多种数据类型,除了常见的String、Hash、List、Set、zSet之外,还包括Stream、Geospatial、Bitmaps、Bitfields、Probabilistic(HyperLogLog、Bloom filter、Cuckoo filter、t-digest、Top-K、Count-min sketch、Configuration)和Time series。这些数据类型在Redis的数据结构中发挥着各自独特的作用。

    2024年02月20日
    浏览(32)
  • 用户Ip地址和百度地图api接口获取用户地理位置(经纬度坐标,城市)

    ?php //获取用户ip(外网ip 服务器上可以获取用户外网Ip 本机ip地址只能获取127.0.0.1) function   getip(){      if (! empty ( $_SERVER [ \\\"HTTP_CLIENT_IP\\\" ])){      $cip   =  $_SERVER [ \\\"HTTP_CLIENT_IP\\\" ];      }      else   if (! empty ( $_SERVER [ \\\"HTTP_X_FORWARDED_FOR\\\" ])){      $cip   =  $_SERVER [ \\\"HTTP_X_FOR

    2024年02月11日
    浏览(54)
  • 地理空间分析12——地理位置数据隐私与安全

    在数字化时代,地理位置数据成为了众多应用程序和服务不可或缺的一部分。从导航应用到社交媒体,从广告定位到城市规划,地理位置数据的应用范围广泛。然而,这些数据的收集和使用也引发了广泛的隐私和安全担忧。本文将探讨地理位置数据隐私的挑战和重要性,并介

    2024年03月19日
    浏览(43)
  • 小程序地理位置接口申请

    申请接口理由: wx.chooseAddress 获取用户收货地址提交理由: 快速定位用户当前位置,获取省市区等地址信息,方便用户提交地址等信息 wx.chooseLocation打开地图选择位置接口提交理由: 为了方便用户能够快速的获取地址, 定位用户位置信息 wx.getLocation获取当前地理位置,速度:

    2024年02月12日
    浏览(29)
  • Unity 获取手机地理位置信息

    在游戏的开发过程中,有时候会遇到需要获取玩家位置信息的需求,比如显示玩家所在的国家城市等。 有一下方法可以参考: 可以根据手机的地区和语言来做判断。 根据IP来判断所处的位置,阿里云啥的都有对应的接口服务。 根据GPS来判断。 以上方法都各有利弊吧,这里简

    2024年02月12日
    浏览(36)
  • 通过ip获取地理位置信息

    GeoLite2-City.mmdb 文件是 MaxMind 公司提供的一个免费的 IP 地址与城市地理位置映射数据库文件。它包含了 IP 地址范围与对应的城市、地区、国家、经纬度等地理位置信息的映射。这种数据库文件可以用于识别访问您的应用程序或网站的用户的地理位置,从而实现针对不同地区的

    2024年02月12日
    浏览(32)
  • Unity之获取用户地理位置

    1.1 利用bilibili的api 【未知稳定性】 lua代码  1.2 利用baidu api 【配额超限,需要扩充配额,需要联系官方】 2.1 API: \\\"https://api.ipify.org\\\" 和 心知天气官网“心知天气 - 高精度气象数据 - 天气数据API接口 - 行业气象解决方案” 获取公网IP 根据IP获取地理信息和天气信息,json反解析

    2024年02月14日
    浏览(32)
  • 使用uniapp开发获取地理位置

    老板要求做一个微信小程序,后面又希望能转为app. 所以选择了uniapp开发. 我的体验和感想就是以后不用uniapp了. 资源不多,学习了可能用处也不大.适合外包的干.这里写一下使用uniapp开发微信小程序获取地理位置 基本逻辑是使用uniapp的api首先获得地理经纬度位置等信息(在这之前

    2024年02月07日
    浏览(37)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包