इस दस्तावेज़ में बताया गया है कि मैप और कंट्रोल के रंग-रूप को कैसे पसंद के मुताबिक बनाया जा सकता है डेटा किसको दिखे और व्यूपोर्ट विकल्प. ऐसा करने के लिए, ये तरीके अपनाए जा सकते हैं:
- क्लाउड-आधारित मैप स्टाइलिंग का इस्तेमाल करें
- मैप की स्टाइल के विकल्प सीधे अपने कोड में सेट करें
मैप को क्लाउड-आधारित मैप स्टाइलिंग के हिसाब से बनाएं
क्लाउड-आधारित मैप इस्तेमाल करके, मैप कॉम्पोनेंट का लुक और स्टाइल पसंद के मुताबिक बनाएं स्टाइलिंग. Google Cloud Console पर, किसी भी मैप के स्टाइल के लिए मैप स्टाइल बनाए जा सकते हैं और उनमें बदलाव किया जा सकता है आपके कोड में कोई बदलाव किए बिना Google Maps का इस्तेमाल करने वाले आपके ऐप्लिकेशन के लिए. ज़्यादा जानकारी के लिए, यह देखें क्लाउड-आधारित मैप स्टाइलिंग.
दोनों
ConsumerMapView
और
ConsumerMapFragment
क्लास में क्लाउड-आधारित मैप स्टाइलिंग का इस्तेमाल किया जा सकता है.
क्लाउड-आधारित मैप स्टाइलिंग का इस्तेमाल करने के लिए, पक्का करें कि चुने गए मैप
रेंडरर LATEST
है. नीचे दिए सेक्शन में, कॉन्टेंट को इस्तेमाल करने के तरीकों के उदाहरण दिए गए हैं
आपके प्रोजेक्ट के लिए क्लाउड-आधारित मैप की स्टाइलिंग कर देता है.
ConsumerMapView
ConsumerMapView
में क्लाउड-आधारित मैप स्टाइलिंग का इस्तेमाल करने के लिए,
GoogleMapOptions
पर mapId
फ़ील्ड भरें और GoogleMapOptions
को पास करें
getConsumerGoogleMapAsync(ConsumerMapReadyCallback, Fragment,
GoogleMapOptions)
or getConsumerGoogleMapAsync(ConsumerMapReadyCallback, FragmentActivity,
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
क्लाउड-आधारित मैप स्टाइलिंग का इस्तेमाल करने के दो तरीके हैं उपभोक्ता मैप फ़्रैगमेंट:
- एक्सएमएल के साथ स्टैटिक तरीके से.
newInstance
के साथ डाइनैमिक तौर पर इस्तेमाल करें.
एक्सएमएल के साथ स्टैटिक रूप से
इसमें एक्सएमएल के साथ क्लाउड-आधारित मैप स्टाइलिंग का इस्तेमाल करने के लिए
ConsumerMapFragment
, बताए गए लक्ष्य के साथ map:mapId
एक्सएमएल एट्रिब्यूट जोड़ें
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
के साथ डाइनैमिक तौर पर इस्तेमाल करें
में newInstance
के साथ क्लाउड-आधारित मैप शैली का इस्तेमाल करने के लिए
ConsumerMapFragment
, GoogleMapOptions
पर mapId
फ़ील्ड सेट करें और
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
}
}
JavaScript उपभोक्ता के अनुभव को शेयर करने वाले मैप पर मैप स्टाइल लागू करने के लिए,
mapId
और
कोई और
mapOptions
जब आप JourneySharingMapView
बनाएँ.
इन उदाहरणों में, मैप आईडी के साथ मैप स्टाइल लागू करने का तरीका बताया गया है.
JavaScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
mapId: 'YOUR_MAP_ID'
}
// Any other styling options.
});
TypeScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
mapId: 'YOUR_MAP_ID'
}
// Any other styling options.
});
मैप को सीधे अपने कोड में स्टाइल करें
आप
JourneySharingMapView
. नीचे दिए गए उदाहरण दिखाते हैं कि
मैप विकल्प. मैप के कौनसे विकल्प सेट किए जा सकते हैं, इस बारे में ज़्यादा जानने के लिए देखें
mapOptions
देखें.
JavaScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
styles: [
{
"featureType": "road.arterial",
"elementType": "geometry",
"stylers": [
{ "color": "#CCFFFF" }
]
}
]
}
});
TypeScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
styles: [
{
"featureType": "road.arterial",
"elementType": "geometry",
"stylers": [
{ "color": "#CCFFFF" }
]
}
]
}
});
तय करें कि SDK टूल में, टास्क का डेटा किसको दिखे
मैप पर कुछ टास्क ऑब्जेक्ट के दिखने की सेटिंग को कंट्रोल किया जा सकता है. इसके लिए, दिखाई देने के नियम.
टास्क के डेटा की डिफ़ॉल्ट सेटिंग
डिफ़ॉल्ट रूप से, किसी वाहन को असाइन किए गए टास्क का डेटा तब दिखता है, जब वाहन, टास्क से पांच स्टॉप के अंदर हो. टास्क तब ही दिखना बंद हो जाएगा, जब टास्क पूरा हुआ या रद्द किया गया.
इस टेबल में दिखाया जाता है कि हर तरह के टास्क के लिए डिफ़ॉल्ट तौर पर किसको दिखे. आप कई टास्क के लिए, दिखने की सेटिंग को कस्टमाइज़ करें, लेकिन सभी के लिए नहीं. टास्क के बारे में ज़्यादा जानकारी पाने के लिए टाइप के तौर पर, शेड्यूल किए गए टास्क गाइड में टास्क के टाइप देखें.
टास्क का टाइप | डिफ़ॉल्ट व्यू | पसंद के मुताबिक बनाने की सुविधा है? | ब्यौरा |
---|---|---|---|
टास्क उपलब्ध न होने से जुड़े टास्क | नहीं दिख रहा है | नहीं | ड्राइवर को ब्रेक देने और ईंधन भरने के लिए इस्तेमाल किया जाता है. अगर डिलीवरी टास्क पर पहुंचने के लिए रास्ता दिया गया है इसमें कोई दूसरा वाहन स्टॉप भी है, इसलिए वह स्टॉप नहीं दिखाया गया है अगर उसमें सिर्फ़ ऐसे टास्क हों जो उपलब्ध नहीं हैं. पहुंचने का अनुमानित समय साथ ही, डिलीवरी के लिए, टास्क पूरा होने में लगने वाला अनुमानित समय अब भी दिखेगा उस टास्क को पूरा करना ज़रूरी है. |
'वाहन के टास्क' खोलें | दिख रहा है | हां | टास्क पूरा होने या रद्द होने के बाद, यह दिखना बंद हो जाएगा. आपके पास यह तय करने का विकल्प है कि वाहन में मौजूद टास्क किसको दिखें. यहां जाएं: 'ओपन' के तौर पर सेट किए गए इवेंट के दिखने की सेटिंग को पसंद के मुताबिक बनाएं वाहन से जुड़े टास्क. |
वाहन में बंद हो चुके टास्क | नहीं दिख रहा है | नहीं | वाहन की तय की गई सीमा के हिसाब से टास्क नहीं दिखाए जा सकते. |
वाहन के खुले होने वाले टास्क देखने की सुविधा को पसंद के मुताबिक सेट करें
TaskTrackingInfo
इंटरफ़ेस में, टास्क से जुड़े कई एलिमेंट मिलते हैं
उपभोक्ता SDK टूल की मदद से देखा जा सकता है.
पसंद के मुताबिक बनाए जा सकने वाले टास्क के डेटा एलिमेंट | |
---|---|
रूट पॉलीलाइन पहुंचने का अनुमानित समय टास्क को पूरा करने में लगने वाला अनुमानित समय |
टास्क तक गाड़ी से जाने की बची हुई दूरी शेष स्टॉप की संख्या वाहन की जगह की जानकारी |
हर टास्क को दिखाने के विकल्प
हर टास्क के हिसाब से, 'किसको दिखे' कॉन्फ़िगरेशन सेटिंग को अपनी पसंद के मुताबिक बनाया जा सकता है
TaskTrackingViewConfig
में, टास्क बनाते या अपडेट करते समय
फ़्लीट इंजन. मानदंड बनाने के लिए, 'किसको दिखे' सेटिंग के इन विकल्पों का इस्तेमाल करें
तय करें कि टास्क एलिमेंट किसको दिखे:
'किसको दिखे' सेटिंग के विकल्प | ||
---|---|---|
शेष स्टॉप की संख्या पहुंचने का अनुमानित समय तक का कुल समय ड्राइविंग के लिए बची हुई दूरी |
मैसेज हमेशा दिखता है कभी नहीं दिखेगा |
यह दिखाने के लिए, मान लें कि एक उदाहरण कस्टमाइज़ेशन तीन के लिए दृश्यता समायोजित करता है डेटा एलिमेंट में, नीचे दी गई टेबल में दी गई शर्तों का इस्तेमाल किया गया है. अन्य सभी एलिमेंट, डिफ़ॉल्ट रूप से दिखने वाले नियमों का पालन करते हैं.
अडजस्ट करने के लिए डेटा एलिमेंट | किसको दिखाई दे | मानदंड |
---|---|---|
रूट पॉलीलाइन | दिखाएं | वाहन तीन स्टॉप के अंदर है. |
ETA | दिखाएं | ड्राइविंग के लिए बाकी दूरी 5,000 से कम है मीटर. |
शेष स्टॉप की संख्या | कभी न दिखाएं | वाहन तीन स्टॉप के अंदर है. |
नीचे दिए गए उदाहरण में यह कॉन्फ़िगरेशन दिखाया गया है:
"taskTrackingViewConfig": {
"routePolylinePointsVisibility": {
"remainingStopCountThreshold": 3
},
"estimatedArrivalTimeVisibility": {
"remainingDrivingDistanceMetersThreshold": 5000
},
"remainingStopCountVisibility": {
"never": true
}
}
रास्ते की पॉलीलाइन और वाहन की जगह की जानकारी दिखाने के नियम
अगर वाहन की लोकेशन भी नहीं है, तो रास्ते की पॉलीलाइन नहीं दिखेंगी visible; अगर ऐसा नहीं होता है, तो जगह के हिसाब से गाड़ी की जगह का पता पॉलीलाइन.
ये दिशा-निर्देश आपको रूट के लिए मान्य संयोजन देने में मदद करते हैं पॉलीलाइन और वाहन की जगह की जानकारी देखने के विकल्प.
दिखने वाले एक जैसे विकल्प | दिखाई देने की शर्त | दिशा-निर्देश |
---|---|---|
रास्ते के पॉलीलाइन विकल्प हमेशा दिखाई देने के लिए सेट किए गए हैं. | वाहन की जगह की जानकारी को 'हमेशा दिखे' के तौर पर सेट करें. | |
वाहन की जगह की जानकारी, 'कभी न दिखे' के तौर पर सेट की गई है. | रास्ते की पॉलीलाइन को 'कभी दिखाई न दें' पर सेट करें. | |
दृश्यता विकल्प इनमें से कोई एक है:
|
रूट पॉलीलाइन विकल्पों को वैल्यू सेट से कम या उसके बराबर वैल्यू पर सेट करें ट्रैक करें. उदाहरण के लिए: "taskTrackingViewConfig": { "routePolylinePointsVisibility": { "remainingStopCountThreshold": 3 }, "vehicleLocationVisibility": { "remainingStopCountThreshold": 5 }, } |
|
'किसको दिखे' सेटिंग के अलग-अलग विकल्प | प्रॉडक्ट दिखने के लिए ज़रूरी शर्तें | दिशा-निर्देश |
गाड़ी की जगह की जानकारी दिख रही है | ऐसा सिर्फ़ तब होता है, जब वाहन की जगह और दोनों पॉलीलाइन के दिखने से जुड़े विकल्प उपलब्ध हैं. उदाहरण के लिए: "taskTrackingViewConfig": { "routePolylinePointsVisibility": { "remainingStopCountThreshold": 3 }, "vehicleLocationVisibility": { "remainingDrivingDistanceMetersThreshold": 3000 }, } इस उदाहरण में, वाहन की जगह की जानकारी सिर्फ़ तब दिखेगी, जब स्टॉप की संख्या कम से कम तीन और बची हुई ड्राइविंग है दूरी कम से कम 3,000 मीटर है. |
अपने-आप फ़िट होने की सुविधा बंद करें
आपके पास, व्यू को व्यूपोर्ट में अपने-आप फ़िट होने से रोकने का विकल्प है और अपने-आप फ़िट होने की सुविधा बंद करके रूट किया जा सकता है. यह उदाहरण वीडियो में, यात्रा की जानकारी शेयर करने की सेटिंग को कॉन्फ़िगर करते समय, ऑटोमैटिक फ़िटिंग की सुविधा को बंद करने का तरीका दिखाया गया है मैप व्यू.
JavaScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
automaticViewportMode:
google.maps.journeySharing
.AutomaticViewportMode.NONE,
...
});
TypeScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
automaticViewportMode:
google.maps.journeySharing
.AutomaticViewportMode.NONE,
...
});