多语言地图 最后更新时间: 2026年03月26日

本文介绍如何使用 JS API 创建多语言地图，包括：

1. 配置英文地图，并设置左下角 Logo 的显示语言
2. 配置比例尺控件的国际化能力（语言与公制/英制单位）

英文图面效果展示

1、英文地图

1.1 准备

1.2 图面展示

请确保你的 Key 已授权多语言地图权限，在地图初始化时，配置languageCode参数即可展示多语言地图图面。下面以英文地图为例：

const map = new AMap.Map("container", {
  viewMode: "3D", //默认使用 2D 模式
  zoom: 11, //地图级别
  languageCode:"en", //设置语言
});

JS API 除了支持英文地图外，还提供了多国语言地图展示，目前已支持包括法语、日语、韩语等在内的 14 种语言。具体语言类型及配置请参考下方参数列表。

1.3 配置左下角 Logo 的显示语言

创建地图时支持通过logoLanguage控制左下角 Logo 语言版本。

const map = new AMap.Map("container", {
  viewMode: "3D", //默认使用 2D 模式
  zoom: 11, //地图级别
  languageCode:"en", //设置语言
  logoLanguage: 'en', //设置logo语言 默认:"zh"（简体中文），可选："en"（英文）
});

2、比例尺控件国际化

本节介绍如何对比例尺控件（AMap.Scale）进行国际化配置，确保在不同语言与使用习惯下，比例尺的单位与显示效果符合预期，包括：

1. 多语言文本切换
2. 公制/英制单位类型切换
3. 配置高对比度描边（提升复杂底图下的可读性）

2.1 创建地图

const map = new AMap.Map("container", {
  zoom: 10, // Initialize map zoom level
  center: [103.804246, 1.400204], 
  showOversea: true,
  logoLanguage: "en",
  languageCode: "en",
});

2.2 多语言文本切换

• 初始化配置：在创建比例尺控件（AMap.Scale）时，通过languageCode参数指定文本语言。下面以英文为例：

map.plugin(["AMap.Scale"], function () {
  scaleControl = new AMap.Scale({
    languageCode: "en", //配置比例尺控件为英文
  });
  map.addControl(scaleControl);
});

• 运行时切换：通过setLanguageCode()方法，可动态更新比例尺语言设置：

scaleControl.setLanguageCode('en');// 切换到英文

scaleControl.getLanguageCode(); // 获取当前语言代码

比例尺控件除了支持英文显示外，还提供了多国语言展示，具体语言类型及配置请参考下方参数列表。

2.3 公制/英制单位切换

• 初始化配置：在创建比例尺控件（AMap.Scale）时，通过unit参数指定单位类型

map.plugin(["AMap.Scale"], function () {
  scaleControl = new AMap.Scale({
    unit: 'imperial', //配置比例尺控件展示单位，默认:"metric"（公制单位），可选："imperial"（英制单位）
  });
  map.addControl(scaleControl);
});

• 运行时切换：通过setUnit()方法，可动态更新比例尺单位类型设置：

scaleControl.setUnit('imperial'); // 切换到英制

scaleControl.getUnit(); // 获取当前单位类型

2.4 配置高对比度描边

• 初始化配置：在创建比例尺控件（AMap.Scale）时，通过highContrast参数指定是否添加描边

map.plugin(["AMap.Scale"], function () {
  scaleControl = new AMap.Scale({
    highContrast: true, //默认: false 无描边
  });
  map.addControl(scaleControl);
});

• 运行时切换：通过setHighContrast()方法，可动态更新比例尺是否添加描边：

scaleControl.setHighContrast(true); // 添加描边

scaleControl.getHighContrast(); // 获取当前是否添加描边

3、本章涉及的属性及方法说明

3.1 AMap.Map

3.2 AMap.Scale