सेटअप और डेमो

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

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

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

Xcode प्रोजेक्ट में, Maps SDK for iOS Utility Library जोड़ना

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

Swift Package Manager का इस्तेमाल करना

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

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

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

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '9.0.0'
  pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
end
  4. pod install चलाएं.
  5. Xcode को बंद करें. इसके बाद, Xcode को लॉन्च करने के लिए, अपने प्रोजेक्ट की .xcworkspace फ़ाइल खोलें (उस पर दो बार क्लिक करें). इसके बाद, प्रोजेक्ट खोलने के लिए, आपको .xcworkspace फ़ाइल का इस्तेमाल करना होगा.

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

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

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

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

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

अपने ऐप्लिकेशन में किसी सुविधा का इस्तेमाल करना

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

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

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

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

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 फ़ाइल का इस्तेमाल करना होगा.

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

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

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 वर्शन में बदलाव किया जा सकता है. ज़्यादा जानकारी के लिए, नीचे दिया गया अपने ऐप्लिकेशन में कोई सुविधा जोड़ना सेक्शन देखें.