Xcode प्रोजेक्ट सेट अप करने का तरीका

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

पहला चरण: ज़रूरी सॉफ़्टवेयर इंस्टॉल करें

iOS के लिए Maps SDK टूल का इस्तेमाल करके प्रोजेक्ट बनाने के लिए, आपको यह डाउनलोड और इंस्टॉल करना होगा:

  • Xcode वर्शन 13.0 या इसके बाद का वर्शन
  • Cocoapods या कार्टेज

दूसरा चरण: XCode प्रोजेक्ट बनाना और iOS के लिए Maps SDK टूल इंस्टॉल करना

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

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

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

sudo gem install cocoapods

iOS के लिए Maps SDK टूल का इस्तेमाल करके, Podfile बनाएं और एपीआई और इसकी डिपेंडेंसी इंस्टॉल करने के लिए इसका इस्तेमाल करें:

  1. अगर आपके पास अभी तक कोई Xcode प्रोजेक्ट नहीं है, तो इसे अभी बनाएं और अपने डिवाइस पर सेव करें. अगर आप iOS डेवलपमेंट के लिए नए हैं:
    1. नया प्रोजेक्ट बनाएं.
    2. iOS > ऐप्लिकेशन टेंप्लेट चुनें.
    3. प्रोजेक्ट के विकल्प वाली स्क्रीन पर:
      1. प्रोजेक्ट का नाम डालें.
      2. बंडल पहचानकर्ता फ़ील्ड का मान रिकॉर्ड करें. नीचे दी गई अपनी एपीआई कुंजी पर पाबंदी लगाने के लिए, उस वैल्यू का इस्तेमाल करें.
      3. प्रोजेक्ट इंटरफ़ेस को स्टोरीबोर्ड पर सेट करें.
      4. भाषा को Swift या Objective-C पर सेट करें.
  2. अपनी प्रोजेक्ट डायरेक्ट्री में Podfile नाम की फ़ाइल बनाएं. यह फ़ाइल, आपके प्रोजेक्ट की डिपेंडेंसी के बारे में बताती है.
  3. Podfile में बदलाव करें और डिपेंडेंसी को उनके वर्शन के साथ जोड़ें. यहां एक उदाहरण दिया गया है, जिसमें iOS के लिए Maps SDK टूल के लिए ज़रूरी डिपेंडेंसी शामिल है:
    source 'https://github.com/CocoaPods/Specs.git'
    
    platform :ios, '13.0'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleMaps', '7.1.0'
    end
    नियमित रूप से pod outdated चलाना न भूलें. इससे, यह पक्का किया जा सकेगा कि नया वर्शन कब है, ताकि आप हमेशा नए वर्शन पर काम करते रहें. अगर ज़रूरी हो, तो सबसे नए वर्शन पर अपग्रेड करें.
  4. Podfile को सेव करें.
  5. एक टर्मिनल खोलें और Podfile वाली डायरेक्ट्री पर जाएं:

    cd <path-to-project>
  6. pod install निर्देश को चलाएं. इससे, Podfile में बताए गए एपीआई इंस्टॉल हो जाएंगे. साथ ही, उनकी डिपेंडेंसी भी उपलब्ध हो जाएंगी.

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

किसी मौजूदा प्रोजेक्ट के एपीआई को अपडेट करने के लिए, यह तरीका अपनाएं:

  1. कोई टर्मिनल खोलें और Podfile वाली प्रोजेक्ट डायरेक्ट्री पर जाएं.
  2. pod update निर्देश को चलाएं. ऐसा करने से, Podfile में बताए गए सभी एपीआई नए वर्शन में अपडेट हो जाएंगे.

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

