इस गाइड में बताया गया है कि यात्रा के बाद, iOS ऐप्लिकेशन में दिखाए जाने वाले मैप को कैसे स्टाइल किया जा सकता है.
शुरू करने से पहले
किसी मैप को स्टाइल करने से पहले, आपके पास ऐसा उपभोक्ता ऐप्लिकेशन होना चाहिए जिसमें नीचे दी गई चीज़ें हों:
मैप व्यू. मैप व्यू शुरू करना देखें.
मैप व्यू इवेंट मैनेज करने का तरीका. देखें कि मैप व्यू इवेंट को कैसे मैनेज करें
आपको उपभोक्ता SDK टूल के लिए ज़रूरी बैकएंड सेवाएं भी सेट अप करनी होंगी. साथ ही, उपभोक्ता SDK टूल सेट अप करना होगा. ज़्यादा जानकारी के लिए, उपभोक्ता SDK टूल सेट अप करें और Fleet Engine क्या है? देखें.
मैप कस्टमाइज़ेशन
कस्टमाइज़ेशन के ये विकल्प उपलब्ध हैं:
मैप की स्टाइल तय करना: क्लाउड पर मैप की स्टाइलिंग की सुविधाओं का इस्तेमाल करके, मैप के रंग, पॉलीलाइन, और मैप की अन्य सुविधाओं की स्टाइल तय की जा सकती है. मैप की स्टाइल अपने हिसाब से तय करना लेख पढ़ें.
कैमरे के ज़ूम को अडजस्ट करना: किसी यात्रा पर फ़ोकस करने के लिए, पहले से मौजूद सुविधा का इस्तेमाल किया जा सकता है या अपने हिसाब से कैमरे के विकल्प सेट किए जा सकते हैं. यात्रा पर फ़ोकस करने के लिए, कैमरे का ज़ूम कम या ज़्यादा करना लेख पढ़ें.
मार्कर और पॉलीलाइन को पसंद के मुताबिक बनाना: अपने ऐप्लिकेशन के डिज़ाइन में, कस्टम मार्कर और रास्ते की पॉलीलाइन जोड़ी जा सकती हैं. इन डिज़ाइन एलिमेंट की मदद से आपके उपभोक्ता ऐप्लिकेशन में, वाहन के रूट की डाइनैमिक झलक दिखाई जाती है. मार्कर को पसंद के मुताबिक बनाना और पॉलीलाइन को पसंद के मुताबिक बनाना लेख पढ़ें.
SDK टूल,
consumerMapStyleCoordinatorप्रॉपर्टी के ज़रिए ये विकल्प उपलब्ध कराता है. यह प्रॉपर्टी,GMTCMapViewक्लास के ज़रिए उपलब्ध है.
मैप को क्लाउड-आधारित मैप स्टाइलिंग के हिसाब से बनाएं
क्लाउड-आधारित मैप स्टाइलिंग का इस्तेमाल करके, मैप कॉम्पोनेंट का लुक और स्टाइल पसंद के मुताबिक बनाएं. Google Maps का इस्तेमाल करने वाले अपने किसी भी ऐप्लिकेशन के लिए, Google Cloud Console में मैप स्टाइल बनाएं और उनमें बदलाव करें. इसके लिए, आपको अपने कोड में कोई बदलाव करने की ज़रूरत नहीं है. ज़्यादा जानकारी के लिए, क्लाउड-आधारित मैप स्टाइलिंग देखें.
ConsumerMapView और ConsumerMapFragment क्लास, दोनों में क्लाउड पर मैप की स्टाइलिंग की सुविधा काम करती है.
क्लाउड पर मैप की स्टाइलिंग की सुविधाओं का इस्तेमाल करने के लिए, पक्का करें कि चुना गया मैप रेंडरर LATEST हो. नीचे दिए सेक्शन में, अपने प्रोजेक्ट के साथ क्लाउड-आधारित मैप स्टाइलिंग इस्तेमाल करने के उदाहरण दिए गए हैं.
ConsumerMapView
ConsumerMapView में क्लाउड-आधारित मैप स्टाइलिंग का इस्तेमाल करने के लिए, GoogleMapOptions पर mapId फ़ील्ड सेट करें और GoogleMapOptions को
get ConsumerGoogleMapAsync(कंज़्यूमरमैप रेडीकॉलबैक, फ़्रैगमेंट,
GoogleMapsOptions) में पास करें
या get ConsumerGoogleMapAsync(प्रवेशMap ReadyCallback, फ़्रैगमेंटActivity,
GoogleMapOptions)
उदाहरण
Java
public class SampleAppActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
ConsumerMapView mapView = findViewById(R.id.consumer_map_view);
if (mapView != null) {
GoogleMapOptions optionsWithMapId = new GoogleMapOptions().mapId("map-id");
mapView.getConsumerGoogleMapAsync(
new ConsumerMapReadyCallback() {
@Override
public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
// ...
}
},
/* fragmentActivity= */ this,
/* googleMapOptions= */ optionsWithMapId);
}
}
}
Kotlin
class SampleAppActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val mapView = findViewById(R.id.consumer_map_view) as ConsumerMapView
val optionsWithMapId = GoogleMapOptions().mapId("map-id")
mapView.getConsumerGoogleMapAsync(
object : ConsumerGoogleMap.ConsumerMapReadyCallback() {
override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
// ...
}
},
/* fragmentActivity= */ this,
/* googleMapOptions= */ optionsWithMapId)
}
}
ConsumerMapFragment
ConsumerMapFragments में, क्लाउड पर मैप की स्टाइलिंग की सुविधाओं का इस्तेमाल करने के दो तरीके हैं:
- स्टैटिक तौर पर, एक्सएमएल के साथ.
newInstanceके साथ डाइनैमिक तौर पर.
एक्सएमएल के साथ स्टैटिक तौर पर
ConsumerMapFragment में एक्सएमएल के साथ क्लाउड पर मैप की स्टाइलिंग की सुविधाओं का इस्तेमाल करने के लिए, तय किए गए mapId के साथ map:mapId एक्सएमएल एट्रिब्यूट जोड़ें. नीचे दिया गया उदाहरण देखें:
<fragment
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
android:name="com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapFragment"
android:id="@+id/consumer_map_fragment"
map:mapId="map-id"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
newInstance के साथ डाइनैमिक तौर पर इस्तेमाल करें
ConsumerMapFragment में newInstance के साथ क्लाउड पर मैप की स्टाइलिंग की सुविधाओं का इस्तेमाल करने के लिए, mapId फ़ील्ड को GoogleMapOptions पर सेट करें और GoogleMapOptions को newInstance पर पास करें. नीचे दिया गया उदाहरण देखें:
Java
public class SampleFragmentJ extends Fragment {
@Override
public View onCreateView(
@NonNull LayoutInflater inflater,
@Nullable ViewGroup container,
@Nullable Bundle savedInstanceState) {
final View view = inflater.inflate(R.layout.consumer_map_fragment, container, false);
GoogleMapOptions optionsWithMapId = new GoogleMapOptions().mapId("map-id");
ConsumerMapFragment consumerMapFragment = ConsumerMapFragment.newInstance(optionsWithMapId);
getParentFragmentManager()
.beginTransaction()
.add(R.id.consumer_map_fragment, consumerMapFragment)
.commit();
consumerMapFragment.getConsumerGoogleMapAsync(
new ConsumerMapReadyCallback() {
@Override
public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
// ...
}
});
return view;
}
}
Kotlin
class SampleFragment : Fragment() {
override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?): View? {
val view = inflater.inflate(R.layout.consumer_map_fragment, container, false)
val optionsWithMapId = GoogleMapOptions().mapId("map-id")
val consumerMapFragment = ConsumerMapFragment.newInstance(optionsWithMapId)
parentFragmentManager
.beginTransaction()
.add(R.id.consumer_map_fragment, consumerMapFragment)
.commit()
consumerMapFragment.getConsumerGoogleMapAsync(
object : ConsumerMapReadyCallback() {
override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
// ...
}
})
return view
}
}
यात्रा पर फ़ोकस करने के लिए, कैमरे के ज़ूम को कम या ज़्यादा करें
यात्रा शेयर करने के चालू सेशन के दौरान, उपयोगकर्ता को रास्ते में चल रहे वाहन का क्लोज़-अप दिखाने के बजाय, उसे बड़े व्यू में देखना ज़्यादा मददगार होता है. इसके लिए, डिवाइस में पहले से मौजूद AutoCamera का इस्तेमाल करके या कैमरे के व्यवहार को अपनी पसंद के मुताबिक बनाकर, कैमरे के ज़ूम लेवल में बदलाव किया जा सकता है. इसके लिए, यह तरीका अपनाएं:
AutoCamera: अगर आपकोAutoCameraका इस्तेमाल करना है, तो आपको कुछ करने की ज़रूरत नहीं है. कैमरा डिफ़ॉल्ट रूप से यात्रा के साथ चलता है.कैमरे के काम करने के तरीके को पसंद के मुताबिक बनाना: कैमरे के काम करने के तरीके को पसंद के मुताबिक बनाने के लिए, आपको
AutoCameraको बंद करना होगा. इसके बाद, अपने हिसाब से बदलाव करें.
AutoCamera, कैमरे को डिफ़ॉल्ट रूप से बीच में करता है
उपभोक्ता SDK टूल की मदद से, AutoCamera की सुविधा मिलती है. यह सुविधा, Maps SDK टूल में पहले से मौजूद मेरी जगह बटन पर डिफ़ॉल्ट रूप से चालू होती है. कैमरा, यात्रा के रास्ते और अगले वेपॉइंट पर फ़ोकस करने के लिए ज़ूम करता है.
अगर आपको AutoCamera का इस्तेमाल करना है, तो पक्का करें कि यह चालू हो. ज़्यादा जानकारी के लिए,
allowCameraAutoUpdate देखें.
Maps SDK के लिए मेरी जगह बटन पर जानकारी के लिए, iOS के लिए Maps SDK दस्तावेज़ में मेरी जगह की जानकारी बटन देखें.
कैमरे के काम करने के तरीके को पसंद के मुताबिक बनाना
कैमरे के काम करने के तरीके को ज़्यादा कंट्रोल करने के लिए, AutoCamera को बंद करें और कैमरे के काम करने के तरीके को पसंद के मुताबिक बनाएं.
AllowCameraAutoUpdate प्रॉपर्टी के साथ AutoCamera को बंद या चालू करें.
कैमरे को अपनी पसंद के मुताबिक बनाने के लिए, iOS के लिए Maps SDK टूल से जुड़े दस्तावेज़ में कैमरे की जगह बदलना देखें.