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

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

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

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

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

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

Ví dụ sau đây hiển thị một 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>

Chế độ xem ví dụ.

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

Lưu ý: Khi bạn tải API theo cách nêu trên, map 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 là gì. Hãy chắc chắn rằng bạn muốn hành vi này trước khi đặt tùy chọn này.

API JavaScript của Maps cũng hỗ trợ hai chiều Văn bản (Bidi) chứa các ký tự ở cả từ trái sang phải (LTR) và từ phải sang trái (RTL) vốn có. Ví dụ về các ngôn ngữ từ phải sang trái 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 ngôn ngữ RTL để sẽ hiển thị chính xác bằng cách thêm dir='rtl' vào thẻ Phần tử <html>. Ví dụ sau đây kết xuất bản đồ của Cairo, Ai Cập sử dụng các chế độ kiểm soát bằng 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 các tiện ích được hỗ trợ ngôn ngữ. Xin lưu ý rằng các ngôn ngữ mới được thêm thường xuyên, vì vậy, danh sách này có thể không đầy đủ hơn.

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

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

Với tư cách là nhà phát triển API Maps JavaScript bạn nên luôn đặt thông số region làm nhiều dịch vụ (chẳng hạn như tính năng Tự động hoàn thành của địa điểm) thường mang lại 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 địa phương bằng cách đảm bảo rằng bản địa hoá khu vực chính xác được áp dụng cho quốc gia mà đơn đăng ký được lưu trữ.

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

Ví dụ: thẻ tập lệnh sau đã bản địa hoá bản đồ thành Hoa Kỳ Vương quốc:

<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 thể hiện hai bản đồ, một bản đồ được mã hoá địa lý "Toledo" dựa trên một region được đặt thành US (Hoa Kỳ) thành "Toledo, Ohio" và một kết quả sai lệch dựa trên region được đặt thành ES (Tây Ban Nha) thành "Toledo, Tây Ban Nha."

Xem Hoa Kỳ và ES ví dụ.

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

Khi đặt ngôn ngữ cho bản đồ, bạn cũng cần xem xét đặt cả khu vực. Đây là bản minh hoạ cho phép bạn tải bản đồ bằng lựa chọn ngôn ngữ và khu vực của mình.

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