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

मैप आईडी, ऐसा आइडेंटिफ़ायर होता है जो किसी मैप की स्टाइल या सुविधा से जुड़ा होता है. 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

गतिविधि के सेक्शन में <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 कोड का इस्तेमाल करके अपने मैप को पसंद के मुताबिक बनाया है, तो 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

अगर आपको किसी नए या मौजूदा मैप में मैप आईडी जोड़ना है, जो हमारे किसी वेब-सेवा एपीआई का इस्तेमाल करता है, तो 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" />

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

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

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

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

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