Maps स्टैटिक एपीआई के लिए स्टाइल रेफ़रंस

स्टाइल के विकल्पों की मदद से, Google Maps की स्टैंडर्ड स्टाइल को पसंद के मुताबिक बनाया जा सकता है. साथ ही, सड़कों, पार्कों, कारोबारों, और दिलचस्पी की अन्य जगहों जैसी सुविधाओं के दिखने के तरीके में बदलाव किया जा सकता है. इन सुविधाओं की स्टाइल बदलने के साथ-साथ, इन्हें पूरी तरह से छिपाया भी जा सकता है. इसका मतलब है कि मैप के किसी खास कॉम्पोनेंट को हाइलाइट किया जा सकता है या मैप को आस-पास के पेज की स्टाइल के हिसाब से बनाया जा सकता है.

अगर आपको एक से ज़्यादा ऐप्लिकेशन में एक ही स्टाइल अपडेट करनी है, तो क्लाउड पर मौजूद स्टाइल को पसंद के मुताबिक बनाने की सुविधा का इस्तेमाल करें. यह सुविधा Google Cloud Console में उपलब्ध है और इसके लिए मैप आईडी की ज़रूरत होती है. संभावित टकराव से बचने के लिए, एक ही ऐप्लिकेशन में क्लाउड पर मौजूद स्टाइल को पसंद के मुताबिक बनाने की सुविधा और हार्डकोड की गई स्टाइलिंग को एक साथ इस्तेमाल न करें.

स्टाइलिंग का बेहतर अनुभव पाने के लिए, क्लाउड पर मौजूद मैप की स्टाइलिंग के साथ JSON स्टाइलिंग का इस्तेमाल किया जा सकता है. इससे मैप की ज़्यादा सुविधाएं और पसंद के मुताबिक बनाने के ज़्यादा विकल्प मिलते हैं. क्लाउड पर मौजूद मैप की स्टाइलिंग का JSON स्कीमा, एम्बेड किए गए JSON स्टाइल के एलान के साथ काम नहीं करता. इसका मतलब है कि Maps Static API में, क्लाउड पर मौजूद मैप की स्टाइलिंग के JSON का सीधे तौर पर इस्तेमाल नहीं किया जा सकता. हालांकि, एम्बेड किए गए JSON स्टाइल के एलान को, क्लाउड पर मौजूद मैप की स्टाइलिंग के JSON स्कीमा में इंपोर्ट किया जा सकता है.

उदाहरण

यहां JSON स्टाइल के एलान का एक उदाहरण दिया गया है. इससे मैप की सभी सुविधाएं स्लेटी रंग में दिखती हैं. इसके बाद, मुख्य सड़क की ज्यामिति नीले रंग में दिखती है. साथ ही, लैंडस्केप के लेबल पूरी तरह से छिप जाते हैं:

[
  {
    "featureType": "all",
    "stylers": [
      { "color": "#C0C0C0" }
    ]
  },{
    "featureType": "road.arterial",
    "elementType": "geometry",
    "stylers": [
      { "color": "#CCFFFF" }
    ]
  },{
    "featureType": "landscape",
    "elementType": "labels",
    "stylers": [
      { "visibility": "off" }
    ]
  }
]

JSON ऑब्जेक्ट

JSON स्टाइल के एलान में ये एलिमेंट शामिल होते हैं:

• featureType (ज़रूरी नहीं) - स्टाइल में बदलाव करने के लिए, चुनी जाने वाली सुविधाएं. सुविधाएं, मैप पर मौजूद भौगोलिक विशेषताएं होती हैं. इनमें सड़कें, पार्क, पानी के स्रोत वगैरह शामिल हैं. अगर कोई सुविधा तय नहीं की जाती है, तो सभी सुविधाएं चुनी जाती हैं.
• elementType (ज़रूरी नहीं) - तय की गई सुविधा की वह प्रॉपर्टी जिसे चुना जाना है. एलिमेंट, किसी सुविधा के सब-पार्ट होते हैं. इनमें लेबल और ज्यामिति शामिल हैं. अगर कोई एलिमेंट तय नहीं किया जाता है, तो सुविधा के सभी एलिमेंट चुने जाते हैं.
• स्टाइलर - चुनी गई सुविधाओं और एलिमेंट पर लागू किए जाने वाले नियम. स्टाइलर, सुविधा का रंग, दिखने की सेटिंग, और वेट बताते हैं. किसी सुविधा पर एक या एक से ज़्यादा स्टाइलर लागू किए जा सकते हैं.

