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

इन प्रोसेस को शुरू करने से पहले, पक्का करें कि आपने सही सेवाओं और Consumer SDK को चालू किया हो. इनके बारे में, पिछले सेक्शन में बताया गया है.

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

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

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

Consumer 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 टूल और मैप रेंडरर

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

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

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

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

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

  • ConsumerMapView पर मार्कर डालना.

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

Consumer SDK टूल को शुरू करने से पहले, Maps SDK टूल को शुरू करना

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

  2. Consumer 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 में एसएसएल के साथ काम करने के बारे में ज़्यादा जानकारी के लिए, Security GMS प्रोवाइडर देखें. इस लेख में, सुरक्षा सेवा देने वाली कंपनी को पैच करने के लिए कोड सैंपल भी शामिल हैं.

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

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