सेटअप और डेमो

प्लैटफ़ॉर्म चुनें: Android iOS

इस पेज पर, iOS के लिए Maps SDK टूल के लिए, यूटिलिटी लाइब्रेरी सेट अप करने का तरीका बताया गया है.

इन सुविधाओं को आज़माने के लिए, इनमें से कोई एक तरीका अपनाएं:

• डेमो ऐप्लिकेशन इंस्टॉल करें और चलाएं. डेमो ऐप्लिकेशन एक स्टैंड-अलोन प्रोजेक्ट है, जिसमें सुविधाओं को आज़माने के लिए ज़रूरी सभी कोड शामिल हैं.
• यूटिलिटी लाइब्रेरी को किसी मौजूदा Xcode प्रोजेक्ट में इंस्टॉल करें. इन सुविधाओं को अपने प्रोजेक्ट में जोड़ें.

विकल्प के तौर पर, CocoaPods इंस्टॉल करें

यूटिलिटी लाइब्रेरी, Google-Maps-iOS-Utils नाम के CocoaPods पॉड के तौर पर उपलब्ध है. CocoaPods, Swift और Objective-C Cocoa प्रोजेक्ट के लिए एक ओपन सोर्स डिपेंडेंसी मैनेजर है.

अगर आपके पास पहले से CocoaPods टूल नहीं है, तो इसे macOS पर इंस्टॉल करें. इसके लिए, टर्मिनल से यह कमांड दें:

sudo gem install cocoapods

ज़्यादा जानकारी के लिए, CocoaPods को शुरू करने की गाइड देखें.

डेमो ऐप्लिकेशन इंस्टॉल करना और चलाना

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

CocoaPods के 1.8.1 और इसके बाद के वर्शन में 'pod try' के साथ एक ऐसी समस्या है जिसके बारे में पहले से जानकारी है. अगर आपको CocoaPods का इस्तेमाल करके फ़ाइलें फ़ेच करनी हैं, तो हमारा सुझाव है कि CocoaPods के वर्शन 1.6.1 का इस्तेमाल करें. इसके अलावा, GitHub से सैंपल फ़ाइलें डाउनलोड की जा सकती हैं.

इन दो तरीकों में से किसी एक का इस्तेमाल करके, डेमो ऐप्लिकेशन इंस्टॉल करें:

GitHub की फ़ाइलों का इस्तेमाल करें

1. GitHub से कोड का सैंपल डाउनलोड करें और संग्रह को अनपैक करें.
2. टर्मिनल विंडो खोलें. उस डायरेक्ट्री पर जाएं जहां सैंपल फ़ाइलों को बड़ा किया गया है. इसके बाद, आपको जिस भाषा का इस्तेमाल करना है उसके लिए सही सैंपल डायरेक्ट्री में ड्रिल-डाउन करें:
   • Swift के लिए, cd google-maps-ios-utils-master/samples/SwiftDemoApp चलाएं
   • Objective-C के लिए, cd google-maps-ios-utils-master/samples/ObjCDemoApp चलाएं
3. यह निर्देश चलाएं:
   

   pod install

4. Xcode को बंद करें और फिर Xcode को लॉन्च करने के लिए, अपने प्रोजेक्ट की .xcworkspace फ़ाइल खोलें (दो बार क्लिक करें). इसके बाद, प्रोजेक्ट को खोलने के लिए, आपको .xcworkspace फ़ाइल का इस्तेमाल करना होगा.

CocoaPods v1.6.1 का इस्तेमाल करें

1. टर्मिनल विंडो खोलें और वर्शन 1.6.1 इंस्टॉल करें:

   sudo gem install cocoapods -v1.6.1

2. Cocoapods का इस्तेमाल करके Google Maps की फ़ाइलें फ़ेच करें:

   pod try Google-Maps-iOS-Utils

   जब कहा जाए, तब Swift या Objective-C चुनें. CocoaPods, आपके खास डेटा को स्टोर करने की जगहों को अपडेट करता है. इसके बाद, यह डेमो को SwiftDemoApp.xcodeproj या ObjCDemoApp.xcodeproj नाम के अस्थायी Xcode प्रोजेक्ट में खोलता है.

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

एपीआई पासकोड पाएं में, अपने ऐप्लिकेशन के लिए एपीआई पासकोड जनरेट किया जाता है. अब डेमो ऐप्लिकेशन के लिए, Xcode प्रोजेक्ट में उस कुंजी को जोड़ें.

ध्यान दें: अगर आपके एपीआई पासकोड में ऐप्लिकेशन पर पाबंदी का इस्तेमाल किया गया है, तो पक्का करें कि आपने ऐप्लिकेशन के बंडल आइडेंटिफ़ायर को कुंजी से जोड़ा हो. उदाहरण के लिए, अगर डेमो ऐप्लिकेशन चलाया जा रहा है, तो बंडल आइडेंटिफ़ायर com.google.gmsutils.DemoApp होगा. किसी कुंजी पर पाबंदी लगाने के बारे में ज़्यादा जानकारी के लिए, एपीआई पासकोड पाएं देखें.

