Google Maps API
可以让你在你自己的网页上嵌入google地图。要使用这个API,你需要上这里去
http://www.google.com/apis/maps/signup.htm
申请一个API key 并按照下面的说明来做。
这个API是新的,所以以完美的文档的要求来说,它可能会有一些小错误。容忍我们,我们将填补这些漏洞,您可以参加这个
Google Maps API 中文讨论区
http://groups.google.com/group/Goolgle-Map-Chinese
地图讨论组来反馈您的问题并讨论这个API。
正文如下:
介绍:
Google Maps的"helloword"程序
浏览器的选择
XHTML和VML
API更新
地理编码,路径选择等
例子:
最基本的
地图移动和动画
向地图中添加控件
事件监听
打开一个属性窗口
地图叠置
单击操作
在标记上的窗口显示信息
创建图标
使用图标类
在地图上使用XML和异步传输RPC("AJAX")
API 总览
GMap 类(the GMap class)
事件 (Event)
信息窗口(the info window)
叠置(Overlays)
图标和标记(Icons and Markers)
折线(Polylines)
控件(Controls)
XML 和 RPC
类参考
GMap
* Constructor
* Methods
* Configuration
* Controls
* State
* Overlays
* Info Window
* Event
GMarker
* Constructor
* Methods
* Events
GPloyLine
* Constructor
GIcon
* Constructor
* Properties
GEvent
* Static Methods
GXmlHttp
* Static Methods
GXml
* Static Methods
GXslt
* Static Methods
* Methods
GPoint
* Constructor
* Properties
GSize
* Constructor
* Propertes
GBounds
* Constructor
* Properties
简介:
Google Maps 的"hello world"实例
最简单的开始学习这个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="/images/mapsgooglecommapsfileapi&v1&keyabcdefg.js"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="/images/mapsgooglecommapsfileapi&v1&keyabcdefg.js"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"&