मैप आईडी का इस्तेमाल करें

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

बनाए जाने के बाद, मैप आईडी किसी प्रोजेक्ट से जुड़े होते हैं. इन्हें एक ही प्लैटफ़ॉर्म (Android, iOS, JavaScript) या Maps स्टैटिक एपीआई तक भी सीमित रखा जाता है.

Cloud Console में कोई भी मैप आईडी बनाने या उसे मैनेज करने के लिए, आपके पास प्रोजेक्ट के मालिक या प्रोजेक्ट एडिटर का IAM की भूमिका होनी चाहिए.

ज़रूरी अनुमतियां

किसी Google Cloud प्रोजेक्ट में कोई भी मैप आईडी या मैप स्टाइल बनाने या मैनेज करने के लिए, आपके पास प्रोजेक्ट का मालिक या एडिटर IAM की भूमिका होनी चाहिए.

एक मैप आईडी बनाएं

मैप आईडी एक यूनीक आइडेंटिफ़ायर होता है, जो Google मैप के एक इंस्टेंस को दिखाता है. आप जब चाहें, Cloud Console पर जाकर, मैप आईडी बना सकते हैं और मैप आईडी से जुड़े स्टाइल को अपडेट कर सकते हैं.

मैप आईडी बनाने के लिए:

  1. Cloud Console में, Maps मैनेजमेंट पेज पर जाएं.
  2. नया मैप आईडी बनाएं दिखाने के लिए, नया मैप आईडी बनाएं चुनें.
    नया मैप आईडी बनाएं

    फ़ॉर्म में, ये काम करें:

    • मैप का नाम डालें.
    • कोई मैप प्रकार या प्लैटफ़ॉर्म बताएं.
    • JavaScript मैप के लिए, रास्टर या वेक्टर मैप टाइप चुनें.
    • मैप के बारे में जानकारी डालें.
    • नया मैप आईडी दिखाने के लिए, आगे बढ़ें चुनें.

मैप आईडी को मैप की शैली से जोड़ें

ये निर्देश मानते हैं कि आपके प्रोजेक्ट में कम से कम एक मौजूदा मैप शैली मौजूद है.

  1. Cloud Console में, Maps मैनेजमेंट पेज पर जाएं.
  2. इस पेज पर, मैप का नाम कॉलम से कोई मौजूदा मैप आईडी चुनें.
  3. इस फ़ॉर्म के सबसे नीचे, इस आईडी आईडी से जुड़े मैप स्टाइल ड्रॉपडाउन से मैप स्टाइल चुनें.
  4. सेव करें को चुनें.
    किसी एक मैप आईडी की जानकारी देने वाला स्क्रीनशॉट, जिसमें ड्रॉपडाउन फ़ील्ड शामिल है. इसकी मदद से उपयोगकर्ता, मैप स्टाइल को इस मैप आईडी से जोड़ सकते हैं.

अपने ऐप्लिकेशन में मैप आईडी जोड़ें

Android

अपना क्लास आईडी, गतिविधि की लेआउट फ़ाइल में <fragment> एलिमेंट के ज़रिए जोड़ें. इसके लिए, MapView क्लास का इस्तेमाल करें या GoogleMapOptions क्लास का इस्तेमाल करके, प्रोग्राम की मदद से अपना मैप आईडी जोड़ें.

उदाहरण के लिए, मान लें कि आपने एक मैप आईडी बनाया है, जो res/values/strings.xml में map_id नाम के स्ट्रिंग वैल्यू के तौर पर स्टोर किया गया है:

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">YOUR_MAP_ID</string>
</resources>

गतिविधि की लेआउट फ़ाइल में <fragment> एलिमेंट के ज़रिए जोड़े गए मैप के लिए, कस्टम स्टाइल वाले सभी मैप फ़्रैगमेंट को map:mapId एट्रिब्यूट में मैप आईडी डालना होगा:

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    class="com.google.android.gms.maps.SupportMapFragment"
    …
    map:mapId="@string/map_id" />

मैप आईडी बताने के लिए, आप MapView क्लास के map:mapId एट्रिब्यूट का इस्तेमाल भी कर सकते हैं:

<com.google.android.gms.maps.MapView
    xmlns:android="http://schemas.android.com/apk/res/android"
    ....
    map:mapId="@string/map_id" />

मैप आईडी को प्रोग्राम के बारे में बताने के लिए, इसे GoogleMapOptions क्लास का इस्तेमाल करके MapFragment इंस्टेंस में पास करें:

Java

 MapFragment mapFragment = MapFragment.newInstance(
     new GoogleMapOptions()
         .mapId(getResources().getString(R.string.map_id)));

