Google Maps Platform का इस्तेमाल शुरू करना

इस पेज पर, Google Maps Platform पर मौजूद किसी भी एपीआई और एसडीके का इस्तेमाल शुरू करने के लिए, ज़रूरी बुनियादी चरणों के बारे में बताया गया है.

क्विकस्टार्ट

अगर आपने बिलिंग खाता या प्रोजेक्ट बनाने के लिए, Google Cloud console का इस्तेमाल कभी नहीं किया है, तो शुरू करें बटन पर क्लिक करें. यह बटन, Cloud console में नए उपयोगकर्ताओं के लिए इंटरैक्टिव सेटअप अनुभव से लिंक करता है:

शुरू करें

इसके अलावा, सेटअप करने के लिए ज़रूरी यह तरीका भी अपनाया जा सकता है:

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

कंसोल

  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, Google Maps Platform या Firebase की सेवाओं के लिए कभी पैसे नहीं चुकाए हैं और आपने Google Cloud को मुफ़्त में आज़माने के लिए कभी साइन अप नहीं किया है, तो आपको मुफ़्त में आज़माने की सुविधा और 300 डॉलर का वेलकम क्रेडिट मिल सकता है. इस क्रेडिट को Google Maps Platform की सेवाओं पर खर्च किया जा सकता है.
  • Google Maps Platform के हर एसकेयू के लिए, हर महीने बिना किसी शुल्क के इस्तेमाल करने की एक तय सीमा होती है. इसके बारे में शुल्क की सूची और Google Maps Platform की बिलिंग में बताया गया है.
  • Google, सार्वजनिक प्रोग्राम के लिए भी क्रेडिट देता है. जैसे, गैर-लाभकारी संस्थाएं, स्टार्टअप, आपातकालीन सहायता, समाचार मीडिया, शिक्षा, और ट्रांसपोर्ट एजेंसियां.

अगले चरण

सेट अप होने के बाद, Google Maps Platform के एपीआई और एसडीके इस्तेमाल किए जा सकते हैं. ज़्यादा जानने के लिए, जिस एपीआई या एसडीके में आपकी दिलचस्पी है उसकी खास जानकारी, डेवलपर, और शुरुआती निर्देश देखें. एपीआई और एसडीके, Google Maps Platform के दस्तावेज़ (प्रॉडक्ट के हिसाब से) और Google Maps Platform API (प्लैटफ़ॉर्म के हिसाब से) में दिए गए हैं.