Tạo điểm đánh dấu nâng cao

Chọn nền tảng: Android iOS JavaScript

Để thêm các điểm đánh dấu nâng cao vào bản đồ, hãy tạo một thực thể mới của AdvancedMarkerOptions rồi dùng GoogleMap.addMarker() để thêm điểm đánh dấu:

Kotlin

private val SYDNEY = LatLng(-33.87365, 151.20689)

val marker: Marker? = map.addMarker(
    AdvancedMarkerOptions()
        .position(SYDNEY)
        .iconView(textView)
        .zIndex(zIndex)
)

Java

private final LatLng SYDNEY = new LatLng(-33.87365, 151.20689);

Marker marker = map.addMarker(
    new AdvancedMarkerOptions()
        .position(SYDNEY)
        .iconView(textView)
        .zIndex(zIndex));

GoogleMap.addMarker() trả về một thực thể của Marker. Nếu cần, bạn có thể truyền giá trị trả về đến AdvancedMarker.

Dùng AdvancedMarkerOptions để định cấu hình các điểm đánh dấu nâng cao. AdvancedMarkerOptions là một lớp con của MarkerOptions nên lớp này hỗ trợ tất cả các chế độ cài đặt giống như MarkerOptions.

AdvancedMarkerOptions cũng cho phép bạn:

• Tạo một thực thể của lớp PinConfig, sau đó dùng thực thể PinConfig để định cấu hình thực thể AdvancedMarkerOptions.

  Sử dụng PinConfig để tuỳ chỉnh các thuộc tính nâng cao của điểm đánh dấu, chẳng hạn như màu nền, màu viền và glyph.

• Tạo một thực thể của lớp View Android và dùng thực thể đó để định cấu hình thực thể AdvancedMarkerOptions.

  Đối tượng View cho phép bạn tuỳ chỉnh hoàn toàn điểm đánh dấu.

Sử dụng PinConfig

Lớp PinConfig chứa các lựa chọn để tuỳ chỉnh điểm đánh dấu nâng cao. Sử dụng PinConfig để:

• Thay đổi màu nền
• Thay đổi màu đường viền
• Thay đổi màu sắc của biểu tượng hoặc thêm văn bản
• Ẩn glyph

Hình 1: Các phần của một điểm đánh dấu nâng cao.

Hãy dùng PinConfig.Builder để tạo một thực thể của PinConfig:

Kotlin

// Use PinConfig.Builder to create an instance of PinConfig.
val pinConfigBuilder: PinConfig.Builder = PinConfig.builder()
pinConfigBuilder.setBackgroundColor(Color.MAGENTA)
val pinConfig: PinConfig = pinConfigBuilder.build()


// Use the  PinConfig instance to set the icon for AdvancedMarkerOptions.
val advancedMarkerOptions: AdvancedMarkerOptions = AdvancedMarkerOptions()
    .icon(BitmapDescriptorFactory.fromPinConfig(pinConfig))
    .position(MARKER_POSITION)

// Pass the AdvancedMarkerOptions instance to addMarker().
val marker: Marker? = map.addMarker(advancedMarkerOptions)

Java

// Use PinConfig.Builder to create an instance of PinConfig.
PinConfig.Builder pinConfigBuilder = PinConfig.builder();
pinConfigBuilder.setBackgroundColor(Color.MAGENTA);
PinConfig pinConfig = pinConfigBuilder.build();

// Use the  PinConfig instance to set the icon for AdvancedMarkerOptions.
AdvancedMarkerOptions advancedMarkerOptions =
    new AdvancedMarkerOptions()
        .icon(BitmapDescriptorFactory.fromPinConfig(pinConfig))
        .position(MARKER_POSITION);

// Pass the AdvancedMarkerOptions instance to addMarker().
Marker marker = map.addMarker(advancedMarkerOptions);

Thay đổi màu nền

Sử dụng phương thức PinConfig.background() để thay đổi màu nền của một điểm đánh dấu:

Kotlin

// Use PinConfig.Builder to create an instance of PinConfig.
val pinConfigBuilder: PinConfig.Builder = PinConfig.builder()
pinConfigBuilder.setBackgroundColor(Color.MAGENTA)
val pinConfig: PinConfig = pinConfigBuilder.build()

Java

// Use PinConfig.Builder to create an instance of PinConfig.
PinConfig.Builder pinConfigBuilder = PinConfig.builder();
pinConfigBuilder.setBackgroundColor(Color.MAGENTA);
PinConfig pinConfig = pinConfigBuilder.build();

Thay đổi màu đường viền

Dùng phương thức PinConfig.borderColor() để thay đổi màu đường viền của một điểm đánh dấu:

Kotlin

// Set the border color.
val pinConfigBuilder: PinConfig.Builder = PinConfig.builder()
pinConfigBuilder.setBorderColor(Color.BLUE)
val pinConfig: PinConfig = pinConfigBuilder.build()

Java

// Set the border color.
PinConfig.Builder pinConfigBuilder = PinConfig.builder();
pinConfigBuilder.setBorderColor(Color.BLUE);
PinConfig pinConfig = pinConfigBuilder.build();

Thay đổi glyph

