במדריך הזה מוסבר איך להתאים אישית את המפה שמוצגת באפליקציה ל-Android כשאתם עוקבים אחרי נסיעה. אתם יכולים להתאים אישית את המראה של המפה בדרכים הבאות:
- עיצוב המפה באמצעות סגנון מפות מבוסס-ענן
- כוונון המצלמה כך שתתמקד בנסיעה
- התאמה אישית של סמנים
- התאמה אישית של קווים פוליגונליים
עיצוב המפה באמצעות עיצוב מפות מבוסס-ענן
התאמה אישית של המראה והתחושה של רכיב המפות באמצעות עיצוב מפות מבוסס-ענן. אתם יכולים ליצור ולערוך סגנונות מפה במסוף Google Cloud לכל האפליקציות שלכם שמשתמשות במפות Google, בלי צורך לבצע שינויים בקוד. למידע נוסף, בוחרים את הפלטפורמה הרצויה בקטע עיצוב מפות מבוסס-ענן.
גם הכיתה ConsumerMapView
וגם הכיתה ConsumerMapFragment
תומכות בעיצוב מפות מבוסס-ענן.
כדי להשתמש בעיצוב מפות מבוסס-ענן, צריך לוודא שה-renderer שנבחר למפות הוא LATEST
. בקטעים הבאים מפורטות דוגמאות לשימוש בסגנון של מפות מבוססות-ענן בפרויקט.
ConsumerMapView
כדי להשתמש בסגנון של מפות מבוססות-ענן ב-ConsumerMapView
, מגדירים את השדה mapId
ב-GoogleMapOptions
ומעבירים את GoogleMapOptions
אל getConsumerGoogleMapAsync(ConsumerMapReadyCallback, Fragment, GoogleMapOptions) או אל 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
יש שתי דרכים להשתמש בעיצוב מפות מבוסס-ענן ב-ConsumerMapFragments:
- באופן סטטי באמצעות ה-XML.
- באופן דינמי באמצעות
newInstance
.
באופן סטטי עם ה-XML
כדי להשתמש בסגנון של מפות מבוססות-ענן עם ה-XML בקטע ConsumerMapFragment
, מוסיפים את מאפיין ה-XML 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
, מגדירים את השדה 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
מרכז את המצלמה
ב-Consumer SDK יש תכונה AutoCamera
שמופעלת כברירת מחדל בלחצן המובנה המיקום שלי של Maps SDK. המצלמה תגדיל את התצוגה כדי להתמקד במסלול הנסיעה ובנקודת העצירה הבאה.
אם רוצים להשתמש ב-AutoCamera
, צריך להפעיל אותו. מידע נוסף זמין במאמר isAutoCameraEnabled
.
פרטים על הלחצן המיקום שלי מופיעים בקטע הלחצן 'המיקום שלי' במסמכי העזרה של Maps JavaScript API.
התאמה אישית של התנהגות המצלמה
כדי לשלוט טוב יותר בהתנהגות המצלמה, תוכלו להשבית את AutoCamera
ולהתאים אישית את התנהגות המצלמה באופן ידני.
משביתים את
AutoCamera
באמצעות ConsumerController.setAutoCameraEnabled().מקבלים את גבולות המצלמה המומלצים באמצעות ConsumerController.getCameraUpdate().
מציינים את
CameraUpdate
כארגומנט לאחת מהפונקציות הבאות של Android: