Manual para desarrolladores

Argenmap v2 desde CDN

jQuery https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js
Argenmap v2 http://www.ign.gob.ar/argenmap2/argenmap.jquery.min.js

Crear un mapa con Argenmap v2

$(selector).argenmap()

Esta función crea una instancia de mapa sobre un elemento html. Preferentemente contenedores divs con un alto definido en píxels. Argenmap v2 puede instanciarse pasando un objeto como argumento. El objeto puede tener opciones de inicialización. A continuación se puede ver el detalle de las opciones con las que puede inicializarse Argenmap v2

Argumentos

Opciones

La barra de zoom se ocultará automáticamente si el alto del mapa no fuera suficiente, aún cuando se hubiese configurando mostrarBarraDeZoom en modeo true.

Las capas satelitales y base están preparadas para mostrarse en EPSG:3857. Si fuese necesario instanciar un mapa en EPSG:4326 para luego importar capas WMS que necesiten esa proyección, se deberá hacerlo con la opción tipo blanco y luego agregar las capas WMS necesarias.

Cambiar la vista con Argenmap v2

$(selector).centro()

Luego de instanciar un mapa, puede usarse .centro(lat,lng) para cambiar el centro del mapa.

Si llamás a .centro() sin parámetros, devuelve el centro actual del mapa, un arreglo del tipo [lat,lng].

Argumentos

Cuando se usa .centro() para pedir las coordenadas del centro del mapa se rompe la encadenabilidad de jQuery y este devuelve un arreglo.

$(selector).zoom()

Aumenta, disminuye o devuelve el nivel de zoom.

Si llamás a zoom() sin parámetros, devuelve un int que representa el nivel de escala del mapa.

Argumentos

Cuando se usa .zoom() para pedir el nivel de zoom del mapa se rompe la encadenabilidad de jQuery y este devuelve un int.

Agregar capas base y superponer capas propias con Argenmap v2

$(selector).capaBase()

Esta función permite cambia a la capa base.

Argumentos

Cuando se usa .capaBase() para pedir la capa base actual del mapa se rompe la encadenabilidad de jQuery y este devuelve un string indicando el nombre de la capa base actual del mapa.

$(selector).agregarCapaWMS()

Superpone una capa desde un servicio WMS al mapa

Argumentos

Opciones

El nombre utilizado para la capa también será el que se utilice para hacer referencia a la capa en otros métodos como quitarCapa o modificarCapa. Es posible dejarlo vacío, sin embargo es considerado una buena práctica la asignación de un nombre

El servicio WMS tiene que estar configurado para poder generar las imágenes con el sistema de referencia EPSG:3857 que es el código que define la proyección de OpenStreetMap, Google Maps, Bing Maps, ESRI WEB Maps y demás mapas web populares.

$(selector).agregarCapaBaseWMS()

Esta función agrega una capa base desde un servicio WMS al mapa. Esta función es igual a agregarCapaWMS pero con todas las opciones configuradas por defecto para conformar una capa base.

Argumentos

Opciones

El nombre utilizado para la capa también será el que se utilice para hacer referencia a la capa en otros métodos como quitarCapa o modificarCapa. Es posible dejarlo vacío, sin embargo es considerado una buena práctica la asignación de un nombre

El servicio WMS tiene que estar configurado para poder generar las imágenes con el sistema de referencia EPSG:3857 que es el código que define la proyección de OpenStreetMap, Google Maps, Bing Maps, ESRI WEB Maps y demás mapas web populares.

$(selector).agregarCapaKML()

Esta función superpone una capa KML en el mapa

Argumentos

Opciones

Los archivos KML y SLD deben encontrarse en el mismo dominio, de lo contrario se recibirá un error de "Política del mismo origen (Same origin policy)".

Para evitar el error "Política del mismo origen (Same origin policy)" Argenmap v2 utiliza un proxy simple en PHP configurado a través de la opciónn proxy Una vez asignado, todos las solicitudes pasan a través de dicho proxy. Es posible utilizar un script de proxy propio y configurarlo asignando una url a proxy.

$(selector).agregarImagen()

Esta función superpone una imagen en el mapa

Argumentos

Opciones

$(selector).quitarCapa()

Esta función quita una capa del mapa. La referencia a la capa que se desea quitar es a través del nombre asignado a la capa.

Argumentos

Agregar marcadores con Argenmap v2

$(selector).agregarMarcador()

Esta función crear un marcador mediante opciones o simplemente haciendo la llamada $(selector).agregarMarcador(), y por defecto el marcador se agregará en el centro del mapa.

Argumentos

Opciones

Si se incorpora un marcador con el mismo nombre que otro, el más nuevo reemplazará al anterior. Este comportamiento provoca que al agregar más de un marcador sin nombre, los mismos se sobreescriban.

$(selector).modificarMarcador()

Esta función modifica un marcador previamente creado. Las opciones para modificar el marcador son las mismas que al momento de crear uno. La referencia del marcador a modificar es el nombre asignado al marcador y es el primer parámetro de este método.

Argumentos

$(selector).quitarMarcador()

Esta función elimina un marcador del mapa.

La referencia al marcador a eliminar es a través del nombre asignado al marcador.

Argumentos

$(selector).agregarMarcadores()

Esta función crea varios marcadores sobre el mapa a partir de un arreglo de objetos que definen las opciones de cada marcador. Cada objeto es igual al que recibe agregarMarcador().

Argumentos

Galería de íconos

La galería de íconos es un diccionario de conveniencia para utilizar marcadores predeterminados. En lugar de suministrar la url de una imagen que se fuera a utilizar como ícono de un marcador, es posible usar el nombre de uno de estos íconos.

Por ejemplo, estas dos llamadas a .agregarMarcador() tienen el mismo resultado:
$('#mapa').agregarMarcador({icono:"tornado"})
$('#mapa').agregarMarcador({icono:"http://ign.gob.ar/argenmap2/argenmap.jquery/img/iconos/tornado.png"})

Íconos disponibles

nombre	ícono	descripción
aeropuerto		Aeropuertos y pistas de aterrizaje
cajero		ATM / Cajero electrónico
correo		Correo
restaurante		Comedor / Restaurante
hospital		Hospital / Clínica
policia		Comisaría / Estación de policía
estacionDeServicio		Estación de servicio
tren		Estación de tren
manifestacion		Manifestación / Turba
peligro		Atención / Peligro
delito		Delito / Crimen
inundacion		Inundaciones
tormenta		Tormenta
tornado		Tornado
terremoto		Terremoto / Derrumbe
volcan		Erupción volcánica / Cenizas
corteDeLuz		Corte de luz / Apagón
pico		Montaña / Cerro / Pico
cascada		Cascada / Salto
glaciar		Glaciar

El marcador utiliza como punto de anclaje el centro horizontal y el borde inferior de la imagen. Para mayor información ver Map Icons Collection.

API OpenLayers

Argenmap v2 utiliza la API de OpenLayers versión 2.12.

Una vez que se instancia Argenmap v2 en un selector, se guarda una instancia de clase argenmap asociado al mismo a través de la funcionalidad $.data() de jQuery.

Asimismo, la clase argenmap guarda una instancia de clase OpenLayersMap en la propiedad mapa. Referenciando a esta propiedad podés acceder a cualquier otra funcionalidad que necesites de OpenLayers para realizar operaciones y aplicaciones más complejas:

var claseOpenLayersMap = $('#mapa').data('argenmap').mapa;
claseOpenLayersMap.getZoom(); //devuelve el nivel de zoom actual del mapa