Geospatial-地理空间

逃离我推掉我的手 2022-09-08 14:50 277阅读 0赞

**本文已收录于专栏**

[❤️《Redis之大厂必备技能包》❤️][Redis]

**欢迎各位关注、三连博主的文章及专栏，全套Redis学习资料，大厂必备技能！**

--------------------

**目录**

一、简介

二、命令

2.1 GEOADD

2.2 GEOPOS

2.3 GEODIST

2.4 GEORADIUS

2.5 GEORADIUSBYMEMBER

2.6 GEOHASH

三、中国省会城市的经纬度

--------------------

## 一、简介 ##

Geospatial是Redis在3.2版本以后增加的地理位置GEO模块，这个模块可以用来实现微信附近的人，在线点餐“附近的餐馆”等位置功能。

## 二、命令 ##

### 2.1 GEOADD ###

**命令简介：**

> **GEOADD key longitude latitude member \[longitude latitude member …\]**

![image.png][]

将给定的空间元素（维度、经度、名字）添加到指定的键里面，数据以有序集合的形式被存放在键中。GEOADD接收的参数必须先输入经度，然后输入维度。  
GEOADD经纬度的输入范围如下（对两极不支持）：

1.  有效经度介于-180°~180°之间
2.  有效维度介于-85.05112878°至85.05112878°之间

当用户尝试输入一个超出范围的经度或者纬度时， GEOADD 命令将返回一个错误。

**代码示例：**  
可以依次添加单个，也可以同时添加多个地理位置的元素。

127.0.0.1:6379> geoadd city 116.405289 39.904987 beijing
    (integer) 1
    127.0.0.1:6379> geoadd city 117.190186 39.125595 tianjin
    (integer) 1
    127.0.0.1:6379> geoadd city 121.472641 31.231707 shanghai
    (integer) 1
    127.0.0.1:6379> geoadd city 112.982277 28.19409 changsha 113.28064 23.125177 guangzhou
    (integer) 2

![image.png][image.png 1]

**错误示例：**

127.0.0.1:6379> geoadd city 190 18 buzhidao
    (error) ERR invalid longitude,latitude pair 190.000000,18.000000

![image.png][image.png 2]

### 2.2 GEOPOS ###

**命令简介：**

> **GEOPOS key member \[member …\]**

根据键（key）获取给定位置元素的位置（经度和纬度），GEOPOS 可以接收一个member，也可以接收多个member，如果member不存在则返回nil

**代码示例：**

127.0.0.1:6379> geopos beijing
    (empty array)
    127.0.0.1:6379> geopos city beijing
    1) 1) "116.40528827905654907"
       2) "39.90498588819134085"
    127.0.0.1:6379> geopos city tianjin shanghai
    1) 1) "117.19018846750259399"
       2) "39.12559461779084558"
    2) 1) "121.47264093160629272"
       2) "31.23170744181923197"
    127.0.0.1:6379> geopos city xiaoriben
    1) (nil)

![image.png][image.png 3]

### 2.3 GEODIST ###

**命令简介：**

> **GEODIST key member1 member2 \[unit\]**

返回两个给定位置之间的距离，以双精度浮点数的形式被返回。如果给定的位置其中一个不存在（两个都不存在也是一样，下面有示例），将会返回空值（nil）。

**unit单位描述：**

*  m -> 米
 *  km -> 千米
 *  mi -> 英里
 *  ft -> 英尺

**默认单位：**  
如果用户未给定指定单位unit，则默认为米（m）

**误差范围：**  
GEODIST 计算的算法会将地球考虑为一个完全球体，在极限情况下，存在最大0.5%的误差

**代码示例：**

127.0.0.1:6379> geodist city beijing shanghai m
    "1067597.0432"
    127.0.0.1:6379> geodist city beijing shanghai km
    "1067.5970"
    127.0.0.1:6379> geodist city beijing xiaoriben
    (nil)
    127.0.0.1:6379> geodist city meiguoguizi xiaoriben
    (nil)

![image.png][image.png 4]

### 2.4 GEORADIUS ###

**命令简介：**

> GEORADIUS key longitude latitude radius m|km|ft|mi \[WITHCOORD\] \[WITHDIST\] \[WITHHASH\] \[ASC|DESC\] \[COUNT count\]

以给定的经纬度为中心， 返回键包含的位置元素当中， 与中心的距离不超过给定最大距离的所有位置元素。

**m|km|ft|mi选项：**

