お気に入り | 日本語 | ログイン

Google Maps API for Flash デベロッパー ガイド

Google Maps API for Flash は、インタラクティブな Google マップを Web サイトに追加するための新しい方法で、Adobe の Flash® プラグインを使って動的なマップ コンテンツを表示します。この API は完全に独立しており、既存の JavaScript Maps API に代わりに使用できます。既存の API のほとんどの機能の他に、Google マップと Flash コンテンツを組み合わせことができる機能が追加されています。

Google Maps API for Flash は新しい API です。みなさまからのご意見をお待ちしております。ご意見をお寄せいただく場合は、Maps API for Flash ディスカッション グループに参加されることをお勧めします。

  1. 対象読者
  2. 概要
  3. 開発環境を設定する
    1. インターフェース ライブラリを取得する
    2. Maps API キーを取得する
  4. Google Maps API for Flash のバージョニング
  5. チュートリアル

対象読者

このドキュメントは、Flash、ActionScript® のプログラミングとオブジェクト指向プログラミングの概念を理解している読者を対象にしています。

このドキュメントは、いずれかの Flash 開発環境で「Hello World」アプリケーションを作成する方法を説明する 3 つの独立したチュートリアルで構成されています。

初めて Google Maps Flash アプリケーションを記述するデベロッパーは、ご自分の開発環境に合ったチュートリアルをお読みください。

さらに、このドキュメントは次の主要分野を含んでいます。

このドキュメントは、主に Flex デベロッパー向けの内容になっていますが、すべての Flash デベロッパーにもご利用いただけるようにしたいと考えています。

はじめに

Google Maps API の Flash 版を使用すると、現在 Flash 開発を行っているデベロッパーは、既存の Flash 開発環境に Google マップを簡単に統合できるようになります。同様に、現在 Flash を使用していないデベロッパーは、Google Maps API for Flash を使用することで、マップ コンテンツの表示と使用にインタラクティブな可能性が広がります。

このデベロッパー ガイドは、Flash 開発と ActionScript プログラミングを理解していることを前提としています。また、さまざまな開発環境を対象としたチュートリアルを用意していますが、特定の開発環境の使用は前提としていません。

注: このガイドは、UNIX に似たコマンドライン例と Macintosh のスクリーンショットを使用していますが、他のデベロッパーにとって用法が大きく異なるわけではありません。

開発環境を設定する

Flash 開発はさまざまな形式を取ることができます。コンテンツの作成と調整に Flash CS3 アプリケーション内のみでオーサリングし、そのフレームワーク内に ActionScript を追加するデベロッパー/設計者もいます。Adobe FlexBuilder® のようなフル機能の IDE を使用して、ActionScript をふんだんに使用した堅固なアプリケーションを作成するデベロッパーもいます。また、Adobe から無料で入手できる Flex SDK® を使用して、アプリケーションをコマンドラインから構築するデベロッパーもいます。お好みの開発環境をご使用ください。

このドキュメントは、3 つの方法のすべてにチュートリアルを提供しています。ただし、このドキュメントにあるコードサンプルは、FlexBuilder または無料の Flex SDK で使用できるように MXML ファイルとなっています。これらのファイルに埋め込まれた ActionScript コードを、直接 Flash CS3 に使用するのはどちらかと言えば単純です。

現在、Google Maps API for Flash は、Flex 開発環境での Adobe AIR® アプリケーションを、直接サポートするようになっています。FlexBuilder チュートリアル内の、AIR アプリケーションのオーサリングのチュートリアルを確認してください。

インターフェース ライブラリを取得する

Google マップを統合する Flash コンテンツの開発には、アプリケーション コード内に Google Maps API for Flash インターフェース ライブラリを含んでいる必要があります。このライブラリは、Maps API for Flash SDK の lib ディレクトリにある *.swc ファイルを含んでいます。ファイルは次の URL から入手可能です。

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

SDK には、FlexBuilder (または無料の Flex SDK) で使用する Flex 版と Flash CS3 で使用する非 Flex 版の 2 つの SWC ファイルが含まれます。Flex *.swc は、ファイル名にある _flex の接尾辞で表されます。

これらの SWC ファイルには、Google Maps API for Flash 開発環境のすべての公開クラス用のインターフェースが含まれます。このライブラリとアプリケーションをコンパイルすると、ランタイム Google Maps API for Flash ライブラリのすべての公開機能を活用し通信できるようになります。ランタイム Google Maps API for Flash ライブラリは、クライアントがアプリケーションをロードするたびに Google サーバーから取り込まれます。

実際に Maps Flash アプリケーションを実行しているコードの大部分は、別のランタイム Google Maps API for 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 ファイルにリンクするときに必要になります。

Maps API キーを取得する

Google Maps API for Flash は、Google JavaScript Maps API と同様に、無料で入手できるデベロッパー キーを使用する必要があります。このキーを、3 つのうちいずれかのロケーションで特定してください。

  • (Flex アプリケーションでは) MXML 宣言と呼ばれる特殊な設定ファイル
  • (Flash アプリケーションでは) あなたの ActionScript コード (処理後の SWF ファイルにコンパイルします)
  • あなたの Web ページにある親 DOM 要素

API キーは SWF ファイルにコンパイルされ、SWF ファイルがホストされているドメインと一致する必要があります。ただし、HTML ファイルのホスト場所である必要はありません。このドキュメントセットは、MXML 宣言にある API キーを定義する Flex の例を示します。

バージョニング

Google Maps API for Flash インターフェース ライブラリは、Google のランタイム ライブラリが提供する実際のコンポーネントと通信できるようになる、ActionScript インターフェースを含みます。時々、これらのコンポーネントを「裏側から」更新する場合があります。インターフェースに変更がない限り、何もする必要はありません。インターフェース SWC ファイルは、自動的に最新の変更に更新します。

新しい機能を導入する場合 (そのためにインターフェースの更新が必要になる場合)、SWC ファイルも更新する必要がありますので、ダウンロードしてください。これらのバージョンは、バージョン スキームに従って名前が付けられます (たとえば、バージョン「1.3」に関連付けられたインターフェース ライブラリは、「map_flex_1_3.swc」という名前になります)。最新の機能を使用するには、インターフェース ライブラリの最新バージョンをダウンロードする必要があります。Google Maps API グループまたはブログを定期的にチェックし、最新バージョンの Google Maps API for Flash の通知を取得するようにしてください。

アプリケーションが Maps API for Flash ライブラリのハードコードされたバージョンを使用するように設定するには、地図の version プロパティを特定のバージョンに設定してください。この設定を行うと現在の実装に対する拡張強化またはバグ修正を利用できなくなるため、推奨されていません。ご注意ください。

チュートリアル

次のチュートリアルでは、お好みの開発環境で Google Maps API for Flash を使用したアプリケーションのサンプルを作成する方法を説明します。

開始するためにすべてのチュートリアルを読む必要はありませんが、異なる開発プロセスを比較するのに役立つでしょう。