Manual para desarrolladores

Manual para desarrolladores

Argenmap v1 desde CDN

jQuery http://code.jquery.com/jquery-1.8.2.js
Argenmap v1 http://www.ign.gob.ar/argenmap/argenmap.jquery.min.js
Google Maps API http://maps.google.com/maps/api/js?sensor=false


Eventos disparados por Argenmap v1

Los eventos disparados por Argenmap v1 están basados en la interfaz de eventos de jQuery, y pueden ser utilizados mediante el método .on() del objeto jQuery creado con Argenmap v1.

.on('zoomend', function ( event , zoomActual ) {} )

El evento zoomend se dispara cuando el mapa modificó su nivel de zoom.

event
(jQuery Event): El objeto de evento lanzado por jQuery
zoomActual
(int): Número indicando el nuevo nivel de zoom

.on('moveend', function ( event , zoomActual, centro[lat, lng] ) {} )

El evento moveend se dispara cuando termina de arrastrarse el mapa, o se modifica el centro o se modifica el zoom de la vista actual.

event
(jQuery Event): El objeto de evento lanzado por jQuery
zoomActual
(int): Número indicando el nuevo nivel de zoom
centro
(Array): Centro[0] tiene la latitud actual del centro del mapa y centro[1] la longitud del centro.


Crear un mapa con Argenmap v1

argenmap()

Esta función permite creae un mapa simple sobre un elemento html. Este método inicializa el mapa y se invoca una única vez. Todos los demás métodos se utilizan luego de aplicar éste, y pueden concatenarse $('#mapa').argenmap().centro(-34,-59).


Cambiar la vista con Argenmap v1

centro(lat:float, lng:float)

Esta función permite para cambiar el centro del mapa luego de instanciarlo, .centro(lat,lng). Si se llama a centro() sin parámetros, devuelve el centro actual.

lat
(float): Número indicando los grados decimales de latitud
lng
(float): Número indicando los grados decimales de longitud

zoom(zoom:int)

Esta función permite aumentar o disminuir la escala del mapa. Si se llama zoom() sin parámetros, devuelve el nivel de zoom actual.

zoom
(int): Un número entero entre 1 y 22 indicando el nivel de zoom al que se quiere visualizar el mapa.


Agregar capas base y superponer capas propias con Argenmap v1

agregarCapaWMS(opciones:Object)

Esta función permite superponer una capa WMS sobre las capas base.

opciones
(objeto simple): Parámetros para configurar la solicitud de la capa WMS. Argenmap v1 utiliza los mismos parámetros que los servicios WMS tradicionales.
url
(string): La url del servidor WMS.
Ejemplo: http://wms.ign.gob.ar/geoserver/wms?
La url debe finalizar con el signo ? o con el signo &.
capas
(string): Los nombres de las capas separados por comas (corresponde al formato del parámetro layers de WMS) de las capas que se quieren pedir al servidor WMS.
Ejemplo: "departamentos,rios,ciudades"
nombre
(string, opcional): El nombre interno que tendrá la capa.
formato
(string, opcional): Valor por defecto: "image/png"
El formato MIME de archivo: "image/jpeg", "image/jpg", "image/png", "image/png8", "image/gif".

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

agregarCapaBaseWMS(opciones:Object)

Esta función permite agregar una capa base al mapa.

opciones
(objeto simple): Parámetros para configurar la solicitud de la capa WMS. Argenmap v1 utiliza los mismos parámetros que los servicios WMS tradicionales.
url
(string): La url del servidor WMS.
Ejemplo: http://wms.ign.gob.ar/geoserver/wms?
La url debe finalizar con el signo ? o con el signo &.
capas
(string): Los nombres de las capas separados por comas (corresponde al formato del parámetro layers de WMS) de las capas que se quieren pedir al servidor WMS.
Ejemplo: "departamentos,rios,ciudades"
nombre
(string, opcional): El nombre interno que tendrá la capa.
formato
(string, opcional): Valor por defecto: "image/png"
El formato MIME de archivo: "image/jpeg", "image/jpg", "image/png", "image/png8", "image/gif".

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

capaBase(nombre:string)

Esta función permite cambiar la capa base actualmente visible en el mapa por la capa especificada mediante el parámetro nombre. Si no se asignan parámetros devuelve el nombre de la capa base actualmente visible.

nombre
(string): El nombre de una de las capas estándar (satellite o IGN) o el nombre de una capa que haya sido superpuesta previamente con agregarCapaBaseWMS().

agregarCapaKML(opciones:Object)

Esta función permite superponer una capa que se importa a partir de un archivo .kml que puede ser accedido a través de una url.

opciones
(objeto simple): Parámetros para configurar la solicitud de la capa WMS.
url
(string): La url del archivo .kml.
nombre
(string - opcional) Nombre que de la nueva capa.

El archivo .kml. tiene que estar accesible públicamente.


Agregar marcadores con Argenmap v1

agregarMarcador(marcador:Object)

Esta función permite crear un marcador a través de la llamada $(selector).agregarMarcador().Por defecto el marcador se agregará en el centro del mapa.

marcador
(objeto simple, opcional): Parámetros para configurar opciones adicionales del marcador que va a ser creado:
lat
(float): La latitud para el marcador (coordenadas geográficas).
lng
(float): La longitud para el marcador (coordenadas geográficas).
icono
(string, opcional): La url de la imagen .pnga utilizar como ícono del marcador.
nombre
(string, opcional): El nombre que tendrá el marcador
contenido
(string, opcional): Contenido html que se observará en un globo de texto al hacer click sobre el marcador.

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.

$(selector).modificarMarcador(nombre, opciones)

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

nombre
(string): El nombre asignado al marcador cuando fue creado.
opciones
(objeto simple): Idénticos parámetros a los utilizados para crear un nuevo marcado.

$(selector).quitarMarcador(nombre)

Esta función permite eliminar un marcador del mapa. La referencia del marcador a modificar es a través del nombre asignado al marcador.

nombre
(string): El nombre asignado al marcador cuando fue creado.

agregarMarcadores([marcador1:Object, marcador2:Object,...,marcadorN:Object])

Esta función permite crear varios marcadores sobre el mapa a partir de un arreglo de objetos que definen marcadores. Cada objeto es igual al que recibe agregarMarcador()