नई CUBA कार्ड

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

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

इस लेख में, हम मैप्स घटक द्वारा पेश किए गए नए फीचर्स के बारे में बात करेंगे और इसकी तुलना हमारे पिछले मैप कंपोनेंट से भी करेंगे।

परत आधारित संरचना

घटक पारंपरिक बहुपरत संरचना का समर्थन करता है जो पेशेवर भौगोलिक सूचना प्रणालियों में व्यापक रूप से उपयोग किया जाता है। परतें मुख्य रूप से रेखापुंज और वेक्टर में विभाजित होती हैं। रेखापुंज की परतें रेखापुंज छवियों से मिलकर बनती हैं, जबकि वेक्टर परतों में वेक्टर ज्यामिति होते हैं।

घटक निम्न प्रकार की परतों का समर्थन करता है:

• टाइल की परत XYZ प्रारूप में टाइल सेवाओं द्वारा प्रदान की गई टाइलों को प्रदर्शित करती है।
• वेब मैप सेवा (WMS) परत WMS सेवाओं द्वारा प्रदान की गई छवियों को प्रदर्शित करती है।
• वेक्टर लेयर में जियो-ऑब्जेक्ट्स (ज्यामितीय विशेषताओं वाली इकाइयाँ) शामिल हैं।

ये परतें नक्शों के संरचनात्मक तत्व हैं। उदाहरण के लिए, निचली परत टाइलों से मिलकर एक आधार नक्शा हो सकती है, दूसरी परत में प्रादेशिक इकाइयों का वर्णन करने वाले बहुभुज हो सकते हैं, उदाहरण के लिए, क्षेत्र और ऊपरी परत में भौगोलिक बिंदु (ग्राहकों, दुकानों आदि का स्थान) हो सकते हैं। इन परतों को एक दूसरे के ऊपर रखने से हमें अंतिम नक्शा मिलता है:

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

CUBA मैप्स एक नया विज़ुअल कंपोनेंट प्रदान करता है - GeoMap । घटक के एक्सएमएल डिस्क्रिप्टर में, आप नक्शे के बुनियादी मापदंडों को सेट कर सकते हैं, साथ ही साथ प्रदर्शित परतों का एक सेट भी कर सकते हैं। ऐसे विन्यास का एक उदाहरण:

 <maps:geoMap id="map" height="600px" width="100%" center="37.615, 55.752" zoom="10"> <maps:layers selectedLayer="addressLayer"> <maps:tile id="tiles" tileProvider="maps_OpenStreetMap"/> <maps:vector id="territoryLayer" dataContainer="territoryDc"/> <maps:vector id="addressLayer" dataContainer="addressDc" editable="true"/> </maps:layers> </maps:geoMap> 

यह दृष्टिकोण आपको अधिक लचीलेपन को प्राप्त करने की अनुमति देता है जो चार्ट और मानचित्र में कमी थी:

• लेयरिंग। यह संरचना आपको किसी भी सामग्री के साथ कार्ड बनाने की अनुमति देती है, उदाहरण के लिए, विभिन्न सेवाओं द्वारा प्रदान की गई टाइलों को मिलाएं।
• परतें एक अमूर्तता प्रदान करती हैं जो सजातीय वस्तुओं को एक साथ लाती हैं। चार्ट और मैप्स घटक में, सभी मानचित्र सामग्री (उदाहरण के लिए, अंक, बहुभुज, आदि) को यूआई घटक में एक सामान्य ढेर में डंप किया गया था। इन वस्तुओं को किसी तरह से संरचना करने के लिए, परियोजना टीमों को अतिरिक्त तर्क लिखना था।
• परतों का वर्णन करने के लिए एक घोषणात्मक विधि। जैसा कि ऊपर दिए गए उदाहरण में दिखाया गया है, आप XML डिस्क्रिप्टर में मानचित्र संरचना (परतों का सेट) को पूरी तरह से निर्दिष्ट कर सकते हैं। कई मामलों में, यह स्क्रीन नियंत्रक में किसी भी अतिरिक्त तर्क को लागू नहीं करने के लिए पर्याप्त है। चार्ट्स और मैप्स का उपयोग करना अतिरिक्त तर्क लिखे बिना करना लगभग असंभव था।

टाइल परतों या WMS का उपयोग करने से आप किसी भी पसंदीदा मानचित्र प्रदाता के साथ काम कर सकते हैं। आप किसी विशिष्ट प्रदाता से बंधे नहीं हैं, क्योंकि यह चार्ट और मैप्स में था ।

वेक्टर परतें मानचित्र पर भू-वस्तुओं के प्रदर्शन, इंटरैक्टिव संपादन और ड्राइंग को बहुत सरल बनाती हैं।

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

