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, API JavaScript của Maps sử dụng chế độ cài đặt ngôn ngữ ưu tiên của người dùng 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 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 lái xe và nhãn điều khiển, 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ề chính trị và bưu chính 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 đồ, thì bạn cũng nên cân nhắc việc đặt khu vực too. Đ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 được trình bày ở 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 rằng bạn muốn hành vi này trước khi đặt lựa 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 phả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 ngôn ngữ RTL để 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 hiển thị bản đồ của Cairo, Ai Cập bằng các chế độ đ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 các 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á 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 API JavaScript của Maps , bạn nên luôn đặt tham số region vì nhiều dịch vụ (chẳng hạn như 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 địa hoá khu vực chính xác được áp dụng cho quốc gia nơi ứng dụng được lưu trữ.

Tham số region chấp nhận các mã nhận dạng thẻ phụ khu vực Unicode (thường) có mối quan hệ 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 mã nhận dạng khu vực Unicode đều giống với mã ISO 3166-1 alpha-2, với 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 mã nhận dạng khu vực là "GB". Xem Thông tin chi tiết về phạm vi cung cấp của Google Maps Platform cho 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 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 một 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 một 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 đồ, thì bạn cũng nên cân nhắc việc đặt khu vực. Sau đâ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.