Plantilla:Map draw/doc

Summary

Esta plantilla permite dibujar objetos sobre un mapa, incluyendo puntos, líneas y polígonos. Al pulsar sobre el mapa en la página, se abrirá un mapa interactivo en pantalla completa que permite consultar información detallada sobre cada uno de los objetos representados.

Se trata de una herramienta de ayuda para construir la sintaxis GeoJSON empleada por la extensión Kartographer, ofreciendo una estructura flexible de parámetros. Algunos valores se pueden calcular automáticamente o extraerse directamente de Wikidata.

Es importante tener en cuenta que el uso de las etiquetas mapframe y maplink de la extensión Kartographer, sobre las que se basa esta plantilla, siempre genera una imagen de mapa estático en la página del artículo. Al pulsar sobre él, se abrirá un mapa interactivo en la misma pestaña (con opción de cierre sin salir de ella), utilizando como base los datos de OpenStreetMap. Alternativamente, haciendo clic derecho, se puede abrir en una nueva pestaña o ventana.


Sintaxis

editar

Sintaxis simple para un solo objeto

editar
  • {{map draw}}
 Genera un mapa estándar utilizando las coordenadas del artículo en Wikidata.
  • {{map draw | coordenadas }}
 Genera un mapa centrado en las coordenadas indicadas.
  • {{map draw |latitud=|longitud=|zoom=|commons=}}
 Genera un mapa con datos de Wikimedia Commons.

Sintaxis completa

editar
{{map draw
    |type= |latitude= |longitude=  |zoom= 
    |height= |width= |text= |align= |frameless= |class= 
    |coordinates= |title= |description= |image= 
    |marker-color= |marker-size= |marker-symbol=
    |stroke= |stroke-width= |stroke-opacity=
    |fill= |fill-opacity=
    |geotype= |ids=
        |geotype1=Point |coordinates1= |title1= |description1= |image1= |marker-color1= |marker-size1= |marker-symbol1=
        |geotype2=LineString |coordinates2= |title2= |description2= |image2= |stroke2= |stroke-width2= |stroke-opacity2= 
        |geotype3=Polygon |coordinates3= |title3= |description3= |image3= |fill3= |fill-opacity3= |stroke3= |stroke-width3= |stroke-opacity3= 
        |geotype4=(geoshape/geomask/geoline) |ids4= |title4= |description4= |image4= |fill4= |fill-opacity4= |stroke4= |stroke-width4= |stroke-opacity4= 
        |titleN= ...
    |commons= 
}}

El único dato requerido son las coordenadas, que pueden especificarse en el parámetro correspondiente o, en su defecto, obtenerse de Wikidata. Para las formas geométricas u objetos externos (geotype externos), es obligatoria su definición. Todos los demás parámetros son opcionales.

Los parámetros numerados permiten combinar diferentes objetos en el mismo mapa. Deben seguir una numeración correlativa a partir del 1.

Datos del mapa

editar
  • type (opcional): Tipo de representación.
    • type =mapframe (de manera predeterminada): genera un mapa estático incrustado en la página. Es lo que se ve directamente en el artículo como vista previa. Al pulsar sobre él, se abre el mapa interactivo en pantalla completa con todos los objetos dibujados.
    • type =maplink: no muestra un mapa en la página, sino un ícono y un enlace que abre el mapa interactivo en una ventana emergente o pestaña nueva. Se usa cuando se quiere referenciar la ubicación sin ocupar espacio con un mapa completo.
  • latitude / longitude (opcional): Coordenadas del centro del mapa en formato decimal. De forma predeterminada se calcula el centro de todos los puntos representados. Solo es necesario especificarlas si se desea centrar el mapa en un punto distinto.
  • zoom (opcional): Nivel de acercamiento del mapa, en rango 0-18:
 - 0 = mapa mundial  
 - 9-11 = región  
 - 13 = ciudad  
 - 18 = edificio  
 De manera predeterminada se calcula el zoom mínimo necesario para representar todos los puntos en el marco definido por height y width. Para un solo punto, se puede usar el parámetro default_zoom, o bien se toma 9 de forma predeterminada.

Datos específicos para mapframe

editar
  • height / width (opcional): Altura y anchura del mapa en píxeles. De manera predeterminada 300x300 px, adecuada para tablas informativas y dispositivos móviles.
  • text (opcional): Texto al pie del mapa.
  • align (opcional): Alineación del mapa. Valores: «left», «center», «right». De forma predeterminada «right».
  • frameless (opcional): Cualquier valor muestra el mapa sin marco. Es incompatible con el parámetro text.