iOS के लिए Maps SDK टूल, Carthage के साथ इस्तेमाल किया जा सकता है. यह स्विफ़्ट और ऑब्जेक्टिव-सी कोको प्रोजेक्ट के लिए, आसान और अलग-अलग डिपेंडेंसी मैनेजर है.

  1. Carthage इंस्टॉल करें. कई तरीके अपनाए जा सकते हैं, इसलिए सटीक तरीकों के लिए, कार्टेज README फ़ाइल देखें.
  2. अगर आपके पास अभी तक कोई Xcode प्रोजेक्ट नहीं है, तो इसे अभी बनाएं और अपने डिवाइस पर सेव करें. अगर आप iOS डेवलपमेंट के लिए नए हैं:
    1. नया प्रोजेक्ट बनाएं.
    2. iOS > ऐप्लिकेशन टेंप्लेट चुनें.
    3. प्रोजेक्ट के विकल्प वाली स्क्रीन पर:
      1. प्रोजेक्ट का नाम डालें.
      2. बंडल पहचानकर्ता फ़ील्ड का मान रिकॉर्ड करें. नीचे दी गई अपनी एपीआई कुंजी पर पाबंदी लगाने के लिए, उस वैल्यू का इस्तेमाल करें.
      3. प्रोजेक्ट इंटरफ़ेस को स्टोरीबोर्ड पर सेट करें.
      4. भाषा को Swift या Objective-C पर सेट करें.
  3. अपनी प्रोजेक्ट डायरेक्ट्री में Cartfile नाम की फ़ाइल बनाएं. यह फ़ाइल, आपके प्रोजेक्ट की डिपेंडेंसी के बारे में बताती है.
  4. Cartfile में बदलाव करें और डिपेंडेंसी को उनके वर्शन के साथ जोड़ें:
    binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1
    समय-समय पर carthage outdated चलाते रहें, ताकि यह पता चल सके कि नया वर्शन कब आ रहा है. इससे, यह पक्का किया जा सकेगा कि आप हमेशा नए वर्शन पर काम करते हैं. अगर ज़रूरी हो, तो नए वर्शन पर अपग्रेड करें.
  5. Cartfile को सेव करें.
  6. टर्मिनल विंडो में, Cartfile वाली डायरेक्ट्री पर जाएं:
    cd <path-to-project>
  7. carthage update निर्देश को चलाएं. इससे, Cartfile में बताए गए एपीआई इंस्टॉल हो जाएंगे. साथ ही, उनकी डिपेंडेंसी भी उपलब्ध हो जाएंगी.
  8. Finder में, अपने प्रोजेक्ट की डायरेक्ट्री में, Carthage/Build/iOS में डाउनलोड की गई फ़्रेमवर्क की फ़ाइलें पर जाएं.
  9. नीचे दिए गए बंडल को अपने प्रोजेक्ट में खींचें और छोड़ें: जब कहा जाए, तब आइटम की कॉपी बनाएं, अगर ज़रूरत हो, तो कृपया ऊपर दिए गए वर्शन का ही इस्तेमाल करें.
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
    • (सिर्फ़ Premium प्लान के ग्राहकों के लिए) GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework
  10. अपने प्रोजेक्ट में GoogleMaps.framework पर दायां क्लिक करें और फ़ाइंडर में दिखाएं चुनें.
  11. GoogleMaps.bundle को Resources फ़ोल्डर से, अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में खींचें और छोड़ें. जब कहा जाए, तब पक्का करें कि आइटम को डेस्टिनेशन ग्रुप में कॉपी करें और नहीं चुना गया है.
  12. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें और अपना ऐप्लिकेशन और टारगेट चुनें.
  13. अपने ऐप्लिकेशन के टारगेट के लिए, फ़ेज़ बनाएं टैब खोलें. इसके बाद, लाइब्रेरी की मदद से लिंक बाइनरी में, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  14. किसी खास टारगेट के बजाय अपना प्रोजेक्ट चुनें और सेटिंग बनाएं टैब खोलें. अन्य लिंकर फ़्लैग सेक्शन में, -ObjC जोड़ें. अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को सामान्य से सभी में बदलें.

  15. iOS के लिए Places SDK टूल इंस्टॉल करने के लिए, iOS के लिए Places SDK टूल के साथ शुरू करें देखें.

किसी मौजूदा प्रोजेक्ट के एपीआई को अपडेट करने के लिए, यह तरीका अपनाएं:

  1. कोई टर्मिनल खोलें और Cartfile वाली प्रोजेक्ट डायरेक्ट्री पर जाएं.
  2. carthage update निर्देश को चलाएं. ऐसा करने से, Cartfile में बताए गए सभी एपीआई नए वर्शन में अपडेट हो जाएंगे.

