इस पेज पर, मैप में डेटासेट जोड़ने और स्टाइल लागू करने का तरीका बताया गया है.
ज़रूरी शर्तें
आगे बढ़ने से पहले, आपके पास मैप आईडी, मैप स्टाइल, और डेटासेट आईडी होना चाहिए.
डेटासेट आईडी को मैप स्टाइल से जोड़ना
किसी डेटासेट की सुविधाओं को स्टाइल करने के लिए, मैप की डेटासेट फ़ीचर लेयर पर स्टाइल फ़ंक्शन लागू करें. डेटासेट की फ़ीचर लेयर तब बनाई जाती है, जब किसी डेटासेट को मैप स्टाइल से जोड़ा जाता है.
अपने डेटासेट को मैप स्टाइल से जोड़ने के लिए:
- Google Cloud Console में, डेटासेट पेज पर जाएं.
- डेटासेट के नाम पर क्लिक करें. डेटासेट की जानकारी वाला पेज दिखेगा.
- झलक देखें टैब पर क्लिक करें.
- मैप की मिलती-जुलती शैलियां सेक्शन में, मैप की शैली जोड़ें पर क्लिक करें.
- असोसिएट करने के लिए, मैप स्टाइल के चेकबॉक्स पर क्लिक करें. इसके बाद, सेव करें पर क्लिक करें.
डेटासेट में स्टाइल लागू करना
किसी डेटासेट में स्टाइल लागू करने के लिए:
स्टाइल फ़ैक्ट्री फ़ंक्शन बनाएं, जो
FeatureLayer.StyleFactory
इंटरफ़ेस को लागू करता हो. यह फ़ंक्शन, डेटासेट के लिए स्टाइल तय करता है.डेटासेट में मौजूद हर सुविधा पर स्टाइल फ़ैक्ट्री फ़ंक्शन लागू करने के लिए,
FeatureLayer.setFeatureStyle()
को कॉल करें.
स्टाइल फ़ैक्ट्री फ़ंक्शन बनाना
फ़ीचर लेयर पर फ़ंक्शन सेट करने पर, स्टाइल फ़ैक्ट्री फ़ंक्शन, डेटासेट लेयर की हर फ़ीचर पर लागू होता है. इस फ़ंक्शन से ऐसा FeatureStyle
ऑब्जेक्ट दिखना चाहिए जिससे पॉलीगॉन को स्टाइल करने का तरीका पता चलता हो.
अगर स्टाइल फ़ैक्ट्री null
दिखाती है, तो दी गई सुविधा रेंडर नहीं होती. ज़्यादा जानकारी के लिए, लेयर से स्टाइल हटाना लेख पढ़ें.
Android के लिए Maps SDK टूल, स्टाइल फ़ैक्ट्री फ़ंक्शन को Feature
इंस्टेंस पास करता है. Feature
इंस्टेंस, सुविधा के मेटाडेटा को दिखाता है. इससे आपको स्टाइल फ़ैक्ट्री फ़ंक्शन में मेटाडेटा का ऐक्सेस मिलता है.
स्टाइल फ़ैक्ट्री फ़ंक्शन को लागू करने पर, यह हमेशा एक जैसे नतीजे दिखाना चाहिए. उदाहरण के लिए, अगर आपको सुविधाओं के किसी सेट को रैंडम तरीके से रंग देना है, तो रैंडम हिस्सा सुविधा के स्टाइल फ़ंक्शन में नहीं होना चाहिए. ऐसा करने से, आपको अनचाहे नतीजे मिल सकते हैं.
यह फ़ंक्शन, लेयर में मौजूद हर फ़ीचर पर काम करता है. इसलिए, ऑप्टिमाइज़ेशन ज़रूरी है. जब किसी फ़ीचर लेयर का इस्तेमाल न किया जा रहा हो, तो रेंडरिंग में लगने वाले समय पर असर न पड़े, इसके लिए FeatureLayer.setFeatureStyle(null)
को कॉल करें.
डेटासेट का आईडी पाने के लिए, FeatureLayer.getDatasetId()
को कॉल भी किया जा सकता है.
स्ट्रोक, भरने, और पॉइंट की त्रिज्या सेट करना
स्टाइल फ़ैक्ट्री फ़ंक्शन में किसी सुविधा को स्टाइल करते समय, ये सेट किए जा सकते हैं:
बॉर्डर का स्ट्रोक कलर और ओपैसिटी, जैसा कि
Color
क्लास में बताया गया है. डिफ़ॉल्ट वैल्यू पारदर्शी (Color.TRANSPARENT
) होती है.स्क्रीन पिक्सल में, बॉर्डर की स्ट्रोक चौड़ाई. डिफ़ॉल्ट वैल्यू 2 है.
भरने का रंग और ओपैसिटी, जैसा कि
Color
क्लास में बताया गया है. डिफ़ॉल्ट वैल्यू पारदर्शी (Color.TRANSPARENT
) होती है.पॉइंट फ़ीचर का पॉइंट रेडियस, 0 से 128 पिक्सल के बीच होना चाहिए.
स्टाइल के लिए आसान नियमों का इस्तेमाल करना
सुविधाओं को स्टाइल करने का सबसे आसान तरीका यह है कि आप कोई FeatureLayer.StyleFactory
तय करें, जो हमेशा एक जैसा FeatureStyle
ऑब्जेक्ट बनाता है. भले ही, सुविधा कोई भी हो. फ़ीचर स्टाइल के विकल्पों को सीधे डेटासेट की फ़ीचर लेयर पर लागू करें या FeatureStyleFunction
के साथ इस्तेमाल करें.
डिक्लेरेटिव स्टाइल के नियमों का इस्तेमाल करना
किसी सुविधा के एट्रिब्यूट के आधार पर, स्टाइल के नियमों को एलान के तौर पर सेट किया जा सकता है. साथ ही, उन्हें अपने पूरे डेटासेट पर लागू किया जा सकता है. सुविधा के स्टाइल फ़ंक्शन से null
दिखाया जा सकता है. उदाहरण के लिए, अगर आपको सुविधाओं के किसी सबसेट को छिपाना है.
उदाहरण के लिए, किसी सुविधा के लिए डेटासेट एट्रिब्यूट का Map<String,String>
दिखाने के लिए, DatasetFeature.getDatasetAttributes()
तरीके का इस्तेमाल करें. इसके बाद, आपके पास फ़ीचर की प्रॉपर्टी के आधार पर, उसकी स्टाइल को पसंद के मुताबिक बनाने का विकल्प होता है.
इस उदाहरण में, डेटासेट की हर सुविधा के "highlightColor" एट्रिब्यूट की वैल्यू तय की गई है, ताकि स्टाइल को कंट्रोल किया जा सके:
Kotlin
// Get the dataset feature, so we can work with all of its attributes. val datasetFeature: DatasetFeature = feature as DatasetFeature
// Create a switch statement based on the value of the // "highlightColor" attribute of the dataset. val attributeColor: MutableMap<String, String> = datasetFeature.getDatasetAttributes() when (attributeColor["highlightColor"]) { "Black" -> { ... } "Red" -> { ... } else -> { ... } }
Java
// Get the dataset feature, so we can work with all of its attributes. DatasetFeature datasetFeature = (DatasetFeature) feature;
// Create a switch statement based on the value of the // "highlightColor" attribute of the dataset. Map<String, String> attributeColor = datasetFeature.getDatasetAttributes(); switch(attributeColor.get("highlightColor")) { case "Black": ... break; case "Red": ... break; default: // Color not defined. ... break; }
डेटासेट की फ़ीचर लेयर पर स्टाइल लागू करना
इस उदाहरण में, डेटासेट की फ़ीचर लेयर में मौजूद पॉलीगॉन पर स्टाइल फ़ैक्ट्री फ़ंक्शन लागू किया गया है. स्टाइल फ़ैक्ट्री फ़ंक्शन, पॉलीगॉन पर कस्टम फ़िल और स्ट्रोक स्टाइल लागू करता है:
अगर आपने अब तक ऐसा नहीं किया है, तो नया मैप आईडी और मैप स्टाइल बनाने के लिए, शुरू करें में दिया गया तरीका अपनाएं. डेटासेट की सुविधा वाली लेयर को चालू करना न भूलें.
मैप शुरू होने पर, डेटासेट की फ़ीचर लेयर का रेफ़रंस पाएं.
Kotlin
private var datasetLayer: FeatureLayer? = null
override fun onMapReady(googleMap: GoogleMap) { // Get the DATASET feature layer. datasetLayer = googleMap.getFeatureLayer(FeatureLayerOptions.Builder() .featureType(FeatureType.DATASET) // Specify the dataset ID. .datasetId(YOUR_DATASET_ID) .build())
// Apply style factory function to DATASET layer. styleDatasetsLayer() }Java
private FeatureLayer datasetLayer;
@Override public void onMapReady(GoogleMap map) { // Get the DATASET feature layer. datasetLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder() .featureType(FeatureType.DATASET) // Specify the dataset ID. .datasetId(YOUR_DATASET_ID) .build());
// Apply style factory function to DATASET layer. styleDatasetsLayer(); }स्टाइल फ़ैक्ट्री फ़ंक्शन बनाएं और उसे डेटासेट की फ़ीचर लेयर पर लागू करें.
नीचे दिए गए उदाहरण में, डेटासेट की सभी सुविधाओं पर एक ही फ़िल और स्ट्रोक लागू किया गया है.
Kotlin
private fun styleDatasetsLayer() {
// Create the style factory function. val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
// Check if the feature is an instance of DatasetFeature. if (feature is DatasetFeature) {
return@StyleFactory FeatureStyle.Builder() // Define a style with green fill at 50% opacity and // solid green border. .fillColor(0x8000ff00.toInt()) .strokeColor(0xff00ff00.toInt()) .strokeWidth(2F) .build() } return@StyleFactory null }
// Apply the style factory function to the feature layer. datasetLayer?.setFeatureStyle(styleFactory) }Java
private void styleDatasetsLayer() {
// Create the style factory function. FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
// Check if the feature is an instance of DatasetFeature. if (feature instanceof DatasetFeature) {
return new FeatureStyle.Builder() // Define a style with green fill at 50% opacity and solid green border. .fillColor(0x8000ff00) .strokeColor(0xff00ff00) .strokeWidth(2) .build(); } return null; };
// Apply the style factory function to the feature layer. datasetLayer.setFeatureStyle(styleFactory); }
किसी लेयर से स्टाइल हटाना
किसी लेयर से स्टाइल हटाने के लिए, FeatureLayer.setFeatureStyle(null)
को कॉल करें.
स्टाइल फ़ैक्ट्री से null
को वापस लाया जा सकता है. उदाहरण के लिए, अगर आपको सुविधाओं के किसी सबसेट को छिपाना है.