Google Maps API（Flash 版）开发人员指南

Google Maps API（Flash 版）是一种将交互式 Google 地图添加到网站中的新方式，它使用 Adobe 的 Flash® 插件来显示动态地图内容！该 API 完全可以替代现有的 JavaScript 地图 API，它不但提供了后者的许多功能，而且可以将 Flash 内容和 Google 地图相结合。

Google Maps API（Flash 版）是一种新产品，欢迎您提供宝贵的意见。欢迎您加入 Google Maps API（Flash 版）论坛，给我们提供宝贵的意见。

读者
简介
设置开发环境
获取接口库
获取地图 API 密钥
Google Maps API（Flash 版）的版本管理
教程
读者
此文档适用于熟悉 Flash、ActionScript® 编程和面向对象编程概念的用户。

该文档包含三个独立的教程，介绍了在一种可用的 Flash 开发环境中创建“Hello World”应用程序的过程：

Flex SDK 教程
FlexBuilder® 教程
Flash CS3 教程
所有新的开发人员都应该阅读适合自己的开发环境的教程，其中说明了怎样编写您的第一个 Google 地图 Flash 应用程序。

此外，经过组织，该文档还涵盖以下关键方面：

Google 地图 Flash 基础知识
Google 地图 Flash 事件
Google 地图 Flash 控件
Google 地图 Flash 叠加层
Google 地图 Flash 服务
文档大部分内容是为支持 Flex 开发人员而编写。但是，我们会努力使所有 Flash 开发人员都能使用该文档。

简介
有了 Google Maps API（Flash 版），当前的 Flash 开发人员可以轻松地将 Google 地图集成到现有的 Flash 开发环境中。同时，Google Maps API（Flash 版）为当前不使用 Flash 的开发人员开创了完全交互显示和使用地图内容的先河。

该《开发人员指南》假定您熟悉 Flash 开发和 ActionScript 编程。尽管我们提供适合不同开发环境的教程，但是不确保该指南适用于任何特殊开发环境。

注意：该指南使用类似于 UNIX 的命令行示例和 Macintosh 屏幕截图，但是用法对于其他开发人员来说不会有太大变化，

设置开发环境
Flash 开发可以采用多种形式。有些开发人员/设计者完全在 Flash CS3 应用程序内编写来创建和排列内容，并在该框架内添加 ActionScript。还有些开发人员则使用功能完整的 IDE（例如 Adobe FlexBuilder®）来创建大量使用 ActionScript 的可靠应用程序。有些开发人员使用 Adobe 免费提供的 Flex SDK® 并从命令行构建应用程序。开发环境的选择由您决定。

该文档为全部三种入门方法都提供了教程。但是，该文档集内的代码示例以 MXML 文件形式提供，可在 FlexBuilder 或免费的 Flex SDK 内使用。直接在 Flash CS3 中使用嵌入在这些文件中的 ActionScript 代码，相对来说更直截了当。

Google Maps API（Flash 版）现在支持直接在 Flex 开发环境内支持 Adobe AIR® 应用程序。在 FlexBuilder 教程内查看有关编写 AIR 应用程序的教程。

获取接口库
要开发集成 Google 地图的 Flash 内容，需要在应用程序代码内加入 Google Maps API（Flash 版）接口库。该库由 Google Maps API（Flash 版）SDK 的 lib 目录中 *.swc 文件组成，您可以从下面的网址找到 SDK：

http://maps.googleapis.com/maps/flash/release/sdk.zip

SDK 包含两个 SWC 文件：适合在 FlexBuilder（或者免费的 Flex SDK）中使用的 Flex 版本，和适合在 Flash CS3 中使用的非 Flex 版本。Flex *.swc 的文件名中标有 _flex 后缀。

这些 SWC 文件包含适用于 Google Maps API（Flash 版）开发环境的所有公共类的接口。使用该库编译应用程序，可以确保应用程序能利用运行时 Google Maps API（Flash 版）库的所有公共功能以及与该功能进行通信；无论客户端何时加载您的应用程序，都会从 Google 服务器检索该运行时库。

请注意，实际运行地图 Flash 应用程序的大批代码仍位于单独的运行时 Google Maps API（Flash 版）库内。这样我们便可以添加增强功能、修正错误和修改核心库功能，但不需要您重新编译应用程序。请注意，如果您希望利用需要新接口的新功能，则需要下载更新的 SWC 文件并重新编译应用程序。

接口库文件名包含一个后缀，用于标识它的版本号。例如，map_flex_1_7.swc 标识 Flex 接口库的 1.7 版，而 map_1_7.swc 标识 Flash 接口库的 1.7 版。下载接口库以后，请立即创建开发目录并将该文件放置在该目录的根目录中。

#
#Create a development directory
#
hostname$ mkdir myflashapp
hostname$ cd myflashapp
#
# Copy the Google Maps API for Flash SDK to the root of your working development directory
#
hostname$ cp ~/sdk.zip .
#
# Unzip the SDK. The SWC interface library is located within the "lib" directory
# Offline ASDoc HTML documentation is available within the "docs" directory
#
hostname$ unzip sdk.zip
记录这个目录位置。在开发过程中，当您需要链接到合适的 SWC 文件时，需要这个目录位置。

获取地图 API 密钥
Google Maps API（Flash 版）与 Google JavaScript 地图 API 一样，需要使用可免费获取的开发人员密钥。您需要在以下三个可用的位置之一中指定该密钥。

（对于 Flex 应用程序）特殊的配置文件，称为 MXML 声明
（对于 Flash 应用程序）ActionScript 代码（将密钥编译到生成的 SWF 文件中）
网页中包含的 DOM 元素
请注意，API 密钥编译到 SWF 文件中并且必须和托管 SWF 文件的域匹配，该域没有必要和托管 HTML 文件的位置相同。该文档集介绍了一些 Flex 示例，这些示例在 MXML 声明内定义 API 密钥。

版本管理
Google Maps API（Flash 版）接口库包含 ActionScript 接口，通过这些接口您可以与 Google 运行时库提供的实际组件进行通信。有时，我们会在“后台”更新这些组件。只要接口不发生更改，您就不需要做任何事情。接口 SWC 文件会自动选取最新更改。

如果引入新功能和新特性（并因此需要更新接口），那么还需要更新接口 SWC 文件，我们会提供该文件供用户下载。此类版本会根据版本方案命名。（例如，与“1.3”版关联的接口库会被命名为“map_flex_1_3.swc”。）您需要下载该接口库的新版本，才能使用这些最新特性。您一定要时时留意 Google 地图 API 网上论坛或博客，确保及时了解关于新版本的 Google Maps API（Flash 版）的通知。

通过将地图的 version 属性设置为特定版本，可以将您的应用程序设置为使用 Google Maps API（Flash 版）库的硬编码版本。请注意，这不是推荐操作，因为这样做会导致您不能利用任何增强功能的优点，也无法对当前实现方法修正错误。

教程
以下教程可指导您在偏好的开发环境中使用 Google Maps API（Flash 版）创建示例应用程序：

Flex SDK 教程
FlexBuilder 教程
Flash CS3 教程
尽管比较不同的开发过程对您来说非常有用，但您无需阅读全部三个教程来入门。