भू वस्तुओं

मान लीजिए हमारे पास एक इकाई है जिसमें ज्यामिति (बिंदु, पॉलीलाइन, बहुभुज) से जुड़ी विशेषता है। हम इस इकाई को भू-वस्तु कहेंगे। तो, घटक भू-वस्तुओं के साथ काम को बहुत सरल करता है।

उदाहरण के लिए, जियो ऑब्जेक्ट एड्रेस पर विचार करें:

 @Entity public class Address extends StandardEntity { ... @Column(name = "LOCATION") @Geometry @MetaProperty(datatype = "GeoPoint") @Convert(converter = CubaPointWKTConverter.class) protected Point location; ... } 

इसमें JTS टोपोलॉजी सूट (JTS) लाइब्रेरी से टाइप org.locationtech.jts.geom.Point का एक location गुण है। घटक JTS ​​से निम्नलिखित ज्यामितीय प्रकारों का समर्थन करता है:

• org.locationtech.jts.geom.Point - अवधि।
• org.locationtech.jts.geom.LineString - org.locationtech.jts.geom.LineString ।
• org.locationtech.jts.geom.Polygon - बहुभुज।

location विशेषता को @Geometry एनोटेशन के साथ टैग किया @Geometry । यह एनोटेशन बताता है कि मानचित्र पर भू-वस्तु प्रदर्शित करते समय इस विशेषता के मूल्य का उपयोग किया जाना चाहिए। विशेषता को निम्न एनोटेशन के साथ भी चिह्नित किया जाता है:

• @MetaProperty - इस मामले में, डेटाटाइप विशेषता को इंगित करने के लिए उपयोग किया जाता है। Datatype इंटरफ़ेस Datatype उपयोग सीयूबीए ढांचे द्वारा मूल्यों को स्ट्रिंग से और उससे बदलने के लिए किया जाता है।
• @Convert - एक जेपीए कनवर्टर को एक स्थिर विशेषता के लिए परिभाषित करता है। JPA कनवर्टर डेटाबेस और जावा कोड में इसके अभ्यावेदन के बीच विशेषता मूल्यों को परिवर्तित करता है। घटक स्थानिक डेटाटाइप-एस और जेपीए-कन्वर्टर्स का एक सेट प्रदान करता है। घटक दस्तावेज में अधिक जानकारी उपलब्ध है। आप जेपीए कनवर्टर के अपने स्वयं के कार्यान्वयन का उपयोग भी कर सकते हैं, जो स्थानिक डेटा के विभिन्न स्रोतों (उदाहरण के लिए, पोस्टजीआईएस ) के साथ काम करना संभव बनाता है।

इस प्रकार, एक इकाई को भू-वस्तु में बदलने के लिए, आपको जेटीएस ज्यामिति प्रकार की एक विशेषता को परिभाषित करने और इसे @Geometry साथ एनोटेट करने की @Geometry । एक और विकल्प है - गेट्टर / सेटर विधि प्रदान करके एक गैर-स्थायी विशेषता बनाएं। यह उपयोगी हो सकता है यदि आप डेटा मॉडल में परिवर्तन नहीं करना चाहते हैं और डीडीएल स्क्रिप्ट को फिर से बनाना चाहते हैं।

उदाहरण के लिए, अक्षांश और देशांतर के लिए अलग-अलग विशेषताओं के साथ इकाई पते पर विचार करें:

 import com.haulmont.addon.maps.gis.utils.GeometryUtils; ... @Entity public class Address extends StandardEntity { ... @Column(name = "LATITUDE") protected Double latitude; @Column(name = "LONGITUDE") protected Double longitude; ... @Geometry @MetaProperty(datatype = "GeoPoint", related = {"latitude", "longitude"}) public Point getLocation() { if (getLatitude() == null || getLongitude() == null) { return null; } return GeometryUtils.createPoint(getLongitude(), getLatitude()); } @Geometry @MetaProperty(datatype = "GeoPoint") public void setLocation(Point point) { Point prevValue = getLocation(); if (point == null) { setLatitude(null); setLongitude(null); } else { setLatitude(point.getY()); setLongitude(point.getX()); } propertyChanged("location", prevValue, point); } ... } 

यदि आप इस दृष्टिकोण का उपयोग करने का निर्णय लेते हैं, तो सुनिश्चित करें कि propertyChanged विधि को सेटर में कहा जाता है, क्योंकि घटक नक्शे पर ज्यामिति को अपडेट करके इस घटना का जवाब देता है।