*  m -> 米
 *  km -> 千米
 *  mi -> 英里
 *  ft -> 英尺

**\[WITHCOORD\] \[WITHDIST\] \[WITHHASH\]选项：**

*  \[WITHCOORD\]：将位置元素的经度和纬度也一并返回。
 *  \[WITHDIST\] ：在返回位置元素的同时， 将位置元素与中心之间的距离也一并返回。 距离的单位和用户给定的范围单位保持一致。
 *  \[WITHHASH\]： 以 52 位有符号整数的形式， 返回位置元素经过原始 geohash 编码的有序集合分值。 这个选项主要用于底层应用或者调试， 实际中的作用并不大。

**\[ASC|DESC\] 选项：**

*  ASC：根据给定的中心位置，从近到远返回位置元素
 *  DESC：根据给定的中心位置，从远到近返回位置元素

**\[COUNT count\] 参数：**  
GEORADIUS 默认会返回符合条件的全部位置元素。但是用户可以通过\[COUNT count\] 参数去指定获取前N个匹配元素。这个参数可以减少需要返回的元素数量，一定程度上可以减少带宽压力。

**返回值：**  
GEORADIUS 的返回值是一个数组，但是数组的内容会根据是否存在上述参数而改变

*  未给定任何WITH参数，则返回普通线性列表
 *  给定\[WITHCOORD\] \[WITHDIST\] \[WITHHASH\]等参数后返回一个二层嵌套数组

具体返回值请查看后续示例，建议还是自己多搞几次就清楚了

**代码示例：**  
未给定任何WITH参数

127.0.0.1:6379> georadius city 116.405289 39.904987 1000 km
    1) "tianjin"
    2) "beijing"

给定\[WITHCOORD\] \[WITHDIST\] \[WITHHASH\]等参数，返回的时二层嵌套数组

127.0.0.1:6379> georadius city 116.405289 39.904987 1000 km withcoord
    1) 1) "tianjin"
       2) 1) "117.19018846750259399"
          2) "39.12559461779084558"
    2) 1) "beijing"
       2) 1) "116.40528827905654907"
          2) "39.90498588819134085"

127.0.0.1:6379> georadius city 116.405289 39.904987 1000 km withdist
    1) 1) "tianjin"
       2) "109.7754"
    2) 1) "beijing"
       2) "0.0001"

### 2.5 GEORADIUSBYMEMBER ###

**命令简介：**

> GEORADIUSBYMEMBER key member radius m|km|ft|mi \[WITHCOORD\] \[WITHDIST\] \[WITHHASH\] \[ASC|DESC\] \[COUNT count\]

GEORADIUSBYMEMBER与GEORADIUS的区别在于，GEORADIUSBYMEMBER无需给定经纬度，只需要给定成员的key就行，具体使用与GEORADIUS一致

**代码示例：**

127.0.0.1:6379> georadiusbymember city beijing 1000 km
    1) "tianjin"
    2) "beijing"

127.0.0.1:6379> georadiusbymember city beijing 1000 km withcoord
    1) 1) "tianjin"
       2) 1) "117.19018846750259399"
          2) "39.12559461779084558"
    2) 1) "beijing"
       2) 1) "116.40528827905654907"
          2) "39.90498588819134085"

### 2.6 GEOHASH ###

**命令名称：**

> **GEOHASH key member \[member …\]**

返回一个或多个位置元素的GeoHash表示，可以给顶多个key中的member，因此返回的是一个数组。

**代码示例：**

127.0.0.1:6379> geohash city beijing shanghai changsha
    1) "wx4g0b7xru0"
    2) "wtw3sjt9vs0"
    3) "wt026ux4mz0"

## 三、中国省会城市的经纬度 ##

为了便于各位大佬们学习Geospatial的学习，我整理了全国省会城市的经纬度在这，有需要的可以自取。

