Định cấu hình bản đồ

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

Tài liệu này mô tả cách định cấu hình bản đồ được thêm vào ứng dụng Android bằng Maps SDK cho Android.

Tổng quan

Bản đồ Kyoto với chế độ cài đặt bản đồ đã được định cấu hình. Sau khi thêm bản đồ vào ứng dụng, bạn có thể định cấu hình chế độ cài đặt ban đầu và thời gian chạy của bản đồ. Bạn cần định cấu hình chế độ cài đặt ban đầu dựa trên việc bạn đã thêm vùng chứa bản đồ (SupportMapFragment hoặc MapView) theo cách tĩnh hay động. Nếu vùng chứa bản đồ được thêm theo cách tĩnh, bạn có thể định cấu hình chế độ cài đặt ban đầu của bản đồ trong tệp bố cục. Nếu vùng chứa bản đồ được thêm theo cách động, bạn có thể định cấu hình chế độ cài đặt ban đầu trong lệnh gọi lại OnCreate bằng đối tượng GoogleMapOptions.

Để biết thông tin chi tiết về cách thêm vùng chứa bản đồ, hãy xem bài viết Thêm bản đồ.

Chế độ cài đặt ban đầu của bản đồ bao gồm:

Trong thời gian chạy, bạn có thể định cấu hình các chế độ cài đặt này và một số chế độ cài đặt bổ sung bằng cách cập nhật đối tượng GoogleMap trong lệnh gọi lại onMapReady. Các chế độ cài đặt bổ sung được định cấu hình thông qua các phương thức của lớp GoogleMap, chẳng hạn như các phương thức định cấu hình lớp giao thông và khoảng đệm bản đồ.

Ví dụ:

Trong đoạn mã ví dụ bên dưới và ảnh chụp màn hình ở trên, bản đồ được định cấu hình với các chế độ cài đặt sau.

Chế độ cài đặt ban đầu được định cấu hình trong tệp bố cục:

  • Bật các nút điều khiển thu phóng.
  • Bật các nút điều khiển cử chỉ xoay.
  • Đặt độ nghiêng của bản đồ thành 30.

Chế độ cài đặt thời gian chạy:

  • Đặt camera ở trung tâm Kyoto, Nhật Bản.
  • Bật loại bản đồ kết hợp.
  • Bật lớp giao thông.

Chế độ cài đặt ban đầu

<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:id="@+id/map"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map:uiZoomControls="true"
    map:uiRotateGestures="true"
    map:cameraTilt="30" />

Chế độ cài đặt thời gian chạy

package com.example.mapsetup;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;

public class MainActivity extends AppCompatActivity implements OnMapReadyCallback {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);

    }

    // Update the map configuration at runtime.
    @Override
    public void onMapReady(GoogleMap googleMap) {
        // Set the map coordinates to Kyoto Japan.
        LatLng kyoto = new LatLng(35.00116, 135.7681);
        // Set the map type to Hybrid.
        googleMap.setMapType(GoogleMap.MAP_TYPE_HYBRID);
        // Add a marker on the map coordinates.
        googleMap.addMarker(new MarkerOptions()
                .position(kyoto)
                .title("Kyoto"));
        // Move the camera to the map coordinates and zoom in closer.
        googleMap.moveCamera(CameraUpdateFactory.newLatLng(kyoto));
        googleMap.moveCamera(CameraUpdateFactory.zoomTo(15));
        // Display traffic.
        googleMap.setTrafficEnabled(true);

    }
}

Trước khi bắt đầu

Trước khi bắt đầu, bạn có thể thiết lập dự án và thêm bản đồ cơ bản thông qua các lựa chọn sau:

  • Tạo ứng dụng bằng mẫu Bản đồ cho Android Studio. Mẫu Bản đồ sẽ tự động định cấu hình dự án và thêm bản đồ cơ bản. Một mảnh được dùng làm vùng chứa bản đồ và được thêm theo cách tĩnh. Để biết thông tin chi tiết, hãy xem phần bắt đầu nhanh.

  • Định cấu hình dự án theo cách thủ công cho SDK và thêm bản đồ cơ bản. Điều này cho phép bạn sử dụng mọi mẫu Android và thêm bản đồ vào ứng dụng hiện có.

