Google 地图 API 文档.pdf

地图API文档mlGoogle地图APIGoogleCodeHomeGoogle地图API概念与示例面向的读者简介“HelloWorld”程序浏览器兼容性XHTML和VMLAPI更新地理译码行程规划和本地搜索标注管理示例程序基本操作地图移动及动画给地图添加控件事件处理函数打开气泡提示窗口地图覆盖物单击事件处理给标注增加气泡提示窗口多页的气泡提示窗口创建图标使用图标类可拖拽的标注标注管理器示例天气预报图疑难解答其它资料API概览GMap2事件气泡提示窗口地图覆盖物控件XMLRPC减少浏览器内存泄露演示程序类参考Google地图API基本概念Google地图JavaScriptAPI使您能够将Google地图嵌入到自己的网页中。在使用该API之前，您需要先申请一个APIKey，然后按照如下的指南操作。由于API比较新，其中有可能存在一些不足，另外文档也还不够完美。请您多多包涵，我们会不断进行改进。同时，欢迎您加入地图API讨论组给我们反馈，并且讨论关于API的问题。文档是根据英文版的GoogleMapsAPI版本2编写的。有关英文版GoogleMapsAPI的最新功能，请参见英文版GoogleMapsAPI版文档请注意，为了使用中国的地图数据，您需要使用来自ditu.googleJavaScript代码。

申请APIKey时自动生成的代码缺省指向maps.google。因此，您需要手动将其改为ditu.google。另外，GoogleMapsAPI的某些功能目前还不支持中国。关于Google地图API，请您在Google地图API讨论组讨论交流。如果参与英文MapsAPI讨论组，请说明您使用的是中文版Google地图API，以避免误解。目录PDF文件使用试用版本创建.地图API文档ml编码折线在地图中使用XML和异步HTTP通信(AJAX)自定义地图控件自定义地图覆盖物面向的读者本文档适用于熟悉JavaScript以及面向对象编程概念的读者。另外，从用户的角度，您也应该很熟悉Google地图这个产品。如果您遇到困难，网上有很多JavaScript指南可供参考。简介您的第一个Google地图程序："Hello,World"学习这个API最简单的方法就是从一个简单的例子开始。下面的网页显示一个500x300的地图，中心位于北京的故宫博物院!DOCTYPEhtmlPUBLIC"-//W3C//DTDXHTML1.0Strict//EN""http://.w3/TR/xhtml1/DTD/xhtml1-strict.dtd"htmlxmlns="http://.w3/1999/xhtml"headmetahttp-equiv="content-type"content="text/html;charset=utf-8"/titleGoogle地图JavaScriptAPI示例/titlescriptsrc="http://ditu.google/maps?file=api&v=2&key=abcdefg"type="text/javascript"/scriptscripttype="text/javascript"//![CDATA[functionload()varmapnewGMap2(document.getElementById("map"));map.setCenter(newGLatLng(39.917,116.397),14);/script/headbodyonload="load()"onunload="GUnload()"divid="map"style="width:500px;height:300px"/div/body/html您可以下载这个例子修改并测试，但是您必须用您自己的APIKey代替文件中Key。

（如果您为某个目录注册了APIKey，那么该APIKey也能够在它的任何PDF文件使用试用版本创建.地图API文档ml子目录下使用）。上面的例子中，地址含了在您的页面放置Google地图所需要的所有JavaScript代码。您的页面必须包含指向这个地址的script标记，并加上您的APIKey。例如，如果您的APIKey是"abcdefg"，那么您的script标记应该类似这样：scriptsrc="http://ditu.google/maps?file=api&v=2&key=abcdefg"type="text/javascript"/script表示地图的类是GMap2。这个类代表页面上的单个地图。您可以根据需要创建任意多个该类的实例（一个实例对应页面上的一个地图）。在创建地图实例时，您需要指定一个页面上已命名的元素（通常是div元素）作为地图控件的容器。除非您明确地指定了地图的大小，默认情况下，地图大小会取决于容器的尺浏览器兼容性Google地图API支持的浏览器种类与Google地图网站相同。由于不同的应用程序在遇到不兼容的浏览器的时候需要采取不同的对策，所以地图API提供了一个全局方法（GBrowserIsCompatible()）来检查兼容性。

但是，当该方法发现一个不兼容的浏览器时，它不会自动采取任何措施。中的脚本几乎可以在任何浏览器中解析而不产生错误，所以您可以放心地在检查浏览器兼容性之前就包含该脚本文件。除了上面的第一个例子以外，本文档中的其它例子都不会检查浏览器兼容性，也不会在老的浏览器中显示错误信息。当然，实际的应用程序应该在浏览器不兼时采取一些用户友好的措施。但是，为了让范例代码易读，我们在本文中省略了这种检查。不少应用程序都会不可避免地遇到浏览器或平台兼容性的问题。对于这类问题目前还没有简单的解决方案，但是您可以从Google地图API讨论组quirksmode上找到一些解决技巧。XHTML和VML我们推荐您使用和标准兼容的XHTML页面来包含地图。当浏览器遇到页面顶端DOCTYPE，它们就会用"标准兼容模式"来呈现页面。这种模式下，页面的布局和行为在不同的浏览器间会具有更好的一致性。如果您想在地图中显示折线，您需要在您的XHTML文档中包含VML命名空间和一些CSS代码。请注意：IE浏览器需要它方能正常显示折线。XHTML文档的开头应该类似这样：!DOCTYPEhtmlPUBLIC"-//W3C//DTD XHTML 1.0 Strict// EN" "http://.w3/TR/xhtml1/DTD/xhtml1- strict.dtd" html xmlns="http://.w3/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml" head meta http-equiv="content-type" content="text/ PDF 文件使用 试用版本创建. 地图API 文档 mlhtml; charset=UTF-8"/ title Google地图 /title style type="text/css" /stylescript src="http://ditu.google/ maps?file=api&v=2&key=abcdefg" type="text/javascript"/script /head API 版本更新 地址 部分表明您使用的API 版本号是2。

您可以将它替换为 v=2.x 的形式，从而使用最新 版本的API。但是请注意，最新发布的版本可能并不如 所指向的版本那样稳定。我们大约每两周都会更新Google 地图API 的版本，届时 v=2.x 版本中的 新功能就会作为稳定版本被替换到 所指向的版本中。我们更新SMn版本时，都会给它们一个编号（例如，“版本2.76”）。随着我 API的更新，基于旧版本的API 编写的代码偶尔可能会无法正常工作。如果 您确实要限定您的程序所使用的API 版本，您可以明确地将该版本号包含在 数中（例如，v=2.75 ）。但是，我们不推荐这么做。如果可能，请尽量使您的 产品适应更新的版本。 当我们对API 进行重大升级时，我们会改变版本号并在 Google Code 和地图 API 讨论组上发布相关信息。一个新版本正式发布以后，我们会让新旧版本至少 同时运行一个月，从而使您有足够的时间将代码迁移到新的版本上。 另外，我们会以用户透明的方式更新API 来解决Bug 和提高性能。正常情况 下，这些改动只会修正 Bug 或者提高性能，但是也可能会不经意地影响一些 API 用户的使用。如果您遇到问题，请到地图API 讨论组来向我们反映。