Google Maps API 指南(http://www.econym.demon.co.uk/googlemaps/)

Google Maps API Tutorial

© 2006 Mike Williams

原始网址 http://www.econym.demon.co.uk/googlemaps/

译文作者 kukukuan

为什么我要翻译这个文档？

因为国内除了翻译官方的文档外，我只看见K_Reverter的Step1.cn上有像样的Google map文档。http://www.econym.demon.co.uk/googlemaps/上的文档相当完善，包含了相当多的为公布的方法和参数，非常利于Hack。不过国内好像看不到，而且是英文，所以就动了翻译的心思。以下进入正题...

本指南旨在帮助用户利用Google API构建交互性的Google地图。

在阅读本文之前，请先查看Google官方的API文档。

可以通过以下两种方式使用本文档：

阅读并试图理解其中的原理；

利用示例文件作为模板，将代码拷贝到你自己的网页中，并修改其中的API Key和相应内容。阅读“潜在的陷阱”部分，并尝试避免发生那些错误。

如果你还没有使用javascript的经历，使用Google Map API不是一件轻松的事情。

如果你发觉Google的文档很难理解，那并不是因为那份文档写得很差，而是因为这个主题本身并不容易。

Business For Life Charity

本文档由Community Church Javascript Team提供。

如果您发现本指南有用，请考虑捐助Blackpool Community Church Business For Life Charity。该慈善团体以向个人提供创业机会的途径帮助第三世界国家。

接受Paypal和Credit Card捐助。

兼容性

API版本2除了支持原来版本1文档中的指令（openInfoWindowXslt例外）之外，还提供了新的语法结构。

如果你已经有一个可用的v1版地图，并且没有使用未公开的特性，那么你只需更改API的版本号就能让其正常工作了。

资源

非官方API 2参考 版本2所有可用方法的详细信息

Events API事件，自定义事件和DOM事件

推荐工具 辅助开发Google Map网页的工具

书籍 PHP和Ajax的Google Map应用

已知的BUG列表 我所知的API V2的BUG列表

基础篇

第一节 带信息窗口的标记

第二节 添加一个可点击的侧边栏

第三节 从XML文件加载数据

第四节 获取方位信息

第五节 Onload函数和外部控制

第六节 信息窗口中的图片和链接

第七节 从XML文件加载折线数据

第八节 文章中的地图

第九节 从纯文本文件中加载数据

第十节 分页信息窗口

第十一节 AJAX哲学

第十二节 从JSON文件中加载数据

第十三节 使用GOverviewMapControl()

第十四节 根据数据自动缩放地图

第十五节 更多侧边栏条目

第十六节 关联数组和自定义图标

第十七节 Google Earth图标

第十八节 向Google Maps发送KML文件

第十九节 对地图的Div使用百分比高度

第二十节 使用GMarkerManager管理大量标记

高级篇

第一节 侧边栏鼠标悬浮事件：当鼠标在侧边栏悬停时动态改变图标

第二节 考虑内存泄露

第三节 考虑国际日期变更线

第四节 当鼠标在标记上悬停时显示信息窗口

第五节 双重地图：一组相互监视对方活动的地图

第六节 在标记上添加标准提示。2.50版添加

第七节 在标记上添加自定义提示，方法1

第八节 在标记上添加自定义提示，方法2

第九节 限制地图的缩放和平移范围

第十节 计算直线建距离和获取两点间直线的方向

第十一节 创建自定义标记

第十二节 创建自定义事件

第十三节 调用GIcon.label

第十四节 调用GControlPosition

第十五节 不同色调的地图

第十六节 带箭头的折现

第十七节 带错误处理的地理编码

第十八节 修正inherited CSS错误

第十九节 最大化信息窗口

第二十节 传递和接受参数

自定义地图

第一节 添加您的自定义地图

第二节 扁平的地图和图表：自定义GProjection

第三节 比较发布的Google Tile

第四节 GTileLayerOverlay，KML和多边形

第三方扩展

列表 我所知的API V2第三方扩展

第一节 使用Jef Poskanzer的Clusterer

第二节 使用Tom Mangan的TLabel扩展的简单示例

第四节 使用Jef Poskanzer的OverlayMessage

第五节 使用ELabels

第六节 API V2.59前的动态标签

第七节 使用EInserts

解决问题

当你的网页无法正常工作时，首先检查Javascript的错误报告。在Firefox里，从“工具”菜单启动“javascript控制台”；在IE中，双击状态栏的错误图标。你总能从错误消息中找到一些线索

别忘了去看看相应章节的“潜在的陷阱”。

获取帮助

有很多相关信息，如果需要稍微高级一些的信息，可以去the Mapki看看

您可以在Google Group中寻找类似问题。您也可以在那里寻求帮助，但别忘了贴上问题网页的网址，这样可以增大你获得有效帮助的机会。避免提交大量javascript代码，相比之下网页链接更易让人接受，因为我们能够立刻在上面使用Javascript Debug工具。