Google 地图 - 本地化

Google Maps - 本地化

默认情况下，Google Maps 会根据用户偏好的语言设置（通常由浏览器设置决定）或英文显示地点名称、标签和用户界面控件（UI controls）。本地化允许您明确设置地图的语言和区域格式。

为何进行本地化？

• 用户体验： 以用户的母语呈现地图，能提高可用性和舒适度。
• 一致性： 确保地图语言与您的网站或应用程序语言保持一致。
• 区域相关性： （通过使用 region 参数）可以根据区域视角影响某些边界或地点名称的显示方式。

如何进行本地化

加载 Maps JavaScript API 时，通过向脚本 URL 添加参数来配置本地化：

• language 参数： 指定用于标签、控件和文本信息的语言。使用 BCP 47 语言代码（例如，ja 代表日语，es 代表西班牙语，zh-CN 代表简体中文）。
• region 参数： 指定区域偏好（可选）。使用两位数的 ISO 3166-1 Alpha-2 国家/地区代码（例如，JP 代表日本，ES 代表西班牙，CN 代表中国）。这主要影响：

• - 地图瓦片如何偏向于该区域内的特征。

• - 使用 Geocoding 等外部服务的应用程序的行为（将结果偏向于该区域）。

示例：加载 API 以显示日语 (ja) 在日本 (JP) 的地图

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

示例：加载 API 以显示西班牙语 (es)，不指定特定区域偏好

<script
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&v=weekly&language=es"
  async defer>
</script>

支持的语言

Google Maps 支持多种语言。有关完整、最新的列表，请参阅官方文档：

• 支持的语言列表

如果指定了一种语言，但在特定区域的地图瓦片中未能完全支持，API 可能会回退到一种密切相关的语言或默认语言（英语）。

示例：显示本地化为简体中文的地图

此示例加载一个以北京为中心的地图，明确请求简体中文语言和中国区域。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Localized Map (Chinese)</title>
    <style>#map { height: 400px; width: 100%; } html, body { height: 100%; margin: 0; padding: 0; }</style>
</head>
<body>
    <div id="map"></div>
    <script>
        async function initMap() {
            const position = { lat: 39.9042, lng: 116.4074 }; // Beijing
            const { Map } = await google.maps.importLibrary("maps");

            const map = new Map(document.getElementById("map"), {
                center: position,
                zoom: 11,
                mapId: "DEMO_MAP_ID",
                mapTypeId: 'roadmap'
            });
        }
    </script>
    <!-- Load API with language and region -->
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&v=weekly&language=zh-CN&region=CN" async defer></script>
</body>
</html>

预期输出：一个北京地图，其中的地点名称（例如“北京市”）、用户界面控件（例如缩放按钮）和版权信息都显示为简体中文。

重要注意事项

• 从右到左 (RTL) 语言： 当指定时，API 会自动处理阿拉伯语 (ar) 或希伯来语 (iw) 等 RTL 语言的布局调整。
• 内容： 本地化仅影响 Google 提供的文本（标签、控件）。您添加的任何自定义内容（例如在 InfoWindows 中）需要在您的应用程序中单独进行翻译。
• 测试： 始终测试您选择的语言/区域组合，以确保其行为符合预期，特别是在地点名称和区域细微差别方面。

延伸阅读：

• 本地化的官方文档