बड़ा भाई देख रहा है ... खुद या होमएस्टिस्टेंट में आंदोलनों के इतिहास के साथ एक नक्शा

प्रविष्टि

अपने होम ऑटोमेशन के लिए, मैं लंबे समय से HomeAssistant का उपयोग कर रहा हूं। एक बार एक मित्र ने मुझसे पूछा, वे कहते हैं, होमएस्टिस्टेंट में नक्शे पर केवल ट्रैकर की वर्तमान स्थिति को इंगित करने की क्षमता क्यों है, लेकिन पूरे मार्ग को प्रदर्शित करना संभव नहीं है? तब से, इस विचार ने मुझे पकड़ लिया है। और एक बार मुझे एहसास हुआ कि मैं वास्तव में इस कार्य को अभी करना चाहता हूं। हर कोई जो इस बारे में आया है में रुचि रखता है, बिल्ली का स्वागत करते हैं ...

अन्वेषण

दरअसल, मार्ग को प्रदर्शित करने के लिए आपको निर्देशांक के साथ बिंदुओं का एक सेट होना आवश्यक है, इसलिए पहला कदम यह पता लगाना था कि होमएसिस्टेंट आवश्यक डेटा (यदि बिल्कुल भी) संग्रहीत करता है और इसे वहां से कैसे निकाला जाए। प्राथमिक स्रोत के एक छोटे अध्ययन ने तुरंत समाधान का नेतृत्व किया: आपको डेटाबेस में वांछित सेंसर की स्थिति को विभिन्न बिंदुओं पर रिकॉर्ड करने के लिए शामिल रिकॉर्डर मॉड्यूल की आवश्यकता होती है, साथ ही साथ इतिहास मॉड्यूल, जो आपको डेटाबेस से सुंदर तरीके से डेटा प्राप्त करने की अनुमति देता है। इतिहास मॉड्यूल में एक अच्छी तरह से प्रलेखित REST एपीआई है । आपको क्या चाहिए!

अगला, आपको किसी तरह नक्शे पर प्राप्त आंकड़ों को प्रदर्शित करने की आवश्यकता है। कई अलग-अलग सेवाएं हैं जो आपको आंदोलनों के इतिहास को प्रदर्शित करने की अनुमति देती हैं। मैंने शायद उन सभी से बहुत दूर जाने की कोशिश की है, लेकिन मैं अपने आप को उन कुछ शब्दों के बारे में बताऊंगा जिनकी मैंने जाँच की थी:
ए यैंडेक्स और गूगल। वास्तव में मेरी जरूरतों के लिए सब कुछ है और इससे भी अधिक, लेकिन भुगतान की गई सेवाओं और मुक्त संस्करणों के मजबूत प्रतिबंधों के कारण, उन्होंने मुझे तुरंत इसके अनुरूप नहीं बताया। उदाहरण के लिए, यैंडेक्स केवल खुली परियोजनाओं के लिए नि: शुल्क उपयोग की अनुमति देता है (अर्थात, किसी को भी किसी भी समय अपने संसाधन खोलने में सक्षम होना चाहिए और इसकी क्षमताओं का लाभ उठाना चाहिए), न कि अनुरोधों की संख्या पर अन्य प्रतिबंधों का उल्लेख करने के लिए। केवल आलसी ने एपीआई के बारे में Google की नीतियों में परिवर्तन के बारे में नहीं लिखा था। फिलहाल, जैसा कि मैं इसे समझता हूं, प्रत्येक एपी या दिशाओं के नक्शे के लिए अनुरोध का भुगतान किया जाता है, अधिक अनुरोध - सस्ता। हालांकि, प्रत्येक उपयोगकर्ता को अपने खाते से जुड़े बैंक कार्ड की प्रति माह 200 डॉलर की मुफ्त सीमा दी जाती है। शीर्ष पर सब कुछ तुरंत आपके कार्ड से भुगतान किया जाता है। कार्ड को खाते से जोड़ना हमारा तरीका नहीं है।

सही है अगर मैंने Google और / या यैंडेक्स के बारे में कहीं गलती की है।

बी OpenRouteService और OpenRouteService नक्शे का एक गुच्छा। सिद्धांत रूप में, क्षमताएं Google या यैंडेक्स से अलग नहीं हैं (किसी भी मामले में, मैंने ध्यान नहीं दिया)। पूरी तरह से मुक्त (प्रति दिन और प्रति मिनट अनुरोधों की संख्या पर प्रतिबंध हैं, यदि अधिक हो, तो समर्थन से संपर्क करने की सलाह दी जाती है ... किसी भी भुगतान किए गए टैरिफ का कोई विवरण नहीं है)। हालाँकि, OpenRouteService मैप्स संसाधन का उपयोग असुविधाजनक (एप्लिकेशन को लंबे समय तक लोड करना और बाईं ओर कष्टप्रद चौड़ा मेनू होता है, जो डिफ़ॉल्ट रूप से खुलता है और API द्वारा अक्षम नहीं होता है, इसके अलावा, यह सेवा मोबाइल उपकरणों के साथ सही तरीके से नहीं खुलती है)। निष्पक्षता में, OpenRouteService नक्शे आपके सर्वर पर डाले जा सकते हैं और यह बहुत संभव है कि आप अपने लिए सब कुछ कॉन्फ़िगर कर सकते हैं।

