मैप सेट अप करें

प्लैटफ़ॉर्म चुनें: Android iOS

अपने उपभोक्ता ऐप्लिकेशन में किसी यात्रा को फ़ॉलो करने के लिए, आपको सबसे पहले एक मैप जोड़ सकता है और अगर ज़रूरी हो, तो वेक्टर मैप के लिए सहायता जोड़ सकता है.

अपने ऐप्लिकेशन में मैप सेट अप करने के लिए, यह तरीका अपनाएं:

  1. यात्रा शेयर करने के लिए मैप का हिस्सा तय करें.
  2. मैप की बुनियादी लेयर और व्यू कंट्रोलर के लिए सहायता जोड़ें.
  3. वेक्टर दिखाने के लिए, Android वेक्टर ग्राफ़िक के लिए सहायता जोड़ें मैप, अगर ज़रूरी हो.

मैप तय करने के बाद, आप अतिरिक्त व्यू और कैमरा जोड़ सकते हैं कंट्रोल करें जिनमें आपको विज़ुअल अनुभव को पसंद के मुताबिक बनाना है. ज़्यादा जानकारी के लिए, मैप की स्टाइल देखें.

पहला चरण: यात्रा शेयर करने के लिए मैप का एक फ़्रैगमेंट तय करना

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

  • ConsumerMapFragment: इसका इस्तेमाल, अपने मैप को Fragment.

  • ConsumerMapView: View.

दोनों में से किसी भी तरीके के लिए सुविधाएं एक जैसी होती हैं. इसलिए, चुनें कि कौनसा तरीका इस्तेमाल करना है आपके ऐप्लिकेशन के लिए बेहतर है.

नीचे दिए गए सेक्शन में, दोनों तरीकों के बारे में ज़्यादा जानकारी दी गई है.

मैप का कोई हिस्सा या व्यू जोड़ें

इनमें से किसी एक विकल्प का इस्तेमाल करके, यात्रा की जानकारी दिखाने के लिए मैप बनाना होगा को देखने के लिए, इन चरणों का पालन करें और कोड के उदाहरण.

  1. इसमें मौजूद अपने ऐप्लिकेशन लेआउट की एक्सएमएल फ़ाइल में, कोई फ़्रैगमेंट या व्यू तय करें /res/layout. इसका इस्तेमाल करके, सफ़र की जानकारी शेयर करने वाले मैप को फ़्रैगमेंट के तौर पर परिभाषित करें ConsumerMapFragment या ConsumerMapView का इस्तेमाल करके व्यू के तौर पर.

    इसके बाद, फ़्रैगमेंट या व्यू, सफ़र का ऐक्सेस देता है ऐसा मैप शेयर किया जा रहा हो जिसे आपका ऐप्लिकेशन ऐक्सेस कर सके और उसमें बदलाव कर सके. यह मैप आपको ConsumerController को हैंडल करता है. इससे आपका ऐप्लिकेशन यह कंट्रोल कर सकता है और शेयर करने के अनुभव को ज़रूरत के मुताबिक कैसे बनाया जा सकता है.

  2. अपने onCreate() वाले तरीके से, getConsumerGoogleMapAsync(callback) को कॉल करें. जो कॉलबैक में एसिंक्रोनस रूप से ConsumerGoogleMap दिखाता है.

  3. यात्रा की जानकारी दिखाने और ज़रूरत के मुताबिक अपडेट करने के लिए, ConsumerGoogleMap का इस्तेमाल करें.

ConsumerMapFragment जोड़ने के तरीके का उदाहरण

  1. अपनी ऐप्लिकेशन लेआउट एक्सएमएल फ़ाइल में फ़्रैगमेंट तय करें, जैसा कि यहां दिखाया गया है उदाहरण के लिए, नीचे दिया गया कोड.

    <fragment
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:name="com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapFragment"
    android:id="@+id/consumer_map_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

  2. onCreate() से getConsumerGoogleMapAsync() को कॉल करें तरीका.