Định cấu hình bản đồ sau khi thêm theo cách tĩnh

Phần này mô tả cách đặt trạng thái ban đầu của bản đồ nếu bạn đã thêm bản đồ theo cách tĩnh vào tệp bố cục.

Maps SDK cho Android xác định một nhóm thuộc tính XML tuỳ chỉnh cho SupportMapFragment hoặc MapView mà bạn có thể dùng để định cấu hình trạng thái ban đầu của bản đồ ngay trong tệp bố cục. Các thuộc tính sau được xác định:

  • mapType – Loại bản đồ cần hiển thị. Các giá trị hợp lệ bao gồm: none, normal, hybrid, satellite và terrain.

  • cameraTargetLat, cameraTargetLng, cameraZoom, cameraBearing, cameraTilt – Vị trí ban đầu của camera. Hãy xem hướng dẫn về camera và khung hiển thị để biết thông tin chi tiết.

  • uiZoomControls, uiCompass – Chỉ định xem các nút điều khiển thu phóng và la bàn có được hiển thị hay không. Hãy xem UiSettings để biết thông tin chi tiết.

  • uiZoomGestures, uiScrollGestures, uiRotateGestures, uiTiltGestures – Chỉ định xem các cử chỉ cụ thể có được bật hay không. Hãy xem UiSettings để biết thông tin chi tiết.

  • zOrderOnTop – Cho biết liệu bề mặt của khung hiển thị bản đồ có được hiển thị ở trên cùng của cửa sổ bản đồ, các nút điều khiển bản đồ và mọi đối tượng trong cửa sổ hay không. Hãy xem bài viết SurfaceView.setZOrderOnTop(boolean) để biết thông tin chi tiết.

  • useViewLifecycle – Chỉ hợp lệ với đối tượng SupportMapFragment. Chỉ định xem vòng đời của bản đồ có được liên kết với khung hiển thị của mảnh hay chính mảnh đó hay không. Hãy xem tài liệu tham khảo để biết thông tin chi tiết.

  • liteMode – true để bật chế độ thu gọn; nếu không, hãy đặt thành false.

  • mapColorScheme – Chỉ định bảng phối màu cho bản đồ thông thường và bản đồ địa hình. Các giá trị bao gồm light (mặc định), dark và follow_system có nghĩa là sử dụng chế độ cài đặt hệ thống hiện tại dựa trên chế độ cài đặt thiết bị cho UI_NIGHT_MODE_MASK. Để biết thêm thông tin, hãy xem bài viết Bảng phối màu bản đồ.

Để sử dụng các thuộc tính tuỳ chỉnh này trong tệp bố cục, tệp đó phải có nội dung khai báo không gian tên sau. Bạn có thể chọn bất kỳ không gian tên nào, không nhất thiết phải là map:

xmlns:map="http://schemas.android.com/apk/res-auto"

Sau đó, bạn có thể thêm các thuộc tính có tiền tố map: vào tệp bố cục.

Tệp bố cục sau đây định cấu hình đối tượng SupportMapFragment với các thuộc tính bản đồ tuỳ chỉnh. Bạn cũng có thể áp dụng các thuộc tính tương tự cho đối tượng MapView.

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:map="http://schemas.android.com/apk/res-auto"
  android:name="com.google.android.gms.maps.SupportMapFragment"
  android:id="@+id/map"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  map:cameraBearing="112.5"
  map:cameraTargetLat="-33.796923"
  map:cameraTargetLng="150.922433"
  map:cameraTilt="30"
  map:cameraZoom="13"
  map:mapType="normal"
  map:mapColorScheme="dark"
  map:uiCompass="false"
  map:uiRotateGestures="true"
  map:uiScrollGestures="false"
  map:uiTiltGestures="true"
  map:uiZoomControls="false"
  map:uiZoomGestures="true"/>

Định cấu hình bản đồ sau khi thêm theo cách động

Phần này mô tả cách đặt trạng thái ban đầu của bản đồ nếu bạn đã thêm bản đồ vào ứng dụng theo cách động.