मैन्युअल तरीके से इंस्टॉल करें

यह गाइड, प्रोजेक्ट में iOS के लिए Maps SDK टूल को मैन्युअल तरीके से जोड़ने और बिल्ड की सेटिंग को कॉन्फ़िगर करने का तरीका बताती है.

  1. SDK टूल की सोर्स फ़ाइलें डाउनलोड करें: GoogleMaps-7.1.0.
  2. सोर्स फ़ाइलों को अनपैक करें.
  3. अगर आपके पास अभी तक कोई Xcode प्रोजेक्ट नहीं है, तो इसे अभी बनाएं और अपने डिवाइस पर सेव करें. अगर आप iOS डेवलपमेंट के लिए नए हैं:
    1. नया प्रोजेक्ट बनाएं.
    2. iOS > ऐप्लिकेशन टेंप्लेट चुनें.
    3. प्रोजेक्ट के विकल्प वाली स्क्रीन पर:
      1. प्रोजेक्ट का नाम डालें.
      2. बंडल पहचानकर्ता फ़ील्ड का मान रिकॉर्ड करें. नीचे दी गई अपनी एपीआई कुंजी पर पाबंदी लगाने के लिए, उस वैल्यू का इस्तेमाल करें.
      3. प्रोजेक्ट इंटरफ़ेस को स्टोरीबोर्ड पर सेट करें.
      4. भाषा को Swift या Objective-C पर सेट करें.
  4. नीचे दिए गए बंडल को अपने प्रोजेक्ट में खींचें और छोड़ें: जब कहा जाए, तब आइटम की कॉपी बनाएं, अगर ज़रूरत हो, तो कृपया ऊपर दिए गए वर्शन का ही इस्तेमाल करें.
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
    • (सिर्फ़ Premium प्लान के ग्राहकों के लिए) GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework
  5. अपने प्रोजेक्ट में GoogleMaps.framework पर दायां क्लिक करें और फ़ाइंडर में दिखाएं चुनें.
  6. GoogleMaps.bundle को Resources फ़ोल्डर से, अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में खींचें और छोड़ें. जब कहा जाए, तब पक्का करें कि आइटम को डेस्टिनेशन ग्रुप में कॉपी करें और नहीं चुना गया है.
  7. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें और अपना ऐप्लिकेशन और टारगेट चुनें.
  8. अपने ऐप्लिकेशन के टारगेट के लिए, फ़ेज़ बनाएं टैब खोलें. इसके बाद, लाइब्रेरी की मदद से लिंक बाइनरी में, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  9. किसी खास टारगेट के बजाय अपना प्रोजेक्ट चुनें और सेटिंग बनाएं टैब खोलें. अन्य लिंकर फ़्लैग सेक्शन में, -ObjC जोड़ें. अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को सामान्य से सभी में बदलें.

  10. iOS के लिए Places SDK टूल इंस्टॉल करने के लिए, iOS के लिए Places SDK टूल के साथ शुरू करें देखें.

XCFramework इंस्टॉल करना

XCFramework एक बाइनरी पैकेज है, जिसका इस्तेमाल आप iOS के लिए Maps SDK टूल इंस्टॉल करने के लिए कई प्लैटफ़ॉर्म पर कर सकते हैं. इसमें M1 चिपसेट का इस्तेमाल करने वाली मशीनें भी शामिल हैं. यह गाइड दिखाता है कि अपने प्रोजेक्ट में iOS के लिए Maps SDK टूल का इस्तेमाल करके, XCFramework कैसे जोड़ें और अपनी बिल्ड सेटिंग को Xcode में कॉन्फ़िगर करें.

कार्तेज के साथ