Swift

अपने AppDelegate.swift में अपनी एपीआई कुंजी इस तरह जोड़ें:

1. यह इंपोर्ट स्टेटमेंट जोड़ें:

   import GoogleMaps

2. एपीआई पासकोड को डबल कोट के बीच में जोड़ने के लिए, इस लाइन में बदलाव करें:

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

अपने AppDelegate.m में अपनी एपीआई कुंजी इस तरह जोड़ें:

1. यह इंपोर्ट स्टेटमेंट जोड़ें:

   @import GoogleMaps;

2. एपीआई पासकोड को डबल कोट के बीच में जोड़ने के लिए, इस लाइन में बदलाव करें:

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";

डेमो ऐप्लिकेशन बनाएं और चलाएं

एपीआई पासकोड जोड़ने के बाद, प्रोजेक्ट बनाएं और चलाएं:

• अगर डेमो का Swift वर्शन इस्तेमाल किया जा रहा है, तो आपके पास यह चुनने का विकल्प है कि ऐप्लिकेशन में कौनसी सुविधा देखनी है.
• अगर डेमो का Objective-C वर्शन चलाया जा रहा है, तो आपको मार्कर क्लस्टरिंग यूटिलिटी का डेमो दिखेगा. इसके बाद, हर यूटिलिटी को आज़माने के लिए डेमो के Objective-C वर्शन में बदलाव किया जा सकता है. ज़्यादा जानकारी के लिए, नीचे दिया गया अपने ऐप्लिकेशन में कोई उपयोगिता जोड़ें सेक्शन देखें.

यूटिलिटी लाइब्रेरी को Xcode प्रोजेक्ट के तौर पर इंस्टॉल करें

अपने Xcode फ़ाइल फ़ोल्डर में यूटिलिटी लाइब्रेरी जोड़ने के लिए, यह तरीका अपनाएं:

CocoaPods का इस्तेमाल करना

1. अगर आपके पास अब तक कोई Xcode प्रोजेक्ट नहीं है, तो अभी एक प्रोजेक्ट बनाएं और उसे अपने लोकल मशीन में सेव करें. (अगर आपने हाल ही में iOS डेवलपमेंट का इस्तेमाल शुरू किया है, तो एक व्यू वाला ऐप्लिकेशन बनाएं.)
2. अगर आपके पास अपने प्रोजेक्ट के लिए पहले से कोई पॉड फ़ाइल नहीं है, तो अपनी प्रोजेक्ट डायरेक्ट्री में Podfile नाम की एक फ़ाइल बनाएं. इस फ़ाइल से आपके प्रोजेक्ट की डिपेंडेंसी के बारे में पता चलता है.
3. अपने प्रोजेक्ट की पॉड फ़ाइल में बदलाव करें और Google-Maps-iOS-Utils पॉड पर डिपेंडेंसी जोड़ें. यहां एक उदाहरण दिया गया है जिसमें iOS के लिए Maps SDK और यूटिलिटी लाइब्रेरी के लिए ज़रूरी डिपेंडेंसी शामिल हैं:

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '13.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '7.4.0'
     pod 'Google-Maps-iOS-Utils', '4.2.2'
   end

4. pod install चलाएं.
5. Xcode को बंद करें और फिर Xcode को लॉन्च करने के लिए, अपने प्रोजेक्ट की .xcworkspace फ़ाइल खोलें (दो बार क्लिक करें). इसके बाद, प्रोजेक्ट को खोलने के लिए, आपको .xcworkspace फ़ाइल का इस्तेमाल करना होगा.

ध्यान दें: मार्कर क्लस्टरिंग यूटिलिटी क्वाडट्री पर निर्भर होती है. हालांकि, मार्कर क्लस्टरिंग के बिना क्वाडट्री का इस्तेमाल किया जा सकता है. अगर आपको सिर्फ़ क्वाडट्री यूटिलिटी का इस्तेमाल करना है, तो अपनी पॉड फ़ाइल में pod 'Google-Maps-iOS-Utils' को 'Google-Maps-iOS-Utils/QuadTree' में बदलें.

कार्थेज का इस्तेमाल करें

1. कार्थेज इंस्टॉल करें. इसके कई तरीके हैं. इसलिए, सटीक चरणों के बारे में जानने के लिए, कार्थेज README फ़ाइल देखें.
2. अगर आपके पास अब तक कोई Xcode प्रोजेक्ट नहीं है, तो अभी एक प्रोजेक्ट बनाएं और उसे अपने लोकल मशीन में सेव करें. (अगर आपने iOS ऐप्लिकेशन के डेवलपमेंट में कोई नया प्रोजेक्ट शुरू किया है, तो एक नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन का टेंप्लेट चुनें. Xcode 11.7 या इससे पहले के वर्शन में, सिंगल व्यू ऐप्लिकेशन बनाएं.)
3. अपनी प्रोजेक्ट डायरेक्ट्री में, Cartfile नाम की फ़ाइल बनाएं. यह फ़ाइल आपके प्रोजेक्ट की डिपेंडेंसी के बारे में बताती है.
4. Cartfile में बदलाव करें और iOS यूटिलिटी लाइब्रेरी डिपेंडेंसी के लिए Maps SDK टूल जोड़ें:
   

   github "googlemaps/google-maps-ios-utils"