स्टाइल तय करने के लिए, आपको featureType और elementType सिलेक्टर के सेट और अपने stylers को स्टाइल ऐरे में शामिल करना होगा. एक ऐरे में, सुविधाओं के किसी भी कॉम्बिनेशन को टारगेट किया जा सकता है. हालांकि, एक साथ लागू की जा सकने वाली स्टाइल की संख्या सीमित होती है. अगर आपका स्टाइल ऐरे, वर्णों की तय की गई सीमा से ज़्यादा है, तो कोई स्टाइल लागू नहीं की जाती.

इस पेज के बाकी हिस्से में, सुविधाओं, एलिमेंट, और स्टाइलर के बारे में ज़्यादा जानकारी दी गई है.

featureType

यहां JSON स्निपेट का एक उदाहरण दिया गया है. इससे मैप पर मौजूद सभी सड़कें चुनी जाती हैं:

{
  "featureType": "road"
}

सुविधाएं या सुविधा के टाइप, मैप पर मौजूद भौगोलिक विशेषताएं होती हैं, इनमें सड़कें, पार्क, पानी के स्रोत, कारोबार वगैरह शामिल हैं.

सुविधाएं, कैटगरी ट्री बनाती हैं. इसमें all रूट के तौर पर काम करता है. अगर कोई सुविधा तय नहीं की जाती है, तो सभी सुविधाएं चुनी जाती हैं. all की कोई सुविधा तय करने पर भी यही असर होता है.

कुछ सुविधाओं में चाइल्ड सुविधाएं शामिल होती हैं. इन्हें तय करने के लिए, डॉट नोटेशन का इस्तेमाल किया जाता है. उदाहरण के लिए, landscape.natural या road.local. अगर सिर्फ़ पैरंट सुविधा तय की जाती है, जैसे कि road, तो पैरंट के लिए तय की गई स्टाइल, उसके सभी चाइल्ड पर लागू होती हैं. जैसे, road.local और road.highway.

ध्यान दें कि पैरंट सुविधाओं में कुछ ऐसे एलिमेंट शामिल हो सकते हैं जो उनके सभी चाइल्ड सुविधाओं में शामिल नहीं होते.

ये सुविधाएं उपलब्ध हैं:

• all (डिफ़ॉल्ट) से सभी सुविधाएं चुनी जाती हैं.
• administrative से सभी प्रशासनिक इलाके चुने जाते हैं. स्टाइलिंग का असर सिर्फ़ प्रशासनिक इलाकों के लेबल पर पड़ता है. भौगोलिक सीमाओं या फ़िल पर नहीं.
  • administrative.country से देश चुने जाते हैं.
  • administrative.land_parcel से ज़मीन के पार्सल चुने जाते हैं.
  • administrative.locality से इलाके चुने जाते हैं.
  • administrative.neighborhood से आस-पास के इलाके चुने जाते हैं.
  • administrative.province से प्रांत चुने जाते हैं.
• landscape से सभी लैंडस्केप चुने जाते हैं.
  • landscape.man_made से मैन-मेड सुविधाएं चुनी जाती हैं. जैसे, इमारतें और अन्य स्ट्रक्चर.
  • landscape.natural से प्राकृतिक सुविधाएं चुनी जाती हैं. जैसे, पहाड़, नदियां, रेगिस्तान, और ग्लेशियर.
  • landscape.natural.landcover से लैंड कवर की सुविधाएं चुनी जाती हैं. ये पृथ्वी की सतह को कवर करने वाला फ़िज़िकल मटीरियल होता है. जैसे, जंगल, घास के मैदान, दलदल, और बंजर ज़मीन.
  • landscape.natural.terrain से ज़मीन की सतह की टेरेन सुविधाएं चुनी जाती हैं, जैसे, ऊंचाई, ढलान, और ओरिएंटेशन.
• poi से दिलचस्पी की सभी जगहें चुनी जाती हैं.
  • poi.attraction से पर्यटकों के घूमने की जगहें चुनी जाती हैं.
  • poi.business से कारोबार चुने जाते हैं.
  • poi.government से सरकारी इमारतें चुनी जाती हैं.
  • poi.medical से आपातकालीन सेवाएं चुनी जाती हैं. इनमें अस्पताल, फ़ार्मेसी, पुलिस, डॉक्टर वगैरह शामिल हैं.
  • poi.park से पार्क चुने जाते हैं.
  • poi.place_of_worship से पूजा की जगहें चुनी जाती हैं. इनमें चर्च, मंदिर, मस्ज़िद वगैरह शामिल हैं.
  • poi.school से स्कूल चुने जाते हैं.
  • poi.sports_complex से खेल परिसर चुने जाते हैं.