में। Mapbbcode । मैं एक सरल प्रारूप में कार्ड के एक दिलचस्प कार्यान्वयन पर ठोकर खाई। सिद्धांत रूप में, परियोजना मेरे कार्य के लिए बिल्कुल उपयुक्त है, हालांकि, इस लेख से मैंने कैटबर्ग के बारे में सीखा और स्रोत की ओर मुड़ने का फैसला किया। अंत में, वह उस पर रुक गया ...

आर पत्रक। नक्शे के लिए बहुत अच्छा ओपन-सोर्स जेएस लाइब्रेरी, सीखना आसान और अच्छी तरह से प्रलेखित। चिप्स से: आप कई सेवाओं (ओपनस्ट्रीटमैप्स, यैंडेक्स, गूगल, मैपबॉक्स, माइक्रोसाफ्ट, आदि) से टाइल का उपयोग करने की अनुमति देता है। इसके अतिरिक्त, मैंने मैप पर आंदोलन की दिशा को इंगित करने के लिए लीफलेट.पॉलीलाइनडेकटोर प्लगइन का उपयोग किया।

यह ध्यान देने योग्य है कि विचाराधीन अंतिम दो संसाधन "मार्गों" का समर्थन नहीं करते हैं, अर्थात, वे यह नहीं जानते कि मौजूदा सड़कों और / या फुटपाथों के साथ बिंदुओं को कैसे जोड़ा जाए, लेकिन बस एक सीधी रेखा के साथ बिंदुओं को कनेक्ट करें। मेरे लिए व्यक्तिगत रूप से, यह एक समस्या नहीं है, बल्कि एक सचेत कदम है। यदि आपको सड़कों पर नेविगेशन की आवश्यकता है, तो आपको भुगतान किए गए Google, यांडेक्स या मुफ्त ओपनराउट सर्विस की दिशा में देखने की आवश्यकता है।

कार्यान्वयन

REST-API के माध्यम से इतिहास मॉड्यूल के लिए अनुरोध काफी सरल है (इसके बाद कोड होमएस्टिस्टेंट भाषा में होगा, अर्थात् अजगर) और आपको आसानी से समझने वाले JSON के रूप में उत्तर प्राप्त करने की अनुमति देता है:

response = requests.get(self._haddr + '/api/history/period/' + dayBegin + '?filter_entity_id=' + self._myid, headers={'Authorization': 'Bearer ' + self._token, 'content-type': 'application/json'}) data = response.json()[0] 

यहाँ self._haddr आपके हा के पते के रूप में है जैसा कि फ्रंटएंड सेटिंग्स में निर्दिष्ट किया गया है, self._myid डिवाइस का उपकरण id है, जिसका मार्ग हम बनाएंगे, dayBegin मार्ग प्रदर्शित करने के लिए अवधि की शुरुआत है, मैंने डिफ़ॉल्ट रूप से वर्तमान दिन की शुरुआत का चयन किया है। self._token एपि तक पहुंचने के लिए एक लंबा जीवन टोकन है, जिसे होमएसिस्टेंट इंटरफ़ेस में प्राप्त किया जा सकता है।

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

  def getDistance(self, latA, lonA, latB, lonB): dst = 0 latRadA = math.radians(latA) lonRadA = math.radians(lonA) latRadB = math.radians(latB) lonRadB = math.radians(lonB) x = latRadB - latRadA y = (lonRadB-lonRadA)*math.cos((latRadB+latRadA)*0.5) dst = 6371*math.sqrt(x*x+y*y) return dst 

यहाँ dst किमी में दूरी है।

यहां बताएं कि कैटलॉग एपीआई को बिंदु नहीं दिखता है। इसके लिए - आधिकारिक वेबसाइट पर । मॉड्यूल निम्नानुसार काम करता है: प्रत्येक एन सेकंड (मैंने इसे 300 पर सेट किया है) मेरे लिए ब्याज की वस्तु के इतिहास के लिए एक अनुरोध किया जाता है। निर्देशांक का परिणामी सरणी बिंदुओं की संख्या को कम करते हुए, दूरी फिल्टर के माध्यम से चलाया जाता है। इसके अलावा, www फ़ोल्डर में HomeAssistant कॉन्फ़िगरेशन वाले फ़ोल्डर में, 2 फाइलें बनती हैं: index.html और path.html। मार्ग। Html फ़ाइल में मानचित्र बनाने के लिए सभी तर्क हैं। और index.html फ़ाइल पेज कैशिंग को रोकने के लिए एक जीवन हैक है। डिफ़ॉल्ट रूप से, HomeAssistant हर संभव चीज़ को कैश करता है, और केवल कैश को रीसेट करने से मानचित्र पर डेटा को अपडेट करने में मदद मिलती है, जो निश्चित रूप से अस्वीकार्य है। Index.html फ़ाइल में, रूट.html की सामग्री को गतिशील रूप से उत्पन्न यादृच्छिक पैरामीटर के साथ कहा जाता है, जो आपको सर्वर से हमेशा रूट.html के वर्तमान संस्करण का अनुरोध करने की अनुमति देता है:

 src = 'route.html?datetime=' + (new Date()).getTime() + Math.floor(Math.random() * 1000000) 