अब जब हमने अपनी भू-वस्तु का वर्ग तैयार कर लिया है, तो हम इस वर्ग के उदाहरणों को वेक्टर लेयर में जोड़ सकते हैं। एक वेक्टर परत अनिवार्य रूप से डेटा (जियो-ऑब्जेक्ट्स) और एक मानचित्र के बीच एक कनेक्टिंग तत्व है। भू-वस्तुओं को एक परत के साथ जोड़ने के लिए, आपको डेटा कंटेनर को स्थानांतरित करने की आवश्यकता है या, अप्रचलित स्क्रीन (सीयूबीए के संस्करण 7 तक) के मामले में, वेक्टर परत के लिए डेटा स्रोत। यह एक XML डिस्क्रिप्टर में किया जा सकता है:

 <maps:geoMap id="map"> <maps:layers> ... <maps:vector id="addressesLayer" dataContainer="addressesDc"/> </maps:layers> </maps:geoMap> 

नतीजतन, एड्रेसडेक कंटेनर में निहित Address वर्ग उदाहरण मानचित्र पर प्रदर्शित किए जाएंगे।

आइए एक प्राथमिक कार्य पर विचार करें: एक मानचित्र के साथ भू-वस्तु को संपादित करने के लिए एक स्क्रीन बनाना, जहां आप ऑब्जेक्ट की ज्यामिति को संपादित कर सकते हैं। समस्या को हल करने के लिए, आपको संपादन स्क्रीन के XML डिस्क्रिप्टर में GeoMap के दृश्य घटक को घोषित करने की आवश्यकता है और संपादित भू-वस्तु वाले कंटेनर से जुड़ी एक वेक्टर परत जोड़ें:

 <maps:geoMap id="map" height="600px" width="100%" center="37.615, 55.752" zoom="10"> <maps:layers selectedLayer="addressLayer"> <maps:tile ..."/> <maps:vector id="addressLayer" dataContainer="addressDc" editable="true"/> </maps:layers> </maps:geoMap> 

यदि आप वेक्टर परत को संपादन योग्य के रूप में चिह्नित करते हैं, तो मानचित्र पर भू-वस्तु का संवादात्मक संपादन सक्रिय होता है। यदि ऑब्जेक्ट की ज्यामिति खाली है, तो मानचित्र स्वचालित रूप से ड्राइंग मोड में बदल जाएगा। जैसा कि आप देख सकते हैं, समस्या को हल करने के लिए, यह नक्शे पर एक वेक्टर परत की घोषणा करने और इसे डेटा कंटेनर / डेटा स्रोत पास करने के लिए पर्याप्त है।

वह सब है। यदि हम इसी समस्या को हल करने के लिए चार्ट्स और मैप्स का उपयोग करते हैं, तो हमें समान कार्यक्षमता प्रदान करने के लिए स्क्रीन कंट्रोलर में काफी कोड लिखना होगा। मैप्स के नए घटक के साथ , ऐसी समस्याओं को हल करना बहुत सरल है।

कैनवास

ऐसे समय होते हैं जब आपको संस्थाओं के साथ काम करने की आवश्यकता नहीं होती है। इसके बजाय, आप एक साधारण API को मैप पर जियोमेट्रीज जोड़ना और आकर्षित करना चाहते हैं, जैसा कि चार्ट्स और मैप्स में था । इसके लिए, GeoMap दृश्य घटक में एक विशेष परत है - कैनवास । यह एक सहायक परत है, जो कि डिफ़ॉल्ट रूप से मानचित्र पर है और जो मानचित्र पर ज्यामितीय जोड़ने और ड्राइंग के लिए एक सरल एपीआई प्रदान करता है। आप map.getCanvas() विधि को कॉल करके map.getCanvas() मानचित्र map.getCanvas() कर सकते map.getCanvas() ।

इसके बाद, हम कुछ सरल कार्यों को देखेंगे, कैसे वे चार्ट और मैप्स में हल किए गए थे और कैनवस का उपयोग करके इसे कैसे किया जाए।

एक नक्शे पर ज्यामितीय प्रदर्शित करें

चार्ट्स और मैप्स में, ज्यामिति वस्तुओं को मैप के दृश्य घटक का उपयोग करके बनाया गया था, जिसका उपयोग कारखाने के रूप में किया गया था, और फिर नक्शे में जोड़ा गया:

 Marker marker = map.createMarker(); GeoPoint position = map.createGeoPoint(lat, lon); marker.setPosition(position); map.addMarker(marker); 

नया मैप घटक जेटीएस लाइब्रेरी से कक्षाओं के साथ सीधे काम करता है:

 CanvasLayer canvasLayer = map.getCanvas(); Point point = address.getLocation(); canvasLayer.addPoint(point); 

ज्यामिति का संपादन

