Incluye licencia y asistencia para empresas.
El API de Google Maps para Flash proporciona una nueva forma de añadir mapas de Google interactivos a un sitio web mediante el complemento Flash® de Adobe para la visualización de contenido dinámico. Esta API es una alternativa completamente independiente al API de Google Maps para JavaScript existente. Además de ofrecer muchas de las funciones de dicha API, permite combinar contenido Flash con Google Maps.
El API de Google Maps para Flash es nueva, por lo que nos gustaría conocer tu opinión. Te animamos a que lo hagas a través del grupo de debate sobre el API de Google Maps para Flash.
Esta documentación está diseñada para usuarios familiarizados con los conceptos de programación orientada a objetos, la programación con ActionScript® y la programación con Flash.
Contiene tres tutoriales independientes, en los que se trata la creación de una aplicación "Hello, World" en uno de los posibles entornos de desarrollo de Flash:
Todos los desarrolladores nuevos deben leer el tutorial adecuado para su entorno de desarrollo en el que se les explicará cómo crear la primera aplicación Google Maps en Flash.
.Además, esta documentación está organizada en las siguientes áreas clave:
La mayoría de la documentación se centra en temas de ayuda para desarrolladores de Flex. No obstante, nos esforzamos por mantener la documentación para que puedan utilizarla todos los desarrolladores de Flash.
La existencia de una versión Flash del API de Google Maps permite a los desarrolladores de Flash actuales integrar fácilmente Google Maps en sus entornos de desarrollo en Flash existentes. Además, el API de Google Maps para Flash ofrece un completo mundo de posibilidades interactivas para la visualización y el uso de contenido de mapas para aquellos desarrolladores que no utilicen actualmente Flash.
En esta guía del desarrollador se asume que el usuario está familiarizado con el desarrollo en Flash y la programación con ActionScript. No se asume el uso de ningún entorno de desarrollo específico, aunque se proporcionan tutoriales para distintos entornos de desarrollo.
Nota: en esta guía se utilizan ejemplos de línea de comandos para UNIX y capturas de pantalla de Macintosh, aunque no debe existir una diferencia significativa si se utilizan otros sistemas.
El desarrollo en Flash puede realizarse de varias formas. Algunos desarrolladores/diseñadores utilizan únicamente la aplicación Flash CS3 para crear y organizar contenido, y añaden ActionScript a ese framework. Otros desarrolladores utilizan un entorno de desarrollo integrado (IDE) con todas las funciones necesarias como, por ejemplo, Adobe FlexBuilder®, para crear aplicaciones completas con un elevado uso de ActionScript. Algunos desarrolladores utilizan la aplicación gratuita Flex SDK® de Adobe y crean las aplicaciones desde la línea de comandos. Cada desarrollador puede elegir el entorno de desarrollo que desee.
En esta documentación se proporcionan tutoriales para los tres sistemas para que puedas comenzar a trabajar. No obstante, los ejemplos de código que se proporcionan en esta documentación se proporcionarán como archivos MXML, para su uso con FlexBuilder o con la aplicación gratuita Flex SDK. Utilizar directamente en Flash CS3 el código ActionScript incrustado en estos archivos es relativamente sencillo.
El API de Google Maps para Flash es actualmente compatible de forma directa con las aplicaciones Adobe AIR® dentro del entorno de desarrollo Flex. Consulta el tutorial sobre la creación de aplicaciones AIR dentro del tutorial para FlexBuilder.
El desarrollo de contenido Flash que integre Google Maps requiere la inclusión de la biblioteca de interfaces del API de Google Maps para Flash en el código de la aplicación creada. Esta biblioteca consta de un archivo *.swc situado en el directorio lib del kit de desarrollo de software (SDK) del API de Google Maps para Flash disponible en la siguiente URL:
http://maps.googleapis.com/maps/flash/release/sdk.zip
El SDK incluye dos archivos SWC: una versión Flex para utilizarla con FlexBuilder (o con la aplicación gratuita Flex SDK) y una versión no Flex para utilizarla con Flash CS3. La versión Flex del archivo *.swc aparece marcada con el sufijo _flex en el nombre de archivo.
Estos archivos SWC contienen interfaces para todas las clases públicas del entorno de desarrollo del API de Google Maps para Flash. La compilación de una aplicación con esta biblioteca garantiza que se pueda utilizar y comunicar con todas las funciones públicas de la biblioteca del tiempo de ejecución del API de Google Maps para Flash, que se recupera desde los servidores de Google cada vez que un cliente carga la aplicación.
Ten en cuenta que la mayor parte del código utilizado para la ejecución de la aplicación de Google Maps para Flash permanecerá en la biblioteca del tiempo de ejecución del API de Google Maps para Flash independiente. Esto nos permitirá realizar mejoras, solucionar errores y hacer modificaciones en las funciones de la biblioteca principal sin que tengas que volver a compilar la aplicación. Ten en cuenta que si quieres utilizar en alguna ocasión funciones nuevas que requieran nuevas interfaces, tendrás que descargar un archivo SWC actualizado y volver a compilar la aplicación.
El nombre de archivo de la biblioteca de interfaces contiene un sufijo que indica el número de versión. Por ejemplo, map_flex_1_7.swc indica la versión 1.7 de la biblioteca de interfaces de Flex, y map_1_7.swc indica la versión 1.7 de la biblioteca de interfaces de Flash. Cuando hayas descargado la biblioteca de interfaces, crea un directorio de desarrollo y coloca este archivo en la raíz de dicho directorio.
# #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
Anota la ubicación del directorio. La necesitarás cuando tengas que crear un enlace al archivo SWC adecuado durante el desarrollo.
El API de Google Maps para Flash, al igual que el API de Google Maps para JavaScript, requiere el uso de una clave de desarrollador disponible de forma gratuita. Deberás especificar esa clave dentro de una de las tres siguientes ubicaciones:
MXML,Ten en cuenta que la clave del API se compila en el archivo SWF y debe corresponder al dominio en el que se aloje el archivo SWF, que no tiene por qué ser necesariamente la ubicación del archivo HTML alojado. En esta documentación se ofrecen ejemplos de Flex en los que se define la clave del API dentro de las declaraciones MXML.
La biblioteca de interfaces del API de Google Maps para Flash contiene las interfaces de ActionScript que te permitirán comunicarte con los componentes reales proporcionados a través de la biblioteca de tiempos de ejecución de Google. Ocasionalmente, realizaremos actualizaciones técnicas en estos componentes. Mientras las interfaces no cambien, no tendrás que realizar ninguna acción. El archivo SWC de interfaces recopilará automáticamente los cambios más recientes.
Si presentamos nuevas funciones (y, por tanto, es necesario actualizar las interfaces), también será necesario actualizar el archivo SWC de interfaces, que estará disponible para su descarga. A estas versiones se les proporcionará un nombre de acuerdo con el esquema de versiones existente. Por ejemplo, la biblioteca asociada a la versión "1.3" se llamará "map_flex_1_3.swc". Deberás descargar una nueva versión de esta biblioteca de interfaces antes de poder utilizar las funciones más recientes. Asegúrate de consultar el blog o el grupo del API de Google Maps para asegurarte de recibir los anuncios de nuevas versiones del API de Google Maps para Flash.
Si quieres configurar tu aplicación para utilizar una versión predefinida de la biblioteca del API de Google Maps para Flash, puedes establecer la propiedad version de Google Maps en una versión específica. Ten en cuenta que esta acción no se recomienda, ya que no permite utilizar ninguna de las mejoras o correcciones de errores realizadas en la implementación actual.
Los siguientes tutoriales te guiarán por la creación de una aplicación de muestra con el API de Google Maps para Flash en tu entorno de desarrollo favorito:
No es necesario leer los tres tutoriales para comenzar, aunque puede resultar útil comparar los distintos procesos de desarrollo.