किसी फीचर लेयर में, बॉर्डर पॉलीगॉन पर स्ट्रोक और भरने के लिए स्टाइल लागू करने के लिए:
स्टाइल फ़ैक्ट्री फ़ंक्शन बनाएं, जो
FeatureLayer.StyleFactoryइंटरफ़ेस को लागू करता हो. यह फ़ंक्शन, किसी फीचर लेयर के लिए स्टाइल तय करता है.फ़ीचर लेयर पर स्टाइल फ़ैक्ट्री फ़ंक्शन लागू करने के लिए,
FeatureLayer.setFeatureStyle()को कॉल करें.
यहां दिए गए उदाहरण वाले मैप में, लोकलिटी फ़ीचर लेयर में किसी एक इलाके की सीमा के पॉलीगॉन को हाइलाइट किया गया है.
स्टाइल फ़ैक्ट्री फ़ंक्शन बनाना
फ़ंक्शन को फ़ीचर लेयर पर सेट करने पर, स्टाइल फ़ैक्ट्री फ़ंक्शन, उस फ़ीचर लेयर के हर पॉलीगॉन पर लागू होता है जिस पर असर पड़ा है. इस फ़ंक्शन से ऐसा FeatureStyle ऑब्जेक्ट दिखना चाहिए जिससे पॉलीगॉन को स्टाइल करने का तरीका पता चलता हो.
Android के लिए Maps SDK टूल, स्टाइल फ़ैक्ट्री फ़ंक्शन को Feature इंस्टेंस पास करता है. Feature इंस्टेंस, सुविधा के मेटाडेटा को दिखाता है. इससे आपको स्टाइल फ़ैक्ट्री फ़ंक्शन में मेटाडेटा का ऐक्सेस मिलता है.
स्टाइल फ़ैक्ट्री फ़ंक्शन को लागू करने पर, यह हमेशा एक जैसे नतीजे दिखाना चाहिए. उदाहरण के लिए, अगर आपको सुविधाओं के किसी सेट को रैंडम तरीके से रंग देना है, तो रैंडम हिस्सा सुविधा के स्टाइल फ़ंक्शन में नहीं होना चाहिए. ऐसा करने से, आपको अनचाहे नतीजे मिल सकते हैं.
यह फ़ंक्शन, लेयर में मौजूद हर फ़ीचर पर काम करता है. इसलिए, ऑप्टिमाइज़ेशन ज़रूरी है. रेंडरिंग में लगने वाले समय पर असर न पड़े, इसके लिए:
सिर्फ़ उन फ़ीचर लेयर को चालू करें जिनकी आपको ज़रूरत है.
जब कोई फ़ीचर लेयर इस्तेमाल में न हो, तब
FeatureLayer.setFeatureStyle(null)को कॉल करें.
पॉलीगॉन का स्ट्रोक और भरने का रंग सेट करना
स्टाइल फ़ैक्ट्री फ़ंक्शन में, बॉर्डर पॉलीगॉन की स्टाइल तय करते समय, ये सेट किए जा सकते हैं:
ARGB कलर फ़ॉर्मैट में पॉलीगॉन बॉर्डर का स्ट्रोक कलर और ओपैसिटी, जैसा कि
Colorक्लास में बताया गया है. डिफ़ॉल्ट वैल्यू पारदर्शी (0x00000000) होती है.स्क्रीन पिक्सल में, पॉलीगॉन बॉर्डर की स्ट्रोक चौड़ाई. डिफ़ॉल्ट वैल्यू 2 है.
ARGB कलर फ़ॉर्मैट में पॉलीगॉन का भरा हुआ रंग और ओपैसिटी, जैसा कि
Colorक्लास के हिसाब से तय किया गया है. डिफ़ॉल्ट वैल्यू पारदर्शी (0x00000000) होती है.
सुविधाओं को टारगेट करने के लिए जगह के आईडी देखना
कई ऐप्लिकेशन, किसी सुविधा की जगह के आधार पर उस पर स्टाइल लागू करते हैं. उदाहरण के लिए, हो सकता है कि आपको अलग-अलग देशों, इलाकों या क्षेत्रों के लिए स्टाइल लागू करनी हो. सुविधा की जगह की जानकारी, जगह के आईडी से दी जाती है.
जगह के आईडी, Google Places के डेटाबेस और Google Maps पर मौजूद किसी जगह की खास तौर पर पहचान करते हैं. जगह का आईडी पाने के लिए:
- इलाकों को नाम से खोजने और तय सीमा के अंदर के इलाकों के लिए जगह के आईडी पाने के लिए, Places API और जियोकोडिंग का इस्तेमाल करें.
- क्लिक इवेंट से डेटा पाना. यह क्लिक किए गए इलाके से जुड़ी सुविधा दिखाता है. इससे, उसके प्लेस आईडी और सुविधा टाइप की कैटगरी को ऐक्सेस किया जा सकता है.
कवरेज, इलाके के हिसाब से अलग-अलग होती है. ज़्यादा जानकारी के लिए, Google की सीमाओं की कवरेज देखें.
भौगोलिक नाम कई सोर्स से उपलब्ध होते हैं. जैसे, भौगोलिक नामों के लिए यूएसजीएस बोर्ड और अमेरिका की गज़ेटियर फ़ाइलें.
जगह का आईडी पाने के लिए, PlaceFeature का इस्तेमाल करना
PlaceFeature
क्लास, Feature क्लास का सबक्लास है.
यह जगह की जानकारी (जगह का आईडी वाली जानकारी) दिखाती है. इसमें ADMINISTRATIVE_AREA_LEVEL_1, ADMINISTRATIVE_AREA_LEVEL_2,
COUNTRY, LOCALITY, POSTAL_CODE, और SCHOOL_DISTRICT टाइप की जानकारी शामिल होती है.
जब प्लेस आईडी उपलब्ध होता है, तो Maps SDK for Android, स्टाइल फ़ैक्ट्री फ़ंक्शन को PlaceFeature का एक इंस्टेंस पास करता है, ताकि आप सुविधा की जगह तय कर सकें.
स्टाइल फ़ैक्ट्री का उदाहरण
इस उदाहरण में, स्टाइल फ़ैक्ट्री फ़ंक्शन को लोकैलिटी फ़ीचर लेयर में मौजूद पॉलीगॉन पर लागू किया गया है. स्टाइल फ़ैक्ट्री फ़ंक्शन, PlaceFeature इंस्टेंस का इस्तेमाल करके, सुविधा का प्लेस आईडी तय करता है. अगर प्लेस आईडी, हवाई के हना के लिए है, तो फ़ंक्शन पॉलीगॉन पर कस्टम फ़िल और स्ट्रोक स्टाइल लागू करता है:
अगर आपने अब तक ऐसा नहीं किया है, तो नया मैप आईडी और मैप स्टाइल बनाने के लिए, शुरू करें में दिया गया तरीका अपनाएं. इलाके की फ़ीचर लेयर को चालू करना न भूलें.
मैप शुरू होने पर, लोकलिटी फ़ीचर लेयर का रेफ़रंस पाएं.
Java
private FeatureLayer localityLayer;
@Override public void onMapReady(GoogleMap map) { // Get the LOCALITY feature layer. localityLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder() .featureType(FeatureType.LOCALITY) .build());
// Apply style factory function to LOCALITY layer. styleLocalityLayer(); }Kotlin
private var localityLayer: FeatureLayer? = null
override fun onMapReady(googleMap: GoogleMap) { // Get the LOCALITY feature layer. localityLayer = googleMap.getFeatureLayer(FeatureLayerOptions.Builder() .featureType(FeatureType.LOCALITY) .build())
// Apply style factory function to LOCALITY layer. styleLocalityLayer() }स्टाइल फ़ैक्ट्री फ़ंक्शन बनाएं और उसे लोकैलिटी फीचर लेयर पर लागू करें.
नीचे दिया गया उदाहरण सिर्फ़ तब लागू होता है, जब जगह की जानकारी के लिए इस्तेमाल किए गए आईडी का इस्तेमाल, हवाई के हना ("ChIJ0zQtYiWsVHkRk8lRoB1RNPo") के लिए किया गया हो. अगर दिया गया प्लेस आईडी, हवाई के हना के लिए नहीं है, तो स्टाइल लागू नहीं होगा.
Java
private void styleLocalityLayer() {
// Create the style factory function. FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
// Check if the feature is an instance of PlaceFeature, // which contains a place ID. if (feature instanceof PlaceFeature) { PlaceFeature placeFeature = (PlaceFeature) feature;
// Determine if the place ID is for Hana, HI. if (placeFeature.getPlaceId().equals("ChIJ0zQtYiWsVHkRk8lRoB1RNPo")) {
// Use FeatureStyle.Builder to configure the FeatureStyle object // returned by the style factory function. return new FeatureStyle.Builder() // Define a style with purple fill at 50% opacity and solid purple border. .fillColor(0x80810FCB) .strokeColor(0xFF810FCB) .build(); } } return null; };
// Apply the style factory function to the feature layer. localityLayer.setFeatureStyle(styleFactory); }Kotlin
private fun styleLocalityLayer() {
// Create the style factory function. val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
// Check if the feature is an instance of PlaceFeature, // which contains a place ID. if (feature is PlaceFeature) { val placeFeature: PlaceFeature = feature as PlaceFeature
// Determine if the place ID is for Hana, HI. if (placeFeature.getPlaceId().equals("ChIJ0zQtYiWsVHkRk8lRoB1RNPo")) {
// Use FeatureStyle.Builder to configure the FeatureStyle object // returned by the style factory function. return@StyleFactory FeatureStyle.Builder() // Define a style with purple fill at 50% opacity and // solid purple border. .fillColor(0x80810FCB.toInt()) .strokeColor(0xFF810FCB.toInt()) .build() } } return@StyleFactory null }
// Apply the style factory function to the feature layer. localityLayer?.setFeatureStyle(styleFactory) }
किसी लेयर से स्टाइल हटाना
किसी लेयर से स्टाइल हटाने के लिए, FeatureLayer.setFeatureStyle(null) को कॉल करें.