지리 공간(Geospatial) 값은 지구상 특정 위치에 대한 경도(longitude)와 위도(latitude) 좌표를 포함하는 데이터입니다. Redis에서는 지리 공간 요소를 정렬된 집합(Sorted Set) 형태로 키에 저장하며, 다양한 전용 명령어를 통해 이러한 값을 손쉽게 저장, 관리, 조회할 수 있습니다.
기본 문법
redis host:port> <명령어> <키 이름>
예제
Redis GEO 주요 명령어
Redis 데이터베이스에서 지리 공간 값을 관리할 때 자주 사용되는 핵심 명령어는 다음과 같습니다.
| 번호 | 명령어 | 설명 |
|---|---|---|
| 1 | GEOADD | 지리 공간 값에 하나 이상의 요소(위치)를 추가합니다. |
| 2 | GEORADIUS | 주어진 좌표(경도·위도)를 중심으로 반경 내에 있는 요소들을 반환합니다. |
| 3 | GEORADIUSBYMEMBER | 지리 공간 값에 저장된 특정 멤버를 중심으로 반경 내에 있는 요소들을 반환합니다. |
| 4 | GEODIST | 지리 공간 값에 속한 두 멤버 간의 거리를 반환합니다. |
| 5 | GEOHASH | 지리 공간 값에 속한 하나 이상의 멤버에 대한 Geohash 값을 반환합니다. |
| 6 | GEOPOS | 지리 공간 값에 속한 하나 이상의 멤버에 대한 위치(경도·위도)를 반환합니다. |
참고 사항
Redis 6.2 버전부터 GEORADIUS와 GEORADIUSBYMEMBER는 더 이상 권장되지 않으며(deprecated), 대신 확장성과 유연성이 뛰어난 GEOSEARCH, GEOSEARCHSTORE 명령어 사용이 권장됩니다. 새 프로젝트에서는 GEOSEARCH 계열 명령어를 사용하는 것이 좋습니다.
참고 자료
- Redis 공식 문서 – GEO Command Docs
지금까지 Redis에서 지리 공간 값을 저장하고 관리하는 데 사용되는 GEO 명령어에 대해 알아보았습니다. 이 글이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!