Kotlin

 val mapFragment = MapFragment.newInstance(
     GoogleMapOptions()
         .mapId(resources.getString(R.string.map_id))
 )

Android Studio में, अपना ऐप्लिकेशन उसी तरह बनाएं और चलाएं जैसा कि आप आम तौर पर करते हैं. पहले चरण में कॉन्फ़िगर की गई कस्टम स्टाइल, आईडी के साथ सभी मैप पर लागू होंगी.

iOS

मैप आईडी का इस्तेमाल करके मैप को इंस्टैंशिएट करने के लिए, नीचे दी गई जानकारी दें:

  1. Cloud Console से मैप आईडी स्ट्रिंग के साथ GMSMapID बनाएं.
  2. अभी-अभी बनाए गए मैप आईडी की जानकारी देने वाला GMSMapView बनाएं.

Swift

let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "<YOUR MAP ID>")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
                                                        longitude:-122.336471
                                                             zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"<YOUR MAP ID>"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;

अगर आप अपना खुद का मैप आईडी इस्तेमाल कर रहे हैं, तो आप अपने मैप आईडी को किसी भी समय एक नई शैली में डालने के लिए Cloud Console में सेट कर सकते हैं. यह शैली आपके और मैप पर उपयोगकर्ताओं के लिए छह घंटे के अंदर अपने आप दिखने लगेगी.

अगर आपको ये बदलाव तुरंत देखने हैं, तो ऐप्लिकेशन को बंद करके, रीस्टार्ट करें. इसके बाद, ऐप्लिकेशन को बंद करके, हाल ही में इस्तेमाल किए गए ऐप्लिकेशन की सूची से बाहर निकलें और फिर से खोलें. इसके बाद, अपडेट किया गया मैप दिखेगा.

JavaScript

अपने ऐप्लिकेशन कोड में मैप आईडी का इस्तेमाल करके मैप बनाने के लिए:

  1. अगर आप अपने मैप को JSON कोड की मदद से पसंद के मुताबिक बना रहे हैं, तो अपने MapOptions ऑब्जेक्ट से styles प्रॉपर्टी हटाएं. अगर ऐसा नहीं है, तो यह चरण छोड़ें.

  2. mapId प्रॉपर्टी का इस्तेमाल करके मैप में मैप आईडी जोड़ें. उदाहरण के लिए :

map = new google.maps.Map(document.getElementById('map'), {
center: {lat: -34.397, lng: 150.644},
zoom: 8,
mapId: 'MAP_ID'
});

मैप स्टैटिक

हमारे वेब-सर्विस एपीआई का इस्तेमाल करने वाले नए या मौजूदा मैप में मैप आईडी जोड़ने के लिए, map_id यूआरएल पैरामीटर जोड़ें और इसे अपने मैप आईडी पर सेट करें. इस उदाहरण में बताया गया है कि Maps स्टैटिक एपीआई का इस्तेमाल करके, मैप पर मैप आईडी जोड़ना.

<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=YOUR_MAP_ID&signature=YOUR_SIGNATURE" />

अमेरिका के न्यूयॉर्क शहर के ब्रुकलिन ब्रिज पर केंद्रित मैप, जिसमें निचले दाएं कोने में मैप नियंत्रण है. मैप में सड़कों, पानी, और ज़मीन को मनपसंद शैली में दिखाया जाता है.

अगर आपको अपना मैप आईडी जोड़ने से पहले, मैप के स्टैटिक यूआरएल में डिजिटल हस्ताक्षर है, तो आपको अपना मैप आईडी जोड़ने के बाद, एक नया डिजिटल हस्ताक्षर बनाना और जोड़ना होगा. नया यूआरएल साइनिंग सीक्रेट जनरेट करते समय, यूआरएल से अपने पिछले डिजिटल हस्ताक्षर को हटाना न भूलें.

मैप आईडी का इस्तेमाल करते समय उपलब्ध सुविधाएं

क्लाउड-आधारित मैप का स्टाइल: Google Cloud Console का इस्तेमाल करके, अपने मैप को स्टाइल, पसंद के मुताबिक बनाएं, और मैनेज करें.
सभी प्लैटफ़ॉर्म (Android, JavaScript, iOS, और Maps स्टैटिक एपीआई) पर उपलब्ध है

वेक्टर मैप: वेक्टर-आधारित टाइलों से बना एक मैप, जो WebGL का इस्तेमाल करके क्लाइंट साइड पर लोड होते समय बनाया जाता है.
JavaScript पर उपलब्ध