सुरक्षा के बारे में थोड़ा सा

HomeAssistant को डिज़ाइन किया गया है ताकि www निर्देशिका के अंदर सभी फाइलें सार्वजनिक हों, यानी www निर्देशिका के अंदर कोई भी फ़ाइल किसी भी ब्राउज़र में बिना किसी प्राधिकरण के खोली जा सकती है, प्रत्यक्ष लिंक को जानकर। मेरे मॉड्यूल के मामले में, यह लिंक यह है: your_address_homeassistant / local / path / index.html । यदि यह आपके लिए महत्वपूर्ण नहीं है, तो आप इस अनुभाग को छोड़ सकते हैं। मैं थोड़ा आगे गया और मार्ग के साथ पृष्ठ पर प्राधिकरण को खराब कर दिया। इसके लिए, मैंने प्रॉक्सी सर्वर के रूप में nginx का उपयोग किया (आप रिवर्स प्रॉक्सी सपोर्ट वाला दूसरा वेब सर्वर चुन सकते हैं)। HomeAssistant वेबसाइट पर इस कॉन्फ़िगरेशन को स्थापित करने के लिए आधिकारिक निर्देश हैं । प्रॉक्सी को सेट करने और ऑपरेशन की जाँच करने के बाद, आपको nginx कॉन्फ़िगरेशन में आवश्यक पृष्ठों में प्राधिकरण जोड़ने की आवश्यकता है:

 location /local/route/route.html { proxy_pass http://localhost:8123/local/route/route.html; proxy_set_header Host $host; proxy_redirect http:// https://; proxy_http_version 1.1; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection $connection_upgrade; auth_basic "Unauthorized"; auth_basic_user_file /etc/nginx/.htpasswd; } 

फिर फ़ाइल "/etc/nginx/.htpasswd" बनाएं और कंसोल में निम्नलिखित कमांड निष्पादित करें:

 sh -c "echo -n 'admin:' >> /etc/nginx/.htpasswd" sh -c "openssl passwd -apr1 >> /etc/nginx/.htpasswd" 

व्यवस्थापक - वांछित लॉगिन के साथ बदलें।

उसके बाद, nginx को पुनरारंभ करें और जांचें: मार्ग के साथ एक पृष्ठ खोलने का प्रयास करते समय, ब्राउज़र को उपयोगकर्ता नाम और पासवर्ड का अनुरोध करना चाहिए। मैं ध्यान देता हूं कि यह एक अलग प्राधिकरण है जिसका होमएस्टीस्टैंट के प्राधिकरण से कोई लेना-देना नहीं है।

निष्कर्ष

शायद इस मॉड्यूल के बारे में कहा जा सकता है।
कौन रुचि रखते हैं, यहां मॉड्यूल की एक कड़ी है। फ़ाइल को पथ के साथ रखें: config_folder_homeassistant / custom_compords / मार्ग / Sens.py, अधिकारों के बारे में मत भूलना।

यदि यह मौजूद नहीं है, तो config_folder_homeassistant / www फ़ोल्डर बनाएं और इसे उचित अधिकार दें।

कॉन्फ़िगरेशन फ़ाइल कॉन्फ़िगरेशन .yaml में, निम्न पंक्तियाँ लिखें:

 sensor: - platform: route name: route entityid: your_device_tracker_entity_id haddr: your_address_homeassistant token: your_long_life_token 

यहाँ आपका_देवाइस_ट्रैकर_एंट्टी_ड आपके डिवाइस डिवाइस_ट्रैकर की आईडी है, आपका_ड्रेस_होम्सिस्टिस्ट आपके होमएस्टीस्टैंट का बाहरी पता है, आपका_लॉन्गलाइफ़_टोकेंन है, जो पहले ही होमएस्टिस्टेंट फ्रंटएंड में रीस्ट एपीआई का उपयोग करने के लिए प्राप्त टोकन है।

उसके बाद, HomeAssistant को पुनरारंभ करें और आनंद लें। मानचित्र एक सीधा लिंक के माध्यम से उपलब्ध होगा: your_address_homeassistant / स्थानीय / मार्ग / index.html । यदि आप चाहें, तो आप इसे पैनल मेनू का उपयोग करके पैनल मे ले सकते हैं_ पैनल या किसी भी एचए विंडो का उपयोग करते हुए "आइफ्रेम" के माध्यम से।
यह सब, आपके ध्यान के लिए धन्यवाद।

युपीडी:
GitHub का लिंक जोड़ा गया। कुछ स्थानों को संशोधित किया (कॉन्फ़िगरेशन हेडर से हटा दिया गया, स्वचालित रूप से config_dir प्राप्त करें, मेरे समय क्षेत्र को सेट करने की क्षमता को जोड़ा)