©2009 Google - Code サイト ホーム - 利用規約 - プライバシー ポリシー - サイト ディレクトリ
Google Code が利用できる言語: English - Español - 日本語 - 한국어 - Português - Pусский - 中文(简体) - 中文(繁體)
| 
日本語 | ログイン
Google Earth API デベロッパー ガイドにようこそ。Google Earth プラグインと Google Earth API を使用すると、皆さんのウェブページにも Google Earth とその 3D レンダリング機能を埋め込むことができます。2D バージョンの Google マップと同じように、3D バージョンにもマーカーや線を描画することができます。
この API は新しいサービスであるため、バグが存在したりドキュメントが完全でないことがあります。Google ではこれらの問題の解決に取り組んでおります。この API について意見を投稿したりディスカッションに参加するには、Google Earth API デベロッパー ヘルプグループをご利用ください。
このドキュメントは、JavaScript のプログラミング概念とオブジェクト指向プログラミングの概念を理解しているデベロッパーを対象にしています。Google Earth API は多くの KML 要素に基づいているため、Google Earth の KML ドキュメントも併せてご覧ください。
このドキュメント内のほとんどの例では、HTML ファイル全体ではなく、関連する JavaScript コードのみを表示しています。これらの JavaScript コードを各自のスケルトン HTML ファイルに挿入したり、http://www.google.co.jp/earth/plugin/examples/samples/index.html からオンラインで多くの例をご利用いただくことができます。
このドキュメント内のほとんどの例では、HTML ファイル全体ではなく、関連する JavaScript コードのみを表示しています。これらの JavaScript コードを各自のスケルトン HTML ファイルに挿入することも、例の後のリンクをクリックして各例の HTML ファイル全体をダウンロードすることもできます。手始めとして、Google Earth プラグインの Sample.html をご利用いただくこともできます。
Google Earth Plug-in API は単独で利用することもできますが、Google Maps API と併せて利用することもできます。Google マップがウェブページにすでに埋め込まれている場合は、オプションで、そのコンテンツを Google マップと Google Earth ブラウザのどちらで表示するかをユーザーが選択するよう機能拡張できます。新しくウェブページを作成し直す必要はありません。たとえば、Google マップを使用するウェブページでは、情報が 2D で表示されています。そこに Google Earth プラグインを組み込むことで、情報を、地形やジオメトリなど多くの Google Earth の特長と併せて 3D で表示できるようになります。
Google Earth Plug-in API をインストールする前に、次のプログラミングに関する注意事項を参照して、アプリケーションがすべての対象プラットフォームで正常に動作することを確認してください。
注: このバージョンの Google Earth プラグインは、Microsoft Windows XP および Vista オペレーティング システムでのみ動作します。その他のオペレーティング システムについては、今後のリリースでサポートを予定しております。
Google Earth プラグインは、現在、次の Microsoft Windows オペレーティング システム上のウェブ ブラウザをサポートしています。
Google Earth プラグインをインストールする方法は次のとおりです。
Google Earth プラグインをアンインストールするには、[スタート] メニューから [Google Earth Plugin]、[Uninstall Google Earth Plugin] の順に選択します。
Samples.html を使用するSamples.html ファイル ( http://www.google.com/earth/plugin/examples/samples/index.html) には、開発に役に立つ JavaScript の例が数多く用意されています。JavaScript コードを表示して、ウェブページから実行することができます。変更は、同じページに表示されている Google Earth ブラウザですぐに確認いただけます。JavaScript コードのテスト用に、このページをご利用ください。
Google Earth プラグインには、サービスの利用を簡単に始められるように、さまざまなサンプル ファイルとテンプレートが用意されています。次の例は、ウェブページに Google Earth ブラウザを埋め込むために使用できる HTML と JavaScript を示しています。アプリケーションを作成する際の足がかりとしてご利用ください。
<html>
<head>
<title>Google</title>
<!-- *** 次のキーを実際の API キーに置き換えます。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>
作成したコードが正常に機能しない場合は、次の方法によって問題を解決してみてください。
Google Earth、KML、Google マップの詳細については、次をご覧ください。