सेटअप

इस पेज पर बताया गया है कि Maps 3D SDK for iOS का इस्तेमाल करके, मैप बनाने के लिए आपको क्या करना होगा. सेटअप की प्रोसेस में, एसडीके के साथ इस्तेमाल करने के लिए Google Cloud प्रोजेक्ट और एपीआई को कॉन्फ़िगर करना शामिल है. इसके बाद, Xcode प्रोजेक्ट सेट अप करना होता है. अपने ऐप्लिकेशन में पहला 3D मैप जोड़ने से पहले, यह तरीका अपनाएं.

ज़रूरी शर्तें

iOS के लिए Maps 3D SDK का इस्तेमाल करने के लिए, आपके प्रोजेक्ट और टारगेट डिवाइसों को ये ज़रूरी शर्तें पूरी करनी होंगी:

  • iOS का कम से कम वर्शन: iOS 16.0 या इसके बाद के वर्शन को टारगेट करें.
  • Xcode: Xcode का वर्शन 16.0 या इसके बाद का वर्शन.

Google Cloud प्रोजेक्ट और एपीआई पासकोड सेट अप करना

iOS के लिए Maps 3D SDK का इस्तेमाल करके ऐप्लिकेशन बनाना शुरू करने से पहले, आपको Google Cloud प्रोजेक्ट और एपीआई पासकोड सेट अप करना होगा. इसके लिए, यह तरीका अपनाएं:

पहला चरण: अपना प्रोजेक्ट सेट अप करना

कंसोल

  1. Google Cloud console में, प्रोजेक्ट चुनने वाले पेज पर, प्रोजेक्ट बनाएं पर क्लिक करें. इससे नया Cloud प्रोजेक्ट बनाने की प्रोसेस शुरू हो जाएगी.

    प्रोजेक्ट चुनने वाले पेज पर जाएं

  2. पक्का करें कि आपके क्लाउड प्रोजेक्ट के लिए बिलिंग की सुविधा चालू हो. पुष्टि करें कि आपके प्रोजेक्ट के लिए बिलिंग की सुविधा चालू है.

    Google Cloud को बिना किसी शुल्क के आज़माया जा सकता है. बिना शुल्क के आज़माने की अवधि, 90 दिनों के बाद या खाते में 300 डॉलर का शुल्क जमा होने के बाद खत्म हो जाती है. इनमें से जो भी पहले हो. कभी भी रद्द करें. ज़्यादा जानकारी के लिए, बिलिंग खाते के क्रेडिट और बिलिंग देखें.

Cloud SDK

gcloud projects create "PROJECT"

Google Cloud SDK, Cloud SDK को इंस्टॉल करने, और इन निर्देशों के बारे में ज़्यादा जानें:

दूसरा चरण: एपीआई या एसडीके चालू करना

Google Maps Platform का इस्तेमाल करने के लिए, आपको वे एपीआई या एसडीके चालू करने होंगे जिनका इस्तेमाल आपको अपने प्रोजेक्ट के साथ करना है.

ध्यान दें कि कुछ इंटिग्रेशन के लिए, आपको कई एपीआई/एसडीके चालू करने होंगे. अगर आपको नहीं पता कि कौनसे एपीआई या एसडीके चालू करने हैं, तो Capabilities Explorer का इस्तेमाल करके देखें. इसके अलावा, उस एपीआई/एसडीके का दस्तावेज़ देखें जिसका आपको इस्तेमाल करना है.

एक या इससे ज़्यादा एपीआई या एसडीके चालू करने के लिए:

कंसोल

  1. Cloud Console में Maps API लाइब्रेरी पेज पर जाकर, Google Maps Platform के उन एपीआई और एसडीके टूल को देखें जिन्हें चालू किया जा सकता है:

    Maps API लाइब्रेरी पेज पर जाएं

  2. उस एपीआई या एसडीके पर क्लिक करें जिसे आपको चालू करना है.
    • अगर बटन पर चालू करें लिखा है, तो एपीआई या एसडीके को चालू करने के लिए बटन पर क्लिक करें.
    • अगर बटन पर मैनेज करें लिखा है, तो इसका मतलब है कि एपीआई या एसडीके पहले से चालू है और आपको कुछ और करने की ज़रूरत नहीं है.
    • इनमें से किसी भी बटन पर क्लिक करने से, एपीआई या एसडीके का डैशबोर्ड दिखेगा. (इस प्रोजेक्ट से एपीआई या एसडीके को हटाने के लिए, बंद करें बटन पर क्लिक करें.)

