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

Chủ đề này mô tả cách định cấu hình bản đồ đã được thêm vào ứng dụng Android bằng SDK Bản đồ dành cho Android.

Tổng quan

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 tĩnh, bạn có thể định cấu hình chế độ cài đặt bản đồ ban đầu trong tệp bố cục. Nếu được thêm một cách linh động, bạn có thể định cấu hình các 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 phần Thêm bản đồ.

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

• Vị trí của máy ảnh, bao gồm: vị trí, thu phóng, hướng và độ nghiêng. Hãy xem phần Máy ảnh và Chế độ xem để biết thông tin chi tiết về cách định vị máy ảnh.
• Loại bản đồ.
• Các thành phần giao diện người dùng để hiển thị, chẳng hạn như nút thu phóng và la bàn.
• Cử chỉ cần bật.
• Liệu chế độ lite có được bật hay không.

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 chế độ cài đặt định cấu hình lớp lưu lượng truy cập và khoảng đệm bản đồ.

Ví dụ:

Trong 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 bằng 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 chế độ điều khiển thu phóng.
• Bật chế độ điều khiển cử chỉ xoay.
• Đặt độ nghiêng bản đồ thành 30.

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

• Đặt máy ảnh ở giữa Kyoto, Nhật Bản.
• Bật loại bản đồ kết hợp.
• Bật lớp giao thông.

<?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" />
    

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 một dự án và thêm một bản đồ cơ bản thông qua các tuỳ chọn sau:

• Tạo ứng dụng bằng mẫu Maps cho Android Studio. Mẫu Maps sẽ tự động định cấu hình dự án và thêm một bản đồ cơ bản. Một mảnh được dùng làm vùng chứa bản đồ và được thêm một 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 một ứng dụng hiện có.

Định cấu hình bản đồ sau khi thêm bản đồ đó một 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 đồ đó một cách tĩnh vào tệp bố cục.

SDK Bản đồ dành cho Android xác định một tập hợp thuộc tính XML tuỳ chỉnh cho SupportMapFragment hoặc MapView mà bạn có thể sử 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 đây hiện đượ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 máy ảnh. Hãy xem hướng dẫn về máy ảnh và thành phần hiển thị để biết thông tin chi tiết.

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

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

• zOrderOnTop – Cho biết liệu giao diện của chế độ xem bản đồ có hiển thị ở đầu cửa sổ bản đồ, các nút điều khiển bản đồ và bất kỳ đối tượng nào trong cửa sổ hay không. Hãy xem 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 chế độ xem của mảnh hay chính mảnh đó hay không. Hãy xem tại đây để biết thông tin chi tiết.

• liteMode – true để bật chế độ lite; nếu không, hãy sử dụng false.

• mapColorScheme – Chỉ định bảng phối màu cho bản đồ pháp tuyến 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 của 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 đây. 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 bằng 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 bản đồ một cách linh độ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 một cách linh động.

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

val options = GoogleMapOptions()

      

GoogleMapOptions options = new GoogleMapOptions();

      

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

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

      

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

      

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

• Nếu bạn đang sử dụng SupportMapFragment, hãy sử dụng phương thức nhà máy tĩnh SupportMapFragment.newInstance(GoogleMapOptions options) để tạo mảnh và truyền vào chế độ cài đặt của bạn.
• Nếu bạn đang sử dụng MapView, hãy sử dụng hàm khởi tạo MapView(Context, GoogleMapOptions) và truyền vào chế độ cài đặt của bạn.

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ử văn bản trên bản đồ sẽ hiển thị bằng ngôn ngữ thích hợp dựa trên chế độ cài đặt thiết bị và vị trí của người dùng. Bạn có thể hạn chế các ngôn ngữ mà ứng dụng sử dụng thành một tập hợp con của tất 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 tệp 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 lưu lượng truy cập

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 lưu lượng truy cập bằng cách gọi phương thức setTrafficEnabled(). Ngoài ra, bạn có thể xác định xem lớp lưu lượng truy cập hiện 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 một bản đồ đã bật lớp giao thô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:

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

      

// 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 đồ pháp tuyến, kết hợp và địa hình:

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

