Redis GEODIST 명령어 – 지리 공간 데이터의 두 멤버 간 거리 구하는 방법

이 튜토리얼에서는 Redis에 저장된 지리 공간 값(geospatial value)에서 두 멤버 사이의 거리를 구하는 방법을 알아봅니다. 이 작업에는 GEODIST 명령어를 사용합니다.

GEODIST 명령어란?

GEODIST 명령어는 키에 저장된 지리 공간 값(정렬 집합, Sorted Set)에서 지정한 두 멤버 사이의 거리를 지정한 단위로 반환합니다. 만약 지정한 멤버 중 하나 또는 둘 다 지리 공간 값에 존재하지 않으면 null이 반환됩니다.

지원되는 거리 단위

1. m – 미터(meter), 기본값
2. km – 킬로미터(kilometer)
3. mi – 마일(mile)
4. ft – 피트(feet)

키가 존재하지 않으면 Nil이 반환되며, 키는 존재하지만 해당 키에 저장된 값이 GEOADD 명령어로 생성된 정렬 집합(Sorted Set)이 아닌 경우에는 오류(error)가 반환됩니다.

문법(Syntax)

redis host:port> GEODIST <keyname> <member-1> <member-2> [unit]

반환 값(Output)

- (string) : 지정한 단위로 계산된 거리 값
- Nil : 키가 존재하지 않는 경우
- Error : 키는 존재하지만 값이 GEOADD로 생성된 정렬 집합이 아닌 경우

예제(Example)

참고 자료(References)

1. Redis 공식 문서 – GEODIST Command Docs

지금까지 Redis 데이터 스토어에 저장된 지리 공간 값의 두 멤버 사이 거리를 구하는 방법을 살펴보았습니다. 내용이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!

<- Geo 명령어 목록으로 돌아가기