उपभोक्ता 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 Authentication में बताए गए तरीके से लागू करना चाहिए.

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

SSL/TLS के बारे में जानकारी

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

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

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