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

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

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

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

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

  • कोकोपॉड या कथेज

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

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

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

अगर आपके पास पहले से 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.4.0'
end
    यह पक्का करने के लिए कि नया वर्शन उपलब्ध है या नहीं, आपके पास नियमित तौर पर pod outdated चलाने का विकल्प हो, ताकि यह पक्का किया जा सके कि आप हमेशा नए वर्शन पर काम करते हैं. अगर ज़रूरी हो, तो सबसे नए वर्शन पर अपग्रेड करें.
  4. Podfile को सेव करें.

  5. कोई टर्मिनल खोलें और Podfile वाली डायरेक्ट्री पर जाएं:

    cd <path-to-project>

  6. pod install निर्देश चलाएं. ऐसा करने से, Podfile में मौजूद एपीआई के साथ-साथ, वे सभी डिपेंडेंसी भी इंस्टॉल हो जाएंगी.

    pod install

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

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

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

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

iOS के लिए Maps SDK टूल, Cartaage के साथ इस्तेमाल किया जा सकता है, जो Swift और Objective-C Cocoa प्रोजेक्ट के लिए, आसान और डीसेंट्रलाइज़्ड डिपेंडेंसी मैनेजर है.

  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. फ़ाइंडर में, अपनी प्रोजेक्ट निर्देशिका में, Carthage/Build/iOS के अंतर्गत डाउनलोड की गई फ़्रेमवर्क फ़ाइलों पर जाएं.
  9. इन बंडल को अपने प्रोजेक्ट में खींचें: (जब आपसे कहा जाए, तब, ज़रूरत के हिसाब से आइटम कॉपी करें चुनें. ऊपर बताए गए वर्शन का ही इस्तेमाल करें.)
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.xcframework
    • (सिर्फ़ Premium प्लान के ग्राहक) GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.xcframework
  10. अपने प्रोजेक्ट में GoogleMaps.xcframework दायां क्लिक करें और Find Finder में दिखाएं चुनें.
  11. Resources फ़ोल्डर से GoogleMaps.bundle को अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में खींचें और छोड़ें. जब कहा जाए, तो पक्का करें कि डेस्टिनेशन ग्रुप के फ़ोल्डर में आइटम कॉपी करें विकल्प नहीं चुना गया हो.
  12. Project Navigator से अपना प्रोजेक्ट चुनें और अपने ऐप्लिकेशन का टारगेट चुनें.
  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 टूल को मैन्युअल तरीके से प्रोजेक्ट में जोड़ने और Xcode में बिल्ड सेटिंग कॉन्फ़िगर करने का तरीका बताया गया है.

  1. SDK टूल की सोर्स फ़ाइलें डाउनलोड करें: Google Maps-7.4.0.
  2. सोर्स फ़ाइलें अनपैक करें.
  3. अगर आपके पास अब तक कोई Xcode प्रोजेक्ट नहीं है, तो इसे अभी बनाएं और उसे अपनी स्थानीय मशीन पर सेव करें. अगर आपने iOS डेवलपमेंट का इस्तेमाल पहले कभी नहीं किया है, तो:
    1. नया प्रोजेक्ट बनाएं.
    2. iOS > ऐप्लिकेशन टेंप्लेट चुनें.
    3. प्रोजेक्ट के विकल्पों वाली स्क्रीन पर:
      1. प्रोजेक्ट का नाम डालें.
      2. बंडल आइडेंटिफ़ायर फ़ील्ड की वैल्यू रिकॉर्ड करें. इस वैल्यू का इस्तेमाल करके, नीचे दी गई अपनी एपीआई कुंजी पर पाबंदी लगाई जा सकती है.
      3. प्रोजेक्ट इंटरफ़ेस को स्टोरीबोर्ड पर सेट करें.
      4. भाषा को Swift या Objective-C पर सेट करें.
  4. इन बंडल को अपने प्रोजेक्ट में खींचें: (जब आपसे कहा जाए, तब, ज़रूरत के हिसाब से आइटम कॉपी करें चुनें. ऊपर बताए गए वर्शन का ही इस्तेमाल करें.)
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.xcframework
    • (सिर्फ़ Premium प्लान के ग्राहक) GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.xcframework
  5. अपने प्रोजेक्ट में GoogleMaps.xcframework दायां क्लिक करें और Find Finder में दिखाएं चुनें.
  6. Resources फ़ोल्डर से GoogleMaps.bundle को अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में खींचें और छोड़ें. जब कहा जाए, तो पक्का करें कि डेस्टिनेशन ग्रुप के फ़ोल्डर में आइटम कॉपी करें विकल्प नहीं चुना गया हो.
  7. Project Navigator से अपना प्रोजेक्ट चुनें और अपने ऐप्लिकेशन का टारगेट चुनें.
  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 एक बाइनरी पैकेज है, जिसका इस्तेमाल आप कई प्लैटफ़ॉर्म पर कर सकते हैं. इसमें M1 चिपसेट का इस्तेमाल करने वाली मशीन भी शामिल है, ताकि iOS के लिए Maps SDK टूल इंस्टॉल किया जा सके. इस गाइड में, XCFramework को iOS के लिए आपके प्रोजेक्ट में जोड़ने और Xcode में अपनी बिल्ड सेटिंग कॉन्फ़िगर करने का तरीका बताया गया है.

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

