जियोआईपी और Django

वेब डेवलपर्स अक्सर अपने आईपी पते द्वारा उपयोगकर्ता का पता लगाने के क्लासिक कार्य का सामना करते हैं। उदाहरण के लिए, कई अलग-अलग समाधान हैं, जो कि मैक्समाइंड जियोलाइट बेस या रूसी इपोजोबेस पर आधारित है। उन सभी के पास काफी निम्न-स्तर के एपीआई हैं, जो समझ में आता है: प्रवेश द्वार पर एक आईपी पता है, बाहर निकलने पर एक देश या शहर है और यदि आप भाग्यशाली हैं, तो कुछ अन्य उपयोगी जानकारी।

जियोआईपी के साथ हमारे द्वारा लॉन्च की गई सभी साइटों में एक सामान्य विशेषता है: उन्हें न केवल सरल जियोलोकेशन की आवश्यकता होती है, उपयोगकर्ता के स्थान के आधार पर साइट पर विभिन्न सामग्री प्रदर्शित करना भी आवश्यक है। अपने लिए इस कार्य को सरल बनाने के लिए, हमने django-ipgeobit एप्लिकेशन से प्रेरित होकर एक छोटी django-geoip बैटरी लिखी।

Django-GeoIP

आवेदन का मुख्य लाभ: यह स्वचालित रूप से उपयोगकर्ता के भूगोल को निर्धारित कर सकता है और इसे अनुरोध वस्तु में पास कर सकता है। अब साइट पर सामग्री, जिसमें "क्षेत्रीयता" है, request.location मान द्वारा view.py में फ़िल्टर करना आसान है।

सुविधाओं

• पाइप स्थापित django-geoip और स्थापित करने के लिए कुछ सरल कदम;
• ReadTheDocs पर विस्तृत प्रलेखन ;
• परीक्षण कवरेज ;
• प्रबंधन टीम के साथ डेटाबेस को अपडेट करना;
• मौजूदा लोगों के अलावा "अपना" भूगोल मॉडल बनाने के लिए एक स्पष्ट एपीआई;
• उपयोगकर्ता दृश्य का उपयोग करके अपना क्षेत्र बदल सकता है;
• django- मेजबान के साथ एकीकरण।

कार्यान्वयन सुविधाएँ

Django-geoip एप्लिकेशन भूगोल पदानुक्रम का समर्थन करता है देश - क्षेत्र - शहर, जो सामान्य रूप में DBMS में संग्रहीत होता है। भूगोल के सभी तत्वों के लिंक के साथ आईपी पते की श्रेणियों का डेटा चौथी तालिका में है। वर्तमान संस्करण केवल ipgeobase.ru डेटा के साथ काम करता है, यह रूस और यूक्रेन में लगभग एक हजार शहर और 150 हजार आईपी रेंज है।

डेटाबेस में डेटा संग्रहीत करने के कारणों में से एक अपना भूगोल मॉडल बनाने की आवश्यकता है जो व्यावसायिक तर्क की चुनौतियों को पूरा करता है। उदाहरण के लिए, एक परियोजना में हम रूस के क्षेत्रों के लिए एक उपयोगकर्ता के स्थान की परिभाषा को सीमित करते हैं, दूसरे में - उन शहरों के समूह तक जिसमें कंपनी मौजूद है। यह मॉडल ipgeobase भूगोल पदानुक्रम के लिए "मुखौटा" पैटर्न को लागू करता है, जिससे आप लचीले ढंग से अपने लिए जियोलोकेशन को कॉन्फ़िगर कर सकते हैं।

कल्पना करें कि हमारी साइट में कई क्षेत्रीय "संस्करण" हैं, जिनमें से प्रत्येक में अपनी सामग्री हो सकती है। इस मामले में, इस क्षेत्र का एक मनमाना नाम हो सकता है और उदाहरण के लिए, रूसी संघ के कई क्षेत्रों में शामिल हैं (आरेख में भू-तालिका):

यह कैसे कॉन्फ़िगर किया गया है और काम करता है इसका एक उदाहरण है। अपने भूगोल मॉडल को परिभाषित करें MyCustomLocation:

# geo/models.py class MyCustomLocation(GeoLocationFacade): name = models.CharField(max_length=100) region = models.OneToOneField(Region, related_name='my_custom_location') is_default = models.BooleanField(default=False) @classmethod def get_by_ip_range(cls, ip_range): """     IP-.       , ,   ,       """ return ip_range.region.geo_location @classmethod def get_default_location(cls): """  -,  ,       IP""" return cls.objects.get(is_default=True) @classmethod def get_available_locations(cls): return cls.objects.all() class Meta: db_table = 'geo_location' 

यह एक सामान्य django मॉडल है, जो तीन वर्ग विधियों द्वारा पूरक है जो जियोआईपी मुखौटा के "इंटरफ़ेस" को लागू करता है। प्रत्येक फ़ंक्शन का उद्देश्य नाम और डॉकस्ट्रिंग से स्पष्ट है। यह शहरों के नाम के साथ डेटाबेस को भरने और उन्हें djagno-geoip मॉडल से बांधने के लिए बनी हुई है।

हम सेटिंग में लिखते हैं:

 GEOIP_LOCATION_MODEL = 'geo.models.MyCustomLocation' 

स्वचालित रूप से क्षेत्र का पता लगाने के लिए मिडलवेयर जोड़ें:

 MIDDLEWARE_CLASSES = (... 'django_geoip.middleware.LocationMiddleware', ... ) 

और वॉइला: request.location में अब प्रत्येक उपयोगकर्ता के लिए हमारे MyCustomLocation मॉडल का मूल्य शामिल है।

 def my_view(request): """ Passing location into template """ ... context['location'] = request.location ... 

यदि उपयोगकर्ता इन शहरों में से किसी में नहीं है, तो उसे डिफ़ॉल्ट क्षेत्र (get_default_location) सौंपा जाएगा।

यह दृष्टिकोण "क्षेत्रीय" साइट बनाने के कार्य को बहुत सुविधाजनक बनाता है जो उपयोगकर्ता के स्थान के आधार पर सामग्री में एक दूसरे से भिन्न होते हैं।

आगे क्या है

अनुप्रयोग, हालांकि अल्फा, हमारे उत्पादन में अच्छा काम करता है (संस्करण 0.2.2)। अल्फा स्थिति संकेत देती है कि भविष्य में एपीआई बदल जाएगा। हम इसे न केवल रूस के लिए, बल्कि दुनिया के बाकी हिस्सों के लिए भी लागू कर सकते हैं । डेटाबेस में एक उपयुक्त आईपी रेंज के लिए खोज के अनुकूलन का विचार भी दिलचस्प लगा।

स्रोत कोड github पर उपलब्ध हैं, आपकी टिप्पणियों की प्रतीक्षा कर रहे हैं।