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

Bạn có thể tuỳ chỉnh bản đồ cho một quốc gia hoặc khu vực cụ thể theo các cách sau:

  • Thay đổi chế độ cài đặt ngôn ngữ mặc định.
  • Chỉ định mã khu vực để thay đổi hành vi của bản đồ dựa trên một quốc gia hoặc lãnh thổ nhất định.

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

Theo mặc định, Maps JavaScript API sử dụng chế độ cài đặt ngôn ngữ ưu tiên của người dùng như đã chỉ định trong trình duyệt, khi hiển thị thông tin văn bản như tên của các chế độ điều khiển, thông báo bản quyền, chỉ đường và nhãn trên bản đồ. Trong hầu hết các trường hợp, bạn nên tuân thủ chế độ cài đặt trình duyệt. Tuy nhiên, nếu muốn API JavaScript của Maps bỏ qua chế độ cài đặt ngôn ngữ của trình duyệt, bạn có thể buộc API này hiển thị thông tin bằng một ngôn ngữ cụ thể bằng cách thêm tham số language vào thẻ <script> khi tải mã API JavaScript của Maps.

Tham số language ảnh hưởng đến tên của các chế độ điều khiển, thông báo bản quyền, chỉ đường và nhãn điều khiển, cũng như phản hồi đối với các yêu cầu dịch vụ. Ảnh hưởng đến các dịch vụ không rõ ràng như vậy. Ví dụ: khi bạn mã hoá địa lý địa chỉ cấp đường, tên quốc gia sẽ được trả về bằng ngôn ngữ bạn yêu cầu, nhưng phần còn lại của địa chỉ sẽ dành riêng cho vị trí bạn đang mã hoá địa lý. Mặt khác, kết quả về địa chỉ bưu chính và kết quả về chính trị sẽ được trả về bằng ngôn ngữ được yêu cầu. Hãy thử bản minh hoạ này để thử nghiệm các thay đổi trên bản đồ khi bạn cập nhật tham số language.

Ví dụ sau đây hiển thị bản đồ bằng tiếng Nhật và đặt khu vực thành Nhật Bản:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=JP&language=ja&callback=initMap">
</script>

Xem ví dụ.

Nếu bạn đặt ngôn ngữ của bản đồ, bạn cũng cần cân nhắc việc đặt khu vực. Điều này giúp đảm bảo rằng ứng dụng của bạn tuân thủ luật pháp địa phương.

Lưu ý: Khi bạn tải API theo cách hiển thị ở trên, bản đồ sẽ sử dụng tiếng Nhật cho tất cả người dùng, bất kể lựa chọn ưu tiên của người dùng. Hãy đảm bảo bạn muốn hành vi này trước khi đặt tuỳ chọn này.

API JavaScript của Maps cũng hỗ trợ văn bản hai chiều (Bidi) chứa các ký tự bằng cả ngôn ngữ từ trái sang phải (LTR) và từ phải sang trái (RTL) theo cách gốc. Ví dụ về các ngôn ngữ RTL bao gồm tiếng Ả Rập, Do Thái và Ba Tư. Nhìn chung, bạn nên chỉ định các trang ngôn ngữ RTL để hiển thị chính xác bằng cách thêm dir='rtl' vào phần tử <html> của trang. Ví dụ sau đây hiển thị bản đồ của Cairo, Ai Cập bằng các thành phần điều khiển tiếng Ả Rập:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=EG&language=ar&callback=initMap">
</script>

Xem ví dụ

Xem danh sách ngôn ngữ được hỗ trợ. Xin lưu ý rằng chúng tôi thường xuyên thêm ngôn ngữ mới, vì vậy danh sách này có thể chưa đầy đủ.

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

Thêm tham số region vào thẻ <script> khi tải mã API JavaScript của Maps, nếu bạn muốn thay đổi ứng dụng để phân phát các ô bản đồ khác nhau hoặc thiên vị ứng dụng (chẳng hạn như thiên vị kết quả mã hoá địa lý theo khu vực).

Là nhà phát triển ứng dụng Maps JavaScript API, bạn nên luôn đặt tham số region vì nhiều dịch vụ (chẳng hạn như tính năng Tự động hoàn thành địa điểm) có xu hướng cung cấp kết quả tốt hơn khi bạn đặt region. Bạn cũng có trách nhiệm đảm bảo rằng ứng dụng của mình tuân thủ luật pháp địa phương bằng cách đảm bảo rằng bạn áp dụng đúng bản địa hoá theo khu vực cho quốc gia lưu trữ ứng dụng.

Tham số region chấp nhận mã nhận dạng thẻ con theo khu vực Unicode (thường) có mối liên kết một với một đến Miền cấp cao nhất theo mã quốc gia (ccTLD). Hầu hết giá trị nhận dạng khu vực Unicode giống với mã ISO 3166-1 alpha-2, ngoại trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD của Vương quốc Anh là "uk" (tương ứng với miền .co.uk) trong khi giá trị nhận dạng khu vực là "GB". Xem Thông tin chi tiết về phạm vi của Nền tảng Google Maps để biết các khu vực được hỗ trợ. Hãy thử bản minh hoạ này để thử nghiệm các thay đổi trên bản đồ khi bạn cập nhật tham số region.

Ví dụ: thẻ tập lệnh sau đây sẽ bản địa hoá bản đồ cho Vương quốc Anh:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=GB&callback=initMap">
</script>

Các ví dụ sau đây cho thấy hai bản đồ, một bản đồ mã hoá địa lý "Toledo" dựa trên region được đặt thành US (Hoa Kỳ) thành "Toledo, Ohio" và một bản đồ thiên vị kết quả dựa trên region được đặt thành ES (Tây Ban Nha) thành "Toledo, Tây Ban Nha".

Xem ví dụ về Hoa Kỳ và ví dụ về Tây Ban Nha.

Bản minh hoạ bản địa hoá

Khi đặt ngôn ngữ của bản đồ, bạn cũng cần cân nhắc việc đặt khu vực. Dưới đây là bản minh hoạ cho phép bạn tải bản đồ bằng ngôn ngữ và khu vực mà bạn chọn.

Xem bản minh hoạ này ở chế độ toàn màn hình.