Java

 public class SampleAppActivity extends AppCompatActivity {

   @Override
   protected void onCreate(Bundle savedInstanceState) {

     // Find the ConsumerMapFragment.
     ConsumerMapFragment consumerMapFragment =
         (ConsumerMapFragment) fragmentManager.findFragmentById(R.id.consumer_map_fragment);

     // Initiate the callback that returns the map.
     if (consumerMapFragment != null) {
       consumerMapFragment.getConsumerGoogleMapAsync(
           new ConsumerMapReadyCallback() {
             // The map returned in the callback is used to access the ConsumerController.
             @Override
             public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
               ConsumerController consumerController = consumerGoogleMap.getConsumerController();
             }
           });
     }
   }

 }

Kotlin

 class SampleAppActivity : AppCompatActivity() {
   override fun onCreate(savedInstanceState: Bundle?) {
     // Find the ConsumerMapFragment.
     val consumerMapFragment =
       fragmentManager.findFragmentById(R.id.consumer_map_fragment) as ConsumerMapFragment

     consumerMapFragment.getConsumerGoogleMapAsync(
       object : ConsumerMapReadyCallback() {
         override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
           val consumerController = consumerGoogleMap.getConsumerController()!!
         }
       }
     )
   }
 }

ConsumerMapView जोड़ने के तरीके का उदाहरण

  1. दृश्य का उपयोग या तो खंड में या किसी गतिविधि में करें, जैसा कि एक्सएमएल फ़ाइल में.

     <com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapView
     xmlns:android="http://schemas.android.com/apk/res/android"
     android:id="@+id/consumer_map_view"
     android:layout_width="match_parent"
     android:layout_height="match_parent" />

  2. onCreate() से getConsumerGoogleMapAsync() पर कॉल करें. तय सीमा में कॉलबैक पैरामीटर के अलावा, यह जानकारी भी शामिल करें:

    • शामिल गतिविधि या फ़्रैगमेंट. ऐक्टिविटी या फ़्रैगमेंट बेस क्लास या तो एक FragmentActivity या एक सहायता Fragment होनी चाहिए (आम तौर पर), क्योंकि वे इसकी लाइफ़साइकल का ऐक्सेस देते हैं.

    • GoogleMapOptions (जो शून्य हो सकता है), जिसमें कॉन्फ़िगरेशन है MapView एट्रिब्यूट के लिए दी गई वैल्यू सबमिट करें.

Java

public class SampleAppActivity extends AppCompatActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    ConsumerMapView mapView = findViewById(R.id.consumer_map_view);

    if (mapView != null) {
      mapView.getConsumerGoogleMapAsync(
          new ConsumerMapReadyCallback() {
            // The map returned in the callback is used to access the ConsumerController.
            @Override
            public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
              ConsumerController consumerController = consumerGoogleMap.getConsumerController();
            }
          }, this, null);
    }
  }

}

Kotlin

class SampleAppActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    val mapView = findViewById(R.id.consumer_map_view) as ConsumerMapView

    mapView.getConsumerGoogleMapAsync(
      object : ConsumerMapReadyCallback() {
        // The map returned in the callback is used to access the ConsumerController.
        override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
          val consumerController = consumerGoogleMap.getConsumerController()!!
        }
      },
      /* fragmentActivity= */ this,
      /* googleMapOptions= */ null,
    )
  }
}

फ़्रैगमेंट में MapView, पिछले उदाहरण के जैसा ही है किसी गतिविधि में MapView को छोड़कर, फ़्रैगमेंट उस लेआउट को बढ़ा देता है जो फ़्रैगमेंट onCreateView() तरीके में MapView शामिल करता है.

Java

public class MapViewInFragment extends Fragment {

  @Override
  public View onCreateView(
      @NonNull LayoutInflater layoutInflater,
      @Nullable ViewGroup viewGroup,
      @Nullable Bundle bundle) {
    return layoutInflater.inflate(R.layout.consumer_map_view, viewGroup, false);
  }

}

Kotlin

class MapViewInFragment : Fragment() {
  override fun onCreateView(
    layoutInflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?,
  ): View {
    return layoutInflater.inflate(R.layout.consumer_map_view, viewGroup, false)
  }
}