Tạo một thực thể Glyph rồi dùng thực thể đó để định cấu hình PinConfig. Sử dụng glyph để đặt văn bản và màu văn bản của glyph, màu glyph hoặc chỉ định một hình ảnh tuỳ chỉnh để dùng làm glyph.

Ví dụ sau đây đặt văn bản glyph:

Kotlin

// Set the glyph text.
val pinConfigBuilder: PinConfig.Builder = PinConfig.builder()
val glyphText = Glyph("A")

// Alteratively, you can set the text color:
// Glyph glyphText = new Glyph("A", Color.GREEN);

pinConfigBuilder.setGlyph(glyphText)
val pinConfig: PinConfig = pinConfigBuilder.build()

Java

// Set the glyph text.
PinConfig.Builder pinConfigBuilder = PinConfig.builder();
PinConfig.Glyph glyphText = new PinConfig.Glyph("A");

// Alternatively, you can set the text color:
// PinConfig.Glyph glyphText = new PinConfig.Glyph("A", Color.GREEN);

pinConfigBuilder.setGlyph(glyphText);
PinConfig pinConfig = pinConfigBuilder.build();

Đặt màu của glyph:

Kotlin

val glyphColor = PinConfig.Glyph(Color.BLUE)
pinConfigBuilder.setGlyph(glyphColor)
val pinConfig: PinConfig = pinConfigBuilder.build()

Java

PinConfig.Glyph glyphColor = new PinConfig.Glyph(Color.BLUE);
pinConfigBuilder.setGlyph(glyphColor);
PinConfig pinConfig = pinConfigBuilder.build();

Đặt hình ảnh tuỳ chỉnh cho biểu tượng. Kỹ thuật này rất hữu ích nếu bạn muốn sử dụng biểu trưng tuỳ chỉnh hoặc chỉ báo trực quan khác trong điểm đánh dấu.

Kotlin

// Set the glyph image.
val glyphImage: Int = R.drawable.example_image
val descriptor = PinConfig.BitmapDescriptorFactory.fromResource(glyphImage)
pinConfigBuilder.setGlyph(Glyph(descriptor))
val pinConfig: PinConfig = pinConfigBuilder.build()

Java

// Set the glyph image.
int glyphImage = R.drawable.example_image;
BitmapDescriptor descriptor = BitmapDescriptorFactory.fromResource(glyphImage);
pinConfigBuilder.setGlyph(new PinConfig.Glyph(descriptor));
PinConfig pinConfig = pinConfigBuilder.build();

Ẩn glyph

Bạn có thể ẩn glyph để màu nền lấp đầy toàn bộ điểm đánh dấu:

Kotlin

// Create a transparent glyph.
val pinConfigBuilder: PinConfig.Builder = PinConfig.builder()
pinConfigBuilder.setBackgroundColor(Color.MAGENTA)
pinConfigBuilder.setGlyph(PinConfig.Glyph(Color.TRANSPARENT))
val pinConfig: PinConfig = pinConfigBuilder.build()

Java

// Create a transparent glyph.
PinConfig.Builder pinConfigBuilder = PinConfig.builder();
pinConfigBuilder.setBackgroundColor(Color.MAGENTA);
pinConfigBuilder.setGlyph(new PinConfig.Glyph(Color.TRANSPARENT));
PinConfig pinConfig = pinConfigBuilder.build();

Sử dụng iconView

Phương thức AdvancedMarkerOptions.iconView() cho phép bạn sử dụng bất kỳ View nào của Android làm điểm đánh dấu. Bằng cách sử dụng một khung hiển thị làm điểm đánh dấu, bạn có toàn quyền kiểm soát điểm đánh dấu.

Lưu ý: Khi sử dụng View làm điểm đánh dấu, đừng thực hiện thao tác trên View để di chuyển điểm đánh dấu đó. Thay vào đó, hãy sửa đổi chính Marker. Ví dụ: để xoay View, hãy sử dụng phương thức Marker.setRotation(). Không xoay View.

Trong ứng dụng, trước tiên, bạn tạo khung hiển thị, sau đó dùng phương thức AdvancedMarkerOptions.iconView() để thêm khung hiển thị vào các điểm đánh dấu nâng cao.

Kotlin

// Create a TextView to use as the marker.
val textView = TextView(this)
textView.text = "Hello!!"
textView.setBackgroundColor(Color.BLACK)
textView.setTextColor(Color.YELLOW)

val marker: Marker? = map.addMarker(
    AdvancedMarkerOptions()
        .position(SYDNEY)
        .iconView(textView)
)

Java

// Create a TextView to use as the marker.
TextView textView = new TextView(this);
textView.setText("Hello!!");
textView.setBackgroundColor(Color.BLACK);
textView.setTextColor(Color.YELLOW);

Marker marker = map.addMarker(
    new AdvancedMarkerOptions()
        .position(SYDNEY)
        .iconView(textView));

Thận trọng: Hiệu suất của một khung hiển thị bản đồ có các điểm đánh dấu iconView có thể không khớp với hiệu suất của các điểm đánh dấu bitmap hoặc điểm đánh dấu mặc định.

Các bước tiếp theo:

• Hành vi va chạm