Arrastre para cambiar el tamaño
MapaMunigex (Clase)
CGS S.L. - Manual de referencia
Clase para generar gráficos de mapas por medio del servício de mapas de tipo OpenStreetMap, Google Maps, Bing maps, etc. Estos gráficos luego se pueden incrustar dentro de los documentos generados por Munigex. Corresponde al tipo de "P" de Munigex
Jerarquía de herencia

Espacio de nombres: CGSSL.Munigex.Lib.Tipos
Ensamblado: DocumentosLib (en DocumentosLib.dll) Versión: 2.2.1.0 (2.2.1.0)
Sintaxis
C#
public class MapaMunigex : TypeBaseMunigex

El tipo MapaMunigex expone a los siguientes miembros.

Constructores
  NombreDescripción
Método públicoMapaMunigex
Constructor por defecto de un mapa de Munigex.
Método públicoCódigo de ejemploMapaMunigex(String)
Construye un objeto mapa en base a la descripción dada en una cadena de texto con un formato muy concreto
Método públicoMapaMunigex(PuntoMapa)
Construye un mapa enfocado en un punto central y con todos sus valores restantes deducidos.
Método públicoMapaMunigex(PuntoMapa, Int32)
Construye un mapa enfocado en un punto central a un determinado nivel de ampliación y con todos sus valores restante deducidos
Método públicoMapaMunigex(PuntoMapa, PuntoMapa, Int32)
Constructor para generar un mapa en base a los puntos del área facilitada y un nivel de ampliación
Método públicoMapaMunigex(PuntoMapa, Int32, Single)
Construye un mapa centrado en un punto con un determinado nivel de ampliación y con todos sus valores restantes deducidos.
Método públicoCódigo de ejemploMapaMunigex(PuntoMapa, PuntoMapa, Int32, Single)
Constructor para generar un mapa en base a los puntos del área facilitada y otros datos
Método públicoMapaMunigex(PuntoMapa, Int32, Single, Single)
Construye un mapa centrado en un punto con un determinado nivel de ampliación y con todos sus valores restantes deducidos.
Método públicoMapaMunigex(Double, Double, Double, Double, Int32)
Constructor para generar un mapa en base a los puntos del área facilitada y otros datos
Método públicoCódigo de ejemploMapaMunigex(Double, Double, Double, Double, Int32, Single)
Constructor para generar un mapa en base a los puntos del área facilitada y otros datos
Top
Propiedades
  NombreDescripción
Propiedad públicaAltoCm
Alto de la imagen resultante en centímetros.
Propiedad públicaAnchoCm
Ancho de la imagen resultante en centímetros
Propiedad públicaAsignado
Valor explícito que representa esta instancia
(Reemplaza a TypeBaseMunigexAsignado.)
Propiedad públicaDescarga
Bytes en crudo de la imagen generada en formato PNG. Esta imagen puede tardar varios segundos en generarse. si la resolución es muy elevada. La imagen se crea en formato PNG
Propiedad públicaEsNumerico
Indica que el dato es de tipo numérico. MunigexMapa no es numérico
(Reemplaza a TypeBaseMunigexEsNumerico.)
Propiedad públicaFuenteMapa
Tipo de mapa que esta establecido por defecto
Propiedad públicaHayArea
Indica si el área de la imagen a generar es válida.
Propiedad públicaCódigo de ejemploImagen
Obtiene la imagen del mapa que puede ser tratada como una imagen normal
Propiedad públicaMarca
Punto de la marca de interés dentro del cuadro visualizado.
Propiedad públicaNivelZoom
Nivel de detalle (zoom) de la imagen del mapa. Puede valer de 1 a 18 en OpenStreetmap.
Propiedad públicaNW
Esquina noroeste del recuadro a visualizar en el mapa
Propiedad públicaSE
Esquina sureste del recuadro a visualizar en el mapa
Propiedad públicaTipo
- Código de texto del tipo de dato que representa este elemento en la aplicación Munigex. Siempre devuelve "P" de mapa
(Reemplaza a TypeBaseMunigexTipo.)
Propiedad públicaUrl
URL completa que permite reproducir la imagen definida para este mapa.
Propiedad públicaValor
Valor explícito que representa esta instancia
Top
Métodos
  NombreDescripción
