सेटअप

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

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

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

चरण 1

कंसोल

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

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

  2. पक्का करें कि आपके Cloud प्रोजेक्ट के लिए बिलिंग चालू हो. पुष्टि करें कि आपके प्रोजेक्ट के लिए बिलिंग चालू है.

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

Cloud SDK

gcloud projects create "PROJECT"

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

दूसरा चरण

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

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

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

कंसोल

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

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

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

Cloud SDK

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

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 इंस्टॉल करने , और इन कमांड के बारे में ज़्यादा जानें:

एनवायरमेंट एपीआई चालू करने के लिए, इस निर्देश का इस्तेमाल करें:

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

तीसरा चरण

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

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

एपीआई पासकोड बनाने के लिए:

कंसोल

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

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

  2. क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > एपीआई पासकोड पर क्लिक करें.
    एपीआई पासकोड बनाया गया डायलॉग में, आपका नया एपीआई पासकोड दिखता है.
  3. बंद करें पर क्लिक करें.
    नया एपीआई पासकोड, एपीआई पासकोड में जाकर क्रेडेंशियल पेज पर दिखता है.
    (प्रोडक्शन में इसका इस्तेमाल करने से पहले, एपीआई को सीमित करना न भूलें.)

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

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

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

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

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

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

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

  • Xcode version 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 दबाएं और "पैकेज जोड़ें" पर क्लिक करें.
  • पैकेज में शामिल प्रॉडक्ट चुनें विंडो में जाकर, पुष्टि करें कि GoogleMaps3D को आपके तय किए गए मुख्य टारगेट में जोड़ा जाएगा. यह चरण पूरा होने के बाद, पैकेज जोड़ें पर क्लिक करें.
  • इंस्टॉल करने की पुष्टि करने के लिए, अपने टारगेट के सामान्य पैनल पर जाएं. फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट में, आपको इंस्टॉल किए गए पैकेज दिखने चाहिए. पैकेज और उसके वर्शन की पुष्टि करने के लिए, प्रोजेक्ट नेविगेटर के पैकेज डिपेंडेंसी सेक्शन को भी देखा जा सकता है.

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

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 की Privacy Manifest फ़ाइल की जांच करना

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

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

अगले चरण

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