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

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

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

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

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

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

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

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

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

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

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

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

Maps SDK और मैप रेंडरर

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

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

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

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

• ConsumerMapView पर मार्कर जोड़े जा रहे हैं.

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

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

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

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

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

@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();
        }
      });
}

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()
      }
    })
  }

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

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

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

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