Khi xem cận cảnh, nhiều thành phố sẽ hiển thị các tòa nhà 3D, như 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).

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ơ đồ mặt bằng của các không gian trong nhà như sân bay, trung tâm mua sắm, cửa hàng bán lẻ lớn và ga phương tiện công cộng. Các bản vẽ mặt bằng này (được gọi là bản đồ trong nhà) sẽ hiển thị cho các loại bản đồ "bình thường" và "vệ tinh" (GoogleMap.MAP_TYPE_NORMAL và GoogleMap.MAP_TYPE_SATELLITE). Các bản vẽ mặt bằng này sẽ tự động bật khi người dùng phóng to và sẽ mờ dần khi bản đồ được thu nhỏ.

Thông báo về việc ngừng sử dụng: Trong một bản phát hành sau này, bản đồ trong nhà chỉ có trên loại bản đồ normal. Kể từ bản phát hành trong tương lai đó, 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ợ môi trường trong nhà, isIndoorEnabled() sẽ tiếp tục trả về giá trị đã được đặt thông qua 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 thời điểm tính năng hỗ trợ trong nhà không hoạt động trên các loại bản đồ đó.

Dưới đây là nội dung tóm tắt về chức năng 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à sẽ được bật. Mỗi lần, bản đồ trong nhà sẽ hiển thị trên một bản đồ. Theo mặc định, đây là bản đồ đầu tiên được thêm vào ứng dụng. Để hiển thị bản đồ trong nhà trên một bản đồ khác, hãy tắt bản đồ đó trên bản đồ đầu tiên, sau đó gọi setIndoorEnabled(true) trên bản đồ thứ hai.
• Để tắt bộ chọn cấp mặc định (bộ chọn sàn), hãy gọi GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(false). Để biết thêm thông tin, hãy xem phần Tương tác với bản đồ.
• OnIndoorStateChangeListener – xác định trình nghe phát hiện thời điểm một toà nhà xuất hiện trong tiêu điểm hoặc một cấp được kích hoạt trong 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 tâm điểm. Sau đó, bạn có thể tìm thấy cấp độ đang hoạt động bằng cách gọi IndoorBuilding.getActiveLevelIndex().
• Việc thiết kế 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 đồ của 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 máy ảnh sẽ phản ánh tâm của vùng đệm.
• Các chế độ điều khiển bản đồ được đặt tương ứng với các cạnh của bản đồ.
• Thông tin pháp lý, chẳng hạn như tuyên bố bản quyền hoặc biểu trưng Google sẽ xuất hiện ở 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.Phương thức setPadding(). Bản đồ sẽ tiếp tục lấp đầy toàn bộ vùng chứa, nhưng vị trí văn bản và vị trí điều khiển, cử chỉ trên bản đồ và chuyển động của máy ảnh sẽ hoạt động như thể đượ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 thao tác di chuyển máy ảnh thông qua lệnh gọi API hoặc thao tác nhấn nút (ví dụ: la bàn, vị trí của tôi, nút thu phóng) đều liên quan đến vùng đệm.
• Phương thức getCameraPosition trả về tâm của vùng đệm.
• Phương thức Projection và getVisibleRegion trả về vùng được thêm khoảng đệm.
• Các thành phần điều khiển giao diện người dùng được bù trừ từ cạnh của vùng chứa theo số 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 chéo một số phần của bản đồ. Trong hình sau, bản đồ được thêm khoảng đệm dọc theo cạnh trên cùng và bên phải. Các nút điều khiển bản đồ hiển thị và văn bản pháp lý sẽ hiển thị dọc theo cạnh của vùng đệm, hiển thị bằng màu xanh lục, trong khi bản đồ sẽ tiếp tục lấp đầy toàn bộ vùng chứa, hiển thị bằng màu xanh dương. Trong ví dụ này, bạn có thể thả một trình đơn lên phía bên phải của bản đồ mà không che khuất các nút điều khiển bản đồ.

Bản đồ phối màu

Đối với bản đồ loại thông thường và bản đồ địa hình, bạn có thể tự động đặt bảng phối màu bản đồ thành màu 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 của 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ị 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.

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

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

Bạn có thể bật/tắt bảng phối màu bằng cách sử dụ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.

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

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

Đị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 chế độ xem 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 tuỳ chọn bản đồ.

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

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 kiểu bản đồ có mức độ ưu tiên cao hơn so với màu nền cục bộ. Để biết thêm thông tin, hãy xem phần Thay đổi màu nền của ứng dụng để tạo kiểu cho bản đồ dựa trên đám mây.