Nội địa hoá bản đồ

Bạn có thể tuỳ chỉnh chế độ cài đặt ngôn ngữ và khu vực được dùng trong bản đồ bằng cách thay đổi chế độ cài đặt ngôn ngữ mặc định và mã khu vực của bản đồ. Điều này có thể ảnh hưởng đến hành vi của bản đồ dựa trên quốc gia hoặc lãnh thổ được chỉ định.

Xem phạm vi phủ sóng của SDK Maps 3D dành cho Android trong bảng phạm vi phủ sóng của Maps.

Bản địa hoá ngôn ngữ

Theo mặc định, SDK 3D của Maps dành cho Android sử dụng chế độ cài đặt ngôn ngữ được định cấu hình trên thiết bị của người dùng để xác định bản dịch nào của bản đồ sẽ hiển thị. Tuy nhiên, bạn có thể ghi đè hành vi mặc định này và đặt một ngôn ngữ cụ thể khi khởi tạo bản đồ hoặc cập nhật ngôn ngữ và khu vực một cách linh hoạt sau khi bản đồ được khởi tạo.

Việc đặt ngôn ngữ sẽ ảnh hưởng đến ngôn ngữ hiển thị của các thành phần điều khiển trên giao diện người dùng, chú thích và thông báo bản quyền. Nội dung cập nhật ngôn ngữ trong thời gian chạy được phản ánh trong chế độ xem bản đồ, nhưng không phản ánh trong bất kỳ thành phần điều khiển nào khác trên giao diện người dùng, chú giải công cụ hoặc các thành phần khác tương tự. Ngôn ngữ này cũng ảnh hưởng đến bản dịch các đặc điểm chính trị, nội dung mô tả và đặc điểm tự nhiên (chẳng hạn như thay đổi "Geneva" thành "Genève" hoặc "hồ" thành "lac") và thay đổi hướng hiển thị văn bản cho các tập lệnh từ phải sang trái.

SDK Maps 3D dành cho Android tìm các lựa chọn ưu tiên về bản địa hoá theo thứ tự sau. Nếu các lựa chọn ưu tiên không được xác định ở bước đầu tiên, thì hệ thống sẽ tiếp tục tìm theo thứ tự đã chỉ định:

  1. Bản cập nhật thời gian chạy: Lựa chọn ưu tiên về ngôn ngữ và lựa chọn ưu tiên theo khu vực được chuyển đến setLocale trên thực thể GoogleMap3D bằng LocaleOptions.
  2. Khởi chạy bản đồ: Lựa chọn ưu tiên về ngôn ngữ và khu vực được chỉ định khi tạo bản đồ, trong XML bố cục trên Map3DView bằng cách sử dụng các thuộc tính map3d:language và map3d:region, hoặc theo phương thức lập trình bằng cách sử dụng Map3DInitConfig.
  3. Chế độ cài đặt thiết bị: Ngôn ngữ theo giá trị mặc định của hệ thống được định cấu hình trên thiết bị Android.

Ví dụ sau đây cho thấy một bản đồ bằng tiếng Trung ("zh") và đặt khu vực thành Trung Quốc ("CN").

Bạn có thể định cấu hình ngôn ngữ và khu vực trong tệp XML bố cục bằng cách sử dụng các thuộc tính map3d:language và map3d:region trên Map3DView:

<com.google.android.gms.maps3d.Map3DView
    android:id="@+id/map3dView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map3d:mapMode="hybrid"
    map3d:language="zh"
    map3d:region="CN" />

Bạn cũng có thể cập nhật ngôn ngữ và khu vực một cách linh động trong thời gian chạy bằng cách tạo một thực thể LocaleOptions, đặt các giá trị bằng setLanguage và setRegion, rồi truyền giá trị đó đến setLocale trên thực thể GoogleMap3D:

val localeOptions = LocaleOptions().apply {
    language = "zh"
    region = "CN"
}
googleMap3D.setLocale(localeOptions)

Bản địa hoá theo khu vực

Việc thiết lập khu vực bằng thuộc tính XML map3d:region, thuộc tính region trên Map3DInitConfig hoặc setRegion trên LocaleOptions có thể phân phát các ô bản đồ khác nhau hoặc thiên về các kết quả phù hợp hơn theo khu vực cho ứng dụng. Ngoài ra, việc đặt thẻ khu vực đảm bảo rằng ứng dụng tuân thủ luật pháp địa phương bằng cách áp dụng chế độ bản địa hoá theo khu vực phù hợp cho quốc gia hoặc lãnh thổ nơi ứng dụng được phân phối.