सेटअप

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

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

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

पहला चरण

कंसोल

  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 का इस्तेमाल करने के लिए, आपको अपने प्रोजेक्ट के साथ इस्तेमाल किए जाने वाले एपीआई या एसडीके चालू करने होंगे.

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

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

कंसोल

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

    Maps API Library पेज पर जाएं

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

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

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 का वर्शन 16.0 या इसके बाद का वर्शन

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

Swift Package Manager

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

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

  • अपना Xcode project या workspace खोलें. इसके बाद, फ़ाइल > पैकेज की डिपेंडेंसी जोड़ें पर जाएं.
  • यूआरएल के तौर पर 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 की निजता मेनिफ़ेस्ट फ़ाइल की जांच करना

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

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

अगले चरण

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

जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.

आखिरी बार 2026-04-29 (UTC) को अपडेट किया गया.