Cloud SDK

इस निर्देश से Maps, Routes, और Places के सभी एपीआई चालू हो जाते हैं:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Google Cloud SDK, Cloud SDK को इंस्टॉल करने, और इन निर्देशों के बारे में ज़्यादा जानें:

Environment API चालू करने के लिए, इस निर्देश का इस्तेमाल करें:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

तीसरा चरण: एपीआई पासकोड पाना

इस चरण में, सिर्फ़ एपीआई पासकोड बनाने की प्रोसेस के बारे में बताया गया है. अगर प्रोडक्शन में एपीआई पासकोड का इस्तेमाल किया जाता है, तो हमारा सुझाव है कि आप एपीआई पासकोड पर पाबंदी लगाएं. ज़्यादा जानकारी के लिए, प्रॉडक्ट के हिसाब से बने एपीआई पासकोड का इस्तेमाल पेज पर जाएं.

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

कंसोल

  1. Google Maps Platform > कुंजियां और क्रेडेंशियल पेज पर जाएं.

    कुंजियां और क्रेडेंशियल पेज पर जाएं

  2. अगर कहा जाए, तो अपना प्रोजेक्ट चुनें.

  3. इनमें से कोई एक काम करें:

    • नई कुंजी बनाना:

      1. क्रेडेंशियल बनाएं > एपीआई पासकोड पर क्लिक करें.
      2. एपीआई पासकोड बनाएं पैनल में, एपीआई से जुड़ी पाबंदियां चुनें सूची खोलें.
      3. इस कुंजी के लिए जिन एपीआई की ज़रूरत नहीं है उन्हें हटा दें. साथ ही, पक्का करें कि आपको जिन एपीआई का इस्तेमाल करना है वे चुने गए हों.
      4. बनाएं पर क्लिक करें. पैनल में आपका नया एपीआई पासकोड दिखता है.

    • किसी मौजूदा कुंजी का इस्तेमाल करना:

      1. कुंजी के नाम पर क्लिक करें.
      2. एपीआई से जुड़ी पाबंदियां चुनें सूची में, वे एपीआई चुनें जिनका आपको इस्तेमाल करना है.
      3. सेव करें पर क्लिक करें.

    यहां किसी एपीआई को चुनने से वह चालू नहीं होता. पक्का करें कि आपने जो एपीआई चुना है वह एपीआई लाइब्रेरी में चालू हो.

  4. कुंजी की स्ट्रिंग को बाद में देखने के लिए, कुंजियां और क्रेडेंशियल पेज पर जाएं. इसके बाद, कुंजी के लिए कुंजी दिखाएं पर क्लिक करें.

अगर कंसोल इन चरणों से अलग दिखता है, तो Google Cloud के दस्तावेज़ में जाकर, एपीआई पासकोड बनाना और एपीआई से जुड़ी पाबंदियां जोड़ना लेख पढ़ें.

Cloud SDK