Nếu đã thêm SupportMapFragment hoặc MapView theo cách động, thì bạn có thể đặt trạng thái ban đầu của bản đồ trong đối tượng GoogleMapOptions. Các lựa chọn có sẵn là các lựa chọn tương tự có trong tệp bố cục. Bạn có thể tạo GoogleMapOptions như sau:

Kotlin

val options = GoogleMapOptions()

Java

GoogleMapOptions options = new GoogleMapOptions();

Sau đó, hãy định cấu hình như sau:

Kotlin

options.mapType(GoogleMap.MAP_TYPE_SATELLITE)
    .compassEnabled(false)
    .rotateGesturesEnabled(false)
    .tiltGesturesEnabled(false)

Java

options.mapType(GoogleMap.MAP_TYPE_SATELLITE)
    .compassEnabled(false)
    .rotateGesturesEnabled(false)
    .tiltGesturesEnabled(false);

Để áp dụng các lựa chọn này khi tạo bản đồ, hãy làm một trong những việc sau:

Bản địa hoá bản đồ

Khi bạn thêm MapView hoặc SupportMapFragment vào ứng dụng, các phần tử dạng văn bản trên bản đồ sẽ xuất hiện bằng ngôn ngữ thích hợp dựa trên chế độ cài đặt và vị trí của thiết bị người dùng. Bạn có thể giới hạn các ngôn ngữ mà ứng dụng sử dụng thành một nhóm nhỏ trong số tất cả các ngôn ngữ được hỗ trợ bằng cách thêm mục resConfigs vào tệp Gradle. Điều này hữu ích cho việc loại bỏ các ngôn ngữ không dùng đến, đồng thời giảm kích thước nhị phân của ứng dụng. Ví dụ:

defaultConfig {
    resConfigs "en", "fr", "es", "zh", "de", "ja", "ru", "ko", "pt", "in"
}

Đọc thêm về cách bản địa hoá ứng dụng Android.

Thiết lập lớp giao thông

Bạn có thể hiển thị dữ liệu giao thông trên bản đồ bằng cách bật lớp giao thông. Bạn có thể bật và tắt lớp giao thông bằng cách gọi phương thức setTrafficEnabled() và có thể xác định xem lớp giao thông có bật hay không bằng cách gọi phương thức isTrafficEnabled(). Ảnh chụp màn hình sau đây cho thấy bản đồ có lớp giao thông được bật.

Lớp giao thông

Thiết lập lớp phương tiện công cộng

Bạn có thể hiển thị dữ liệu phương tiện công cộng trên bản đồ bằng cách bật lớp phương tiện công cộng. Bạn có thể bật và tắt lớp phương tiện công cộng bằng cách gọi setTransitEnabled() phương thức, và có thể xác định xem lớp phương tiện công cộng có bật hay không bằng cách gọi isTransitEnabled() phương thức. Ảnh chụp màn hình sau đây cho thấy bản đồ có lớp phương tiện công cộng được bật.

Lớp phương tiện công cộng

Đặt loại bản đồ

Để đặt loại bản đồ, hãy gọi phương thức setMapType. Ví dụ: để hiển thị bản đồ vệ tinh:

Kotlin

// Sets the map type to be "hybrid"
map.mapType = GoogleMap.MAP_TYPE_HYBRID

Java

// Sets the map type to be "hybrid"
map.setMapType(GoogleMap.MAP_TYPE_HYBRID);

Hình ảnh sau đây so sánh các loại bản đồ thông thường, kết hợp và địa hình:

So sánh 3 loại bản đồ: bản đồ thông thường, bản đồ kết hợp và bản đồ địa hình.

Thiết lập toà nhà 3D

Nhiều thành phố khi xem cận cảnh sẽ có các toà nhà 3D, như bạn có thể thấy trong hình ảnh bên dưới về Vancouver, Canada. Bạn có thể tắt các toà nhà 3D bằng cách gọi GoogleMap.setBuildingsEnabled(false).

Bản đồ Vancouver, Canada

Thiết lập chế độ cài đặt bản đồ trong nhà

