अपने उपभोक्ता ऐप्लिकेशन में किसी यात्रा को फ़ॉलो करने के लिए, आपको सबसे पहले एक मैप जोड़ सकता है और अगर ज़रूरी हो, तो वेक्टर मैप के लिए सहायता जोड़ सकता है.
अपने ऐप्लिकेशन में मैप सेट अप करने के लिए, यह तरीका अपनाएं:
- यात्रा शेयर करने के लिए मैप का हिस्सा तय करें.
- मैप की बुनियादी लेयर और व्यू कंट्रोलर के लिए सहायता जोड़ें.
- वेक्टर दिखाने के लिए, Android वेक्टर ग्राफ़िक के लिए सहायता जोड़ें मैप, अगर ज़रूरी हो.
मैप तय करने के बाद, आप अतिरिक्त व्यू और कैमरा जोड़ सकते हैं कंट्रोल करें जिनमें आपको विज़ुअल अनुभव को पसंद के मुताबिक बनाना है. ज़्यादा जानकारी के लिए, मैप की स्टाइल देखें.
पहला चरण: यात्रा शेयर करने के लिए मैप का एक फ़्रैगमेंट तय करना
आप जहां मैप बना रहे हैं, वहां बनाने के लिए मैप फ़्रैगमेंट या व्यू जोड़कर मैप तय करते हैं अपने उपभोक्ता ऐप्लिकेशन में मांग पर यात्रा की जानकारी शेयर करते हैं. अपने मैप के बारे में बताने के लिए, इनमें से कोई तरीका अपनाएं:
दोनों में से किसी भी तरीके के लिए सुविधाएं एक जैसी होती हैं. इसलिए, चुनें कि कौनसा तरीका इस्तेमाल करना है आपके ऐप्लिकेशन के लिए बेहतर है.
नीचे दिए गए सेक्शन में, दोनों तरीकों के बारे में ज़्यादा जानकारी दी गई है.
मैप का कोई हिस्सा या व्यू जोड़ें
इनमें से किसी एक विकल्प का इस्तेमाल करके, यात्रा की जानकारी दिखाने के लिए मैप बनाना होगा को देखने के लिए, इन चरणों का पालन करें और कोड के उदाहरण.
इसमें मौजूद अपने ऐप्लिकेशन लेआउट की एक्सएमएल फ़ाइल में, कोई फ़्रैगमेंट या व्यू तय करें
/res/layout
. इसका इस्तेमाल करके, सफ़र की जानकारी शेयर करने वाले मैप को फ़्रैगमेंट के तौर पर परिभाषित करेंConsumerMapFragment
याConsumerMapView
का इस्तेमाल करके व्यू के तौर पर.इसके बाद, फ़्रैगमेंट या व्यू, सफ़र का ऐक्सेस देता है ऐसा मैप शेयर किया जा रहा हो जिसे आपका ऐप्लिकेशन ऐक्सेस कर सके और उसमें बदलाव कर सके. यह मैप आपको
ConsumerController
को हैंडल करता है. इससे आपका ऐप्लिकेशन यह कंट्रोल कर सकता है और शेयर करने के अनुभव को ज़रूरत के मुताबिक कैसे बनाया जा सकता है.अपने
onCreate()
वाले तरीके से,getConsumerGoogleMapAsync(callback)
को कॉल करें. जो कॉलबैक में एसिंक्रोनस रूप सेConsumerGoogleMap
दिखाता है.यात्रा की जानकारी दिखाने और ज़रूरत के मुताबिक अपडेट करने के लिए,
ConsumerGoogleMap
का इस्तेमाल करें.
ConsumerMapFragment
जोड़ने के तरीके का उदाहरण
अपनी ऐप्लिकेशन लेआउट एक्सएमएल फ़ाइल में फ़्रैगमेंट तय करें, जैसा कि यहां दिखाया गया है उदाहरण के लिए, नीचे दिया गया कोड.
<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" />
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
जोड़ने के तरीके का उदाहरण
दृश्य का उपयोग या तो खंड में या किसी गतिविधि में करें, जैसा कि एक्सएमएल फ़ाइल में.
<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" />
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 डिवाइस और वेक्टर ड्रॉएबल:
- अपनी गतिविधि में यह कोड जोड़ें. इन कोड की अवधि
उपभोक्ता 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 पर किसी यात्रा को फ़ॉलो करना मैप की फ़ॉर्मैटिंग करना