इस पेज पर, iOS के लिए Maps SDK की यूटिलिटी लाइब्रेरी सेट अप करने का तरीका बताया गया है.
इन यूटिलिटी को आज़माने के लिए, इनमें से कोई एक तरीका अपनाएं:
- किसी मौजूदा Xcode प्रोजेक्ट में, यूटिलिटी लाइब्रेरी इंस्टॉल करें. इन यूटिलिटी को अपने प्रोजेक्ट में जोड़ें.
- डेमो ऐप्लिकेशन इंस्टॉल करें और उसे चलाएं. डेमो ऐप्लिकेशन एक स्टैंडअलोन प्रोजेक्ट है. इसमें यूटिलिटी को आज़माने के लिए ज़रूरी सभी कोड शामिल होते हैं.
किसी Xcode प्रोजेक्ट में, iOS के लिए Maps SDK की यूटिलिटी लाइब्रेरी जोड़ना
अपनी Xcode वर्कस्पेस में यूटिलिटी लाइब्रेरी जोड़ने के लिए, यह तरीका अपनाएं:
Swift Package Manager का इस्तेमाल करना
- अगर आपके पास अब तक कोई Xcode प्रोजेक्ट नहीं है, तो उसे अभी बनाएं और अपनी लोकल मशीन पर सेव करें. (अगर आपने iOS डेवलपमेंट में नया-नया काम शुरू किया है, तो एक नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें. Xcode 11.7 या इससे पुराने वर्शन पर, सिंगल व्यू ऐप्लिकेशन बनाएं.)
- iOS के लिए Maps SDK को डिपेंडेंसी के तौर पर जोड़ें. विकल्पों के लिए, एसडीके इंस्टॉल करना लेख देखें.
- अपने Xcode प्रोजेक्ट में, फ़ाइल -> Swift पैकेज -> पैकेज डिपेंडेंसी जोड़ें पर जाएं.
- दिखने वाली विंडो में, iOS के लिए Maps SDK की यूटिलिटी लाइब्रेरी का रिपॉज़िटरी यूआरएल
https://github.com/googlemaps/google-maps-ios-utilsडालें और आगे बढ़ें को चुनें. - इस समय, आपसे अपने GitHub खाते से पुष्टि करने के लिए कहा जा सकता है. प्रोसेस जारी रखने के लिए, GitHub का निजी ऐक्सेस टोकन बनाने के लिए दिए गए निर्देशों का पालन करें.
- अगली विंडो में, वर्शन रेडियो बटन चुनें. इसके बाद, ड्रॉप-डाउन सूची से अगले बड़े वर्शन तक को चुनें. साथ ही, iOS के लिए Maps SDK की यूटिलिटी लाइब्रेरी का सबसे नया वर्शन डालें. उदाहरण के लिए, "6.0.0" डालें.
- प्रोजेक्ट में जोड़ें के बगल में मौजूद ड्रॉप-डाउन पर क्लिक करें. इसके बाद, अपना प्रोजेक्ट चुनें और पैकेज जोड़ें को चुनें.
अपने ऐप्लिकेशन में एपीआई पासकोड जोड़ना
एपीआई पासकोड जनरेट करने और उसे अपने Xcode प्रोजेक्ट में जोड़ने के निर्देशों के लिए, Xcode प्रोजेक्ट सेट अप करना लेख देखें.प्रोजेक्ट बनाना और उसे चलाना
एपीआई पासकोड जोड़ने के बाद, प्रोजेक्ट बनाएं और उसे चलाएं.
अपने ऐप्लिकेशन में किसी यूटिलिटी का इस्तेमाल करना
अपने ऐप्लिकेशन में किसी यूटिलिटी का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, हर यूटिलिटी से जुड़ा दस्तावेज़ देखें:
डेमो ऐप्लिकेशन इंस्टॉल करना और उसे चलाना
यूटिलिटी लाइब्रेरी में एक डेमो ऐप्लिकेशन शामिल होता है. इसे इंस्टॉल करके, हर यूटिलिटी को आज़माया जा सकता है.
डेमो ऐप्लिकेशन इंस्टॉल करने के लिए:GitHub से फ़ाइलें इस्तेमाल करना
- GitHub
से
कोड के नमूने का संग्रह डाउनलोड करें और संग्रह को अनपैक करें. इसके अलावा, रिपॉज़िटरी को किसी लोकल डायरेक्ट्री में क्लोन करें:
git clone https://github.com/googlemaps/google-maps-ios-utils.git
- टर्मिनल विंडो खोलें. इसके बाद, उस डायरेक्ट्री पर जाएं जहां आपने नमूना फ़ाइलें अनपैक की हैं. साथ ही,
अपनी पसंद की भाषा के लिए, सैंपल डायरेक्ट्री में जाएं:
Swift
cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeprojObjective-C
cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj
डेमो ऐप्लिकेशन में एपीआई पासकोड जोड़ना
एपीआई पासकोड पाना लेख में, अपने ऐप्लिकेशन के लिए एपीआई पासकोड जनरेट करने का तरीका बताया गया है. अब उस पासकोड को डेमो ऐप्लिकेशन के Xcode प्रोजेक्ट में जोड़ें., एपीआई पासकोड पाना लेख देखें.Swift
अपना एपीआई पासकोड, AppDelegate.swift में इस तरह जोड़ें:
- इंपोर्ट करने का यह स्टेटमेंट जोड़ें:
import GoogleMaps
- डबल कोट के बीच अपना एपीआई पासकोड जोड़ने के लिए, इस लाइन में बदलाव करें:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
अपना एपीआई पासकोड, AppDelegate.m में इस तरह जोड़ें:
- इंपोर्ट करने का यह स्टेटमेंट जोड़ें:
@import GoogleMaps;
- डबल कोट के बीच अपना एपीआई पासकोड जोड़ने के लिए, इस लाइन में बदलाव करें:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
डेमो ऐप्लिकेशन बनाना और उसे चलाना
एपीआई पासकोड जोड़ने के बाद, प्रोजेक्ट बनाएं और उसे चलाएं:
- अगर डेमो का Swift वर्शन चलाया जा रहा है, तो यह चुना जा सकता है कि ऐप्लिकेशन में कौनसी यूटिलिटी देखनी है.
- अगर डेमो का Objective-C वर्शन चलाया जा रहा है, तो मार्कर क्लस्टरिंग यूटिलिटी का डेमो दिखेगा. इसके बाद, हर यूटिलिटी को आज़माने के लिए, डेमो के Objective-C वर्शन में बदलाव किया जा सकता है. ज़्यादा जानकारी के लिए, नीचे दिया गया अपने ऐप्लिकेशन में कोई यूटिलिटी जोड़ना सेक्शन देखें.