Inclui licença e suporte para empresas
A API do Google Maps para Flash fornece uma nova maneira de adicionar a interatividade do Google Maps ao seu site, usando o plug-in Flash® da Adobe para exibir conteúdo dinâmico de mapas! Esta API existe como uma alternativa totalmente independente à API do Google Maps para JavaScript existente, e fornece muitos dos recursos dessa API ao mesmo tempo em que adiciona também a capacidade de usar conteúdo Flash no Google Maps.
A API do Google Maps para Flash é nova, por isso gostaríamos de ouvir seus comentários. Incentivamos a sua participação no grupo de discussão da API do Google Maps para Flash para que você faça seus comentários.
Esta documentação foi criada para pessoas que estão familiarizadas com programação em Flash e ActionScript®, além de conceitos de programação orientada a objetos.
Esta documentação contém três tutoriais independentes, abrangendo a criação de um aplicativo "Olá, mundo" em um dos ambientes de desenvolvimento possíveis de Flash:
Todos os novos desenvolvedores devem ler o tutorial apropriado para seu ambiente de desenvolvimento de modo a obter explicações sobre como escrever seu primeiro aplicativo do Google Maps para Flash.
.Além disso, essa documentação está organizada para abranger as seguintes áreas principais:
A maioria da documentação se concentra em oferecer suporte aos desenvolvedores de Flex. No entanto, faremos o possível para que a documentação possa ser usada por todos os desenvolvedores de Flash.
O fornecimento de uma versão em Flash da API do Google Maps permite que os desenvolvedores atuais de Flash integrem facilmente o Google Maps aos seus ambientes de desenvolvimento existentes em Flash. Além disso, a API do Google Maps para Flash abre as portas diante de um mundo de possibilidades interativas para a exibição e uso de conteúdo de mapas para desenvolvedores que, atualmente, não usam Flash.
Este guia do desenvolvedor pressupõe que você esteja familiarizado com o desenvolvimento em Flash e programação em ActionScript. Também não presume o uso de nenhum ambiente de desenvolvimento específico, embora forneça tutoriais para diferentes ambientes.
Observação: Este guia utiliza exemplos de linha de comando semelhantes a UNIX e capturas de tela do Macintosh, embora o uso não deva mudar de forma perceptível para outros desenvolvedores.
O desenvolvimento em Flash pode assumir muitas formas. Alguns desenvolvedores/designers escrevem somente dentro do aplicativo Flash CS3 para criar e organizar o conteúdo e posteriormente adicionam o ActionScript a essa estrutura. Outros desenvolvedores usam um IDE completo como o Adobe FlexBuilder® para criar aplicativos robustos com uso intenso de ActionScript. Alguns desenvolvedores usam o Flex SDK® da Adobe, disponível gratuitamente, e criam seus aplicativos a partir da linha de comando. A escolha do ambiente de desenvolvimento é toda sua.
Esta documentação fornecerá tutoriais para os três métodos de modo a auxiliá-lo. No entanto, os exemplos de código dessa documentação serão fornecidos como arquivos MXML, para uso no FlexBuilder ou no Flex SDK gratuito. É relativamente simples usar o código ActionScript incorporado nesses arquivos diretamente no Flash CS3.
A API do Google Maps para Flash agora suporta diretamente aplicativos Adobe AIR® no ambiente de desenvolvimento Flex. Consulte o tutorial para criação de aplicativos AIR no Tutorial do FlexBuilder.
O desenvolvimento do conteúdo em Flash que integra o Google Maps exige a inclusão de uma biblioteca de interfaces da API do Google Maps para Flash no código do seu aplicativo. Essa biblioteca é composta por um arquivo *.swc dentro do diretório lib da API do Google Maps para Flash SDK disponível no seguinte URL:
http://maps.googleapis.com/maps/flash/release/sdk.zip
O SDK inclui dois arquivos SWC: uma versão em Flex para uso no FlexBuilder (ou com o Flex SDK gratuito) e uma versão que não é em Flex para uso no Flash CS3. O Flex *.swc é indicado com um sufixo _flex no nome do arquivo.
Esses arquivos SWC contêm interfaces para todas as classes públicas do ambiente de desenvolvimento da API do Google Maps para Flash. A compilação do seu aplicativo com essa biblioteca garante a utilização e comunicação com toda a funcionalidade pública da biblioteca de tempo de execução da API do Google Maps para Flash, que é recuperada dos servidores do Google sempre que um cliente carrega seu aplicativo.
A maior parte do código para a execução real do seu aplicativo em Flash para o Google Maps permanece na biblioteca de tempo de execução separada da API do Google Maps para Flash. Isso permite a realização de aprimoramentos, a correção de bugs e modificações na funcionalidade básica da biblioteca sem que seja necessário recompilar seu aplicativo. Se você quiser usar uma nova funcionalidade que exija novas interfaces, será necessário fazer o download de um arquivo SWC atualizado e recompilar seu aplicativo.
O nome do arquivo da biblioteca de interfaces contém um sufixo identificando o número de sua versão. Por exemplo, map_flex_1_7.swc identifica a versão 1.7 da biblioteca de interfaces do Flex, enquanto map_1_7.swc identifica a versão 1.7 da biblioteca de interfaces do Flash. Após o download da biblioteca de interfaces, crie um diretório de desenvolvimento e coloque esse arquivo na raiz do diretório.
# #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
Anote o local desse diretório. Ele será necessário quando você precisar vincular o arquivo SWC adequado durante o desenvolvimento.
A API do Google Maps para Flash, assim como a API do Google Maps para JavaScript, exige o uso de uma chave de desenvolvedor disponível gratuitamente. Será necessário especificar essa chave em um dos três locais possíveis:
|
MXMLA chave de API é compilada no arquivo SWF e deve corresponder ao domínio no qual o arquivo SWF está hospedado, que talvez não seja necessariamente o local do arquivo HTML hospedado. Este conjunto de documentos mostrará exemplos de Flex definindo a chave de API em declarações MXML.
A biblioteca de interfaces da API do Google Maps para Flash contém as interfaces de ActionScript que permitem a comunicação com os componentes reais fornecidos por meio da biblioteca de tempo de execução do Google. Ocasionalmente, faremos atualizações não aparentes nesses componentes. Desde que as interfaces não sejam alteradas, você não precisará fazer nada. O arquivo SWC da interface obterá automaticamente as alterações mais recentes.
Se introduzirmos novas funcionalidades e recursos (e for necessário atualizar as interfaces), também precisaremos atualizar o arquivo SWC da interface, que será disponibilizado para download. Essas versões serão nomeadas de acordo com o esquema da versão. Por exemplo, a biblioteca de interfaces associada à versão "1.3" terá o nome "map_flex_1_3.swc." Será necessário fazer download de uma nova versão dessa biblioteca de interfaces antes de usar os recursos mais recentes. Acompanhe o grupo ou blog da API do Google Maps para garantir que você receba anúncios sobre novas versões da API do Google Maps para Flash.
É possível definir que seu aplicativo use uma versão de código rígido da biblioteca da API do Maps para Flash configurando a propriedade version do Google Maps para uma versão específica. Isso não é recomendado, pois você não será beneficiado por quaisquer aprimoramentos ou correções de bugs na implementação atual.
Os seguintes tutoriais o orientam na criação de um aplicativo de exemplo usando a API do Google Maps para Flash no ambiente de desenvolvimento de sua preferência:
Não é necessário ler os três tutoriais para começar, embora seja útil para comparar os diferentes processos de desenvolvimento.