iOS के लिए Maps SDK टूल Carthage के साथ इस्तेमाल किया जा सकता है, जो कि स्विफ़्ट और ऑब्जेक्टिव-सी कोको प्रोजेक्ट के लिए, आसान और अलग-अलग डिपेंडेंसी मैनेजर है.

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

    binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1-beta
  5. Cartfile को सेव करें.
  6. टर्मिनल विंडो में, Cartfile वाली डायरेक्ट्री पर जाएं:
    cd <path-to-project>
  7. carthage update निर्देश को चलाएं. इससे, Cartfile में बताए गए एपीआई इंस्टॉल हो जाएंगे. साथ ही, उनकी डिपेंडेंसी भी उपलब्ध हो जाएंगी.
  8. Finder में, अपने प्रोजेक्ट की डायरेक्ट्री में, Carthage/Build में डाउनलोड की गई फ़्रेमवर्क की फ़ाइलें पर जाएं.
  9. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किए गए कॉन्टेंट में जाकर, नीचे दिए गए XCFrameworks को अपने प्रोजेक्ट में खींचें और छोड़ें. हर XCFramework के लिए एम्बेड न करें चुनना न भूलें:
    • GoogleMaps-x.x.x/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/GoogleMapsCore.xcframework
    • (सिर्फ़ Premium प्लान के ग्राहकों के लिए) GoogleMaps-x.x.x/GoogleMapsM4B.xcframework
  10. अपने प्रोजेक्ट में GoogleMaps.xcframework पर दायां क्लिक करें और फ़ाइंडर में दिखाएं चुनें.
  11. GoogleMaps.bundle को ios-arm64_x86_64-simulator/GoogleMaps.framework/Resources फ़ोल्डर से, अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में खींचें और छोड़ें. जब कहा जाए, तब पक्का करें कि अगर ज़रूरी हो, तो आइटम कॉपी करें नहीं चुना गया है.
  12. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें और अपना ऐप्लिकेशन और टारगेट चुनें.
  13. अपने ऐप्लिकेशन के टारगेट के लिए, फ़ेज़ बनाएं टैब खोलें. इसके बाद, लाइब्रेरी की मदद से लिंक बाइनरी में, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  14. किसी खास टारगेट के बजाय अपना प्रोजेक्ट चुनें और सेटिंग बनाएं टैब खोलें. अन्य लिंकर फ़्लैग सेक्शन में, -ObjC जोड़ें. अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को सामान्य से सभी में बदलें.

  15. iOS XCFramework के लिए स्थल SDK इंस्टॉल करने के लिए, iOS के लिए स्थान SDK के साथ शुरू करें देखें.

मैन्युअल रूप से

इस गाइड में, iOS के लिए Maps SDK टूल को अपने प्रोजेक्ट में मैन्युअल तरीके से जोड़ने और Xcode में बिल्ड की सेटिंग कॉन्फ़िगर करने का तरीका बताया गया है.

  1. SDK टूल की सोर्स फ़ाइलें डाउनलोड करें: GoogleMaps-7.1.0-beta-xcframework.
  2. सोर्स फ़ाइलों को अनपैक करें.
  3. अगर आपके पास अभी तक कोई Xcode प्रोजेक्ट नहीं है, तो इसे अभी बनाएं और अपने डिवाइस पर सेव करें. अगर आप iOS डेवलपमेंट के लिए नए हैं:
    1. नया प्रोजेक्ट बनाएं.
    2. iOS > ऐप्लिकेशन टेंप्लेट चुनें.
    3. प्रोजेक्ट के विकल्प वाली स्क्रीन पर:
      1. प्रोजेक्ट का नाम डालें.
      2. बंडल पहचानकर्ता फ़ील्ड का मान रिकॉर्ड करें. नीचे दी गई अपनी एपीआई कुंजी पर पाबंदी लगाने के लिए, उस वैल्यू का इस्तेमाल करें.
      3. प्रोजेक्ट इंटरफ़ेस को स्टोरीबोर्ड पर सेट करें.
      4. भाषा को Swift या Objective-C पर सेट करें.
  4. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किए गए कॉन्टेंट में जाकर, नीचे दिए गए XCFrameworks को अपने प्रोजेक्ट में खींचें और छोड़ें. हर XCFramework के लिए एम्बेड न करें चुनना न भूलें:
    • GoogleMaps-x.x.x/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/GoogleMapsCore.xcframework
    • (सिर्फ़ Premium प्लान के ग्राहकों के लिए) GoogleMaps-x.x.x/GoogleMapsM4B.xcframework
  5. अपने प्रोजेक्ट में GoogleMaps.xcframework पर दायां क्लिक करें और फ़ाइंडर में दिखाएं चुनें.
  6. GoogleMaps.bundle को ios-arm64_x86_64-simulator/GoogleMaps.framework/Resources फ़ोल्डर से, अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में खींचें और छोड़ें. जब कहा जाए, तब पक्का करें कि अगर ज़रूरी हो, तो आइटम कॉपी करें नहीं चुना गया है.
  7. प्रोजेक्ट नेविगेटर से अपना प्रोजेक्ट चुनें और अपना ऐप्लिकेशन और टारगेट चुनें.
  8. अपने ऐप्लिकेशन के टारगेट के लिए, फ़ेज़ बनाएं टैब खोलें. इसके बाद, लाइब्रेरी की मदद से लिंक बाइनरी में, ये फ़्रेमवर्क और लाइब्रेरी जोड़ें:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  9. किसी खास टारगेट के बजाय अपना प्रोजेक्ट चुनें और सेटिंग बनाएं टैब खोलें. अन्य लिंकर फ़्लैग सेक्शन में, -ObjC जोड़ें. अगर ये सेटिंग नहीं दिख रही हैं, तो बिल्ड सेटिंग बार में मौजूद फ़िल्टर को सामान्य से सभी में बदलें.

  10. iOS XCFramework के लिए स्थल SDK इंस्टॉल करने के लिए, iOS के लिए स्थान SDK के साथ शुरू करें देखें.

