सेटअप और डेमो

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

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

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

किसी Xcode प्रोजेक्ट में iOS यूटिलिटी लाइब्रेरी के लिए Maps SDK टूल जोड़ना

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

Swift पैकेज मैनेजर का इस्तेमाल करें

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

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

  1. अगर आपके पास अभी तक Xcode प्रोजेक्ट नहीं है, तो अभी एक प्रोजेक्ट बनाएं और उसे यहां सेव करें कंप्यूटर पर ट्रांसफ़र किया जा सकता है. (अगर आप iOS डेवलपमेंट में नए हैं, तो सिंगल ऐप्लिकेशन देखें.)
  2. अगर आपके पास अपने प्रोजेक्ट के लिए पहले से कोई पॉड फ़ाइल नहीं है, तो एक फ़ाइल बनाएं आपकी प्रोजेक्ट डायरेक्ट्री में Podfile नाम है. यह फ़ाइल आपकी की डिपेंडेंसी.
  3. अपने प्रोजेक्ट की पॉड फ़ाइल में बदलाव करें और 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.0.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 प्रोजेक्ट में जोड़ सकते हैं.

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

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

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

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

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

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

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

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

  1. डाउनलोड करें कोड सैंपल संग्रह, GitHub और संग्रह को अनपैक करें.
  2. टर्मिनल विंडो खोलें. इसके बाद, उस डायरेक्ट्री पर जाएं जहां आपने सैंपल फ़ाइलों को बड़ा किया है, और आपको जिस भाषा का इस्तेमाल करना है उसके लिए सैंपल डायरेक्ट्री में ड्रिल-डाउन करें:
    • स्विफ़्ट के लिए, 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 नाम के अस्थायी Xcode प्रोजेक्ट में डेमो खुलता है या ObjCDemoApp.xcodeproj.

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

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