Ở mức thu phóng cao, bản đồ sẽ hiển thị sơ đồ tầng cho các không gian trong nhà như sân bay, trung tâm thương mại, cửa hàng bán lẻ lớn và nhà ga. Các sơ đồ tầng này (gọi là bản đồ trong nhà) được hiển thị cho các loại bản đồ "thông thường" và "vệ tinh" (GoogleMap.MAP_TYPE_NORMAL và GoogleMap.MAP_TYPE_SATELLITE). Các sơ đồ này sẽ tự động bật khi người dùng phóng to và mờ dần khi bản đồ được thu nhỏ.

Thông báo ngừng sử dụng: Trong bản phát hành sau này, bản đồ trong nhà sẽ chỉ có trên loại bản đồ normal. Kể từ bản phát hành sau này, bản đồ trong nhà sẽ không được hỗ trợ trên bản đồ satellite, terrain hoặc hybrid. Ngay cả khi không hỗ trợ bản đồ trong nhà, isIndoorEnabled() sẽ tiếp tục trả về giá trị đã được đặt bằng setIndoorEnabled(), như hiện tại. Theo mặc định, setIndoorEnabled là true. Ghi chú phát hành sẽ cho bạn biết khi nào tính năng hỗ trợ bản đồ trong nhà không còn dùng được trên các loại bản đồ đó.

Bản đồ trong nhà của một trung tâm mua sắm cho thấy các lối thoát và khu vực bán hàng.

Dưới đây là phần tóm tắt về các tính năng của bản đồ trong nhà trong API:

  • Bạn có thể tắt bản đồ trong nhà bằng cách gọi GoogleMap.setIndoorEnabled(false). Theo mặc định, bản đồ trong nhà được bật. Bản đồ trong nhà được hiển thị trên một bản đồ tại một thời điểm. Theo mặc định, đây là bản đồ đầu tiên được thêm vào ứng dụng của bạn. Để hiển thị bản đồ trong nhà trên một bản đồ khác, hãy tắt bản đồ trong nhà trên bản đồ đầu tiên, sau đó gọi setIndoorEnabled(true) trên bản đồ thứ hai.
  • Để tắt trình chọn cấp độ mặc định (trình chọn tầng), hãy gọi GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(false). Để biết thêm thông tin chi tiết, hãy xem bài viết Tương tác với Bản đồ.
  • OnIndoorStateChangeListener – xác định các trình nghe phát hiện thời điểm một toà nhà được lấy làm tiêu điểm hoặc một tầng được kích hoạt trong một toà nhà. Để biết thông tin chi tiết, hãy xem bài viết Tương tác với Bản đồ.
  • getFocusedBuilding – truy xuất toà nhà đang được lấy làm tiêu điểm. Sau đó, bạn có thể tìm thấy tầng đang hoạt động bằng cách gọi IndoorBuilding.getActiveLevelIndex().
  • Việc tạo kiểu cho bản đồ cơ sở không ảnh hưởng đến bản đồ trong nhà.

Thiết lập khoảng đệm bản đồ

Video này cho thấy ví dụ về khoảng đệm bản đồ.

Bản đồ Google được thiết kế để lấp đầy toàn bộ khu vực do phần tử vùng chứa xác định, thường là MapView hoặc SupportMapFragment. Một số khía cạnh về cách bản đồ xuất hiện và hoạt động được xác định theo kích thước của vùng chứa:

  • Mục tiêu của camera sẽ phản ánh trung tâm của khu vực được đệm.
  • Các nút điều khiển bản đồ được đặt tương đối so với các cạnh của bản đồ.
  • Thông tin pháp lý, chẳng hạn như nội dung tuyên bố bản quyền hoặc biểu trưng của Google, xuất hiện dọc theo cạnh dưới cùng của bản đồ.

Bạn có thể thêm khoảng đệm xung quanh các cạnh của bản đồ bằng cách sử dụng GoogleMap.setPadding() phương thức. Bản đồ sẽ tiếp tục lấp đầy toàn bộ vùng chứa, nhưng vị trí của văn bản và nút điều khiển, cử chỉ trên bản đồ và chuyển động của camera sẽ hoạt động như thể bản đồ được đặt trong một không gian nhỏ hơn. Điều này dẫn đến những thay đổi sau:

  • Các chuyển động của camera bằng cách sử dụng lệnh gọi API hoặc nhấn nút (ví dụ: la bàn, vị trí của tôi, nút thu phóng) tương ứng với khu vực được đệm.
  • Phương thức getCameraPosition trả về trung tâm của khu vực được đệm.
  • Phương thức Projection và getVisibleRegion trả về khu vực được đệm.
  • Các nút điều khiển trên giao diện người dùng được bù trừ từ cạnh của vùng chứa theo số lượng pixel được chỉ định.

