本文檔設計用于熟悉 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 文件。