一切就绪!

着手开发前,请先阅读我们的开发者文档

激活 Google Maps JavaScript API

为帮助您起步,我们将引导您在 Google Developers Console 中先完成几项任务:

  1. 创建或选择项目
  2. 激活 Google Maps JavaScript API 及相关服务
  3. 创建相应密钥
继续

将地图本地化

可通过下列方式自定义地图,使其适合特定国家或地区:

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

语言本地化

默认情况下,Google Maps JavaScript API 按照浏览器中的指定使用用户首选语言设置来显示文本信息,例如:控件的名称、版权声明、行车路线和地图上的标签。在大多数情况下,最好遵守浏览器的设置。不过,如果想让 Maps JavaScript API 忽略浏览器的语言设置,可通过在加载 Maps JavaScript API 代码时向 <script> 添加一个 language 参数,强制浏览器使用特定语言显示信息。

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

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

查看示例

设置地图的语言时必须同时考虑设置区域。这有助于确保应用遵守当地法律的规定。

:按上面所示方式加载 API 时,无论用户首选项如何,地图都将对所有用户使用日语。因此,在设置此选项之前,请确保您的确希望如此。

Maps JavaScript API 还为包含左至右 (LTR) 和右至左 (RTL) 两种语言字符的双向 (Bidi) 文本提供原生支持。例如,阿拉伯语、希伯来闪族语和现代波斯语就属于 RTL 语言。通常,您应该通过向页面的 <html> 元素添加 dir='rtl',来指定要正确呈现的 RTL 语言页面。下例呈现的是使用阿拉伯语控件显示的埃及开罗地图:

<!DOCTYPE html>
<html dir="rtl">
  <body>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ar&region=EG">
    </script>
  </body>
</html>

查看示例

请参阅支持的语言列表。请注意,经常会有新语言添加进来,所以此列表可能并不详尽。

区域本地化

当您从 maps.googleapis.com 加载 Google Maps JavaScript API 时,它会为应用行为应用倾向于美国的默认偏向。如果想要更改应用,以提供不同的地图图块或为应用设置偏向(例如使地理编码结果偏向特定区域),您可以通过在加载 Maps JavaScript API 代码时向 <script> 标记添加 region 参数来替换此默认行为。

作为 Maps JavaScript API 应用的开发者,您必须确保为托管应用的国家/地区应用正确的区域本地化,从而确保您的应用遵守当地法律。

region 参数接受 Unicode 区域子标记标识符,后者(通常)具有对国家/地区代码顶级域 (ccTLD) 的一对一映射。大多数 Unicode 区域标识符都与 ISO 3166-1 代码一致,但有一些明显例外。例如,英国的 ccTLD 是“uk”(对应于域 .co.uk),但其区域标识符是“GB”。

例如,以下脚本标记针对英国对地图进行了本地化:

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

下面的示例显示了两份地图,一份地图是根据默认区域(美国)将“Toledo”地理编码为“Toledo, Ohio”,另一份地图则是根据 region 的设置值 ES (Spain) 将结果偏向“Toledo, Spain”。

查看美国示例ES 示例

在中国加载 API

Google Maps JavaScript API 在中国境内的服务域名是 http://maps.google.cn。向中国用户提供内容时,请将 https://maps.googleapis.com 替换为 http://maps.google.cn。例如:

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY">
</script>

如果您的应用是特别针对中国用户而开发的,则应同时添加 region 和 language 参数。API 支持将 language 参数的值指定为 zh-CNzh-TW

<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY">
</script>

发送以下问题的反馈:

此网页
Google Maps JavaScript API
Google Maps JavaScript API
需要帮助?请访问我们的支持页面