本文档设计用于熟悉 JavaScript 编程、ActionScript编程和面向对象编程概念的人。您还应从用户的角度熟悉Mapbar 地图。网络上有许多 JavaScript和ActionScript教程。

本文档是概念性文档，不一定完整和详尽；其目标是使您可以很快地开始使用 Mapbar Flash地图 API 探索和开发很酷的应用程序。我们还发布了 Mapbar Flash 地图 API类 参考，该文档相对比较完整。

• 向前兼容：Flash 地图 API 向前兼容了Mapbar 地图 API，并在此基础上扩展了新的功能。
• 渲染效果：比JavaScript版本地图更炫的渲染效果和地图动画。
• 自定义皮肤：地图叠加物支持自定义皮肤，以达到您所期望的效果。

如果在此之前您的网站上已经嵌入了JavaScript版本地图，那么只需要做极小的改动就能切换成效果更炫的Flash版本地图。

开始钻研 Mapbar Flash 地图 API 之前，为了确保应用程序可以在目标平台上顺利运行，应注意以下浏览器版本以及Flash播放器版本的问题：

• Internet Explorer 6.0 或更高版本。
• Firefox 2.0 或更高版本。
• Mapbar Flash 地图 API 支持Adobe FlashPlayer 9 播放器环境，或者更高版本播放器。

Mapbar 地图尽可能的做到在所有浏览器中显示效果一致，但对于一些问题，因为浏览器底层的支持不同，导致某些效果在不同的浏览器上显示略有不同，但我们保证功能是正确的。

好的应用程序将不可避免遇到浏览器和平台之间不一致的情况。这些问题没有简单的解决方法，通过网络查找解决方案不失为一个好办法，同时，您也可以通过问题反馈将问题提交给我们。

Mapbar API 的引用地址为 http://union.mapbar.com/apis/maps/free?f=fapi&v=31&k=abcdef ，该网址指向包含使用 Mapbar API 所需的参数信息和定义的 JavaScript 文件的位置。您的页面必须包含指向此网址的 script 标签，并在参数中设置所需的值。

该网址中各参数含义如下：

• f : 表示您需要使用的 API ， Mapbar 提供的不仅仅是 地图 API ，除此之外还有 地图搜索 API 等开发接口。
• v : 表示您所使用的 API 的版本标识，相关 API 版本更新后您可填入其它版本标识。
• k : 表示您申请的 API 密钥。

我们将使用透明方式进行当前 API 版本的错误修订和性能增强，这些错误修订只会提高性能和修订错误，但我们可能会意外损坏某些 API 客户端。对于比较严重的错误更新记录我们会发布在版本更新历史栏目中。当 API 发生重大更新时，我们将更改主版本号，发生这种情况之前，我们会在 API 文档首页的顶部以最明显的方式通知您。

已发布的 API 版本我们会一直保留，您可以使用 API 网址中版本标识参数指定您需要使用的API。

地图 API 中的示例

请注意本文档中的多数示例仅显示相关 JavaScript 代码，而不显示整个 HTML 文件。可以将 JavaScript 代码插入自己的框架 HTML 文件，或可以通过单击示例后的链接下载每个示例的完整 HTML 文件。