editar
  • text (opcional): Texto que aparece en el enlace. De manera predeterminada muestra las coordenadas en caso de un solo objeto.
  • class (opcional): Formato CSS a aplicar mediante una clase definida en Mediawiki:Common.css, por ejemplo class=infobox. La clase no-icon evita que se muestre el icono delante del enlace.

Datos de los objetos

editar

Se puede definir más de un objeto numerando los parámetros correlativamente a partir del 1. Si no existe numeración, el parámetro sin número se aplicará al primer objeto.

Parámetros comunes a todos los tipos de objeto

editar
  • geotype / geotypeN: Tipo de objeto. Valores:
    • Para objetos dibujados (opcional): Point, MultiPoint, LineString, Polygon. El tipo se obtiene a partir del formato de las coordenadas. Solo es obligatorio en el caso de MultiPoint.
    • Para objetos externos importados de OpenStreetMap mediante «ids» de Wikidata (obligatorio):
      • geoshape: polígono con área interior marcada
      • geomask: polígono con área exterior marcada
      • geoline: polígono con solo la línea de contorno; para objetos lineales funciona en pocos casos, pendiente de phab:T155924.
  • coordinates / coordinatesN (opcional): Coordenadas en formato decimal.
    • Para un solo objeto puede usarse como primer parámetro sin nombre. De forma predeterminada se obtiene de Wikidata.
      • Para datos externos no se utiliza.
    • Formatos:
      • Punto: «latitud,longitud»
      • Línea o multipunto: varios puntos separados por punto y coma «punto; punto; …»
      • Polígono: línea de contorno con la última coordenada igual a la primera. Agujeros internos: otro polígono separado por dos puntos «linea_contorno:linea_contorno…»
  • title / titleN (opcional): Título de la etiqueta del objeto.
  • description / descriptionN (opcional): Descripción del objeto, que aparece como subtítulo en la etiqueta.
  • image / imageN (opcional): Imagen en la etiqueta del objeto, con el nombre del archivo sin prefijo.

Datos específicos para puntos

editar
  • marker-color / marker-colorN (opcional): Color del marcador en formato CSS. De manera predeterminada "#7e7e7e" gris claro. Ver tabla de colores.
  • marker-size / marker-sizeN (opcional): Tamaño del marcador. Valores: small, medium, large. De forma predeterminada medium.
  • marker-symbol / marker-symbolN (opcional): Símbolo dentro del marcador. De manera predeterminada vacío. Valores:
    • marker-symbol(N) = -number: numera correlativamente todos los puntos; también permite un número entre 0 y 9.
    • marker-symbol(N) = -letter: marca los puntos con letras A, B, C…; acepta letras entre a y z.
    • marker-symbol(N) = icono: nombre de un icono disponible en Iconos Maki. Más iconos en mw:Help:Extension:Kartographer/Icons.

Datos específicos para líneas

editar
  • stroke / strokeN (opcional): Color de la línea en formato CSS. De manera predeterminada "#555555" gris oscuro.
  • stroke-width / stroke-widthN (opcional): Anchura de la línea (>=0). De forma predeterminada 2.
  • stroke-opacity / stroke-opacityN (opcional): Opacidad de la línea (0-1). De manera predeterminada 1.0.

Datos específicos para polígonos

editar
  • fill / fillN (opcional): Color del interior del polígono (excepto agujeros). De manera predeterminada "#555555" gris oscuro.
  • fill-opacity / fill-opacityN (opcional): Opacidad del interior del polígono (0-1). De forma predeterminada 0.6.
  • También se aplican stroke, stroke-width y stroke-opacity para la línea de contorno.

Datos específicos para objetos externos

editar
  • ids / idsN (opcional): Identificador del elemento en Wikidata (Q...). Se pueden incluir varios separados por coma. De forma predeterminada obtiene el identificador de la página actual. Permite acceder a objetos de OpenStreetMap vinculados a la propiedad wikidata=Q…
  • commons / commonsN (opcional): Nombre de un mapa en Wikimedia Commons, sin prefijo "Data:" y con extensión ".map". Para ejemplos, consultar c:Special:Allpages/Data: y mw:Help:Map Data.

Ejemplos

editar

Ayuda

editar

Véase también

editar
  • Módulo:Mapa – Código de apoyo de la plantilla
  • mw:Help:Extension:Kartographer – Documentación de la extensión
  • Especificación simplestyle, versión GeoJSON utilizada
  • Maps en MediaWiki