तीसरा चरण: अपनी एपीआई कुंजी को प्रोजेक्ट में जोड़ना

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

यहां दिए गए उदाहरणों में, YOUR_API_KEY को अपनी एपीआई कुंजी से बदलें.

Swift

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

  1. इंपोर्ट किया गया यह स्टेटमेंट जोड़ें:
    import GoogleMaps
  2. अपनी एपीआई कुंजी का इस्तेमाल करके, application(_:didFinishLaunchingWithOptions:) वाले तरीके में यह जोड़ें:
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. अगर आप Places API का भी इस्तेमाल कर रहे हैं, तो अपनी कुंजी यहां जोड़ें, जैसा कि यहां दिखाया गया है:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

  1. इंपोर्ट किया गया यह स्टेटमेंट जोड़ें:
    @import GoogleMaps;
  2. अपनी एपीआई कुंजी का इस्तेमाल करके, application:didFinishLaunchingWithOptions: वाले तरीके में यह जोड़ें:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. अगर आप Places API का भी इस्तेमाल कर रहे हैं, तो अपनी कुंजी यहां जोड़ें, जैसा कि यहां दिखाया गया है:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

चौथा चरण (ज़रूरी नहीं): मेटल रेंडरिंग फ़्रेमवर्क का इस्तेमाल करने के लिए ऑप्ट-इन करना

iOS के लिए Maps SDK टूल, Apple से मेटल रेंडरिंग फ़्रेमवर्क इस्तेमाल करने के लिए, ऑप्ट-इन करने का विकल्प देता है. अपने ऐप्लिकेशन में मेटल रेंडरर को आज़माने के लिए, Objective-C में [GMSServices setMetalRendererEnabled:YES] को कॉल करें या Maps के व्यू देखने से पहले, स्विफ़्ट में GMSServices.setMetalRendererEnabled(true) को कॉल करें.

अगर आप मैन्युअल तरीके से SDK टूल इंस्टॉल कर रहे हैं, तो आपको Metal.framework को XCode में भी जोड़ना होगा.

चरण 5: मैप जोड़ना

