Flash 地圖 API 概念

本文檔設(shè)計用于熟悉 JavaScript 編程、ActionScript編程和面向?qū)ο缶幊谈拍畹娜?。您還應(yīng)從用戶的角度熟悉Mapbar 地圖。網(wǎng)絡(luò)上有許多 JavaScript和ActionScript教程。

本文檔是概念性文檔，不一定完整和詳盡；其目標(biāo)是使您可以很快地開始使用 Mapbar Flash地圖 API 探索和開發(fā)很酷的應(yīng)用程序。我們還發(fā)布了 Mapbar Flash 地圖 API類 參考，該文檔相對比較完整。

• 向前兼容：Flash 地圖 API 向前兼容了Mapbar 地圖 API，并在此基礎(chǔ)上擴(kuò)展了新的功能。
• 渲染效果：比JavaScript版本地圖更炫的渲染效果和地圖動畫。
• 自定義皮膚：地圖疊加物支持自定義皮膚，以達(dá)到您所期望的效果。

如果在此之前您的網(wǎng)站上已經(jīng)嵌入了JavaScript版本地圖，那么只需要做極小的改動就能切換成效果更炫的Flash版本地圖。

開始鉆研 Mapbar Flash 地圖 API 之前，為了確保應(yīng)用程序可以在目標(biāo)平臺上順利運行，應(yīng)注意以下瀏覽器版本以及Flash播放器版本的問題：

• Internet Explorer 6.0 或更高版本。
• Firefox 2.0 或更高版本。
• Mapbar Flash 地圖 API 支持Adobe FlashPlayer 9 播放器環(huán)境，或者更高版本播放器。

Mapbar 地圖盡可能的做到在所有瀏覽器中顯示效果一致，但對于一些問題，因為瀏覽器底層的支持不同，導(dǎo)致某些效果在不同的瀏覽器上顯示略有不同，但我們保證功能是正確的。

好的應(yīng)用程序?qū)⒉豢杀苊庥龅綖g覽器和平臺之間不一致的情況。這些問題沒有簡單的解決方法，通過網(wǎng)絡(luò)查找解決方案不失為一個好辦法，同時，您也可以通過問題反饋將問題提交給我們。

Mapbar API 的引用地址為 http://union.mapbar.com/apis/maps/free?f=fapi&v=31&k=abcdef ，該網(wǎng)址指向包含使用 Mapbar API 所需的參數(shù)信息和定義的 JavaScript 文件的位置。您的頁面必須包含指向此網(wǎng)址的 script 標(biāo)簽，并在參數(shù)中設(shè)置所需的值。

該網(wǎng)址中各參數(shù)含義如下：

• f : 表示您需要使用的 API ， Mapbar 提供的不僅僅是 地圖 API ，除此之外還有 地圖搜索 API 等開發(fā)接口。
• v : 表示您所使用的 API 的版本標(biāo)識，相關(guān) API 版本更新后您可填入其它版本標(biāo)識。
• k : 表示您申請的 API 密鑰。

我們將使用透明方式進(jìn)行當(dāng)前 API 版本的錯誤修訂和性能增強(qiáng)，這些錯誤修訂只會提高性能和修訂錯誤，但我們可能會意外損壞某些 API 客戶端。對于比較嚴(yán)重的錯誤更新記錄我們會發(fā)布在版本更新歷史欄目中。當(dāng) API 發(fā)生重大更新時，我們將更改主版本號，發(fā)生這種情況之前，我們會在 API 文檔首頁的頂部以最明顯的方式通知您。

已發(fā)布的 API 版本我們會一直保留，您可以使用 API 網(wǎng)址中版本標(biāo)識參數(shù)指定您需要使用的API。

地圖 API 中的示例

請注意本文檔中的多數(shù)示例僅顯示相關(guān) JavaScript 代碼，而不顯示整個 HTML 文件?？梢詫?JavaScript 代碼插入自己的框架 HTML 文件，或可以通過單擊示例后的鏈接下載每個示例的完整 HTML 文件。