<table> 
 <thead> 
  <tr> 
   <th><strong>名称</strong></th> 
   <th><strong>经度</strong></th> 
   <th><strong>维度</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>北京市</td> 
   <td>116.405289</td> 
   <td>39.904987</td> 
  </tr> 
  <tr> 
   <td>天津市</td> 
   <td>117.190186</td> 
   <td>39.125595</td> 
  </tr> 
  <tr> 
   <td>呼和浩特市</td> 
   <td>111.751990</td> 
   <td>40.841490</td> 
  </tr> 
  <tr> 
   <td>银川市</td> 
   <td>106.232480</td> 
   <td>38.486440</td> 
  </tr> 
  <tr> 
   <td>石家庄市</td> 
   <td>114.502464</td> 
   <td>38.045475</td> 
  </tr> 
  <tr> 
   <td>济南市</td> 
   <td>117.000923</td> 
   <td>36.675808</td> 
  </tr> 
  <tr> 
   <td>郑州市</td> 
   <td>113.665413</td> 
   <td>34.757977</td> 
  </tr> 
  <tr> 
   <td>西安市</td> 
   <td>108.948021</td> 
   <td>34.263161</td> 
  </tr> 
  <tr> 
   <td>武汉市</td> 
   <td>114.298569</td> 
   <td>30.584354</td> 
  </tr> 
  <tr> 
   <td>南京市</td> 
   <td>118.76741</td> 
   <td>32.041546</td> 
  </tr> 
  <tr> 
   <td>合肥市</td> 
   <td>117.283043</td> 
   <td>31.861191</td> 
  </tr> 
  <tr> 
   <td>上海市</td> 
   <td>121.472641</td> 
   <td>31.231707</td> 
  </tr> 
  <tr> 
   <td>长沙市</td> 
   <td>112.982277</td> 
   <td>28.19409</td> 
  </tr> 
  <tr> 
   <td>南昌市</td> 
   <td>115.892151</td> 
   <td>28.676493</td> 
  </tr> 
  <tr> 
   <td>杭州市</td> 
   <td>120.15358</td> 
   <td>30.287458</td> 
  </tr> 
  <tr> 
   <td>福州市</td> 
   <td>119.306236</td> 
   <td>26.075302</td> 
  </tr> 
  <tr> 
   <td>广州市</td> 
   <td>113.28064</td> 
   <td>23.125177</td> 
  </tr> 
  <tr> 
   <td>台北市</td> 
   <td>121.5200760</td> 
   <td>25.0307240</td> 
  </tr> 
  <tr> 
   <td>海口市</td> 
   <td>110.199890</td> 
   <td>20.044220</td> 
  </tr> 
  <tr> 
   <td>南宁市</td> 
   <td>108.320007</td> 
   <td>22.82402</td> 
  </tr> 
  <tr> 
   <td>重庆市</td> 
   <td>106.504959</td> 
   <td>29.533155</td> 
  </tr> 
  <tr> 
   <td>昆明市</td> 
   <td>102.71225</td> 
   <td>25.040609</td> 
  </tr> 
  <tr> 
   <td>贵阳市</td> 
   <td>106.713478</td> 
   <td>26.578342</td> 
  </tr> 
  <tr> 
   <td>成都市</td> 
   <td>104.065735</td> 
   <td>30.659462</td> 
  </tr> 
  <tr> 
   <td>兰州市</td> 
   <td>103.834170</td> 
   <td>36.061380</td> 
  </tr> 
  <tr> 
   <td>西宁市</td> 
   <td>101.777820</td> 
   <td>36.617290</td> 
  </tr> 
  <tr> 
   <td>拉萨市</td> 
   <td>91.11450</td> 
   <td>29.644150</td> 
  </tr> 
  <tr> 
   <td>乌鲁木齐市</td> 
   <td>87.616880</td> 
   <td>43.826630</td> 
  </tr> 
  <tr> 
   <td>沈阳市</td> 
   <td>123.429092</td> 
   <td>41.796768</td> 
  </tr> 
  <tr> 
   <td>长春市</td> 
   <td>125.324501</td> 
   <td>43.886841</td> 
  </tr> 
  <tr> 
   <td>哈尔滨市</td> 
   <td>126.642464</td> 
   <td>45.756966</td> 
  </tr> 
  <tr> 
   <td>香港</td> 
   <td>114.165460</td> 
   <td>22.275340</td> 
  </tr> 
  <tr> 
   <td>澳门</td> 
   <td>113.549130</td> 
   <td>22.198750</td> 
  </tr> 
 </tbody> 
</table>

[Redis]: https://blog.csdn.net/qq_41125219/category_11179094.html
[image.png]: /images/20220829/0f6a94c96a724cefbf854d599f01d11b.png
[image.png 1]: /images/20220829/b76a120460334247b71d5cc36cb405d9.png
[image.png 2]: /images/20220829/9ebb7e70975d4dcdaa5059a715165e1b.png
[image.png 3]: /images/20220829/360742563b694ecbaaeb95e92cb26573.png
[image.png 4]: /images/20220829/be5bcbf42af5421384e89a21204cd597.png