最简单的开始学习这个API的方法是看一个简单的例子。。这个网页显示了以Palo
Alto为中心的一个300×300的地图
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Google Maps JavaScript API Example - simple</title>
<script
src="http://maps.google.com/maps?file=api&v=1&key=abcdefg"type="text/javascript"></script>
</head>
<body>
<div id="map" style="width: 300px; height: 300px"></div>
<script type="text/javascript">
//<![CDATA[
if (GBrowserIsCompatible()) {
var map = new GMap(document.getElementById("map"));
map.centerAndZoom(new GPoint(-122.141944, 37.441944), 4);
}
//]]>
</script>
</body>
</html>
你可以把这个例子下载下来并编辑和测试它,但是你需要将"abcdefg"替换成你自己的Maps
API key,让这个例子能在你自己的网站上运行。
正如你在上面的例子中所看到的,Google
Maps引入了一个简单的javascript
url(http://maps.google.com/maps?file=api&v=1),这个url包含了所有的在你的网页上创建地图的所需要的标记和符号。要使用Google
Maps
Api,你需要去创建一个简单的script标记来指向这个url,当然要加上你从google那里申请来的这个API的key。
<script
src="http://maps.google.com/maps?file=api&v=1&key=abcdefg"type="text/javascript"></script>
Google Maps
API输出的最主要的类是GMap类,它表现了一个网页上的简单的地图。你可以创建更多的这个类的实例(每个实例来表网页上的一个地图)。地图被嵌入到一个容器­-中,一般是一个div元素。
操纵和叠置图层到地图实例的方法会在下面详细介绍。
浏览器兼容性
Google Maps并不对所有的浏览器兼容。现在Google
Maps支持的浏览器版本有Firefox/Mozilla,IE5.5以上版本,Safari1.2以上版本部分支持Opera。它不支持IE5.0。由于不­-同的应用要求用户对不同的浏览器作不同的操作,Maps
API提供了一个globle
方法(GBrowserIsCompatible())来检查兼容性,但是它没有任何自动的针对不同浏览器的行为。
脚本http://maps.google.com/maps?file=api&v=1将在几乎所有的浏览器上被正确解析,所以你可以在检查兼容性之前安全地将这个脚本引入进来。
除了上面的例子检测了兼容性外,本文档中的所有例子都没有检测兼容性,对于老的浏览器,他们也不会提示任何信息。显然,真正的应用中应该将事情做得更好,但是我­-们忽略了这些检查来让我们的例子更容易读。
XHTML 和 VML
我们推荐您再包含地图的网页上使用符合标准的XHTML。当浏览器检测到在页首的DOCTYPE标签时,它们将使用符合标准的模式来执行你的网页,这样可以使得­-在不同的浏览器上的布局和行为更加的可预料一些。
同样的,如果你在你的地图上要包含PLOYLINE,对于IE浏览器你需要在你的XHTML文档中引入VML名称空间。你的HTML文档应该这样开始:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html
xmlns="http://www.w3.org/1999/xhtml"xmlns:v="urn:schemas-microsoft-com:vml">
<head>
<style type="text/css">
v\:* {
behavior:url(#default#VML);
}
</style>
<script
src="http://maps.google.com/maps?file=api&v=1&key=abcdefg"type="text/javascript"></script>
</head>
查看Microsoft VML workshop可以得到更多信息。
API 的更新
URl
http://maps.google.com/maps?file=api&v=1代表API的‘1.0‘版本。当我们要对这个API作出重大更新的时候,我们将增加版本号并在GOOGLE
CODE和MAP API讨论