नीचे दिए गए कोड से, मौजूदा ViewController में सामान्य मैप जोड़ने का तरीका बताया गया है:

  1. GMSMapView का इंस्टेंस बनाने और शुरू करने के लिए, अपने ऐप्लिकेशन में डिफ़ॉल्ट ViewController जोड़ें या अपडेट करें.

    Swift

    /*
     * Copyright 2020 Google Inc. All rights reserved.
     *
     *
     * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
     * file except in compliance with the License. You may obtain a copy of the License at
     *
     *     http://www.apache.org/licenses/LICENSE-2.0
     *
     * Unless required by applicable law or agreed to in writing, software distributed under
     * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
     * ANY KIND, either express or implied. See the License for the specific language governing
     * permissions and limitations under the License.
     */
    
    import UIKit
    import GoogleMaps
    
    class ViewController: UIViewController {
    
        override func viewDidLoad() {
            super.viewDidLoad()
            // Do any additional setup after loading the view.
            // Create a GMSCameraPosition that tells the map to display the
            // coordinate -33.86,151.20 at zoom level 6.
            let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
            let mapView = GMSMapView.map(withFrame: self.view.frame, camera: camera)
            self.view.addSubview(mapView)
    
            // Creates a marker in the center of the map.
            let marker = GMSMarker()
            marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
            marker.title = "Sydney"
            marker.snippet = "Australia"
            marker.map = mapView
      }
    }
    
          

    Objective-C

    /*
    * Copyright 2020 Google Inc. All rights reserved.
    *
    *
    * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
    * file except in compliance with the License. You may obtain a copy of the License at
    *
    *     http://www.apache.org/licenses/LICENSE-2.0
    *
    * Unless required by applicable law or agreed to in writing, software distributed under
    * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
    * ANY KIND, either express or implied. See the License for the specific language governing
    * permissions and limitations under the License.
    */
    
    #import "ViewController.h"
    #import <GoogleMaps/GoogleMaps.h>
    
    @interface ViewController ()
    
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
      // Do any additional setup after loading the view.
      // Create a GMSCameraPosition that tells the map to display the
      // coordinate -33.86,151.20 at zoom level 6.
      GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                              longitude:151.20
                                                                   zoom:6];
      GMSMapView *mapView = [GMSMapView mapWithFrame:self.view.frame camera:camera];
      mapView.myLocationEnabled = YES;
      [self.view addSubview:mapView];
    
      // Creates a marker in the center of the map.
      GMSMarker *marker = [[GMSMarker alloc] init];
      marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
      marker.title = @"Sydney";
      marker.snippet = @"Australia";
      marker.map = mapView;
    }
    
    @end
    
          
  2. अपना ऐप्लिकेशन चलाएं. आपको ऑस्ट्रेलिया और सिडनी के बीच एक मार्कर दिखेगा. अगर आपको मार्कर दिखता है, लेकिन मैप नहीं दिख रहा है, तो पुष्टि करें कि आपने अपनी एपीआई कुंजी दी है.

छठा चरण (ज़रूरी नहीं): एपीआई से इस्तेमाल की जाने वाली यूआरएल स्कीम का एलान करना

iOS 9 और Xcode 7 से, ऐप्लिकेशन यूआरएल की उन स्कीम के बारे में बता सकते हैं जिन्हें वे खोलने वाले हैं. इसके लिए, वे ऐप्लिकेशन की Info.plist फ़ाइल में स्कीम के बारे में बताते हैं. जब उपयोगकर्ता मैप पर Google लोगो पर क्लिक करता है, तो iOS के लिए Maps SDK टूल, Google Maps का मोबाइल ऐप्लिकेशन खोलता है. ऐसे में, आपका ऐप्लिकेशन काम की यूआरएल स्कीमों के बारे में बता सकता है.

iOS के लिए Maps SDK टूल की इस्तेमाल की जा रही यूआरएल स्कीम की जानकारी देने के लिए, अपने Info.plist पर ये लाइनें जोड़ें:

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>googlechromes</string>
    <string>comgooglemaps</string>
</array>

नीचे दिया गया स्क्रीनशॉट, Xcode यूज़र इंटरफ़ेस में कॉन्फ़िगरेशन दिखाता है:

Xcode में LSApplicationQuerySchenes का कॉन्फ़िगरेशन

ऊपर दी गई जानकारी के बिना, मैप पर Google लोगो पर टैप करने के दौरान ये गड़बड़ियां हो सकती हैं:

-canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"
-canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

इन गड़बड़ियों को खत्म करने के लिए, ऊपर बताए गए तरीके का इस्तेमाल करके अपने Info.plist में एलान जोड़ें.

अगला कदम क्या है

अब आपके पास एपीआई कुंजी और Xcode प्रोजेक्ट है, तो आप ऐप्लिकेशन बना सकते हैं और उन्हें चला सकते हैं. iOS के लिए Maps SDK टूल कई ट्यूटोरियल और सैंपल ऐप्लिकेशन उपलब्ध कराता है. ज़्यादा जानकारी के लिए, ये देखें: