Sử dụng SDK Maps dành cho Android v3.1.0 BETA

Phiên bản beta 3.1.0 của SDK Maps dành cho Android là phương thức triển khai mới có cùng một giao diện API như phiên bản trước (tất cả các lớp và phương thức vẫn giữ nguyên) và một số tính năng mới để bạn dùng thử:

  • Tùy chỉnh Maps
  • Xử lý xung đột đánh dấu
  • Tuỳ chỉnh hình nhiều đường

Hướng dẫn này chỉ cho bạn cách sử dụng các tính năng mới.

Tùy chỉnh Maps (bản thử nghiệm)

Kiểu bản đồ dựa trên đám mây cung cấp nhiều công cụ và tính năng cho phép bạn tùy chỉnh và quản lý cách bản đồ của bạn được tạo kiểu dễ dàng hơn. Thay vì tạo kiểu cho bản đồ mã trong API bằng SDK và API Maps, bạn có thể quản lý và định kiểu cho bản đồ của mình trong Google Cloud Console. Để biết thêm thông tin, hãy xem nội dung Tổng quan về chế độ tùy chỉnh bản đồ của Android.

Xử lý xung đột đánh dấu (thử nghiệm)

Bạn có thể chỉ định xem điểm đánh dấu tùy chỉnh có nên ghi đè nhãn bản đồ cơ sở mặc định khi có xung đột hay không, và để chỉ báo mức độ ưu tiên tương đối giữa các điểm đánh dấu tùy chỉnh. Để biết thêm thông tin, hãy xem phần Xử lý xung đột đánh dấu (Android).

Tuỳ chỉnh Polyline (beta)

Hiện có một số cách mới để tùy chỉnh giao diện của nhiều dòng:

  • Nhiều đường đa màu đặt các phân đoạn nhiều đường thành các màu khác nhau.
  • Nhiều đường chuyển màu tô màu một đa giác bằng cách sử dụng độ dốc là hai màu.
  • Đường đa giác bị hỏng tạo kiểu nhiều đường bằng cách sử dụng các bitmap lặp lại.

Tạo một đường nhiều màu

Bạn có thể sử dụng span cho từng phân đoạn màu của một polyline bằng cách tạo các đối tượng StyleSpan và thêm các đối tượng đó vào PolylineOptions bằng cách sử dụng phương thức addSpan() hoặc addSpans(). Theo mặc định, mỗi mục trong mảng sẽ đặt màu của phân đoạn tương ứng. Ví dụ sau đây cho thấy việc đặt màu phân đoạn để tạo nhiều đường với các phân đoạn màu đỏ và màu xanh lục:

Java


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(Color.RED))
        .addSpan(new StyleSpan(Color.GREEN)));

      

Kotlin


val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(StyleSpan(Color.RED))
        .addSpan(StyleSpan(Color.GREEN))
)

      

Tạo một polyline gradient

Bạn có thể xác định độ dốc bằng cách chỉ định hai số nguyên 32 bit alpha-red-green-blue (ARGB) để chỉ định màu bắt đầu và màu kết thúc của nét vẽ. Hãy đặt thuộc tính này trên đối tượng tùy chọn của hình dạng bằng cách gọi PolylineOptions.addSpan(). Ví dụ sau cho thấy việc tạo nhiều đường dốc từ màu đỏ đến màu vàng từ Vườn thú Park Park đến Kirkland, Washington.

Java


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(StrokeStyle.gradientBuilder(Color.RED, Color.YELLOW).build())));

      

Kotlin


val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(
            StyleSpan(
                StrokeStyle.gradientBuilder(
                    Color.RED,
                    Color.YELLOW
                ).build()
            )
        )
)

      

Tạo một đường kẻ nhiều đường

Bạn có thể đặt giao diện của nhiều hình thành hoạ tiết bitmap lặp lại. Để thực hiện việc này, hãy tạo một StampStyle với TextureStyle, sau đó thiết lập thuộc tính này trên đối tượng tuỳ chọn của hình dạng bằng cách gọi PolylineOptions.addSpan() như dưới đây:

Java


StampStyle stampStyle =
        TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build();
StyleSpan span = new StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build());
map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(span));

      

Kotlin


val stampStyle =
    TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build()
val span = StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build())
map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(span)
)

      

Nhập thư viện tiện ích tương thích với beta

Nếu đang sử dụng Thư viện tiện ích API Android của Google Maps, bạn cũng cần cập nhật các phần phụ thuộc của dự án để thay thế phiên bản hiện tại bằng phiên bản tương thích với phiên bản beta bằng cách làm như sau:

  1. Nhập thư viện tiện ích tương thích với beta trong tệp build.gradle của bạn:
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
    
  2. Xóa nội dung sau khỏi build.gradle để xóa thư viện tiện ích không tương thích với beta:
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'
    

Chạy mẫu

Kho lưu trữ Mẫu của Google trên GitHub bao gồm các ứng dụng mẫu minh hoạ cách sử dụng SDK bản đồ thử nghiệm v3.1.0 dành cho Android.