Google 地球 API

注册以获取 Google 地图 API 密钥

Google 地球 API
- 开发者指南
  - 基础主题
  - 高级主题

Google 地球 API 开发者指南

欢迎使用 Google 地球 API 开发者文档。通过使用 Google 地球插件及其 API，您可以在网页中嵌入全功能的 Google 地球及其三维呈现功能。您可以像在二维的 Google 地图上一样，在三维版本上绘制标记和线条。

由于是全新的 API，所以可能会存在缺陷，文档也不尽完美。与我们一起努力使其日臻完善吧！请加入 Google 地球 API 开发者论坛，提供反馈意见并参与 API 的讨论。

目标受众

本文档专门针对熟悉 JavaScript 编程和面向对象的程序设计概念的人员而设计。Google 地球 API 是以多种 KML 元素为基础，因此请参阅 Google 地球 KML 文档。

Google 地球插件 API 中的示例

本文档中的大多数示例仅显示了相关的 JavaScript 代码，并未显示完整的 HTML 文件。您可以将 JavaScript 代码植入自己的 HTML 框架文件，也可以在线查看示例 http://www.google.com/earth/plugin/examples/samples/index.html。

本文档中的大多数示例仅显示了相关的 JavaScript 代码，并未显示完整的 HTML 文件。您可以将 JavaScript 代码植入自己的 HTML 框架文件，也可以点击每个示例后面的链接，下载完整的 HTML 文件。Google 地球插件自带的 Sample.html 文件也可作为开始的基点。

Google 地球插件 API 简介

您可以单独使用 Google 地球插件 API，也可以将其同 Google 地图 API 结合使用。如果您的网页中嵌入了 Google 地图，您可以让用户选择在 Google 地图中还是在 Google 地球浏览器中查看内容来对网页进行增效。您可以在同一网页上执行该操作。例如，Google 地图网页以二维展示信息。集成 Google 地球插件后，用户可以选择以三维模式显示信息，而且还可以观看到地形、几何图案及其他众多的 Google 地球独有的功能。

安装插件

在安装 Google 地球插件 API 之前，请阅读以下编程注释，以确保您的应用程序能够跨平台工作。

注释：本版本的 Google 地球插件仅支持 Microsoft Windows XP 和 Vista 操作系统。对其他操作系统的支持计划在未来版本中实现。

Google 地球插件当前支持 Microsoft Windows 操作系统上的下列浏览器：

IE 6.0+
IE 7.0+
Firefox 2.x 或 2.0x（将很快能够支持 Firefox 3.0）
Netscape 7.1+
Mozilla 1.4+
Flock 1.0+

要安装 Google 地球插件：

注册以获取 Google 地图 API 密钥。
下载并运行 Google 地球插件安装程序。
默认情况下，插件及相关文件会安装在 C:\Program Files\Google Earth Plugin

卸载 Google 地球插件

要卸载 Google 地球插件，请从开始菜单选择 Google 地球插件 ，然后选择卸载。

使用 `Samples.html`

Samples.html 文件 (http://www.google.com/earth/plugins/examples/samples/index.html) 包含很多有用的 JavaScript 示例。您可以看到 JavaScript 代码，并可从网页上直接运行这些代码。在页面上可以立即看到 Google 地球浏览器中的变化。使用该页面来测试您的 JavaScript 代码。

在网页中嵌入 Google 地球

Google 地球插件中包含了若干示例文件以及入门使用的模板。以下示例显示了用于在网页中嵌入 Google 地球浏览器的 HTML 和 JavaScript。您可以根据以下示例创建自己的应用程序。

<html>
<head>
  <title>Google</title>
<!-- *** 使用您自己的 API 密钥替换下面的密钥（要获取密钥，请访问 http://code.google.com/apis/maps/signup.html） *** -->
  <script type="text/javascript" src="http://maps.google.com/maps?file=api&v=2&key=abcdefg"></script>
  <script type="text/javascript">
google.load("earth", "1");
google.load("maps", "2.99");  // 用于 JS 地理编码器

var ge = null;
var geocoder;

function el(e) { return document.getElementById(e); }

function init() {
  geocoder = new GClientGeocoder();
  google.earth.createInstance("map3d", initCB, failureCB);
}

function initCB(object) {
  ge = object;
  ge.getWindow().setVisibility(true);
}

function failureCB(object) {
  alert('未能加载');
}

function submitLocation() {
  var address = el('address').value;
  geocoder.getLatLng(
    address, 
    function(point) {
      if (point && ge != null) {
        var la = ge.createLookAt('');     
        la.set(point.y, point.x, 100, ge.ALTITUDE_RELATIVE_TO_GROUND, 
               0, 0, 4000);
        ge.getView().setAbstractView(la);
      }
    }
  );
}

  </script>
</head>
<body onload='init()' id='body'>
  <div style='background:#ffe6e6; font-weight:bold; font-size: 16pt; font-family: arial;'>
    <center>Google 机密</center>

  </div>

  <div>
    <form name='searchform' id='searchform' action='javascript:submitLocation();void(0);'>
      <input type=text size=60 id='address'></input>
      <input type=submit value='转到位置'>
    </form>
  </div>

  <div id='map3d_container' style='border: 1px solid silver; height: 500px;'>

    <div id='map3d' style='height: 100%;'></div>
  </div>
</body>
</html>

故障排除

如果您的代码不能正常工作，可尝试通过以下方法解决问题：

确认 API 密钥是否有效。
检查有无拼写错误。注意，JavaScript 区分大小写。
使用 JavaScript 调试工具。在 Firefox 中，您可以使用 JavaScript 控制台、 Venkman Debugger 或 Firebug 插件。在 IE 中，您可以使用 Microsoft Script Debugger。此处的Screencast 系列演示了如何使用各种调试工具。
搜索开发者论坛。如果未找到能够回答您问题的帖子，请将您的问题张贴到论坛并附上问题演示网页的链接。
有关开发人员资源的更多信息，请查看更多资源。


例如，“ajax api”或“开源”

Google 地球 API