यहां दिए गए कमांड में, PROJECT_ID की जगह अपना प्रोजेक्ट आईडी डालें.

  • नई कुंजी बनाएं: यहां दिया गया निर्देश चलाएं और DISPLAY_NAME को कुंजी के नाम से बदलें. SERVICE_NAME को उस एपीआई की सेवा के नाम से बदलें जिसका आपको इस्तेमाल करना है. जैसे, places.googleapis.com. ज़्यादा एपीआई को अनुमति देने के लिए, --api-target फ़्लैग को दोहराएं.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

    Google Cloud SDK, Cloud SDK को इंस्टॉल करने, और इन निर्देशों के बारे में ज़्यादा जानें:

  • किसी मौजूदा कुंजी का इस्तेमाल करना: यह कमांड चलाएं और KEY_ID को कुंजी के आईडी से बदलें. SERVICE_NAME की जगह, उस एपीआई की सेवा का नाम डालें जिसे जोड़ना है. --append फ़्लैग, उन एपीआई को बनाए रखता है जिनकी अनुमति कुंजी पहले से देती है. इसके बिना, कमांड उन्हें बदल देता है.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=SERVICE_NAME

    Google Cloud SDK, Cloud SDK को इंस्टॉल करने, और इन निर्देशों के बारे में ज़्यादा जानें:

    कुंजी का आईडी, कुंजी की स्ट्रिंग या डिसप्ले नेम नहीं होता. इसे ढूंढने के लिए, gcloud services api-keys list --project="PROJECT_ID" चलाएं. आईडी, name फ़ील्ड का आखिरी हिस्सा होता है: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

की स्ट्रिंग देखने के लिए, gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" चलाएं.

एसडीके को चालू करने के लिए, Google Cloud Console में iOS के लिए Maps 3D एसडीके पेज पर जाएं. इन चरणों को पूरा करने के बारे में ज़्यादा जानकारी के लिए, Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.

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

इस सेक्शन में, iOS के लिए Maps 3D SDK के साथ इस्तेमाल करने के लिए, Xcode प्रोजेक्ट बनाने और उसे कॉन्फ़िगर करने का तरीका बताया गया है.

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

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

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

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

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

Swift Package Manager

iOS के लिए Maps 3D SDK को Swift Package Manager का इस्तेमाल करके इंस्टॉल किया जा सकता है.

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

  • Xcode project या workspace खोलें. इसके बाद, File > Add Package Dependencies पर जाएं.
  • यूआरएल के तौर पर https://github.com/googlemaps/ios-maps-3d-sdk डालें. इसके बाद, पैकेज को पुल करने के लिए Enter दबाएं और "Add Package" पर क्लिक करें.
  • पैकेज के प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि GoogleMaps3D को आपके तय किए गए मुख्य टारगेट में जोड़ा जाएगा. इसके बाद, पैकेज जोड़ें पर क्लिक करें.
  • इंस्टॉलेशन की पुष्टि करने के लिए, अपने टारगेट के सामान्य पैनल पर जाएं. Frameworks, Libraries, and Embedded Content में, आपको इंस्टॉल किए गए पैकेज दिखेंगे. पैकेज और उसके वर्शन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन को भी देखा जा सकता है.

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

Swift Package Manager

अपने ऐप्लिकेशन के मुख्य एंट्री पॉइंट में (या मैप लोड होने से पहले किसी भी समय) अपना एपीआई पासकोड जोड़ें. इसके लिए, यह तरीका अपनाएं.

  1. इंपोर्ट करने के लिए यह स्टेटमेंट जोड़ें: 
    import GoogleMaps3D
  2. यह तरीका जोड़ें. YOUR_API_KEY को अपने एपीआई पासकोड से बदलें. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

चौथा चरण (ज़रूरी नहीं): Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना

Apple के मुताबिक, App Store पर मौजूद ऐप्लिकेशन के लिए, ऐप्लिकेशन की निजता से जुड़ी जानकारी देना ज़रूरी है.

Apple की प्राइवसी मेनिफ़ेस्ट फ़ाइल, SDK टूल के रिसॉर्स बंडल में शामिल होती है. यह पुष्टि करने के लिए कि निजता मेनिफ़ेस्ट फ़ाइल को शामिल किया गया है और उसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं. इसके बाद, संग्रह से निजता रिपोर्ट जनरेट करें.

अगले चरण

अब आपके पास iOS के लिए Maps 3D SDK के साथ इस्तेमाल करने के लिए, Google Cloud प्रोजेक्ट, एपीआई पासकोड, और Xcode प्रोजेक्ट सेट अप है. अब आपके पास अपने ऐप्लिकेशन में 3D मैप जोड़ने का विकल्प है.