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 những 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ữ mà người dùng ưu tiên như được chỉ định trong trình duyệt, khi hiển thị thông tin dạng văn bản, chẳng hạn như tên của các chế độ điều khiển, thông báo bản quyền, chỉ đường lái xe và nhãn trên bản đồ. Trong hầu hết các trường hợp, bạn nên tuân theo chế độ cài đặt của trình duyệt. Tuy nhiên, nếu muốn Maps JavaScript API 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ã Maps JavaScript API.

Tham số language ảnh hưởng đến tên của các chế độ kiểm soát, thông báo bản quyền, chỉ đường lái xe và nhãn kiểm soát, cũng như các phản hồi đối với yêu cầu dịch vụ. Ảnh hưởng đến các dịch vụ không rõ ràng. Ví dụ: khi mã hoá địa lý địa chỉ ở cấp đường, tên quốc gia sẽ được trả về bằng ngôn ngữ mà 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í mà bạn đang mã hoá địa lý. Mặt khác, kết quả về bưu chính 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ạ bản địa hoá để 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ữ cho bản đồ, thì bạn cũng nê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 nêu 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 lựa chọn này.

Maps JavaScript API 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) một cách tự nhiên. Ví dụ về các ngôn ngữ RTL bao gồm tiếng Ả Rập, tiếng Do Thái và tiếng Ba Tư. Thông thường, bạn nên chỉ định các trang có ngôn ngữ viết từ phải sang trái để hiển thị đúng cách bằng cách thêm dir='rtl' vào phần tử <html> của trang. Ví dụ sau đây kết xuất một bản đồ Cairo, Ai Cập bằng các chế độ kiểm soát 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ụ

Ngôn ngữ được hỗ trợ

Google thường xuyên cập nhật các ngôn ngữ được hỗ trợ. Danh sách này có thể chưa đầy đủ và có thể thay đổi.

Mã ngôn ngữ Ngôn ngữ Mã ngôn ngữ Ngôn ngữ
af Tiếng Hà Lan ở Nam Phi ja Tiếng Nhật
sq Tiếng Albania kn Tiếng Kannada
sáng Tiếng Amhara kk Tiếng Kazakh
ar Tiếng Ả Rập km Tiếng Khmer
hy Tiếng Armenia ko Tiếng Hàn
az Tiếng Azerbaijan ky Tiếng Kyrgyz
eu Tiếng Basque lo Tiếng Lào
be Tiếng Belarus lv Tiếng Latvia
bn Tiếng Bengal lt Tiếng Lithuania
bs Tiếng Bosnia mk Tiếng Macedonia
bg Tiếng Bungary ms Tiếng Malay
my Tiếng Miến Điện ml Tiếng Malayalam
ca Tiếng Catalan mr Tiếng Marathi
zh Tiếng Trung mn Tiếng Mông Cổ
zh-CN Tiếng Trung (Giản thể) ne Tiếng Nepal
zh-HK Tiếng Trung (Hong Kong) không Tiếng Na Uy
zh-TW Tiếng Trung (Phồn thể) pl Tiếng Ba Lan
giờ Tiếng Croatia pt Tiếng Bồ Đào Nha
cs Tiếng Séc pt-BR Tiếng Bồ Đào Nha (Brazil)
da Tiếng Đan Mạch pt-PT Tiếng Bồ Đào Nha (Bồ Đào Nha)
nl Tiếng Hà Lan pa Tiếng Punjab
en Tiếng Anh ro Tiếng Rumani
en-AU Tiếng Anh (Úc) ru Tiếng Nga
en-GB Tiếng Anh (Anh) sr Tiếng Serbia (Chữ Kirin)
et Tiếng Estonia sr-Latn Tiếng Serbia (chữ Latinh)
fa Tiếng Farsi si Tiếng Sinhala
fi Tiếng Phần Lan sk Tiếng Slovak
fil Tiếng Philippines sl Tiếng Slovenia
fr Tiếng Pháp es Tiếng Tây Ban Nha
fr-CA Tiếng Pháp (Canada) es-419 Tiếng Tây Ban Nha (Mỹ La Tinh)
gl Tiếng Galicia sw Tiếng Swahili
ka Tiếng Gruzia sv Tiếng Thuỵ Điển
de Tiếng Đức ta Tiếng Tamil
el Tiếng Hy Lạp te Tiếng Telugu
gu Tiếng Gujarat th Tiếng Thái
iw Tiếng Do Thái tr Tiếng Thổ Nhĩ Kỳ
hi Tiếng Hindi uk Tiếng Ukraina
hu Tiếng Hungary ur Tiếng Urdu
is Tiếng Iceland uz Tiếng Uzbek
id Tiếng Indonesia vi Tiếng Việt
it Tiếng Ý zu Tiếng Zulu

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

Thêm một tham số region vào thẻ <script> khi tải mã Maps JavaScript API, nếu bạn muốn thay đổi ứng dụng để phân phát các ô bản đồ khác nhau hoặc điều chỉnh ứng dụng (chẳng hạn như điều chỉnh 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 một tham số region vì nhiều dịch vụ (chẳng hạn như Place Autocomplete) 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 bạn tuân thủ luật pháp địa phương bằng cách đảm bảo rằng chế độ bản địa hoá theo khu vực phù hợp được áp dụng cho quốc gia nơi ứng dụng được lưu trữ.

Tham số region chấp nhận giá trị nhận dạng thẻ phụ khu vực Unicode. Các giá trị này (thường) có mối quan hệ tương ứng một-một với Miền cấp cao nhất theo mã quốc gia (ccTLD). Hầu hết các giá trị nhận dạng khu vực Unicode đều giống với mã ISO 3166-1 alpha-2, ngoại trừ một số trường hợp đá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 Google Maps Platform để 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 2 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 đồ khác 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ữ cho bản đồ, bạn cũng cần cân nhắc việc đặt khu vực. Sau đây là một 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.