दूसरा चरण: मैप की बुनियादी लेयर और व्यू कंट्रोलर के लिए सहायता जोड़ना

अपने ऐप्लिकेशन में, यात्रा शेयर करने की सुविधा चालू करने के लिए, ये क्लास आपके ऐप्लिकेशन पर लागू की जा सकती हैं: ConsumerGoogleMap और ConsumerController.

  • ConsumerMapFragment से ConsumerGoogleMap पाएं या ConsumerMapView, जो दोनों एसिंक्रोनस रूप से वापस लौटते हैं ConsumerMapReadyCallback में ConsumerGoogleMap.

    ConsumerGoogleMap, GoogleMap क्लास के लिए एक रैपर क्लास है. यह GoogleMap के बराबर एपीआई, ताकि आपका ऐप्लिकेशन मैप से इंटरैक्ट कर सके. इस तरह से आपका ऐप्लिकेशन उसी बुनियादी Google के साथ आसानी से इंटरैक्ट कर सकता है मैप. उदाहरण के लिए, GoogleMap सिर्फ़ एक कॉलबैक रजिस्ट्रेशन की अनुमति देता है, लेकिन ConsumerGoogleMap, ड्यूअल रजिस्टर किए गए कॉलबैक के साथ काम करता है. ये कॉलबैक आपको तो आपका ऐप्लिकेशन उन कॉलबैक को रजिस्टर करता है जिन्हें क्रम से कॉल किया जाता है.

  • getConsumerController() में ConsumerGoogleMap से ConsumerController पाएं.

    ConsumerController, यात्रा शेयर करने की सुविधाओं का ऐक्सेस देता है. जैसे जैसे कि यात्राओं को मॉनिटर करने, यात्रा की स्थिति को कंट्रोल करने, और जगहों को सेट करने का.

इस लिंक पर जाकर, अपने ऐप्लिकेशन में ConsumerGoogleMap और ConsumerController को जोड़ने का तरीका जानें Java और Kotlin के उदाहरण नीचे दिए गए हैं.

Java

private ConsumerGoogleMap consumerGoogleMap;
private ConsumerController consumerController;
private ConsumerMapView consumerMapView;

consumerMapView.getConsumerGoogleMapAsync(
    new ConsumerMapReadyCallback() {
      @Override
      public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerMap) {
        consumerGoogleMap = consumerMap;
        consumerController = consumerMap.getConsumerController();
      }
    },
    this, null);

Kotlin

var consumerGoogleMap: ConsumerGoogleMap
var consumerController: ConsumerController
val consumerMapView = findViewById(R.id.consumer_map_view) as ConsumerMapView

consumerMapView.getConsumerGoogleMapAsync(
  object : ConsumerMapReadyCallback() {
    override fun onConsumerMapReady(consumerMap: ConsumerGoogleMap) {
      consumerGoogleMap = consumerMap
      consumerController = consumerMap.getConsumerController()
    },
    /* fragmentActivity= */ this,
    /* googleMapOptions= */ null,
  }
)

चरण 3: Android वेक्टर ग्राफ़िक के लिए सहायता जोड़ना

अगर आपके ऐप्लिकेशन डिज़ाइन को वेक्टर ग्राफ़िक के लिए सहायता चाहिए, तो इन चरणों का उपयोग करके Android डिवाइस और वेक्टर ड्रॉएबल:

  1. अपनी गतिविधि में यह कोड जोड़ें. इन कोड की अवधि उपभोक्ता SDK में वेक्टर ड्रॉएबल का इस्तेमाल करने के लिए AppCompatActivity.

Java

// ...
import android.support.v7.app.AppCompatActivity;

// ...

public class ConsumerTestActivity extends AppCompatActivity {
  // ...
}

Kotlin

// ...
import android.support.v7.app.AppCompatActivity

// ...

class ConsumerTestActivity : AppCompatActivity() {
  // ...
}

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

Android पर किसी यात्रा को फ़ॉलो करना मैप की फ़ॉर्मैटिंग करना