🌏 2.7.2 지리적 공간 인덱스 (Geospatial Index)
📘 개요

지리적 공간 정보는 위도(latitude)와 경도(longitude)를 이용해 지구상 위치를 표현하는 데이터입니다.

Redis에서는 이 정보를 활용해 위치 기반 검색, 거리 계산, 반경 내 검색 등 공간 데이터를 효율적으로 다룰 수 있습니다.

내부적으로 Sorted Set(정렬된 집합) 구조를 기반으로 동작합니다.

🧭 기본 개념
🔹 저장 원리

위치 정보는 Sorted Set 형태로 저장되며, 각 멤버의 스코어(score)는 GeoHash 값으로 변환되어 저장됩니다.

GeoHash는 위도·경도를 문자 형태로 인코딩한 값으로, 가까운 위치일수록 해시가 유사한 접두어를 가집니다.

예시:

도시 위도 경도 GeoHash
Tokyo 35.6812362 139.7671248 xn76urx660p
Osaka 34.7024854 135.4937619 xn76um7jts9k
🧩 실행 예시

1️⃣ 위치 정보 추가

GEOADD mygeo 139.7671248 35.6812362 "Tokyo Station" \
135.4937619 34.7024854 "Osaka Station"
(integer) 2

2️⃣ 두 지점 간 거리 계산 (미터 단위)

GEODIST mygeo "Tokyo Station" "Osaka Station"
"403362.9301"

3️⃣ 위치의 GeoHash 조회

GEOHASH mygeo "Tokyo Station"
"xn76urx660p"

TYPE 명령어로 확인하면 내부적으로 zset 형식임을 알 수 있습니다.

TYPE mygeo

결과: zset

🧮 GeoHash의 원리

위도와 경도를 문자열(보통 Base32) 로 변환하여 저장.

인접 지역일수록 해시 접두부가 유사합니다.

해시 자릿수가 많을수록 정밀도가 증가하지만, 영역 범위는 좁아집니다.

예:

xn76urx6 → 도쿄 근처

xn76um7j → 오사카 근처

🧰 주요 명령어 요약
명령어 기능 시간 복잡도
GEOADD key lon lat member [lon lat member ...] 위치 정보 추가 O(logN)
GEOPOS key member [...] 멤버의 위도·경도 반환 O(1)
GEODIST key m1 m2 [M KM FT
GEOHASH key member [...] GeoHash 문자열 반환 O(1)
GEOSEARCH key FROMMEMBER member BYRADIUS r M KM ...** 특정 반경 내 위치 검색
GEOSEARCHSTORE dest source FROMMEMBER member BYRADIUS ... 검색 결과를 다른 키에 저장 O(N + logM)
📏 거리 단위
단위 설명
M 미터 (기본 단위)
KM 킬로미터
FT 피트
MI 마일
🧮 활용 예시

도쿄/오사카 위치 저장

GEOADD building-location 139.7671248 35.6812362 "Tokyo Station" \
135.4937619 34.7024854 "Osaka Station"

GeoHash 확인

GEOHASH building-location "Tokyo Station" "Osaka Station"
1) "xn76urx660p"
2) "xn76um7jts9k"

위도·경도 확인

GEOPOS building-location "Tokyo Station"
1) "139.76712494988577271"
2) "35.68123554127875963"

거리 계산

GEODIST building-location "Tokyo Station" "Osaka Station"
"403362.9301"

🧭 반경 검색 (반경 내 위치 찾기)

경도 140, 위도 30 기준으로 반경 700km 이내 위치 검색

GEORADIUS building-location 140 30 700 km
1) "Osaka Station"
2) "Tokyo Station"

반경 650km로 줄이면?

GEORADIUS building-location 140 30 650 km
1) "Tokyo Station"

반경 100km이면?

(empty array)

Tokyo와 Osaka 중 어느 위치가 반경 내 포함되는지 한눈에 확인 가능.

⚙️ GEORADIUSBYMEMBER (멤버 중심 반경 검색)

Tokyo Station을 중심으로 반경 400km 이내 검색

GEORADIUSBYMEMBER building-location "Tokyo Station" 400 km
1) "Tokyo Station"

반경 410km 이내 검색

GEORADIUSBYMEMBER building-location "Tokyo Station" 410 km
1) "Osaka Station"
2) "Tokyo Station"

Tokyo를 중심으로 400km까지는 자기 자신만 포함되고,
410km 이상이면 Osaka까지 포함됩니다.

⚠️ 주의 — 명령어 변경

Redis 6.2 이후 버전에서는 GEORADIUS와 GEORADIUSBYMEMBER 명령이 폐지 예정이며,
대신 GEOSEARCH 및 GEOSEARCHSTORE 명령으로 대체됩니다.

폐지 예정 대체 명령
GEORADIUS GEOSEARCH
GEORADIUSBYMEMBER GEOSEARCHSTORE
📘 요약 정리
항목 설명
자료 구조 내부적으로 Sorted Set 사용
핵심 기능 거리 계산, 반경 내 검색, 위치 저장
활용 분야 매장 찾기, 배달 반경 계산, 근처 사용자 검색
핵심 명령어 GEOADD, GEODIST, GEOHASH, GEOSEARCH, GEOSEARCHSTORE
GeoHash 위도·경도를 문자열로 변환하여 인접 위치를 표현