उदाहरण के साथ Redis GEORADIUSBYMEMBER कमांड

इस ट्यूटोरियल में, हम सीखेंगे कि भू-स्थानिक मूल्य के तत्वों को एक कुंजी पर कैसे संग्रहीत किया जाए, जो विशिष्ट क्षेत्र के अंतर्गत आता है। इसके लिए हम एक Redis GEORADIUSBYMEMBER . का उपयोग करेंगे आदेश।

GEORADIUSBYMEMBER कमांड

इस कमांड का उपयोग एक कुंजी पर संग्रहीत भू-स्थानिक मूल्य (सॉर्टेड सेट) के एक या अधिक सदस्यों को वापस करने के लिए किया जाता है, जो देशांतर, निर्दिष्ट सदस्य के अक्षांश मान और त्रिज्या तर्कों का उपयोग करके गणना की गई क्षेत्र की सीमा के अंदर होते हैं। इस क्षेत्र की गणना निर्दिष्ट सदस्य के देशांतर, अक्षांश मान को वृत्त के केंद्र स्थान के रूप में और निर्दिष्ट इकाई में त्रिज्या को वृत्त की त्रिज्या के रूप में उपयोग करके की जाती है।

त्रिज्या निम्न में से किसी एक इकाई का उपयोग करके निर्दिष्ट की जाती है:-

m मीटर के लिए (डिफ़ॉल्ट)।
किमी किलोमीटर के लिए।
mi मीलों के लिए।
ft पैरों के लिए।

वैकल्पिक तर्क

Redis GEORADIUSBYMEMBER कमांड निम्नलिखित वैकल्पिक तर्क लेता है :-

विथिस्ट:- यह सर्कल के केंद्र से लौटे तत्वों की दूरी लौटाता है। दूरी की इकाई त्रिज्या तर्क की इकाई के समान है।
WITHCOORD:- यह सभी लौटे हुए तत्वों के देशांतर, अक्षांश निर्देशांक देता है।
WITHHASH :- यह सभी लौटाए गए तत्वों की कच्ची जियोश स्ट्रिंग (52 बिट अहस्ताक्षरित पूर्णांक) देता है। यह जियोश स्ट्रिंग क्रमबद्ध सेट में एक तत्व का स्कोर है।
ASC:- यह तत्वों को केंद्र के सापेक्ष निकटतम से सबसे दूर के क्रम में लौटाता है। डिफ़ॉल्ट रूप से तत्वों को क्रमबद्ध क्रम में लौटाया जाता है।
DESC:- यह केंद्र के सापेक्ष सबसे दूर से निकटतम छँटाई क्रम में तत्वों को लौटाता है।
COUNT <गिनती> :- यह पहले तक सीमित तत्वों को लौटाता है गिनती मिलान करने वाले तत्व। डिफ़ॉल्ट रूप से सभी मेल खाने वाले तत्व वापस आ जाते हैं।

वापसी मूल्य

यह आदेश निम्न प्रकार के मानों के साथ एक सरणी उत्तर देता है:-

अगर [साथ ] वैकल्पिक तर्क निर्दिष्ट नहीं हैं, यह आदेश तत्व के नाम वाली एक सरणी देता है।
अगर WTHCOORD , विथडिस्ट , साथ में विकल्प निर्दिष्ट हैं, यह आदेश सरणी की एक सरणी देता है, जहां प्रत्येक उप सरणी एक तत्व का प्रतिनिधित्व करती है। उप सरणी में पहला आइटम हमेशा लौटाए गए तत्व का नाम होता है और अन्य जानकारी निम्नलिखित क्रम में वापस कर दी जाती है:-
1. एक फ्लोटिंग पॉइंट नंबर के रूप में केंद्र से दूरी, त्रिज्या में निर्दिष्ट एक ही इकाई में।
2. जियोहैश इंटीजर।
3. निर्देशांक दो आइटम x,y सरणी (देशांतर, अक्षांश) के रूप में।

जब कुंजी मौजूद नहीं होती है तो शून्य वापस आ जाता है और कुंजी मौजूद होने पर त्रुटि वापस आ जाती है, लेकिन कुंजी पर संग्रहीत मान सॉर्ट किए गए सेट डेटाटाइप का नहीं होता है, जिसे GEOADD कमांड का उपयोग करके पॉप्युलेट किया जाता है। रेडिस GEORADIUSBYMEMBER कमांड का सिंटैक्स इस प्रकार है :-

वाक्यविन्यास :-

redis host:post> GEORADIUSBYMEMBER <keyname> <member> <radius> [UNIT] [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key]

आउटपुट :-

- (array) reply, representing the elements of geospatial values.
- Nil, if key does not exist.
- Error, if key exist and value stored at the key is not a sorted set populated using GEOADD command.