Buscador de Parcelas Manual de uso para desarrolladores IDESF

Transcripción

1 Buscador de Parcelas Manual de uso para desarrolladores IDESF

2 INDICE de CONTENIDO 01- INTRODUCCION FUNCIONALIDADES COMO EMBEBER EL WIDGET BUSCADOR DE PARCELAS OPCIONES PARA PARAMETRIZAR EL WIDGET RETORNO O RESULTADO...7 Revisiones...9 Página 2 de 9

3 01- INTRODUCCION La aplicación buscador de parcelas, mediante el ingreso de un identificador único, realiza la búsqueda de parcelas catastrales dentro de los límites provinciales. Si logra encontrarla, devuelve la ubicación de la misma en el mapa, y setea variables en la página web que la embebe. Caso contrario le aparecerá un mensaje Parcela no encontrada. 02- FUNCIONALIDADES a) El objetivo principal, es darle la posibilidad a cualquier ciudadano de buscar parcelas dentro del territorio de la provincia de Santa Fe y ofrecer la visualización geográfica de las mismas. b) También brinda la opción a cualquier desarrollador de embeber la aplicación en una página web, dentro de un formulario (la aplicación se ofrece en formato de widget), con el objetivo de recuperar la envolvente 1 (es decir el extent de la parcela encontrada), las coordenadas del centroide 2 de la parcela, junto al identificador de la parcela buscada y de esta forma validar su existencia. 1 Envolvente: son las coordenadas en latitud, longitud, del extremo inferior izquierdo y el extremo superior derecho (EPSG:4326) de la parcela. 2 Centroide: son las coordenadas en latitud, longitud de un punto del centro de la parcela 03- COMO EMBEBER EL WIDGET BUSCADOR DE PARCELAS Para embeber el buscador de parcelas como widget deberá realizar los siguiente pasos: a) Agregue en su código HTML la siguiente librería: <script src=" </script> b) En el cuerpo de la página web definir donde se desee, el siguiente código: <!-- EMBEBIDO BUSCADOR PARCELAS --> <script> window.name = 'BuscadorParcelasCatastrales'; var extent_parcela = []; //variable cliente que almacena el extent var id_parcela = ""; //variable cliente que almacena el id var centroide_parcela = []; //variable cliente que almacena el centroide var socket = new easyxdm.socket({ Página 3 de 9

4 remote: "<?php echo " MAPA_INCORPORADO=true&COMPACTO=false"?>", container:embebido, onready: function(){ /** * Seteamos el tamaño del iframe */ this.container.getelementsbytagname("iframe")[0].style.height = "595px"; this.container.getelementsbytagname("iframe")[0].style.width = "550px"; this.container.getelementsbytagname("iframe")[0].scrolling = "no"; this.container.getelementsbytagname("iframe")[0].frameborder = "0"; //gestión de campos html iniciales por ejemplo: $('#id_buscado').val(''); $('#centroide_parcela').val('');, onmessage:function(message, origin) { //puedo actuar sobre los mensajes que me envía el widget if(message == 'nuevabusqueda') {//ante una nueva búsqueda, el widget envía un mensaje de nuevabusqueda else{ $('#id_buscado').val(''); $('#centroide_parcela').val(''); extent_parcela = []; id_parcela = []; centroide_parcela = []; //El id parcela es cargado en el campo [0] del mensaje, //para esto hay que dividirlo utilizando message.split(','); respuesta = message.split(','); id_parcela = respuesta[0]; $('#id_buscado').val(''); $('#centroide_parcela').val(''); extent_parcela = [respuesta[1],respuesta[2],respuesta[3],respuesta[4]]; centroide_parcela = [respuesta[5],respuesta[6]]; if(extent_parcela[1]!= "") { //El extent de la parcela es cargado en el indice //[1,2,3,4] del mensaje Página 4 de 9

5 //El centroide se carga en el indice [5,6] $('#id_buscado').val(id_parcela); $('#centroide_parcela').val(centroide_parcela); else { console.log("id_parcela:"+id_parcela+"\rextent:"+extent_parcela + "\rcentroide: "+centroide_parcela); $('#id_buscado').val('no encontrada'); $('#centroide_parcela').val('no encontrada'); console.log("id_parcela:"+id_parcela); ); <!-- FIN EMBEBIDO BUSCADOR PARCELAS --> 04- OPCIONES PARA PARAMETRIZAR EL WIDGET Dentro del código de la aplicación, en el socket, se presenta una variable remote, que hace referencia a una URL parametrizable.... var socket = new easyxdm.socket({ remote: "<?php echo " MAPA_INCORPORADO=true&COMPACTO=false"?>",... Si desea generar el widget con el mapa incorporado donde se puede visualizar la parcela buscada, defina el parámetro: MAPA_INCORPORADO=true Página 5 de 9

6 Si decide configurar el widget sin el mapa. Defina el parámetro: MAPA_INCORPORADO=false De esta forma, quedará configurado para la validación de parcelas y la obtención del id de parcela, su extent asociado, y el centroide de parcela. También puede parametrizar la forma en que se ingresa el identificador único de parcela, especificando en la URL indicada, la variable COMPACTO. COMPACTO=true Página 6 de 9

7 Si configura el widget en modo compacto, implica que el campo Distrito, lo deberá ingresar mediante el número que identifica al mismo directamente. Por defecto la aplicación esta configura con los siguientes parámetros: MAPA_INCORPORADO=true COMPACTO=false Si no se define ninguna variable, el wigdet se configurará con un mapa incorporado y en modo completo. Recuerde que en la URL,la primer variable se concatena con el signo con el? y la unión de las variables se realiza agregando el símbolo & luego la variable=valor Ejemplo RETORNO O RESULTADO En todos los casos si la búsqueda es exitosa quedarán disponibles tres variables javascript, que se obtienen del mensaje proveniente del widget. Array(Strings): [id_parcela, left, bottom, right, top, Latitud, Longitud ] id_parcela: Almacena el id de parcela buscada, asociado a la envolvente guardada en extent_parcela Página 7 de 9

8 extent_parcela: array(strings) [left, bottom, right, top], donde cada posición representa una coordenada: y ambas coordenadas forman la envolvente o el extent right,top !!!! left,botom centroide_parcela: array(strings) [ Latitud, Longitud ] (Almacena las coordenadas de un punto, que en la mayoría de los casos es el centroide (centro de la parcela), y en otros caso, el centroide cae fuera de la parcela, por tener formas irregulares, para estos casos el punto se ajusta a una coordenada que este dentro de la parcela). Página 8 de 9

9 Revisiones Versión Fecha Resumen de Cambios Autor /08/2016 Documento inicial IDESF Página 9 de 9