चार्ट्स और मैप्स में, आप ज्यामिति को संपादन योग्य बना सकते हैं। जब यूआई के माध्यम से इस तरह की ज्यामिति बदली जाती थी, तो संबंधित घटनाओं को बुलाया जाता था:

 Marker marker = map.createMarker(); GeoPoint position = map.createGeoPoint(lat, lon); marker.setPosition(position); marker.setDraggable(true); map.addMarker(marker); map.addMarkerDragListener(event -> { // do something }); 

मैप्स घटक में, कैनवस में जेटीएस ज्यामिति जोड़ते समय, संबंधित विधि एक विशेष ऑब्जेक्ट लौटाती है जो नक्शे पर इस ज्यामिति का एक प्रतिनिधित्व है: CanvasLayer.Point , CanvasLayer.Polygon । CanvasLayer.Polyline या CanvasLayer.Polygon । CanvasLayer.Polygon । इस ऑब्जेक्ट में विभिन्न ज्यामिति मापदंडों को सेट करने के लिए एक धाराप्रवाह इंटरफ़ेस है, इसका उपयोग ज्यामिति से संबंधित घटनाओं की सदस्यता लेने के लिए या कैनवस से ज्यामिति को हटाने के लिए भी किया जा सकता है।

 CanvasLayer canvasLayer = map.getCanvas(); CanvasLayer.Point location = canvasLayer.addPoint(address.getLocation()); location.setEditable(true) .setPopupContent(address.getName()) .addModifiedListener(modifiedEvent -> address.setLocation(modifiedEvent.getGeometry())); 

रेखागणित ड्राइंग

पुराने ऐड-ऑन चार्ट्स और मैप्स में एक सहायक घटक था - DrawingOptions । इसका उपयोग मानचित्र पर आकर्षित करने की क्षमता को सक्रिय करने के लिए किया गया था। ज्यामिति तैयार होने के बाद, इसी घटना को उठाया गया था:

 DrawingOptions options = new DrawingOptions(); PolygonOptions polygonOptions = new PolygonOptions(true, true, "#993366", 0.6); ControlOptions controlOptions = new ControlOptions( Position.TOP_CENTER, Arrays.asList(OverlayType.POLYGON)); options.setEnableDrawingControl(true); options.setPolygonOptions(polygonOptions); options.setDrawingControlOptions(controlOptions); options.setInitialDrawingMode(OverlayType.POLYGON); map.setDrawingOptions(options); map.addPolygonCompleteListener(event -> { //do something }); 

मैप्स घटक समान आसान बनाता है। नए मैप्स कैनवस में ज्यामितीय ड्राइंग के लिए तरीकों का एक सेट है। उदाहरण के लिए, बहुभुज खींचने के लिए, canvas.drawPolygon() उपयोग करें। canvas.drawPolygon() विधि। इस पद्धति को कॉल करने के बाद, नक्शा बहुभुज ड्राइंग मोड में बदल जाएगा। विधि Consumer<CanvasLayer.Polygon> फ़ंक्शन को स्वीकार करता है, जिसमें आप खींचे गए बहुभुज के साथ अतिरिक्त कार्य कर सकते हैं।

 canvasLayer.drawPolygon(polygon -> { territory.setPolygon(polygon.getGeometry()); }); 

भू-विश्लेषण उपकरण

क्लस्टरिंग

नए मैप्स घटक में मौजूद एक अन्य उपयोगी उपकरण बिंदु क्लस्टरिंग है। यदि परत में बड़ी संख्या में बिंदु होते हैं, तो आप पास के बिंदुओं को क्लस्टर में समूह में क्लस्टर करने में सक्षम कर सकते हैं, ताकि मानचित्र शून्य दिखाई दे और बेहतर माना जाए:

XML विवरणक में vector टैग के अंदर cluster टैग जोड़कर क्लस्टरिंग को सक्षम किया गया है:

 <maps:vector id="locations" dataContainer="locationsDc" > <maps:cluster/> </maps:vector> 

आप बिंदु भार के आधार पर क्लस्टरिंग को भी सक्षम कर सकते हैं। बिंदु का वजन weightProperty पैरामीटर में निर्दिष्ट विशेषता का मूल्य है।

 <maps:vector id="orders" dataContainer="ordersDc" > <maps:cluster weightProperty="amount"/> </maps:vector> 

गर्मी नक्शे

हीटमैप कई भौगोलिक स्थानों में डेटा घनत्व का एक दृश्य प्रतिनिधित्व है। GeoMap के दृश्य घटक में हीट मैप जोड़ने का एक तरीका है: addHeatMap(Map<Point, Double> intensityMap) मैप addHeatMap(Map<Point, Double> intensityMap) ।

निष्कर्ष

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

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

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

हमें उम्मीद है कि आप घटक का आनंद लेंगे। आपकी प्रतिक्रिया की प्रतीक्षा है!