Khoảng đệm có thể hữu ích khi thiết kế giao diện người dùng chồng lên một phần của bản đồ. Trong hình ảnh sau đây, bản đồ được đệm dọc theo các cạnh trên cùng và bên phải. Các nút điều khiển bản đồ và văn bản pháp lý có thể nhìn thấy sẽ xuất hiện dọc theo các cạnh của khu vực được đệm (màu xanh lục), trong khi bản đồ sẽ tiếp tục lấp đầy toàn bộ vùng chứa (màu xanh dương). Trong ví dụ này, bạn có thể di chuyển một trình đơn lên phía bên phải của bản đồ mà không làm che khuất các nút điều khiển bản đồ.

Khoảng đệm bản đồ

Bảng phối màu bản đồ

Đối với bản đồ thuộc loại thông thường và địa hình, bạn có thể đặt bảng phối màu bản đồ theo cách động thành tối, sáng hoặc sử dụng chế độ cài đặt hệ thống hiện tại. Ví dụ: bạn có thể làm tối hoặc làm sáng bảng phối màu bản đồ dựa trên thời gian trong ngày hoặc việc sử dụng thiết bị trong nhà hay ngoài trời.

Theo mặc định, bản đồ sử dụng chế độ sáng. Giá trị chế độ cài đặt hệ thống hiện tại dựa trên chế độ cài đặt thiết bị cho UI_NIGHT_MODE_MASK.

Kotlin

mapFragment = SupportMapFragment.newInstance(GoogleMapOptions().mapColorScheme(MapColorScheme.DARK).mapId(mapId2))

Java

mapFragment = SupportMapFragment.newInstance(new GoogleMapOptions().mapColorScheme(MapColorScheme.DARK).mapId(mapId2));

Bạn có thể chuyển đổi bảng phối màu bằng phương thức GoogleMap.setMapColorScheme() để đặt kiểu hiện tại thành chế độ tối, chế độ sáng hoặc tuân theo chế độ cài đặt hệ thống.

Kotlin

googleMap.setMapColorScheme(MapColorScheme.DARK)
googleMap.setMapColorScheme(MapColorScheme.LIGHT)
googleMap.setMapColorScheme(MapColorScheme.FOLLOW_SYSTEM)

Java

googleMap.setMapColorScheme(MapColorScheme.DARK);
googleMap.setMapColorScheme(MapColorScheme.LIGHT);
googleMap.setMapColorScheme(MapColorScheme.FOLLOW_SYSTEM);

Để tạo kiểu sáng và kiểu tối tuỳ chỉnh cho bản đồ, hãy sử dụng định kiểu bản đồ dựa trên đám mây.

Định cấu hình màu nền

Khi làm việc ở chế độ tối hoặc chuyển đổi giữa các khung hiển thị bản đồ, bạn nên định cấu hình màu nền mặc định của bản đồ. Bạn có thể thực hiện việc này bằng cách đặt thuộc tính backgroundColor của các lựa chọn bản đồ.

Kotlin

private val googleMapOptions: GoogleMapOptions =
    GoogleMapOptions().backgroundColor(Color.argb(255, 255, 0, 0));

Java

private GoogleMapOptions options = new GoogleMapOptions().backgroundColor(Color.argb(255, 255, 0, 0));

Bạn cũng có thể sử dụng tính năng định kiểu bản đồ dựa trên đám mây để định cấu hình màu nền. Màu nền được đặt trong tính năng tạo kiểu bản đồ có mức độ ưu tiên cao hơn màu nền cục bộ. Để biết thêm thông tin, hãy xem bài viết Thay đổi màu nền của ứng dụng chotính năng định kiểu bản đồ dựa trên đám mây.