Método públicoAmpliarRecuadro
Amplía la zona a visualizar. Mantiene el punto marcado como centro de ampliación.
Método públicoClonar
Hace una copia del mapa.
Método públicoCuadro
Establece un nuevo recuadro de visualización del mapa
Método públicoEncuadrar(PuntoMapa)
Encuadra una imagen moviéndola una serie de grados en longitud y latitud
Método públicoCódigo de ejemploEncuadrar(Double, Double)
Genera un nuevo mapa encuadrando la imagen y moviéndola una cantidad de unidades en longitud y latitud relativas al tamaño del cuadro actualmente enfocado.
Método públicoEnFuenteMapa(String)
Genera un nuevo mapa con una fuente generador distinta.
Método públicoEnFuenteMapa(MapaFuente)
Establece la fuente (la institución que provee) de los mapas a utilizar.
Método públicoEnTamano
Devuelve una copia con el nuevo tamaño del mapa si se elige el estilo "ImagenMapa" al combinar
Método públicoEnTexto
Devuelve los datos del mapa en un formato de cadena legible.
Método públicoEnTextoLegible
Devuelve un valor de la cadena en texto legible.
(Reemplaza a TypeBaseMunigexEnTextoLegible.)
Método públicoEstilo(Int16)
Establece el estilo deseado del campo para generar el documento combinado
Método públicoEstilo(Int16, Int16)
Establece el estilo deseado al generar el documento combinado normal y el combinado plano
Método públicoLoadFromVar
Carga las opciones de visualización en MS-Word de la definición dada en la base de datos en la variable IDVar
(Reemplaza a TypeBaseMunigexLoadFromVar(String).)
Método públicoMarcar(PuntoMapa)
Coloca una marca de un punto de interés.
Método públicoMarcar(Double, Double)
Coloca una marca de un punto de interés en la longitud y latitud indicadas.
Método públicoMarcarCentro
Coloca una marca de interés en el centro del recuadro seleccionado
Método públicoModoCombinacionSinVariables
Método públicoToString
Devuelve los datos del mapa en un formato de cadena legible y que permite reconstruir el objeto a la vez.
(Reemplaza a ObjectToString.)
Método públicoVista
Devuelve un nuevo mapa con la vista cambiada.
Top
Campos
  NombreDescripción
Campo públicoMiembro estáticoCodTipo
Código interno que utiliza Munigex para almacenar un valor de este tipo. Siempre devuelve "P" de mapa
Top
Observaciones

Cada mapa consta de varios elementos:

  • Un par de coordenadas de la esquina noroeste del recuadro a visualizar.
  • Un par de coordenadas de la esquina sureste del recuadro a visualizar.
  • Un factor de detalle (zoom) del mapa con valores entre 1 y 20 (Depende de la fuente de los mapas). Cuanto más grande es este factor más detallado se ve el mapa. Este factor tiene carácter logarítmico, no es lineal, de manera que cada nivel es un factor de multiplicación de la escala x2. El nivel de detalle con valor=1 es el equivalente a una visualización del mapa del mundo completo y un nivel 18 una ampliación de 218=262.144 veces más grande, aproximadamente unos 150 metros.
  • Un ancho en centímetros de la imagen final que se genere. Este ancho conocido de antemano permite ajustar la resolución del mapa para que la visualización del mismo sea lo más agradable posible. El alto se deduce de la proporción del recuadro a visualizar.
  • Un par de coordenadas de un punto de interés. Este punto se decorará con una imagen para destacarlo. Este elemento es opcional.
  • Una fuente de mapas. Los hay de Google, de Bing, de OpenStreetMap y de MapQuest. Cada uno de ellos genera imágenes con unos atributos diferentes por lo que el usuario debe elegir uno. Por ejemplo OpenStreeMap es gratis pero su calidad y resolución es baja.
  • Una vista. Hay varios tipos de vista en los mapas: De carreteras, de satelite, etc.

Hay que notar que los datos se pasan con grados decimales sin el símbolo de grados. La longitud 0º corresponde al meridiano de Greenwich y los grados positivos de longitud van hacia el este. Los grados positivos de latitud van hacia el norte. Así el polo norte esta en la latitud +90º y cualquier punto del ecuador esta en la latitud 0º. El polo sur esta en la latitud -90º.

Si se anotan valores superiores a los indicados, Munigex los adecua para no exceder la capacidad del servicio de generación de mapas.

Por simplicidad con los mapas habituales se suele usar el convenio de direcciones siguiente: arriba = norte e izquierda = oeste.

Estos mapas se generan con formato de imagen de bits (PNG) y pueden ser incrustados dentro de los documentos cuando se combinan.

Una vez construido el objeto se puede utilizar para obtener imágenes de mapas de carreteras y edificaciones de "OpenStreetMap" aunque también pueden utilizarse los de "Google Maps" si así se desea.

Cabe señalar que "OpenStreetMap" es una organización que permite hacer mapas de acceso gratuito en el que los usuarios pueden completarlos con fotos e información y todos los detalles que quieran. Para más información acceder a http://www.openstreetmap.es

Vea también