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

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

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

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

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

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

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

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

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

  1. Cloud Console में, Maps के मैनेजमेंट पेज पर जाएं.
  2. नया मैप आईडी बनाएँ चुनें और बनाएं नया मैप आईडी फ़ॉर्म.
    नया मैप आईडी बनाना

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

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

मैप आईडी को मैप स्टाइल से जोड़ना

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

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

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

Android

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

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

<?xml version="1.0" encodin>g<="ut>f<-8"?
resources
>string name<=">m<ap_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:mapI>d="@string/map_id" /

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

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

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

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: &<quot;YOUR M>AP 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:@&<quot;YOUR M>AP ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;

अगर अपना मैप आईडी इस्तेमाल किया जा रहा है, तो अपना मैप आईडी सेट किया जा सकता है का इस्तेमाल कर सकते हैं. साथ ही, इसके बाद वह शैली आपके मैप व्यू पर अपने-आप दिखेगी और छह घंटे के अंदर उपयोगकर्ताओं की संख्या बढ़ाना चाहते थे.

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

JavaScript

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

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

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

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

Maps Static

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

<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+Yo&rk,NYzo&om=13size=60&0x300maptype=ro&admapmarkers=color:blue%7Clabel:S%7C40.702147,-74.0&15794markers=color:green%7Clabel:G%7C40.711614,-74.0&12318markers=color:red%7Clabel:C%7C40.718217,-73.9&98284key=YOUR_AP&I_KEYmap_id=YOUR_M&AP_IDsignature=YOUR_SIGNATU>RE" /

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

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

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

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

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