5. Cartfile को सेव करें.
6. किसी टर्मिनल विंडो में, उस डायरेक्ट्री पर जाएं जिसमें Cartfile:
   

   cd <path-to-project>

   है
7. अपडेट कमांड चलाएं:
   

   carthage update --platform iOS

   
   इससे, Cartfile में बताए गए एपीआई के साथ-साथ उनकी डिपेंडेंसी भी इंस्टॉल हो जाएगी.
8. Finder में अपनी प्रोजेक्ट डायरेक्ट्री के Carthage/Build/iOS में डाउनलोड की गई फ़्रेमवर्क फ़ाइलों पर जाएं.
9. इन बंडल को अपने प्रोजेक्ट में खींचकर, अपने प्रोजेक्ट में iOS फ़्रेमवर्क के लिए Maps SDK टूल जोड़ें. (जब आपसे कहा जाए, तब ज़रूरी होने पर आइटम कॉपी करें, कृपया ऊपर दिए गए वर्शन का ही इस्तेमाल करें को चुनें.)
   • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
10. अपने प्रोजेक्ट में GoogleMaps.framework पर राइट क्लिक करें और Find in Finder को चुनें.
11. Resources फ़ोल्डर से Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle को अपने प्रोजेक्ट में खींचें और छोड़ें. जब कहा जाए, तब पक्का करें कि आइटम को डेस्टिनेशन ग्रुप के फ़ोल्डर में कॉपी करें विकल्प नहीं चुना गया हो.
12. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें और ऐप्लिकेशन का टारगेट चुनें.
13. अपने ऐप्लिकेशन के टारगेट के लिए फ़ेज़ बनाएं टैब खोलें और बाइनरी को लाइब्रेरी से लिंक करें सेक्शन में, ये फ़्रेमवर्क जोड़ें:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

14. खास टारगेट के बजाय अपना प्रोजेक्ट चुनें और बिल्ड सेटिंग टैब खोलें. लिंकर के दूसरे फ़्लैग सेक्शन में, -ObjC जोड़ें. अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में फ़िल्टर को बेसिक से सभी में बदलें.

Swift पैकेज मैनेजर का उपयोग करें

1. अगर आपके पास अब तक कोई Xcode प्रोजेक्ट नहीं है, तो अभी एक प्रोजेक्ट बनाएं और उसे अपने कंप्यूटर में सेव करें. (अगर आपने iOS डेवलपमेंट का इस्तेमाल पहले कभी नहीं किया है, तो एक नया प्रोजेक्ट बनाएं और iOS ऐप्लिकेशन टेंप्लेट चुनें. Xcode 11.7 या उससे पहले के वर्शन पर, सिंगल व्यू ऐप्लिकेशन बनाएं.)
2. iOS के लिए, Maps SDK टूल को डिपेंडेंसी के तौर पर जोड़ें. विकल्पों के लिए, SDK टूल इंस्टॉल करना देखें.
3. अपने Xcode प्रोजेक्ट में, फ़ाइल -> स्विफ़्ट पैकेज -> पैकेज डिपेंडेंसी जोड़ें पर जाएं.
4. स्क्रीन पर दी गई विंडो में, Maps SDK for iOS Utility Library रिपॉज़िटरी का यूआरएल https://github.com/googlemaps/google-maps-ios-utils डालें और आगे बढ़ें को चुनें.
• इस स्थिति में, आपको अपने GitHub खाते से पुष्टि करने के लिए कहा जा सकता है. प्रोसेस जारी रखने के लिए, GitHub पर निजी ऐक्सेस टोकन बनाने के लिए निर्देशों का पालन करें.
5. अगली विंडो में, वर्शन रेडियो विकल्प चुनें और ड्रॉपडाउन सूची से एग्ज़ैक्ट चुनें. इसके बाद, iOS यूटिलिटी लाइब्रेरी के लिए Maps SDK का सबसे नया वर्शन (उदाहरण के लिए, "3.4.0") डालें और आगे बढ़ें चुनें.

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

एपीआई पासकोड जनरेट करने और उसे अपने Xcode प्रोजेक्ट में जोड़ने के निर्देशों के लिए, Xcode प्रोजेक्ट सेट अप करें लेख पढ़ें.

प्रोजेक्ट बनाएं और चलाएं

एपीआई पासकोड जोड़ने के बाद, प्रोजेक्ट बनाएं और चलाएं.

अपने ऐप्लिकेशन में कोई उपयोगिता जोड़ें

अपने ऐप्लिकेशन में किसी यूटिलिटी प्रॉडक्ट का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, उससे जुड़े दस्तावेज़ देखें:

• मार्कर क्लस्टरिंग
• क्वाडट्री
• KML रेंडरिंग
• GeoJSON रेंडरिंग
• हीटमैप