将地图本地化

您可以通过以下方式为特定国家或地区自定义地图:

  • 更改默认语言设置。
  • 指定区域代码,此代码会根据给定国家或地区改变地图的行为。

语言本地化

默认情况下,在显示文字信息(如控件名称、版权声明、行车路线和地图标签)时,Maps JavaScript API 会使用浏览器中指定的首选语言设置。在大多数情况下,最好遵循浏览器设置。不过,如果您希望 Maps JavaScript API 忽略浏览器的语言设置,可以通过在加载 Maps JavaScript API 代码时向 <script> 标记添加 language 参数来强制浏览器使用特定语言显示信息。

language 参数会影响控件名称、版权声明、行车路线和控件标签的名称,以及服务请求的响应。对服务的影响并不明显。例如,对街道地址进行地理编码时,国家/地区名称会以您请求的语言返回,但其余地址则取决于您要进行地理编码的位置。另一方面,邮政和政治搜索结果会以请求的语言返回。尝试此演示,以在更新 language 参数时尝试地图上的更改。

以下示例以日语显示地图,并将区域设置为日本:

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

查看示例

如果您设置地图语言,请务必同时考虑设置区域。这有助于确保您的应用符合当地法律。

注意:当您按照上述方式加载 API 时,无论用户偏好设置如何,地图都会对所有用户使用日语。 因此,在设置此选项之前,请确保您的确希望如此。

Maps JavaScript API 还支持双向 (Bidi) 文本,即同时包含从左到右 (LTR) 和从右到左 (RTL) 语言的字符。RTL 语言的示例包括阿拉伯语、希伯来语和波斯语。通常,您应通过向网页的 <html> 元素添加 dir='rtl' 来指定要正确呈现的 RTL 语言网页。以下示例呈现了使用阿拉伯语控件的埃及开罗地图:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=EG&language=ar&callback=initMap">
</script>

查看示例

请参阅支持的语言列表。请注意,我们会经常添加新的语言,因此该列表可能并不详尽。

区域本地化

如果您想更改应用以提供不同的地图图块或偏向应用(例如,使地理编码结果偏向于相应区域),请在加载 Maps JavaScript API 代码时向 <script> 标记添加 region 参数。

作为 Maps JavaScript API 应用的开发者,我们建议您始终设置 region 参数,因为设置 region 后,各种服务(例如地点自动补全)往往能够提供更好的结果。 您有责任确保应用托管国家/地区应用了正确的区域本地化,以确保您的应用遵守当地法律。

region 参数接受 Unicode 区域子标记标识符,这些标识符通常与国家/地区代码顶级域名 (ccTLD) 具有一对一的映射关系。除某些明显不同之外,大多数 Unicode 区域标识符与 ISO 3166-1 alpha-2 代码完全相同。例如,英国的 ccTLD 为“uk”(对应于网域 .co.uk),但其区域标识符为“GB”。如需了解受支持的区域,请参阅 Google Maps Platform 覆盖范围详情。 尝试此演示,以在更新 region 参数时尝试地图上的更改。

例如,以下脚本标记将地图本地化到英国:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=GB&callback=initMap">
</script>

以下示例显示了两张地图,一张根据设置为 US(美国)的 region 对“俄亥俄州托莱多”进行地理编码,而另一张根据设置为 ES(西班牙)的 region 对结果进行偏向,结果显示到“西班牙托莱多”。

查看美国示例ES 示例

本地化演示

设置地图语言时,请务必同时设置区域。 此演示可让您以自己选择的语言和区域加载地图。

全屏观看此演示。