iOS के लिए Maps SDK टूल, Cartaage के साथ इस्तेमाल किया जा सकता है, जो कि Swift और Objective-C Cocoa प्रोजेक्ट के लिए, आसान और डीसेंट्रलाइज़्ड डिपेंडेंसी मैनेजर है.

  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. फ़ाइंडर में, अपनी प्रोजेक्ट निर्देशिका में, 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 दायां क्लिक करें और Find Finder में दिखाएं चुनें.
  11. ios-arm64_x86_64-simulator/GoogleMaps.framework/Resources फ़ोल्डर से GoogleMaps.bundle को अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में खींचें और छोड़ें. जब कहा जाए, तब पक्का करें कि ज़रूरत के हिसाब से आइटम कॉपी करें चुना नहीं है.
  12. Project Navigator से अपना प्रोजेक्ट चुनें और अपने ऐप्लिकेशन का टारगेट चुनें.
  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 के लिए Places SDK टूल इंस्टॉल करने के लिए, iOS के लिए Places SDK टूल का इस्तेमाल शुरू करना देखें.

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

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

  1. SDK टूल की सोर्स फ़ाइलें डाउनलोड करें: Google Maps-7.4.0.
  2. सोर्स फ़ाइलें अनपैक करें. XCFramework को ऐक्सेस करने के लिए Frameworks फ़ोल्डर पर नेविगेट करें.
  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 दायां क्लिक करें और Find Finder में दिखाएं चुनें.
  6. ios-arm64_x86_64-simulator/GoogleMaps.framework/Resources फ़ोल्डर से GoogleMaps.bundle को अपने Xcode प्रोजेक्ट की टॉप लेवल डायरेक्ट्री में खींचें और छोड़ें. जब कहा जाए, तब पक्का करें कि ज़रूरत के हिसाब से आइटम कॉपी करें चुना नहीं है.
  7. Project Navigator से अपना प्रोजेक्ट चुनें और अपने ऐप्लिकेशन का टारगेट चुनें.
  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 के लिए Places SDK टूल इंस्टॉल करने के लिए, iOS के लिए Places 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] को कॉल करें या किसी भी मैप व्यू को बनाने से पहले Swift में GMSServices.setMetalRendererEnabled(true) को कॉल करें.

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

पांचवां चरण: कोई मैप जोड़ना

नीचे दिया गया कोड मौजूदा 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

    ViewController.m

  2. अपना ऐप्लिकेशन चलाएं. आपको एक मैप दिखेगा, जिसके आस-पास सिडनी, ऑस्ट्रेलिया का मार्कर होगा. अगर आपको मार्कर दिखता है, लेकिन मैप नहीं दिख रहा, तो पक्का करें कि आपने एपीआई कुंजी दी है.

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

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

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

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

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

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

ऊपर दी गई जानकारी के बिना, उपयोगकर्ता मैप पर 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 टूल, कई ट्यूटोरियल और ऐप्लिकेशन के नमूने उपलब्ध कराता है. इनकी मदद से, शुरू करने में आपको मदद मिलती है. ज़्यादा जानकारी के लिए, ये देखें: