उपभोक्ता SDK टूल शुरू करें

ये प्रक्रियाएं शुरू करने से पहले, पक्का करें कि आपने सही सेवाएं और उपभोक्ता SDK टूल चालू किए हैं, जैसा कि पिछले सेक्शन में बताया गया है.

Consumer SDK को शुरू करने के लिए, यह तरीका अपनाएं:

  1. ConsumerAPI इंस्टेंस पाना
  2. पसंदीदा रेंडरर के लिए अनुरोध करने के लिए, Maps SDK को शुरू करना

ConsumerApi इंस्टेंस पाएं

उपभोक्ता SDK टूल का इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को एसिंक्रोनस रूप से सिंगलटन ConsumerApi को शुरू करना होगा. शुभारंभ करने का तरीका, AuthTokenFactory क्लास का इस्तेमाल करके, ज़रूरत पड़ने पर उपयोगकर्ता के लिए नए JWT टोकन जनरेट करता है.

providerId, आपके Google Cloud प्रोजेक्ट का प्रोजेक्ट आईडी है. Fleet Engine प्रोजेक्ट बनाने के बारे में ज़्यादा जानकारी के लिए, Fleet Engine गाइड में Fleet Engine प्रोजेक्ट बनाएं देखें.

आपके ऐप्लिकेशन में AuthTokenFactory को Consumer SDK टूल के लिए पुष्टि करने के तरीके में बताए गए तरीके से लागू किया जाना चाहिए.

Java

Task<ConsumerApi> consumerApiTask = ConsumerApi.initialize(
    this, "myProviderId", authTokenFactory);

consumerApiTask.addOnSuccessListener(
  consumerApi -> this.consumerApi = consumerApi);

Kotlin

val consumerApiTask =
  ConsumerApi.initialize(this, "myProviderId", authTokenFactory)

consumerApiTask?.addOnSuccessListener { consumerApi: ConsumerApi ->
  this@YourActivity.consumerApi = consumerApi
}

Maps SDK टूल और मैप रेंडरर

उपभोक्ता SDK v2.0.0 और उसके बाद के वर्शन, Android v18.1.0 और बाद के वर्शन के लिए Maps SDK पर काम करते हैं. नीचे दी गई टेबल में, Maps SDK टूल के वर्शन के हिसाब से डिफ़ॉल्ट रेंडरर की खास जानकारी दी गई है. साथ ही, यह भी बताया गया है कि दोनों रेंडरर के साथ काम करने की सुविधा क्या है. अगर हो सके, तो नए रेंडरर का इस्तेमाल करें. अगर आपको लेगसी रेंडरर का इस्तेमाल करना है, तो MapsInitializer.initialize() का इस्तेमाल करके साफ़ तौर पर बताएं.

Maps SDK का वर्शन नए रेंडरर के साथ काम करता है लेगसी रेंडरर के साथ काम करता है डिफ़ॉल्ट रेंडरर
V18.1.0 और इससे पहले के वर्शन हां हां लेगसी*
V18.2.0 हां हां सबसे नए

* नए मैप रेंडरर के रोल आउट होने पर, सबसे नया रेंडरर डिफ़ॉल्ट होगा.

अगर आपको किसी पसंदीदा रेंडरर का इस्तेमाल करना है, तो OnMapsSdkInitializedCallback नतीजे देने के बाद, यूआई-रेंडरिंग से जुड़ी सभी कार्रवाइयां करें. यूज़र इंटरफ़ेस (यूआई)-रेंडरिंग की कार्रवाइयों में ये कार्रवाइयां शामिल हैं:

  • GoogleMapView या ConsumerMapView वाले व्यू को बड़ा करना.

  • ConsumerMapView पर मार्कर लगाए जा रहे हैं.

अगर OnMapsSdkInitializedCallback नतीजा मिलने के बाद, ये कार्रवाइयां नहीं की जाती हैं, तो Maps SDK टूल आपके पसंदीदा रेंडरर को असाइन नहीं करता. इसके बजाय, मैप व्यू को डिफ़ॉल्ट रेंडरर से रेंडर किया जाता है.

उपभोक्ता SDK टूल शुरू करने से पहले, Maps SDK टूल चालू करें

  1. अपनी Application या स्टार्ट-अप Activity क्लास में, MapsInitializer.initialize()

  2. उपभोक्ता SDK टूल शुरू करने से पहले, रेंडरर के अनुरोध के नतीजे का इंतज़ार करें.

ज़्यादा जानकारी के लिए, ये उदाहरण देखें.

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.main);
  initViews();

  MapsInitializer.initialize(getApplicationContext(), Renderer.LATEST,
      new OnMapsSdkInitializedCallback() {
        @Override
        public void onMapsSdkInitialized(Renderer renderer) {
          switch (renderer) {
            case LATEST:
              Log.i("maps_renderer", "LATEST renderer");
              break;
            case LEGACY:
              Log.i("maps_renderer", "LEGACY renderer");
              break;
          }

          initializeConsumerSdk();
        }
      });
}

Kotlin

fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)
  initViews()

  MapsInitializer.initialize(
    getApplicationContext(), Renderer.LATEST,
    object : OnMapsSdkInitializedCallback() {
      fun onMapsSdkInitialized(renderer: Renderer?) {
        when (renderer) {
          LATEST -> Log.i("maps_renderer", "LATEST renderer")
          LEGACY -> Log.i("maps_renderer", "LEGACY renderer")
        }
        initializeConsumerSdk()
      }
    })
  }

एसएसएल/टीएलएस के बारे में जानकारी

अंदरूनी तौर पर, Consumer SDK टूल, Fleet Engine सेवा के साथ सुरक्षित तरीके से कम्यूनिकेट करने के लिए, एसएसएल/टीएलएस का इस्तेमाल करता है. Android API के 23 या उससे पहले के वर्शन के लिए, सर्वर से संपर्क करने के लिए SecurityProvider पैच की ज़रूरत पड़ सकती है. Android में एसएसएल के साथ काम करने के बारे में ज़्यादा जानकारी के लिए, सुरक्षा GMS सेवा देने वाली कंपनी देखें. इस लेख में, सुरक्षा सेवा देने वाली कंपनी को पैच करने के लिए कोड सैंपल भी शामिल हैं.

आगे क्या करना है

मैप सेट अप करना