मैप आईडी एक यूनीक आइडेंटिफ़ायर होता है. इसका इस्तेमाल, Google Maps के किसी एक इंस्टेंस को दिखाने के लिए किया जाता है. मैप आईडी का इस्तेमाल, अपनी वेबसाइटों और ऐप्लिकेशन पर मैप की सुविधाओं को चालू करने या मैप को मैनेज करने या उनकी स्टाइल तय करने के लिए किया जाता है. Google Cloud Console के प्रोजेक्ट में, मैप मैनेजमेंट पेज पर जाकर, अपने हिसाब से हर प्लैटफ़ॉर्म के लिए मैप आईडी बनाए जा सकते हैं. जैसे, JavaScript, Android, iOS या स्टैटिक मैप.
मैप आईडी का इस्तेमाल करने वाली सुविधाओं और ज़्यादा जानकारी के लिए, मैप आईडी की खास जानकारी देखें.
ज़रूरी अनुमतियां
अपने प्रोजेक्ट में कोई मैप आईडी बनाने या मैनेज करने के लिए, आपको प्रोजेक्ट के Cloud Console आईएएम पेज पर, भूमिका के लेवल की सही अनुमतियों वाले प्रिंसिपल का इस्तेमाल करना होगा. जैसे, एडिटर या मालिक. ज़्यादा जानकारी के लिए, आईएएम की बुनियादी और पहले से तय भूमिकाओं का रेफ़रंस देखें.
मैप आईडी बनाना
Cloud Console में मैप आईडी बनाने के लिए, यह तरीका अपनाएं:
ज़रूरी अनुमतियों के साथ, Cloud Console प्रोजेक्ट में साइन इन करें और उसे खोलें.
Cloud Console में, Maps मैनेजमेंट पेज पर जाएं.
मैप आईडी बनाएं पर क्लिक करें.
नया मैप आईडी बनाएं पेज पर, ये काम करें:
- नाम के लिए, मैप आईडी को कोई नाम दें.
- ज़रूरी नहीं: जानकारी के लिए, बताएं कि मैप आईडी का इस्तेमाल किस काम के लिए किया जाता है.
- मैप टाइप के लिए, वह प्लैटफ़ॉर्म चुनें जिस पर आपको मैप आईडी का इस्तेमाल करना है. JavaScript चुनने पर, रेस्टर (डिफ़ॉल्ट) या वेक्टर मैप टाइप भी चुनें. वेक्टर मैप के बारे में ज़्यादा जानने के लिए, वेक्टर मैप देखें.
- अपना नया मैप आईडी दिखाने के लिए, सेव करें पर क्लिक करें.
मैप के किसी स्टाइल से मैप आईडी जोड़ना
अगर क्लाउड पर मैप की स्टाइलिंग की सुविधाओं का इस्तेमाल किया जा रहा है, तो अपने मैप आईडी के साथ मैप स्टाइल जोड़ें. ज़्यादा जानकारी के लिए, जोड़ें लेख पढ़ें.
अपने ऐप्लिकेशन में मैप आईडी जोड़ना
Android
MapView क्लास का इस्तेमाल करके, गतिविधि की लेआउट फ़ाइल में <fragment> एलिमेंट के ज़रिए अपना मैप आईडी जोड़ें. इसके अलावा, प्रोग्राम के हिसाब से GoogleMapOptions क्लास का इस्तेमाल करके भी ऐसा किया जा सकता है.
उदाहरण के लिए, मान लें कि आपने एक मैप आईडी बनाया है, जिसे res/values/strings.xml में map_id नाम की स्ट्रिंग वैल्यू के तौर पर सेव किया गया है:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">MAP_ID</string>
</resources>
गतिविधि की लेआउट फ़ाइल में <fragment> एलिमेंट की मदद से जोड़े गए मैप के लिए,
जिन सभी मैप फ़्रैगमेंट में कस्टम स्टाइल होना चाहिए उनके लिए map:mapId एट्रिब्यूट में मैप आईडी की जानकारी देनी होगी:
<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
map:name="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
मैप आईडी का इस्तेमाल करके मैप इंस्टैंशिएट करने के लिए, यह तरीका अपनाएं:
- Cloud Console से मैप आईडी की स्ट्रिंग का इस्तेमाल करके,
GMSMapIDबनाएं. - आपने जो मैप आईडी बनाया है उसके बारे में बताने वाला
GMSMapViewबनाएं.
Swift
let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "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:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;
अगर आपने अपना मैप आईडी इस्तेमाल किया है, तो किसी भी समय नई स्टाइल पाने के लिए, Cloud Console में अपना मैप आईडी सेट किया जा सकता है. यह स्टाइल, आपके और उपयोगकर्ताओं के लिए, मैप व्यू में करीब छह घंटे के अंदर अपने-आप दिखने लगेगी.
अगर आपको बदलाव तुरंत देखने हैं, तो ऐप्लिकेशन से बाहर निकलकर उसे बंद करें और फिर से खोलें. इसके लिए, हाल ही में इस्तेमाल किए गए ऐप्लिकेशन की सूची से ऐप्लिकेशन को बंद करें और फिर से खोलें. इसके बाद, आपको अपडेट किया गया मैप दिखेगा.
JavaScript
अपने ऐप्लिकेशन कोड में मैप आईडी वाला मैप बनाने के लिए:
अगर एम्बेड किए गए JSON कोड की मदद से, मैप को पहले से ही पसंद के मुताबिक बनाया जा रहा है, तो अपने
MapOptionsऑब्जेक्ट सेstylesप्रॉपर्टी को हटाएं. अगर ऐसा नहीं है, तो इस चरण को छोड़ें.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 Static API का इस्तेमाल करके मैप में मैप आईडी जोड़ने का तरीका बताया गया है.
<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=MAP_ID&signature=YOUR_SIGNATURE" />