• road से सभी सड़कें चुनी जाती हैं.
  • road.arterial से मुख्य सड़कें चुनी जाती हैं.
  • road.highway से हाइवे चुने जाते हैं.
  • road.highway.controlled_access से नियंत्रित ऐक्सेस वाले हाइवे चुने जाते हैं.
  • road.local से स्थानीय सड़कें चुनी जाती हैं.
• transit से ट्रांज़िट के सभी स्टेशन और लाइनें चुनी जाती हैं.
  • transit.line से ट्रांज़िट लाइनें चुनी जाती हैं.
  • transit.station से ट्रांज़िट के सभी स्टेशन चुने जाते हैं.
  • transit.station.airport से हवाई अड्डे चुने जाते हैं.
  • transit.station.bus से बस स्टॉप चुने जाते हैं.
  • transit.station.rail से रेल स्टेशन चुने जाते हैं.
• water से पानी के स्रोत चुने जाते हैं.

elementType

यहां JSON स्निपेट का एक उदाहरण दिया गया है. इससे सभी स्थानीय सड़कों के लेबल चुने जाते हैं:

{
  "featureType": "road.local",
  "elementType": "labels"
}

एलिमेंट, किसी सुविधा के सबडिविज़न होते हैं. उदाहरण के लिए, सड़क में मैप पर दिखने वाली ग्राफ़िकल लाइन (ज्यामिति) और उसका नाम बताने वाला टेक्स्ट (लेबल) शामिल होता है.

ये एलिमेंट उपलब्ध हैं. हालांकि, ध्यान दें कि किसी खास सुविधा में इनमें से कोई भी, कुछ या सभी एलिमेंट शामिल हो सकते हैं:

ज़ूम लेवल के हिसाब से, लेबल टेक्स्ट के fill और stroke के रंग बदलते हैं. ज़ूम लेवल के हिसाब से एक जैसा अनुभव देने के लिए, हमेशा fill और stroke दोनों को तय करें.

• all (डिफ़ॉल्ट) से तय की गई सुविधा के सभी एलिमेंट चुने जाते हैं.
• geometry से तय की गई सुविधा के सभी ज्यामितीय एलिमेंट चुने जाते हैं.
  • geometry.fill से, सुविधा की ज्यामिति का सिर्फ़ फ़िल चुना जाता है.
  • geometry.stroke से, सुविधा की ज्यामिति का सिर्फ़ स्ट्रोक चुना जाता है.
• labels से, तय की गई सुविधा से जुड़े टेक्स्ट वाले लेबल चुने जाते हैं.
  • labels.icon से, सुविधा के लेबल में दिखने वाला सिर्फ़ आइकॉन चुना जाता है.
  • labels.text से, लेबल का सिर्फ़ टेक्स्ट चुना जाता है.
  • labels.text.fill से, लेबल का सिर्फ़ फ़िल चुना जाता है. आम तौर पर, लेबल का फ़िल, लेबल टेक्स्ट के आस-पास दिखने वाली रंगीन आउटलाइन के तौर पर रेंडर होता है.
  • labels.text.stroke से, लेबल के टेक्स्ट का सिर्फ़ स्ट्रोक चुना जाता है.

stylers

स्टाइलर, फ़ॉर्मैटिंग के ऐसे विकल्प होते हैं जिन्हें मैप की सुविधाओं और एलिमेंट पर लागू किया जा सकता है.

यहां JSON स्निपेट का एक उदाहरण दिया गया है. इसमें आरजीबी वैल्यू का इस्तेमाल करके, किसी सुविधा को चमकीले हरे रंग में दिखाया गया है:

"stylers": [
  { "color": "#99FF33" }
]

इस स्निपेट से, किसी सुविधा के रंग की इंटेंसिटी पूरी तरह से हट जाती है. भले ही, उसका शुरुआती रंग कोई भी हो. इसका असर यह होता है कि सुविधा, ग्रेस्केल में रेंडर होती है:

"stylers": [
  { "saturation": -100 }
]

इस स्निपेट से, कोई सुविधा पूरी तरह से छिप जाती है:

    "stylers": [
      { "visibility": "off" }
    ]

स्टाइल के ये विकल्प काम करते हैं:

