انتقال برای سفارشی‌سازی نسخه ۱.۰ کیت توسعه نرم‌افزار مصرف‌کننده Android

سفارشی‌سازی نشانگر

در نسخه‌های قبلی Consumer SDK، از شیء MarkerStyleOptions Consumer SDK برای سفارشی‌سازی ویژگی‌های سبک نشانگر استفاده می‌کردید. در Consumer SDK نسخه ۱.۰، مستقیماً از شیء MarkerOptions از Maps SDK استفاده می‌کنید.

// Centering the marker anchor at (0.5, 0.5) is recommended.
// For vehicle markers, set flat to true to allow the vehicle marker to freely
// rotate flat on the map (rather than always have it face the camera).
MarkerOptions vehicleMarkerOptions = new MarkerOptions()
    .flat(true)
    .anchor(0.5f, 0.5f)
    .icon(vehicleIcon)
    .zIndex(1.0f);
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE);

ConsumerMapStyle گزینه‌های سبک پیش‌فرض مشخص‌شده توسط کیت توسعه نرم‌افزار را برای نوع نشانگر داده‌شده برمی‌گرداند، اگر سبک هنوز تنظیم نشده باشد یا اگر گزینه‌های سبک روی null تنظیم شده باشد.

// ConsumerMapStyle returns the SDK-set default style options if none has been set yet.
MarkerOptions defaultPickupPointStyleOptions = consumerMapStyle.getMarkerStyleOptions(MarkerType.PICKUP_POINT);

// Setting the style to null reverts the style back to the SDK-set default properties.
consumerMapStyle.setMarkerStyleOptions(MarkerType.PICKUP_POINT, /* markerStyleOptions= */ null);
MarkerOptions defaultPickupPointStyleOptions = consumerMapStyle.getMarkerStyleOptions(MarkerType.PICKUP_POINT);

اگر نمی‌خواهید سبک جدیدی را از ابتدا ایجاد کنید، می‌توانید سبک پیش‌فرض را اصلاح کنید. مثال زیر فقط نماد سوار شدن را تغییر می‌دهد و برای بقیه گزینه‌های نشانگر از تنظیمات پیش‌فرض کیت توسعه نرم‌افزار استفاده می‌کند.

// getMarkerStyleOptions returns the default pickup point style options, since
// the custom style hasn't been set yet.
MarkerOptions pickupPointStyleOptions =
  consumerMapStyle.getMarkerStyleOptions(MarkerType.PICKUP_POINT);
// Modify the icon value and set the style.
consumerMapStyle.setMarkerStyleOptions(
  pickupPointStyleOptions.icon(pickupPointIcon));

سفارشی‌سازی چندخطی

در نسخه‌های قبلی Consumer SDK، از شیء PolylineStyleOptions Consumer SDK برای سفارشی‌سازی ویژگی‌های سبک چندخطی استفاده می‌کردید. در «کیت توسعه نرم‌افزار مصرف‌کننده» نسخه ۱.۰، از شیء PolylineOptions از «کیت توسعه نرم‌افزار Maps» برای سفارشی‌سازی ویژگی‌های سبک چندخطی پایه و از شیء TrafficStyle برای سفارشی‌سازی رنگ‌های ترافیک چندخطی استفاده می‌کنید.

چندخطی‌های ترافیک در نسخه آلفای Consumer SDK نسخه ۱.۰ دردسترس است. اگر ترافیک قابل‌مشاهده باشد، رنگ چندخطی پایه با رنگ‌های ترافیک جایگزین می‌شود. ترافیک به‌طور پیش‌فرض قابل‌مشاهده نیست. فیلدهای TrafficStyle که تنظیم نشده‌اند با مقادیر پیش‌فرض مشخص‌شده در کیت توسعه نرم‌افزار تکمیل می‌شوند.

// PolylineOptions is from Maps SDK
PolylineOptions polylineOptions = new PolylineOptions()
  .color(color)
  .width(width)
  .geodesic(geodesic)
  .startCap(startCap)
  .endCap(endCap)
  .zIndex(zIndex);
consumerMapStyle.setPolylineStyleOptions(
  PolylineType.ACTIVE_ROUTE, polylineOptions);

// TrafficStyle is from ConsumerSDK
TrafficStyle trafficStyle = TrafficStyle.builder()
  .setTrafficVisibility(true)
  .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
  .setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
  .setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
  .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
  .build();
consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);

ConsumerMapStyle گزینه‌های سبک پیش‌فرض کیت توسعه نرم‌افزار را برای نوع چندخطی داده‌شده برمی‌گرداند، اگر هنوز هیچ گزینه‌ای تنظیم نشده باشد یا اگر گزینه‌های سبک روی null تنظیم شده باشد. این موضوع هم برای PolylineOptions پایه و هم برای TrafficStyle صدق می‌کند.

// ConsumerMapStyle returns the SDK's default style options if none has been set yet.
PolylineOptions defaultActiveRouteStyleOptions = consumerMapStyle.getPolylineStyleOptions(PolylineType.ACTIVE_ROUTE);

// Setting the style to null reverts the style back to the SDK-set default properties.
consumerMapStyle.setPolylineStyleOptions(
  PolylineType.ACTIVE_ROUTE, /* polylineStyleOptions= */ null);
PolylineOptions defaultActiveRouteStyleOptions =
  consumerMapStyle.getPolylineStyleOptions(PolylineType.ACTIVE_ROUTE);

اگر نمی‌خواهید سبک جدیدی را از ابتدا ایجاد کنید، می‌توانید سبک پیش‌فرض را اصلاح کنید. مثال زیر فقط رنگ چندخطی مسیر فعال پایه را تغییر می‌دهد و برای بقیه گزینه‌های نشانگر از تنظیمات سبک پیش‌فرض SDK استفاده می‌کند.

// Only customize the remaining route polyline color.
PolylineOptions remainingRouteStyleOptions =
     consumerMapStyle.getPolylineStyleOptions(PolylineType.REMAINING_ROUTE);
consumerMapStyle.setPolylineStyleOptions(
  remainingRouteStyleOptions.color(Color.DARK_BLUE));