Guía para Desarrolladores de La Versión 2 Del API de Google Static Maps

19/05/13
Gua para desarrolladores de la versin 2 del API de Google Static Maps - API de imgenes de Google Maps Google Developers
[email protected] Sign out
Google Maps Jobs X
Buscar
Inicio
Productos
Conferencias
Escaparate
Live
Grupos
API de imgenes de Google Maps

Google Static Maps Street View ---------Versin 3 del API de JavaScript de Google Maps API de Google Maps for Business Servicios web del API de Google Maps API de Google Places API de Google Earth API obsoletas
Comentar este documento
Gua para desarrolladores de la versin 2 del API de Google Static Maps

El API de Google Static Maps te permite insertar imgenes de Google Maps en tu sitio web sin utilizar JavaScript ni ningn sistema de carga dinmica de pginas. El servicio de Google Static Maps crear tu mapa a partir de los parmetros de URL enviados a travs de una solicitud HTTP estndar y generar una imagen de mapa que podrs mostrar en tu pgina web. Nuevo! Los lmites de uso del API de Google Static Maps han cambiado. Si creas una clave de API y la incluyes en tu solicitud, podrs realizar un seguimiento del uso en la consola de las API y adquirir lmites adicionales si fuera necesario. En este documento se describe la versin 2 del API de Google Static Maps. Para actualizar las URL de la versin 1, consulta la Gua de actualizacin. Ejemplo rpido Audiencia Clave de API Lmites de uso Descripcin general Parmetros de URL Cmo usar parmetros Cmo especificar ubicaciones Latitudes y longitudes Direcciones Cmo indicar el uso de un sensor Niveles de zoom Tamaos de imagen Valores de escala Formatos de imagen Tipos de mapas Mapas con estilos Seleccin de recursos Operaciones de estilo Cmo aadir marcadores Estilos de marcadores Ubicaciones de marcadores Iconos personalizados Rutas de mapas estticos Estilos de rutas Cmo especificar puntos de rutas Polilneas codificadas Ventanas grficas Cmo posicionar de forma implcita mapas que usan marcadores Ms informacin
Ejemplo rpido
En el siguiente ejemplo se indica la URL de una imagen de mapa esttico del centro de Nueva York, que se muestra debajo:
h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = B r o o k l y n + B r i d g e , N e w + Y o r k , N Y & z o o m = 1 3 & s i z e = 6 0 0 x 3 0 0 & m & m a r k e r s = c o l o r : b l u e % 7 C l a b e l : S % 7 C 4 0 . 7 0 2 1 4 7 , 7 4 . 0 1 5 7 9 4 & m a r k e r s = c o l o r : g r e e n % 7 C l a b e l : G % 7 C 4 0 . 7 1 1 6 1 4 , 7 4 . 0 1 2 3 & m a r k e r s = c o l o r : r e d % 7 C c o l o r : r e d % 7 C l a b e l : C % 7 C 4 0 . 7 1 8 2 1 7 , 7 3 . 9 9 8 2 8 4 & s e n s o r = f a l s e
https://developers.google.com/maps/documentation/staticmaps/index?hl=es
1/24
19/05/13
Ten en cuenta que no es necesario que hagas nada "especial" para que esta imagen aparezca en la pgina. No se necesita JavaScript. Todo lo que hemos tenido que hacer es crear una URL y colocarla dentro de una etiqueta < i m g > . Puedes colocar un mapa esttico de Google en cualquier lugar de tu pgina web en el que puedas incluir una imagen.
Audiencia
Este documento est dirigido a creadores de pginas web y de contenido para mviles que quieran incluir imgenes del API de Google Static Maps en una pgina web o en aplicaciones para mviles. Ofrece una introduccin sobre el uso del API y material de referencia sobre los parmetros disponibles.
Clave de API
El API de Google Static Maps utiliza una clave de API para identificar tu aplicacin. Las claves de API se administran a travs de la consola de las API de Google. Para activar el API de Google Static Maps y crear una clave, sigue estos pasos: 1. Accede a la pgina de la consola de las API (https://code.google.com/apis/console) e inicia sesin en tu cuenta de Google. 2. Haz clic en el enlace de servicios en el men de la izquierda y, a continuacin, activa el servicio del API de Google Static Maps. 3. Una vez que el servicio se haya activado, tu clave de API estar disponible en la seccin de acceso del API sencillo de la pgina de acceso del API. Las aplicaciones del API de Google Static Maps utilizan la clave para aplicaciones del navegador. De forma predeterminada, una clave se puede utilizar en cualquier sitio. Te recomendamos encarecidamente que restrinjas el uso de la clave a los dominios que administres. Para especificar los dominios que pueden utilizar la clave de API, haz clic en el enlace para Editar referencias permitidas... de la consola de las API. Si incluyes una clave de API en tu solicitud, podrs realizar un seguimiento del uso en la consola de las API y adquirir lmites adicionales si fuera necesario. Para especificar una clave en tu solicitud, inclyela como valor del parmetro k e y .
h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = N e w + Y o r k , N Y & z o o m = 1 3 & s i z e = 6 0 0 x 3 0 0 & k e y = A P I _ c o n s o l e _ k
Ten en cuenta que no es obligatorio utilizar una clave, pero s recomendable. Los ejemplos que aparecen en este documento no incluyen el parmetro k e y , por lo que funcionarn para todos los usuarios que copien y peguen el cdigo.
Lmites de uso
Los clientes del API de Google Maps for Business cuentan con lmites distintos a los que se indican a continuacin. Una solicitud de mapa esttico se considera una "visita de pgina" a efectos de la administracin de lmites del API de Google Maps for Business y se aplica al nmero total de visitas a la pgina adquiridas con la licencia del API de Google Maps for Business. El API de Google Static Maps cuenta con los lmites de uso que se indican a continuacin:
2/24
19/05/13
25.000 solicitudes gratuitas diarias de mapas estticos por aplicacin Las solicitudes de imgenes adicionales se pueden adquirir por aplicacin y se les aplica la tarifa que se indica en las preguntas frecuentes. Los lmites adicionales se adquieren a travs de la consola de las API y es necesario utilizar una clave de API. Si un usuario supera estos lmites, el servidor devolver un estado HTTP 403 y se mostrar la imagen que aparece a continuacin para indicrselo:
Restriccin de tamao de la URL

Las URL de mapas estticos tienen un tamao limitado de 2.048 caracteres. En la prctica, probablemente no necesitars URL de mayor tamao que estas, a no ser que crees mapas complicados que incluyan un gran nmero de marcadores y de rutas. Sin embargo, ten en cuenta que los navegadores y los servicios pueden aplicar la codificacin de URL a determinados caracteres antes de enviarlos al servicio de Google Static Maps, lo que producir un aumento en el uso de caracteres. Para obtener ms informacin sobre cmo crear una URL vlida, consulta esta pgina.
Descripcin general
El API de Google Static Maps devuelve una imagen (GIF, PNG o JPEG) en respuesta a una solicitud HTTP a travs de una direccin URL. Para cada solicitud tendrs que especificar la ubicacin del mapa, el tamao de la imagen, el nivel de zoom, el tipo de mapa y la colocacin de marcadores opcionales en lugares determinados del mapa. Adems, puedes etiquetar tus marcadores con caracteres alfanumricos. Una imagen del API de Google Static Maps se inserta en el atributo s r cde la etiqueta < i m g >de la etiqueta (o en su equivalente en otros lenguajes de programacin). Si se utiliza una imagen del API de Google Static Maps fuera de una aplicacin web (por ejemplo, en un navegador), se debe incluir un enlace que dirija a la ubicacin mostrada en un navegador web o en una aplicacin nativa de Google Maps (los usuarios del API de Google Maps for Business no estn sujetos a este requisito). Para obtener informacin completa y actualizada sobre este requisito, consulta la seccin 10.1.1(h) de las Condiciones de servicio de Google Maps/Google Earth. En este documento se describe el formato obligatorio de las URL del API de Google Static Maps y se indican los parmetros disponibles. Tambin se incluyen algunas sugerencias y trucos para especificar las URL.
Parmetros de URL
Las URL del API de Google Static Maps deben tener el siguiente formato:
h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? p a r a m e t e r s Si el acceso a tu sitio web se hace a travs de HTTPS, las imgenes de mapas estticos tambin se deben cargar a travs de HTTPS para evitar alertas de seguridad del navegador. Asimismo, tambin se recomienda utilizar HTTPS si tus solicitudes incluyen informacin confidencial de usuarios, como la ubicacin de un usuario:
h t t p s : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? p a r a m e t e r s Ten en cuenta que el API de Google Static Maps no admite URL con iconos personalizados que utilicen HTTPS, por lo que se mostrar el icono predeterminado. Tanto si se utiliza HTTP como HTTPS, hay ciertos parmetros de URL que son obligatorios y otros que son opcionales. Como en las URL estndar, todos los parmetros se separan con el carcter & . A continuacin, se indican los parmetros admitidos y sus posibles valores. Importante: la relacin de parmetros de URL que aparece a continuacin utiliza ejemplos que se incluyen en formato preescape por razones de claridad. Antes de enviar cualquier solicitud al API, debes asegurarte de que los parmetros tengan
3/24
19/05/13
una codificacin de URL adecuada. Por ejemplo, muchos parmetros utilizan una pleca (| ) como separador que se debe codificar como % 7 Cal final de la URL, como se indica en el ejemplo rpido que se incluye en la parte superior de este documento. El API de Google Static Maps define imgenes de mapas mediante los parmetros de URL que se indican a continuacin. Parmetros de ubicacin c e n t e r(obligatorio si no hay marcadores presentes): define el centro del mapa, equidistante de todos los bordes de este. Este parmetro toma una ubicacin como un par separado por comas {latitud,longitud} (por ejemplo, "40.714728,-73.998672") o como una direccin de cadena (por ejemplo "ayuntamiento, nueva york, ny") identificando una ubicacin nica en la superficie de la Tierra. Para obtener ms informacin, consulta la seccin sobre ubicaciones ms adelante. z o o m(obligatorio si no hay marcadores presentes): define el nivel de zoom del mapa, que determina su nivel de ampliacin. Este parmetro toma un valor numrico correspondiente al nivel de zoom de la regin deseada. Para obtener ms informacin, consulta la seccin sobre niveles de zoom ms adelante. Parmetros de mapa s i z e(obligatorio): define las dimensiones rectangulares de la imagen del mapa. Este parmetro adopta la forma de una cadena { h o r i z o n t a l _ v a l u e } x { v e r t i c a l _ v a l u e } . Por ejemplo, 5 0 0 x 4 0 0define un mapa de 500 pxeles de ancho por 400 de alto. En los mapas cuyo ancho sea inferior a 180 pxeles se mostrar un logotipo reducido de Google. Este parmetro se ve afectado por el parmetro s c a l e , que se describe a continuacin. El tamao final de salida ser el producto de los valores de escala y tamao. s c a l e(opcional): afecta al nmero de pxeles que se muestran. s c a l e = 2 : muestra el doble de pxeles que s c a l e = 1 , pero mantiene la misma rea de cobertura y el mismo grado de detalle (es decir, el contenido del mapa no cambia). Es de utilidad al desarrollar un mapa que se vaya a ver con una alta resolucin o al crear mapas que se vayan a imprimir. El valor predeterminado es 1 . Los valores aceptados son 2y 4(4solo est disponible para clientes del API de Google Maps for Business). Para obtener ms informacin, consulta los valores de escala. f o r m a t(opcional): define el formato de la imagen resultante. De forma predeterminada, el API de Google Static Maps crea imgenes PNG. Hay varios formatos posibles disponibles, incluidos los tipos GIF, JPEG y PNG. El formato que debes utilizar depender de cmo desees presentar la imagen. JPEG suele proporcionar un mayor grado de compresin, mientras que GIF y PNG proporcionan mayor nivel de detalle. Para obtener ms informacin, consulta la seccin sobre formatos de imagen. m a p t y p e(opcional): define el tipo de mapa que se va a generar. Hay varios valores de tipo de mapa posibles, incluidos r o a d m a p ,s a t e l l i t e ,h y b r i dy t e r r a i n . Para obtener ms informacin, consulta la seccin sobre tipos de mapas del API de Google Static Maps que aparece ms adelante. l a n g u a g e(opcional): define el idioma que se debe utilizar para mostrar las etiquetas de los mosaicos de mapas. Ten en cuenta que este parmetro solo es compatible con algunos mosaicos de pases, por lo que si el idioma especfico solicitado no es compatible con el conjunto de mosaicos, se utilizar el idioma predeterminado de ese conjunto. r e g i o n(opcional): define los lmites apropiados que se deben mostrar en funcin de determinados factores geogrficos y polticos. Acepta un cdigo de regin especificado como un valor ccTLD de dos caracteres ("dominio de nivel superior"). Parmetros de recurso m a r k e r s(opcional): define uno o varios marcadores para adjuntarlos a la imagen en ubicaciones especificadas. Este parmetro adopta una definicin de marcador nica con parmetros separados por plecas (| ). Se pueden colocar varios marcadores en el mismo parmetro m a r k e r scuando tienen el mismo estilo; puedes aadir marcadores adicionales de diferentes estilos mediante la adicin de parmetros m a r k e r scomplementarios. Ten en cuenta que si suministras marcadores para un mapa, no tendrs que especificar los parmetros c e n t e rni z o o m(que normalmente son obligatorios). Para obtener ms informacin, consulta la seccin sobre marcadores de mapas estticos que aparece ms adelante. p a t h(opcional): define una nica ruta de dos o ms puntos conectados para superponerla en la imagen en ubicaciones especificadas. Este parmetro toma una cadena de definiciones de puntos separadas por plecas (| ). Puedes proporcionar rutas adicionales si aades parmetros p a t hcomplementarios. Ten en cuenta que si suministras una ruta para un mapa, no tendrs que especificar los parmetros c e n t e rni z o o m(que normalmente son necesarios). Para obtener ms informacin, consulta la seccin sobre rutas de mapas estticos que aparece ms adelante. v i s i b l e(opcional): especifica una o varias ubicaciones que deben estar visibles en el mapa, aunque no se muestre ningn marcador o ningn indicador. Utiliza este parmetro para asegurarte de que se muestren determinados recursos o ubicaciones de mapas en el mapa esttico. s t y l e(opcional): define un estilo personalizado para alterar la presentacin de un recurso concreto (carretera, parque, etc.) del mapa. Este parmetro utiliza los argumentos f e a t u r ey e l e m e n tque identifican los recursos que se
4/24
19/05/13
pueden seleccionar y un conjunto de operaciones de estilo que se debe aplicar a esa seleccin. Puedes proporcionar diferentes estilos si aades parmetros s t y l ecomplementarios. Para obtener ms informacin, consulta la seccin Mapas con estilos que se incluye ms adelante. Parmetros de notificacin s e n s o r(obligatorio): especifica si la aplicacin que solicita el mapa esttico va a utilizar un sensor para determinar la ubicacin del usuario. Este parmetro es obligatorio para todas las solicitudes de mapas estticos. Para obtener ms informacin, consulta la seccin Cmo indicar el uso de un sensor que aparece ms adelante. Los usuarios del API de Google Maps for Business deben incluir parmetros c l i e n ty s i g n a t u r evlidos junto con sus solicitudes. Para obtener ms informacin, consulta el captulo Servicios web del API de Google Maps for Business.
Cmo usar parmetros

El API de Google Static Maps es relativamente fcil de usar, ya que est formada solo por una URL con parmetros. En esta seccin se explica cmo utilizar estos parmetros para construir direcciones URL.
Cmo especificar ubicaciones

El API de Google Static Maps debe ser capaz de identificar con precisin ubicaciones del mapa, tanto para centrar el mapa en la ubicacin correcta (mediante el parmetro c e n t e r ) como para colocar marcas de posicin opcionales (mediante el parmetro m a r k e r s ) en lugares del mapa. El API de Google Static Maps utiliza nmeros (valores de latitud y longitud) o cadenas (direcciones) para especificar estas ubicaciones. Estos valores identifican una ubicacin codificada de forma geogrfica. Varios parmetros (como, por ejemplo, los parmetros m a r k e r sy p a t h ) toman varias ubicaciones. En estos casos, las ubicaciones estn separadas por el carcter de plecas (| ).
Latitudes y longitudes
Las latitudes y longitudes se definen mediante nmeros dentro de una cadena de texto separado con comas de seis posiciones decimales de precisin. Por ejemplo, "40.714728,-73.998672" es un valor de cdigo geogrfico vlido. Los niveles de precisin superiores al sexto decimal se ignoran. Los valores de longitud se basan en su distancia a Greenwich (Inglaterra), por donde pasa el meridiano cero. Dado que Greenwich est situado a 51.477222 grados de latitud, podemos introducir un valor c e n t e rde 5 1 . 4 7 7 2 2 2 , 0para centrar el mapa en esta localidad:
Los valores de latitud y longitud se deben corresponder con una ubicacin vlida de la superficie terrestre. Las latitudes pueden tener cualquier valor entre 9 0y 9 0 , mientras que la longitud debe estar comprendida entre 1 8 0y 1 8 0 . Si especificas un valor de latitud o de longitud no vlido, tu solicitud ser rechazada como una solicitud incorrecta.
5/24
19/05/13
Direcciones
La mayora de las personas no se expresan en trminos de longitud y latitud, sino que utilizan direcciones para referirse a las ubicaciones. El proceso de convertir una direccin en un punto geogrfico se conoce como codificacin geogrfica y el servicio de Google Static Maps puede realizar la codificacin geogrfica si le proporcionas direcciones vlidas. En todos los parmetros en los que puedas ofrecer la latitud y la longitud, puedes especificar en su lugar una cadena que indique una direccin. Google codificar de forma geogrfica la direccin y proporcionar al servicio de Google Static Maps un valor de latitud/longitud para utilizarlo en la ubicacin de marcadores o en la especificacin de ubicaciones. La cadena debe presentar el formato de escape URL, para que direcciones como, por ejemplo, "Ayuntamiento, Nueva York, NY" se conviertan en "Ayuntamiento,Nueva+York,NY", por ejemplo. Ten en cuenta que las direcciones pueden reflejar las ubicaciones precisas como direcciones postales, las polilneas como rutas designadas o las reas poligonales como ciudades, pases o parques nacionales. En el caso de los resultados poligonales o polilineales, el servidor de Google Static Maps utilizar el punto central de la lnea o del rea como el centro de la direccin. Para obtener ms informacin sobre cmo codificar de forma geogrfica una direccin, puedes probar la direccin con esta herramienta de codificacin geogrfica. El siguiente ejemplo genera un mapa esttico de Berkeley (California, Estados Unidos): h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = B e r k e l e y , C A & z o o m = 1 4 & s i z e = 4 0 0 x 4 0 0 & s e n s o r = f a l s e
Cmo indicar el uso de un sensor

Si utilizas el API de Google Static Maps, debers indicar si tu aplicacin utiliza un "sensor" (por ejemplo, un localizador GPS) para determinar la ubicacin del usuario. Esto resulta de especial importancia para los dispositivos mviles. Las aplicaciones deben transmitir un parmetro de sensor obligatorio que indique si la aplicacin utiliza un dispositivo sensor o no. Las aplicaciones que determinan la ubicacin del usuario a travs de un sensor deben transmitir s e n s o r = t r u een la URL de solicitud del API de Google Static Maps. Si tu aplicacin no utiliza un sensor, debers transmitir s e n s o r = f a l s e .
Niveles de zoom
Los mapas de Google Maps tienen un nmero entero como "nivel de zoom" que define la resolucin de la vista actual. En la vista de mapas de carretera se admiten los niveles de zoom entre 0(el ms bajo, donde todo el planeta se puede ver en un mapa) y 2 1 +(en el que se ven edificios individuales). Google Maps define el nivel de zoom 0para mostrar todo el planeta. Cada nivel sucesivo dobla la precisin tanto horizontal como vertical. Para obtener ms informacin sobre este procedimiento, consulta la documentacin del API de Google Maps. Nota: no todos los niveles de zoom se muestran en todos los lugares de la Tierra. Estos niveles varan dependiendo de la
6/24
19/05/13
ubicacin, ya que los datos en algunas partes del planeta no son tan precisos como en otras. Si envas una solicitud de un nivel de zoom en el que no existan mosaicos de mapa, el API de Google Static Maps devuelve una imagen en blanco. En el siguiente ejemplo se muestran dos solicitudes de mapas de Manhattan con el mismo valor c e n t e rpero con niveles de zoom de 12 y 14, respectivamente:
h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = 4 0 . 7 1 4 7 2 8 , 7 3 . 9 9 8 6 7 2 & z o o m = 1 2 & s i z e = 4 0 0 x 4 0 0 & s e n s o r = f h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = 4 0 . 7 1 4 7 2 8 , 7 3 . 9 9 8 6 7 2 & z o o m = 1 4 & s i z e = 4 0 0 x 4 0 0 & s e n s o r = f
Tamaos de imagen
El parmetro s i z e , junto con el parmetro c e n t e r , define el rea de cobertura de un mapa. Tambin define el tamao de salida del mapa en pxeles, cuando se multiplica por el valor s c a l e(que es 1de forma predeterminada). En la tabla que aparece a continuacin se muestran los valores mximos permitidos para el parmetro s i z econ cada valor s c a l e . API Gratuita s c a l e = 1 6 4 0 x 6 4 0 s c a l e = 2 6 4 0 x 6 4 0(devuelve 1.280x1.280 s c a l e = 4 No disponible
7/24
19/05/13
pxeles) API de Google Maps for Business 2 0 4 8 x 2 0 4 8 1 0 2 4 x 1 0 2 4(devuelve 2.048x2.048 pxeles) 5 1 2 x 5 1 2(devuelve 2.048x2.048 pxeles)
En el siguiente ejemplo se solicita una "tira" de la Tierra alrededor del ecuador con un nivel de zoom de 1: h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = 0 , 0 & z o o m = 1 & s i z e = 4 0 0 x 5 0 & s e n s o r = t r u e _ o r _ f a l s e
En el ejemplo que aparece a continuacin se solicita un mapa pequeo, con un tamao de 100x100 pxeles, centrado en la misma regin. Observa el tamao ms reducido del logotipo de Google:
Valores de escala
El parmetro s i z edel API de Google Static Maps define el tamao de un mapa en pxeles, por lo que un mapa con s i z e = 2 0 0 x 2 0 0se mostrar con un tamao de 200x200 pxeles. En un monitor LCD de ordenador, que normalmente tiene 100 pxeles por pulgada, un mapa de 200x200 tendr dos pulgadas en todas las dimensiones. Sin embargo, cada vez hay ms dispositivos mviles que disponen de pantallas de alta resolucin con una densidad de pxeles superior a 300 pxeles por pulgada, que: o bien reducen el tamao de una imagen de 200x200 pxeles a solo 0,7 pulgadas, lo que hace que las etiquetas y los iconos sean demasiado pequeos para verlos, o bien amplan la imagen para que se vea mejor, lo que da lugar a una imagen borrosa o pixelada. Demasiado pequea Demasiado pixelada
Al desarrollar aplicaciones para dispositivos mviles, utiliza el parmetro s c a l edel API para mostrar imgenes de mapas de alta resolucin que no tengan estos problemas. El valor s c a l ese multiplica por el valor s i z epara determinar el tamao de salida real de la imagen en pxeles sin cambiar el rea de cobertura del mapa (el valor predeterminado de s c a l ees 1. Los valores aceptados son 1, 2 y, solo para los clientes del API de Google Maps for Business, 4). Por ejemplo, un valor de escala de 2 mostrar la misma rea de cobertura de mapa que una solicitud en la que no se haya especificado la escala, pero con el doble de pxeles en todas las dimensiones. Aqu se incluyen las carreteras y las etiquetas para que se puedan leer con una resolucin alta, en pantallas pequeas y cuando las ampla el navegador.
150x150
150x150&scale=2
8/24
19/05/13
Una imagen como esa tambin se ver bien en los navegadores de los ordenadores de escritorio, cuando se inserte en una etiqueta i m go d i vcon la altura y el ancho establecidos mediante CSS. El navegador reducir la imagen al tamao correcto sin disminuir su calidad. En la tabla que aparece a continuacin se muestran tres solicitudes de imgenes diferentes. La primera corresponde a una imagen de 100x100 pxeles sin valor de escala. Se muestra correctamente en el ordenador, pero es demasiado pequea para poder verla bien en un dispositivo mvil. En la segunda se duplica el tamao del mapa. En el ordenador de escritorio, el CSS se adapta al elemento i m g especificado de 100x100 pxeles, pero las carreteras y las etiquetas se hacen demasiado pequeas al reducir la imagen. En el dispositivo mvil, el tamao de la imagen es el correcto, pero en este caso tampoco se ven bien las carreteras y las etiquetas. La tercera solicitud corresponde a un mapa de 100x100 pxeles con s c a l e = 2 . La imagen se muestra con 200 pxeles de detalle. En el ordenador, se reduce perfectamente, por lo que no se distingue de la solicitud original de 100x100 pxeles, mientras que en el dispositivo mvil se puede ver correctamente gracias a la resolucin adicional que muestra el API.
Dispositivo Escritorio (con h e i g h t = " 1 0 0 p x "y w i d t h = " 1 0 0 p x "en la etiqueta i m g )
1 0 0 x 1 0 0
2 0 0 x 2 0 0
1 0 0 x 1 0 0 & s c a l e = 2
Alta resolucin (simulada)
Sugerencia: las plataformas mviles, como iOS y Android, permiten la compatibilidad de las aplicaciones con pantallas de alta resolucin mediante la especificacin de imgenes independientes para cada resolucin. El parmetro de escala facilita la solicitud de una imagen de mapa para pantallas de resolucin estndar y del mapa apropiado para una pantalla de alta resolucin, solo con establecer s c a l e = 1y s c a l e = 2 , respectivamente. Para obtener ms informacin sobre cmo desarrollar aplicaciones para pantallas de alta resolucin y dispositivos mviles, consulta los siguientes documentos: Cmo admitir varias pantallas (en ingls), en la Gua para desarrolladores de Android, Sitios web de alta resolucin por pulgada(en ingls), artculo en el que se incluyen las recomendaciones de Webkit.org para desarrolladores, Cmo admitir pantallas de alta resolucin (en ingls), en la biblioteca para desarrolladores de iOS.
9/24
19/05/13
Formatos de imagen
Las imgenes se pueden devolver en varios formatos de grficos web comunes: GIF, JPEG y PNG. El parmetro f o r m a ttoma uno de los siguientes valores: p n g 8o p n g(predeterminado): especifica el formato PNG de 8 bits. p n g 3 2 : especifica el formato PNG de 32 bits. g i f :especifica el formato GIF. j p g : especifica el formato de compresin JPEG. j p g b a s e l i n e : especifica un formato de compresin JPEG no progresivo. j p gy j p g b a s e l i n e : suelen proporcionar el tamao de imagen ms pequeo, aunque lo hacen mediante una compresin "con prdida", que puede dar lugar a que la imagen pierda calidad. g i f ,p n g 8y p n g 3 2 : proporcionan una compresin sin prdida. La mayora de las imgenes JPEG son progresivas, lo que significa que cargan una imagen ms general y la resolucin de la imagen se va afinando a medida que llegan ms datos. Esto permite que las imgenes se carguen ms rpidamente en las pginas web y es el uso de los archivos JPEG ms extendido actualmente. No obstante, algunos usos de JPEG (especialmente impresin) requieren imgenes no progresivas (punto de referencia). En estos casos, es posible que quieras utilizar el formato j p g b a s e l i n e , que es no progresivo.
Tipos de mapas
El API de Google Static Maps crea mapas en los distintos formatos que se indican a continuacin. r o a d m a p(predeterminado): especifica una imagen de mapa de carreteras estndar, como se muestra habitualmente en la pgina de Google Maps. Si no se especifica el valor m a p t y p e , el API de Google Static Maps ofrecer mosaicos de tipo r o a d m a pde forma predeterminada. s a t e l l i t e : especifica una imagen obtenida por satlite. t e r r a i n : especifica una imagen de mapa de relieve fsico, en la que aparece relieve y vegetacin. h y b r i d : especifica un hbrido de imagen obtenida por satlite e imagen de mapa de carreteras, en la que aparece una capa transparente de calles principales y nombres de lugares en la imagen obtenida por satlite. Puedes ver la diferencia entre los tipos de terreno y de mapa de carreteras en el ejemplo de cdigo que se muestra a continuacin.
h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = 4 0 . 7 1 4 7 2 8 , 7 3 . 9 9 8 6 7 2 & z o o m = 1 2 & s i z e = 4 0 0 x 4 0 0 & m a p t y p e =
10/24
19/05/13
Los mapas hbridos utilizan imgenes de satlite y recursos de mapas de carretera para crear un mapa de combinacin. En los siguientes ejemplos se muestran los tipos de mapas obtenidos por satlite y los tipos de mapas hbridos:
11/24
19/05/13
Mapas con estilos

Los mapas con estilos te permiten personalizar la presentacin de estilos de mapas de Google estndar, cambiando la visualizacin de elementos tales como carreteras, parques y reas urbanizadas que reflejen un estilo diferente al utilizado en el tipo de mapa predeterminado. Estos componentes se denominan recursos y un mapa con estilo te permite seleccionar estos recursos y aplicar estilos a su visualizacin (incluso ocultarlos por completo). Estos cambios permiten resaltar en un mapa componentes concretos o contenido complementario incluido en la pgina. Un mapa con "estilo" personalizado se compone de uno o ms estilos especificados, cada uno de los cuales se indica a travs de un parmetro s t y l edentro de la URL de solicitud de mapas estticos. Los estilos adicionales se especifican transmitiendo parmetros s t y l ecomplementarios. Un estilo consiste en una seleccin y en un conjunto de reglas que se debe aplicar a la seleccin. Las reglas indican las modificaciones visuales que se deben aplicar a la seleccin. Cada declaracin s t y l ese compone de los argumentos que se indican a continuacin y que se separan con una pleca ("| ") dentro de la declaracin s t y l e : f e a t u r e(opcional): indica los recursos que se pueden seleccionar en la modificacin de estilo (consulta la seccin Recursos de mapas que aparece ms adelante). Si no se especifica ningn argumento f e a t u r e , se seleccionarn todos los recursos. e l e m e n t(opcional): indica qu subconjunto de recursos seleccionados se puede utilizar (consulta la seccin Elementos de mapas que se incluye ms adelante). Si no se especifica ningn argumento e l e m e n t , se seleccionarn todos los elementos del recurso determinado. Todos los argumentos que se incluyan detrs indicarn las reglas que se deben aplicar a los recursos seleccionados. Todas las reglas se aplican en el orden en el que aparecen en la declaracin s t y l e(consulta la seccin Reglas de estilo que aparece ms adelante). Cualquier conjunto de reglas debe incluirse despus de la seleccin de recursos y debe cumplir con las limitaciones de longitud de URL del API de Google Static Maps. Nota: la declaracin s t y l edebe especificar los argumentos anteriores en el orden establecido. Por ejemplo, una seleccin de recursos con dos reglas se mostrara como se indica a continuacin:
s t y l e = f e a t u r e : f e a t u r e A r g u m e n t | e l e m e n t : e l e m e n t A r g u m e n t | r u l e 1 : r u l e 1 A r g u m e n t | r u l e 2 : r u l e 2 A r g u m e n t
Recursos de mapas
Un mapa se compone de un conjunto de recursos como, por ejemplo, carreteras o parques. Los tipos de recursos forman un rbol de categoras, cuya raz es f e a t u r e : a l l . A continuacin, se indican algunos recursos habituales. f e a t u r e : a l l(predeterminado): selecciona todos los recursos del mapa. f e a t u r e : r o a d : selecciona todas las carreteras del mapa. f e a t u r e : l a n d s c a p e : selecciona todos los paisajes de fondo de un mapa, que suele ser el rea entre las carreteras, por ejemplo. En las ciudades, el paisaje suele componerse de reas edificadas.
12/24
19/05/13
La lista completa de recursos que se pueden seleccionar en un mapa se incluye en el documento de referencia de la versin 3 del API de JavaScript de Google Maps. Algunas categoras de tipos de recursos incluyen subcategoras que se especifican separadas por puntos (por ejemplo, l a n d s c a p e . n a t u r a lo r o a d . l o c a l ). Si se especifica el recurso principal (r o a d , por ejemplo), entonces los estilos aplicados a esta seleccin se aplican a todas las carreteras, incluidas las subcategoras.
Elementos de los recursos de mapa

Por otra parte, algunos de los recursos de un mapa constan de diferentes elementos . Por ejemplo, una carretera incluye, no solo la lnea grfica (geometra) que la representa sobre el mapa, sino tambin el texto que indica su nombre (etiquetas) en el mapa. Los elementos de los recursos se deben seleccionar mediante la declaracin del argumento e l e m e n t . A continuacin se indican los valores de argumentos de elementos admitidos. e l e m e n t : a l l(predeterminado): selecciona todos los elementos del recurso. e l e m e n t : g e o m e t r y : permite seleccionar solamente los elementos geomtricos del recurso correspondiente. e l e m e n t : l a b e l s : selecciona solo las etiquetas de texto asociadas a un recurso concreto. Si no se especifica ningn argumento de elemento, los estilos se aplicarn a todos los elementos del recurso independientemente del tipo de elemento. La siguiente declaracin s t y l eselecciona las etiquetas para todas las carreteras locales: s t y l e = f e a t u r e : r o a d . l o c a l | e l e m e n t : l a b e l s
Reglas de estilo
Las reglas de los modificadores de estilo son opciones de formato que se aplican a todos los recursos y elementos especificados en cada declaracin s t y l e . Cada declaracin s t y l edebe contener una o ms operaciones separadas con una pleca ("| "). Cada operacin especifica el valor de su argumento con dos puntos (": "), y todas las operaciones se aplican a la seleccin en el orden en que se especificaron. A continuacin, se indican los argumentos de operacin y los valores utilizados que se admiten actualmente. h u e(una cadena hexadecimal RGB de formato 0 x R R G G B B ) indica el color bsico que se debe aplicar a la seleccin (* consulta la nota de uso que aparece ms adelante). l i g h t n e s s(un valor de punto flotante entre 1 0 0y 1 0 0 ) indica el cambio porcentual en el brillo del elemento. Los valores negativos incrementan la opacidad (-100 corresponde al negro) mientras que los valores positivos aumentan el brillo (+100 corresponde al blanco). s a t u r a t i o n(un valor de punto flotante entre 1 0 0y 1 0 0 ) indica el cambio porcentual en la intensidad del color bsico que se debe aplicar al elemento. g a m m a(un valor de punto flotante entre 0 . 0 1y 1 0 . 0 , donde 1 . 0no aplica correcciones) indica la cantidad de correccin gamma que se debe aplicar al elemento. Los valores de gamma modifican la luminosidad de los matices de una forma no lineal sin variar los valores de blanco o de negro. Los valores de gamma se suelen utilizar para modificar el contraste de diferentes elementos. Por ejemplo, podras modificar el valor de gamma para incrementar o reducir el contraste entre los bordes y el interior de los elementos. Los valores bajos de gamma (< 1) incrementan el contraste, mientras que los valores elevados (> 1) disminuyen el contraste. i n v e r s e _ l i g h t n e s s : t r u einvierte la luminosidad existente. v i s i b i l i t y(o n ,o f fo s i m p l i f i e d ) indica si un elemento aparece en el mapa y la forma en que se muestra. v i s i b i l i t y : s i m p l i f i e dindica que el mapa debe simplificar la presentacin de los elementos para que se vean correctamente (una estructura de carretera simplificada puede mostrar menos carreteras, por ejemplo). Las reglas de los modificadores de estilo se deben aplicar como operaciones diferentes e independientes y en el orden en que aparecen en la declaracin s t y l e . El orden es importante, ya que algunas operaciones no se pueden conmutar. Los recursos y los elementos que se modifican a travs de operaciones de estilo (normalmente) suelen disponer de estilos existentes, por lo que las operaciones actan sobre dichos estilos, si existen. Ten en cuenta que utilizamos el modelo de matiz, saturacin y luminosidad (HSL) para definir el color dentro de las operaciones de los modificadores de estilo. Las operaciones de definicin de color son habituales en el diseo grfico. El matiz indica el color bsico, la saturacin la intensidad de ese color y la luminosidad la cantidad relativa de blanco o negro del color constituyente. Los tres valores de HSL se pueden indicar como valores RGB (y viceversa). La correccin gamma sirve para modificar la saturacin en el espacio de color, normalmente para incrementar o reducir el contraste. Asimismo, el modelo HSL
13/24
19/05/13
define el color dentro de un espacio de coordenadas, donde h u eindica la orientacin dentro de una rueda de color, mientras que la saturacin y la luminosidad indican las amplitudes a lo largo de ejes diferentes. Los matices se miden dentro de un espacio de color RGB, que es similar a la mayora de espacios de color RGB, a menos que no existan escalas de blancos y negros.
Rueda de color RGB Nota: aunque h u eutiliza un valor de color hexadecimal RGB, solo lo usa para determinar el color bsico (la orientacin en la rueda de color) y no para definir la saturacin o la luminosidad, que se indican por separado como cambios porcentuales. Por ejemplo, el matiz del verde puro se puede definir como h u e : 0 x 0 0 f f 0 0o h u e : 0 x 0 0 0 1 0 0y ambos matices sern idnticos (los dos valores corresponden al verde puro en el modelo de color HSL). Los valores h u eRGB estn formados por partes iguales de rojo, verde y azul, como h u e : 0 x 0 0 0 0 0 0 0(negro) y h u e : 0 x f f f f f f(blanco) y todas las escalas puras de grises, y no indican ningn matiz, dado que ninguno de estos valores determina una orientacin en el espacio de coordenadas HSL. Para especificar negro, blanco o gris, debes eliminar toda la saturacin (s a t u r a t i o n ) (aade una operacin s a t u r a t i o n : 1 0 0 ) y determinar la luminosidad (l i g h t n e s s ) en su lugar. Asimismo, cuando se modifican recursos existentes que ya disponan de un esquema de color, cambiar un valor, como h u e , no modifica la saturacin (s a t u r a t i o n ) o la luminosidad (l i g h t n e s s ) existentes. El siguiente ejemplo muestra un mapa de Brooklyn en el que el color de las carreteras locales se ha cambiado a verde brillante y el de las reas residenciales a negro (ten en cuenta que en este ejemplo completamente funcional se ha utilizado una codificacin de URL correcta para las plecas que sirven de separador; consulta la nota anterior).
h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? s e n s o r = f a l s e & s i z e = 5 1 2 x 5 1 2 & c e n t e r = B r o o k l y n & z o o m = 1 2 & s t y l e = f
14/24
19/05/13
En el siguiente ejemplo, ms complejo, se utilizan varias operaciones y simplificaciones para obtener la apariencia aproximada de un atlas de carreteras de Estados Unidos.
h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? s e n s o r = f a l s e & s i z e = 5 1 2 x 5 1 2 & z o o m = 1 1 & c e n t e r = C h i c a g o & s t y l e = f e
Marcadores
El parmetro m a r k e r sdefine un conjunto de uno o varios marcadores en un conjunto de ubicaciones. Los marcadores definidos en una declaracin m a r k e r snica deben mostrar el mismo estilo visual; si deseas mostrar marcadores con estilos distintos, tendrs que proporcionar varios parmetros m a r k e r scon informacin de estilo independiente.
15/24
19/05/13
El parmetro m a r k e r stoma un conjunto de asignaciones de valores (descriptores de marcadores ) con el formato m a r k e r s = m a r k e r S t y l e s | m a r k e r L o c a t i o n 1 |m a r k e r L o c a t i o n 2 | . . . , etc. El conjunto de estilos de marcadores (mark erStyles ) se establece al principio de la declaracin m a r k e r sy consta de cero o varios descriptores de estilo separados por plecas (| ), seguido de un conjunto de una o varias ubicaciones separadas tambin por plecas (| ). Dado que tanto la informacin de estilo como la informacin de ubicacin vienen delimitadas por plecas, la informacin de estilo debe aparecer primero en cualquier descriptor de marcador. Una vez que el servidor de Google Static Maps detecta una ubicacin en el descriptor de marcador, se asume que todos los dems parmetros son tambin ubicaciones.
Estilos de marcadores
El conjunto de descriptores de estilo de marcadores es una serie de asignaciones de valores separados por plecas (| ). El descriptor de estilo define atributos visuales que se van a utilizar al mostrar los marcadores en el descriptor de marcador. A continuacin se indican las asignaciones de clave/valor de los descriptores de estilo. s i z e :(opcional) especifica el tamao del marcador del conjunto { t i n y ,m i d ,s m a l l } . Si no se define un parmetro s i z e , el marcador aparecer en su tamao predeterminado (normal). c o l o r :(opcional) especifica un color de 24 bits (por ejemplo, c o l o r = 0 x F F F F C C ) o un color predefinido del conjunto { b l a c k ,b r o w n ,g r e e n ,p u r p l e ,y e l l o w ,b l u e ,g r a y ,o r a n g e ,r e d ,w h i t e } . Ten en cuenta que las transparencias (que se especifican mediante valores de color hexadecimales de 32 bits) no se pueden utilizar con los marcadores, aunque s se admiten en las rutas. l a b e l :(opcional) especifica un nico carcter alfanumrico en mayscula del conjunto {A-Z, 0-9} (el uso de caracteres en mayscula es un nuevo requisito introducido en esta versin del API). Ten en cuenta que los marcadores con tamao definido m i dy predeterminado son los nicos marcadores capaces de mostrar un parmetro a l p h a n u m e r i c c h a r a c t e r . Los marcadores t i n yy s m a l lno son capaces de mostrar un carcter alfanumrico. Nota: en vez de utilizar estos marcadores, es posible que desees utilizar tu propio icono personalizado (para obtener ms informacin, consulta Iconos personalizados que aparece ms adelante).
Ubicaciones de marcadores
Todos los descriptores de marcadores deben incluir un conjunto de una o varias ubicaciones que definan el lugar del mapa en el que se va a ubicar el marcador. Estas ubicaciones se pueden especificar como valores de latitud/longitud o como direcciones. Estas ubicaciones estn separadas por plecas (| ). Los parmetros de ubicacin definen la ubicacin del marcador en el mapa. Si la ubicacin queda fuera del mapa, el marcador no aparecer en la imagen generada, siempre que se hayan proporcionado los parmetros c e n t e ry z o o m . Sin embargo, si no se han especificado estos parmetros, el servidor de Google Static Maps generar automticamente una imagen que incluir los marcadores proporcionados (consulta la seccin Cmo posicionar de forma implcita mapas que usan marcadores que aparece ms adelante). A continuacin se muestra una declaracin de marcador de muestra. Ten en cuenta que definimos un conjunto de estilos y tres ubicaciones: h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = W i l l i a m s b u r g , B r o o k l y n , N Y & z o o m = 1 3 & s i z e = 4 0 0 x 4 0 0 & m a r k e r s = c o l o r : b l u e % 7 C l a b e l : S % 7 C 1 1 2 1 1 % 7 C 1 1 2 0 6 % 7 C 1 1 2 2 2 & s e n s o r = t r u e _ o r _ f a l s e
16/24
19/05/13
Para definir marcadores con estilos distintos, tenemos que proporcionar varios parmetros m a r k e r s . Este conjunto de parmetros m a r k e r sdefine tres marcadores: un marcador azul con la etiqueta "S" en las coordenadas 62.107733, -145.5419, un marcador verde pequeo en "Delta Junction, AK", y un marcador amarillo mediano con la etiqueta "C" en "Tok, AK". Estos marcadores se muestran en el ejemplo que aparece a continuacin:
h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = 6 3 . 2 5 9 5 9 1 , 1 4 4 . 6 6 7 9 6 9 & z o o m = 6 & s i z e = 4 0 0 x 4 0 0 \ & m a r k e r s = c o l o r : b l u e % 7 C l a b e l : S % 7 C 6 2 . 1 0 7 7 3 3 , 1 4 5 . 5 4 1 9 3 6 & m a r k e r s = s i z e : t i n y % 7 C c o l o r : g r e e n % 7 C D e l t a + J u n c t i o n , & m a r k e r s = s i z e : m i d % 7 C c o l o r : 0 x F F F F 0 0 % 7 C l a b e l : C % 7 C T o k , A K & s e n s o r = f a l s e "/ >
Iconos personalizados
En vez de utilizar los iconos de marcador de Google, puedes utilizar tus propios iconos personalizados. Los iconos personalizados se especifican mediante los siguientes descriptores para el parmetro m a r k e r s : i c o nespecifica una URL que se puede utilizar como el icono personalizado del marcador. Las imgenes pueden estar en formato PNG, JPEG o GIF, aunque el formato recomendado es PNG. s h a d o w(predeterminado t r u e ) indica que el servicio de Google Static Maps debera crear una sombra adecuada para la imagen. Esta sombra se basa en la regin visible de la imagen y en su opacidad o transparencia.
17/24
19/05/13
El parmetro i c o nse debe especificar mediante una URL (que debe ser una URL codificada). Puedes utilizar cualquier URL vlida que quieras o un servicio para acortar URL como, por ejemplo, h t t p : / / b i t . l yo h t t p : / / t i n y u r l . c o m . La mayora de los servicios para acortar URL tienen la ventaja de la codificacin automtica de URL. Los iconos tienen un lmite de 4.096 pxeles (64x64 para las imgenes cuadradas), y el servicio de Google Static Maps permite hasta cinco iconos personalizados nicos por solicitud. Ten en cuenta que cada uno de estos iconos nicos se puede utilizar varias veces dentro del mapa esttico. Los iconos personalizados que tienen un descriptor s h a d o w : t r u e(el predeterminado) tendrn su "punto de anclaje" establecido como el centro inferior de la imagen de icono proporcionada, a partir de la que se representa la sombra. Los iconos sin sombra (que establecen un descriptor s h a d o w : f a l s e ) se consideran en su lugar como iconos centrados en sus ubicaciones especificadas, por lo que sus puntos de anclaje se establecen como el centro de la imagen. En el siguiente ejemplo se utiliza el API de Google Chart para crear marcadores personalizados que muestren varias cafeteras de Nueva York: h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? s i z e = 4 8 0 x 4 8 0 & m a r k e r s = i c o n : h t t p : / / c h a r t . a p i s . g o o g l e . c o m / c h a r t ? c h s t = d _ m a p _ p i n _ i c o n % 2 6 c h l d = c a f e % 2 5 7 C 9 9 6 6 0 0 % 7 C 2 2 4 + W e s t + 2 0 t h + S t r e e t + N Y % 7 C 7 5 + 9 t h + A v e + N Y % 7 C 7 0 0 + E + 9 t h + S t + N Y & s e n s o r = t r u e _ o r _ f a l s e
Nota: los diferentes niveles de escape anteriores pueden resultar confusos. El API de Google Chart utiliza plecas (| ) para delimitar cadenas dentro de los parmetros de URL. Como este carcter no se puede utilizar legalmente dentro de una URL (consulta la nota anterior), a la hora de crear una URL de grfico vlida, se aplica el formato de escape % 7 C . El resultado se inserta como una cadena en una especificacin i c o n . Sin embargo, contiene un carcter %(del formato % 7 Cmencionado anteriormente) que no se puede incluir directamente como dato en una URL y al que se debe aplicar el formato de escape % 2 5 . Como consecuencia, la URL incluye % 2 5 7 C , que representa dos capas de codificacin. Del mismo modo, la URL de grfico contiene un carcter &que no se puede incluir directamente sin que se confunda con un separador de parmetros de URL de mapas estticos, por lo que tambin se debe codificar. A continuacin, se indican los pasos que se deben seguir para crear una URL de mapa esttico: #I n t e n d e dc h l dp a r a m e t e r : c h l d = c a f e | 9 9 6 6 0 0 #E m b e d d e di naf u l l yv a l i dc h a r tU R L : h t t p : / / c h a r t . a p i s . g o o g l e . c o m / c h a r t ? c h s t = d _ m a p _ p i n _ i c o n & c h l d = c a f e % 7 C 9 9 6 6 0 0 #I n t e n d e di c o np a r a m e t e r ,c o n t a i n i n gaf u l l yv a l i dU R L : m a r k e r s = i c o n : h t t p : / / c h a r t . a p i s . g o o g l e . c o m / c h a r t ? c h s t = d _ m a p _ p i n _ i c o n & c h l d = c a f e % 7 C 9 9 6 6 0 0
18/24
19/05/13
#E m b e d d e di nav a l i da n du n a m b i g u o u ss t a t i cm a pU R L : . . . & m a r k e r s = i c o n : h t t p : / / c h a r t . a p i s . g o o g l e . c o m / c h a r t ? c h s t = d _ m a p _ p i n _ i c o n % 2 6 c h l d = c a f e % 2 5 7 C 9 9 6 6 0 0
Rutas de mapas estticos

El parmetro p a t hdefine un conjunto de una o varias ubicaciones conectadas por una ruta que se deben superponer a la imagen del mapa. El parmetro p a t htoma un conjunto de asignaciones de valores (descriptores de ruta) con el formato p a t h = p a t h S t y l e s | p a t h L o c a t i o n 1 | p a t h L o c a t i o n 2 | . . . , etc. Ten en cuenta que los dos puntos de ruta se separan entre s mediante una pleca (| ). Dado que la informacin de estilo y la informacin de punto estn delimitadas por plecas, la informacin de estilo debe aparecer primero en los descriptores de ruta. Una vez que el servidor de Google Static Maps detecta una ubicacin en el descriptor de ruta, se asume que todos los dems parmetros tambin son ubicaciones.
Estilos de ruta
El conjunto de descriptores de estilo de ruta es una serie de asignaciones de valores separadas por plecas (| ). El descriptor de estilo define los atributos visuales que se van a utilizar al mostrar la ruta. A continuacin se indican las asignaciones de clave/valor de los descriptores de estilo. w e i g h t :(opcional) especifica el grosor de la ruta en pxeles. Si no se define un parmetro w e i g h t , la ruta aparecer con el grosor predeterminado (5 pxeles). c o l o r :(opcional) especifica un color de 24 bits (por ejemplo, c o l o r = 0 x F F F F C C ) o un valor hexadecimal de 32 bits (por ejemplo, c o l o r = 0 x F F F F C C F F ) o del conjunto { b l a c k ,b r o w n ,g r e e n ,p u r p l e ,y e l l o w ,b l u e , g r a y ,o r a n g e ,r e d ,w h i t e } . Al especificar un valor hexadecimal de 32 bits, los dos ltimos caracteres indican el valor de transparencia alfa de 8 bits. Este valor vara entre 0 0(completamente transparente) y F F(completamente opaco). Ten en cuenta que las transparencias se pueden utilizar en las rutas, aunque no se admiten en los marcadores. f i l l c o l o r :(opcional) indica que la ruta delimita un rea poligonal y especifica el color de relleno que se va a utilizar como superposicin en dicha rea. El conjunto de ubicaciones siguientes no tiene que ser un bucle "cerrado"; el servidor de Google Static Maps unir de forma automtica el primer y el ltimo punto. Sin embargo, ten en cuenta que cualquier trazo fuera del rea de relleno no se cerrar a menos que proporciones especficamente la misma ubicacin inicial y final. A continuacin, se muestran algunos ejemplos de definiciones de ruta. Lnea delgada azul, opacidad del 50%: p a t h = c o l o r : 0 x 0 0 0 0 f f | w e i g h t : 1 Lnea opaca roja: p a t h = c o l o r : 0 x f f 0 0 0 0 f f | w e i g h t : 5 Lnea delgada opaca negra: p a t h = c o l o r : 0 x f f f f f f f f | w e i g h t : 1 0 Estos estilos de ruta son opcionales. Si quieres emplear los atributos predeterminados, debers omitir la definicin de los atributos de ruta; en este caso, el primer "argumento" del descriptor de ruta estar formado por el primer punto declarado (ubicacin).
Puntos de ruta
Para dibujar una ruta, el parmetro p a t htambin se debe transmitir a dos o ms puntos. El API de Google Static Maps conectar la ruta que describen esos puntos, en el orden especificado. Cada punto de ruta (pathPoint) aparece marcado en el descriptor de ruta (pathDescriptor) separado por el carcter |(pleca). En el siguiente ejemplo se define una ruta azul con una opacidad del 50% predeterminada de Union Square (Nueva York) a Times Square (Nueva York).
19/24
19/05/13
Los detalles del parmetro p a t haparecen a continuacin: p a t h = c o l o r : 0 x 0 0 0 0 f f | w e i g h t : 5 | 4 0 . 7 3 7 1 0 2 , 7 3 . 9 9 0 3 1 8 | 4 0 . 7 4 9 8 2 5 , 7 3 . 9 8 7 9 6 3 | 4 0 . 7 5 2 9 4 6 , 7 3 . 9 8 7 3 8 4 | 4 0 . 7 5 5 8 2 3
En el siguiente ejemplo se define la misma ruta pero con una lnea opaca roja y una opacidad del 100%:
Los detalles del parmetro p a t haparecen a continuacin:
p a t h = c o l o r : 0 x f f 0 0 0 0 f f | w e i g h t : 5 | 4 0 . 7 3 7 1 0 2 , 7 3 . 9 9 0 3 1 8 | 4 0 . 7 4 9 8 2 5 , 7 3 . 9 8 7 9 6 3 | 4 0 . 7 5 2 9 4 6 , 7 3 . 9 8 7 3 8 4 | 4 0 . 7 5 5 8 2 3
20/24
19/05/13
En el ejemplo que se indica a continuacin se muestra un rea poligonal de Manhattan, con una serie de intersecciones transmitidas como ubicaciones:
Los detalles del parmetro p a t haparecen a continuacin: p a t h = c o l o r : 0 x 0 0 0 0 0 0 0 0 | w e i g h t : 5 | f i l l c o l o r : 0 x F F F F 0 0 3 3 | 8 t h + A v e n u e + % 2 6 + 3 4 t h + S t , N e w + Y o r k , N Y | \ 8 t h + A v e n u e + % 2 6 + 4 2 n d + S t , N e w + Y o r k , N Y | P a r k + A v e + % 2 6 + 4 2 n d + S t , N e w + Y o r k , N Y , N Y | \ P a r k + A v e + % 2 6 + 3 4 t h + S t , N e w + Y o r k , N Y , N Y Ten en cuenta que se establece la ruta para que sea invisible y el rea poligonal para que tenga una opacidad del 15%.
Polilneas codificadas
Puedes declarar una ruta como una polilnea codificada, en lugar de como una serie de ubicaciones, utilizando el prefijo e n c : en la declaracin de ubicacin de p a t h . Ten en cuenta que si suministras una ruta de polilnea codificada para un mapa, no tendrs que especificar los parmetros c e n t e rni z o o m(que normalmente son obligatorios). El siguiente ejemplo muestra la ruta de la autopista de Alaska desde Dawson Creek (Columbia Britnica) hasta Delta Junction (Alaska) con una polilnea codificada:
h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? s i z e = 4 0 0 x 4 0 0 & p a t h = w e i g h t : 3 % 7 C c o l o r : o r a n g e % 7 C e n c : p o l y l i n e _
21/24
19/05/13
Al igual que sucede con las rutas estndar, las rutas de polilneas codificadas tambin pueden delimitar reas poligonales si se incluye un argumento f i l l c o l o ren el parmetro p a t h . En el siguiente ejemplo, se muestra el rea poligonal de Brooklyn (Nueva York):
h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? s i z e = 4 0 0 x 4 0 0 & p a t h = f i l l c o l o r : 0 x A A 0 0 0 0 3 3 % 7 C c o l o r : 0 x F F F F F F 0 0 e n c : e n c o d e d _ d a t a
Ventanas grficas
Las imgenes pueden especificar una ventana grfica indicando las ubicaciones visibles mediante el parmetro v i s i b l e .A travs del parmetro v i s i b l e , el servicio de Google Static Maps generar un mapa en el que las ubicaciones existentes sean visibles (este parmetro se puede combinar con rutas o marcadores existentes para definir tambin una regin visible). Si se define una ventana grfica de este modo, no ser necesario especificar un nivel de zoom exacto. En el ejemplo que aparece a continuacin se muestra un mapa que se centra en Boston (Massachusetts) y que incluye MIT y Harvard Square en Cambridge (Massachusetts): h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = B o s t o n , M A
& v i s i b l e = 7 7 + M a s s a c h u s e t t s + A v e , C a m b r i d g e , M A % 7 C H a r v a r d + S q u a r e , C a m b r i d g e , M A & s i z e = 5 1 2 x 5 1 2 & s e n s o r = t r u e _ o r _ f a
22/24
19/05/13
Cmo posicionar de forma implcita mapas que usan marcadores

Por lo general, debers especificar los parmetros de URL c e n t e ry z o o mpara definir la ubicacin y el nivel de zoom del mapa que has generado. Sin embargo, si proporcionas los parmetros m a r k e r s ,p a t ho v i s i b l e , puedes dejar que el API de Google Static Maps determine, de forma implcita, el centro y el nivel de zoom correctos, segn una evaluacin de la posicin de estos elementos. Si proporcionas dos o ms elementos, el API de Google Static Maps determinar un centro y un nivel de zoom adecuados, incluyendo mrgenes generosos para los elementos incluidos. En el ejemplo que se indica a continuacin, se muestra San Francisco, Oakland y San Jos (California): h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? s i z e = 5 1 2 x 5 1 2 & m a p t y p e = r o a d m a p \ & m a r k e r s = s i z e : m i d % 7 C c o l o r : r e d % 7 C S a n + F r a n c i s c o , C A % 7 C O a k l a n d , C A % 7 C S a n + J o s e , C A & s e n s o r = f a l s e
23/24
19/05/13
Ms informacin
Para obtener ms informacin sobre el uso del API de Google Static Maps y de otras API de Google Maps, consulta la pgina de la comunidad del API de Google Maps.
Last updated enero 31, 2013.
Google
Condiciones de servicio
Poltica de privacidad
Empleo
espaol
Informar sobre un error
24/24

Guía para Desarrolladores de La Versión 2 Del API de Google Static Maps

Cargado por

Copyright:

Formatos disponibles

Guía para Desarrolladores de La Versión 2 Del API de Google Static Maps

Cargado por

Información del documento

Descripción original:

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Guía para Desarrolladores de La Versión 2 Del API de Google Static Maps

Cargado por

Copyright:

Formatos disponibles

19/05/13

Google Maps Jobs X

API de imgenes de Google Maps

Comentar este documento

Gua para desarrolladores de la versin 2 del API de Google Static Maps

h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = N e w + Y o r k , N Y & z o o m = 1 3 & s i z e = 6 0 0 x 3 0 0 & k e y = A P I _ c o n s o l e _ k

Restriccin de tamao de la URL

Cmo usar parmetros

Cmo especificar ubicaciones

Cmo indicar el uso de un sensor

Dispositivo Escritorio (con h e i g h t = " 1 0 0 p x "y w i d t h = " 1 0 0 p x "en la etiqueta i m g )

Alta resolucin (simulada)

h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = 4 0 . 7 1 4 7 2 8 , 7 3 . 9 9 8 6 7 2 & z o o m = 1 2 & s i z e = 4 0 0 x 4 0 0 & m a p t y p e =

h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = 4 0 . 7 1 4 7 2 8 , 7 3 . 9 9 8 6 7 2 & z o o m = 1 2 & s i z e = 4 0 0 x 4 0 0 & m a p t y p e =

h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = 4 0 . 7 1 4 7 2 8 , 7 3 . 9 9 8 6 7 2 & z o o m = 1 2 & s i z e = 4 0 0 x 4 0 0 & m a p t y p e =

h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? c e n t e r = 4 0 . 7 1 4 7 2 8 , 7 3 . 9 9 8 6 7 2 & z o o m = 1 2 & s i z e = 4 0 0 x 4 0 0 & m a p t y p e =

Mapas con estilos

Elementos de los recursos de mapa

h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? s e n s o r = f a l s e & s i z e = 5 1 2 x 5 1 2 & c e n t e r = B r o o k l y n & z o o m = 1 2 & s t y l e = f

h t t p : / / m a p s . g o o g l e a p i s . c o m / m a p s / a p i / s t a t i c m a p ? s e n s o r = f a l s e & s i z e = 5 1 2 x 5 1 2 & z o o m = 1 1 & c e n t e r = C h i c a g o & s t y l e = f e

Rutas de mapas estticos

Los detalles del parmetro p a t haparecen a continuacin: p a t h = c o l o r : 0 x 0 0 0 0 f f | w e i g h t : 5 | 4 0 . 7 3 7 1 0 2 , 7 3 . 9 9 0 3 1 8 | 4 0 . 7 4 9 8 2 5 , 7 3 . 9 8 7 9 6 3 | 4 0 . 7 5 2 9 4 6 , 7 3 . 9 8 7 3 8 4 | 4 0 . 7 5 5 8 2 3

Los detalles del parmetro p a t haparecen a continuacin:

& v i s i b l e = 7 7 + M a s s a c h u s e t t s + A v e , C a m b r i d g e , M A % 7 C H a r v a r d + S q u a r e , C a m b r i d g e , M A & s i z e = 5 1 2 x 5 1 2 & s e n s o r = t r u e _ o r _ f a

Cmo posicionar de forma implcita mapas que usan marcadores

Last updated enero 31, 2013.

Informar sobre un error

También podría gustarte