• hue (आरजीबी हेक्स स्ट्रिंग, जिसका फ़ॉर्मैट #RRGGBB) बुनियादी रंग दिखाता है.

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

• lightness (-100 और 100 के बीच फ़्लोटिंग पॉइंट वैल्यू) एलिमेंट की चमक में होने वाले प्रतिशत बदलाव को दिखाती है. नेगेटिव वैल्यू से अंधेरा बढ़ता है (जहां -100 का मतलब काला रंग है) वहीं, पॉज़िटिव वैल्यू से चमक बढ़ती है (जहां +100 का मतलब सफ़ेद रंग है).

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

• saturation (फ़्लोटिंग पॉइंट वैल्यू, जो -100 और 100 के बीच होती है) एलिमेंट पर लागू किए जाने वाले बुनियादी रंग की इंटेंसिटी में होने वाले प्रतिशत बदलाव को दिखाती है.

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

• gamma (फ़्लोटिंग पॉइंट वैल्यू, जो 0.01 और 10.0 के बीच होती है. इसमें 1.0 का मतलब है कि कोई सुधार लागू नहीं किया गया है) एलिमेंट पर लागू किए जाने वाले गामा सुधार की मात्रा को दिखाती है. गामा सुधार रंगों की लाइटनेस में नॉन-लीनियर तरीके से बदलाव करते हैं. हालांकि, इससे सफ़ेद या काले रंग की वैल्यू पर कोई असर नहीं पड़ता. आम तौर पर, गामा सुधार का इस्तेमाल कई एलिमेंट के कंट्रास्ट में बदलाव करने के लिए किया जाता है. उदाहरण के लिए, एलिमेंट के किनारों और अंदरूनी हिस्सों के बीच कंट्रास्ट को बढ़ाने या घटाने के लिए, गामा में बदलाव किया जा सकता है.

  ध्यान दें: इस विकल्प से, गामा कर्व का इस्तेमाल करके, डिफ़ॉल्ट Google स्टाइल के हिसाब से लाइटनेस को अडजस्ट किया जाता है. अगर Google, बुनियादी मैप की स्टाइल में कोई बदलाव करता है, तो उन बदलावों का असर आपके मैप की उन सुविधाओं पर पड़ता है जिनकी स्टाइलिंग gamma का इस्तेमाल करके की गई है. अगर आपके पास color स्टाइलर का इस्तेमाल करने का विकल्प है, तो इसका इस्तेमाल करना बेहतर है.

• invert_lightness (अगर true) मौजूदा लाइटनेस को इनवर्ट करता है. उदाहरण के लिए, यह सफ़ेद टेक्स्ट वाले गहरे रंग के मैप पर तुरंत स्विच करने के लिए काम का है.

  ध्यान दें: यह विकल्प, डिफ़ॉल्ट Google स्टाइल को इनवर्ट करता है. अगर Google बुनियादी मैप की स्टाइल में कोई बदलाव करता है, तो उन बदलावों का असर आपके मैप की उन सुविधाओं पर पड़ता है जिनकी स्टाइलिंग invert_lightness का इस्तेमाल करके की गई है. अगर आपके पास color स्टाइलर का इस्तेमाल करने का विकल्प है, तो इसका इस्तेमाल करना बेहतर है.

• visibility (on, off, या simplified) से पता चलता है कि एलिमेंट, मैप पर दिखता है या नहीं और कैसे दिखता है. A simplified विज़िबिलिटी से, असर वाली सुविधाओं से स्टाइल की कुछ सुविधाएं हट जाती हैं. उदाहरण के लिए, सड़कों को बिना आउटलाइन वाली पतली लाइनों में बदल दिया जाता है. वहीं, पार्कों के लेबल टेक्स्ट हट जाते हैं, लेकिन लेबल आइकॉन बरकरार रहते हैं.
• color (आरजीबी हेक्स स्ट्रिंग, जिसका फ़ॉर्मैट #RRGGBB) सुविधा का रंग सेट करता है.
• weight (इंटीजर वैल्यू, जो शून्य से ज़्यादा या उसके बराबर होती है) सुविधा का वेट पिक्सल में सेट करता है. वेट को ज़्यादा वैल्यू पर सेट करने से, टाइल के बॉर्डर के पास क्लिप करने की समस्या हो सकती है.

स्टाइल के नियम, तय किए गए क्रम में लागू होते हैं. एक ही स्टाइल ऑपरेशन में, एक से ज़्यादा कार्रवाइयों को शामिल न करें. इसके बजाय, हर कार्रवाई को स्टाइल ऐरे में अलग-अलग एंट्री के तौर पर तय करें.

ध्यान दें: क्रम ज़रूरी है, क्योंकि कुछ कार्रवाइयां कम्यूटेटिव नहीं होती हैं. स्टाइल ऑपरेशन के ज़रिए, जिन सुविधाओं और/या एलिमेंट में बदलाव किया जाता है उनमें (आम तौर पर) पहले से ही स्टाइल मौजूद होती हैं. अगर पहले से स्टाइल मौजूद हैं, तो ऑपरेशन उन पर लागू होते हैं.

ह्यू, सैचुरेशन, लाइटनेस मॉडल

ध्यान दें: ह्यू, सैचुरेशन, लाइटनेस, और गामा सेटिंग का असर, बुनियादी मैप की स्टाइल के हिसाब से तय होता है. अगर Google, बुनियादी मैप की स्टाइल में कोई बदलाव करता है, तो उन बदलावों का असर आपके मैप की उन सुविधाओं पर पड़ता है जिनकी स्टाइलिंग इन विकल्पों का इस्तेमाल करके की गई है. अगर आपके पास निरपेक्ष color स्टाइलर का इस्तेमाल करने का विकल्प है, तो इसका इस्तेमाल करना बेहतर है.

स्टाइल किए गए मैप, स्टाइलर ऑपरेशन में रंग दिखाने के लिए, ह्यू, सैचुरेशन, लाइटनेस (एचएसएल) मॉडल का इस्तेमाल करते हैं. ह्यू बुनियादी रंग दिखाता है, सैचुरेशन उस रंग की इंटेंसिटी दिखाता है, और लाइटनेस कॉम्पोनेंट कलर में सफ़ेद या काले रंग की मात्रा दिखाता है.

गामा सुधार, कलर स्पेस में लाइटनेस में बदलाव करता है. आम तौर पर, यह कंट्रास्ट को बढ़ाने या घटाने के लिए किया जाता है. इसके अलावा, एचएसएल मॉडल, कोऑर्डिनेट स्पेस में रंग तय करता है . इसमें hue कलर व्हील में ओरिएंटेशन दिखाता है . वहीं, सैचुरेशन और लाइटनेस, अलग-अलग ऐक्सिस के साथ ऐम्प्लिट्यूड दिखाते हैं . ह्यू को आरजीबी कलर स्पेस में मेज़र किया जाता है. यह ज़्यादातर आरजीबी कलर स्पेस जैसा ही होता है. हालांकि, इसमें सफ़ेद और काले रंग के शेड मौजूद नहीं होते.

hue एचटीएमएल हेक्स कलर वैल्यू लेता है. हालांकि, यह इस वैल्यू का इस्तेमाल सिर्फ़ बुनियादी रंग तय करने के लिए करता है. जैसे, कलर व्हील के आस-पास इसका ओरिएंटेशन. यह सैचुरेशन या लाइटनेस के लिए इस वैल्यू का इस्तेमाल नहीं करता. सैचुरेशन या लाइटनेस को प्रतिशत बदलाव के तौर पर अलग से दिखाया जाता है.

उदाहरण के लिए, प्योर ग्रीन के लिए ह्यू को hue:0x00ff00 या hue:0x000100 के तौर पर तय किया जा सकता है. दोनों ह्यू एक जैसे हैं. दोनों वैल्यू, एचएसएल कलर मॉडल में प्योर ग्रीन की ओर इशारा करती हैं.

आरजीबी कलर व्हील

आरजीबी hue वैल्यू में लाल, हरे, और नीले रंग के बराबर हिस्से शामिल होते हैं . ये वैल्यू, ह्यू नहीं दिखाती हैं, क्योंकि इनमें से कोई भी वैल्यू, एचएसएल कोऑर्डिनेट स्पेस में ओरिएंटेशन नहीं दिखाती . उदाहरण के लिए, "#000000" (काला), "#FFFFFF" (सफ़ेद), और स्लेटी रंग के सभी प्योर शेड. काला, सफ़ेद या स्लेटी रंग दिखाने के लिए, आपको सभी saturation हटाने होंगे (वैल्यू को -100 पर सेट करें) और lightness को अडजस्ट करना होगा.

इसके अलावा, मौजूदा सुविधाओं में बदलाव करते समय, जिनमें पहले से ही कलर स्कीम मौजूद है, hue जैसी वैल्यू में बदलाव करने से, उसके मौजूदा saturation या lightness में कोई बदलाव नहीं होता.