Plantilla:Map draw

Documentación de la plantilla

Plantilla para dibujar objetos sobre un mapa, como puntos, líneas o polígonos. Pulsando sobre él se amplia el mapa interactivo en pantalla completa obteniendo información sobre cada uno de los objetos.

Esta plantilla es una ayuda para construir la sintaxis de GeoJSON de la extensión Kartographer con una estructura flexible de parámetros. Algunos valores se pueden calcular automáticamente u obtenerlos de Wikidata.

Se ha de tener en cuenta que el uso de las etiquetas mapframe y maplink de la extensión Kartographer, y en las que se basa esta plantilla, siempre generan una imagen de mapa estático en la página del artículo. Pulsando sobre él se abrirá, en la pestaña activa con opción de cierre sin salir de ella, un mapa interactivo, con base en OpenStreetMap. Pulsando botón derecho se puede abrir en una nueva pestaña o ventana.

Sintaxis

Sintaxis simple para un solo objeto:.

{{map draw}} genera un mapa estándar con las coordenadas del artículo en Wikidata

{{map draw | coordenadas }} genera un mapa estándar con centro en las coordenadas indicadas, según se detalla seguidamente

{{map draw |latitud=|longitud=|zoom=|commons=}} genera un mapa con datos de Wikimedia Commons

Sintaxis completa:

{{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, o bien especificadas en el parámetro o bien disponibles en Wikidata. Para las formas geométricas u objetos geotype externos es requerida su definición. Todos los otros parámetros son opcionales.

Los parámetros numerados son para combinar diferentes objetos. Tienen que seguir una numeración correlativa a partir del 1.

Datos del mapa

type (opcional): tipos de representación. Valores:
- type =mapframe (por defecto): genera un mapa estático en un marco como vista previa para acceder al mapa dinámico.
- type =maplink: muestra un enlace en el mapa con un icono y un texto.

latitude / longitude (opcional): Coordenadas del centro del mapa a representar, en formato decimal. Por defecto calcula el centro de todos los puntos representados, por lo que sólo será necesario si se quiere centrar el mapa en otro punto.
zoom (opcional): nivel de zum del mapa (0-18): 0=mapa mundi, 9-11=región, 13=ciudad, 18=edificio. Por defecto calcula el zum mínimo para representar todos los puntos en el marco definido por altura (height) y anchura (width). Para un solo punto usa el parámetro default_zoom o bien 9 por defecto.

Datos para mapframe:

height / width (opcional): altura y anchura del mapa en píxeles. Por defecto es 300 (300px x 300px), la medida habitual en tablas informativas y apropiada para dispositivos móviles.
text (opcional): texto al pie del mapa.
align (opcional): alineación del mapa. Valores: left, center, right. Por defecto right.
frameless (opcional): con cualquier valor muestra el mapa sin marco. Es incompatible con el parámetro texto.

Datos para maplink:

text (opcional): texto del enlace. Por defecto mostrara las coordenadas en caso de un solo objeto.
class (opcional): formato CSS a aplicar con una class que este definida en Mediawiki:Common.css, por ejemplo class=infobox. Con class=no-icon no muestra el icono delante del enlace.

Datos de los objetos

Se puede definir más de un objeto numerando los parámetros N correlativamente a partir del 1. En caso de no existir el parámetroN tomará el valor del parámetro sin la numeración.

Parámetros comunes a todos los tipos de objetos:

geotype / geotypeN: tipos de objeto. Valores:
- Para objetos dibujados (opcional): Point, MultiPoint, LineString, Polygon. Lo obtiene a partir del formato de las coordenadas. Sólo es necesario en el caso MultiPoint que tiene el mismo formato que LineString.
- Para objetos externos importados de OpenStreetMap con "ids" de Wikidata (requerido):
  - geoshape: polígono con el área interior marcada,
  - geomask: polígono con el área exterior marcada,
  - geoline: polígono con sólo la línea de contorno; para objetos lineales funciona en pocos casos, pendiente de phab:T155924.
coordinates / coordinatesN (opcional): Coordenadas en formato decimal. Como alternativa para un solo objeto puede ser el primer parámetro sin nombre. Por defecto lo obtiene de Wikidata. Para datos externos no se usa. Formatos:
- Un punto: con el formato «latitud , longitud».
- Una línea o multipunto: consta de diversos puntos con las coordenadas separadas por un punto y coma: «punto ; punto...»
- Un polígono: es una línea de contorno con la última coordenada igual a la primera para cerrarlo. Un agujero en el interior del área es 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, como subtítulo en la etiqueta.
image / imageN (opcional): Imagen en la etiqueta del objeto, con el nombre del fichero sin prefijo.

Datos para los puntos

marker-color / marker-colorN (opcional): Color del marcador del punto con formato CSS. Por defecto es "#7e7e7e". Ver la tabla de colores.
marker-size / marker-sizeN (opcional): Medida de los marcadores. Valores: small, medium, large; por defecto es medium.
marker-symbol / marker-symbolN (opcional): Símbolo dentro del marcador, por defecto vacío. Valores:
- marker-symbol(N) = -number, numera correlativamente todos los puntos. También acepta un número determinado entre 0 y 9.
- marker-symbol(N) = -letter, marca los puntos con letras A, B, C... También acepta una letra determinada entre a y z, en minúscula.
- marker-symbol(N) = icono, con el nombre de uno de los iconos disponibles: Iconos Maki. Ver uso de iconos Mapi. (Más iconos en mw:Help:Extension:Kartographer/Icons)

Datos para las líneas

stroke / strokeN (opcional): Color de la línea con formato CSS. Por defecto es "#555555". Ver la tabla de colores.
stroke-width / stroke-widthN (opcional): Anchura de la línea con valor numérico igual o mayor a 0, por defecto 2.
stroke-opacity / stro:ke-opacityN (opcional): Opacidad de la línea con valor decimal entre 0 y 1, por defecto 1.0.

Datos para los polígonos

fill / fillN (opcional): Color del interior del polígono, excepto agujeros, con formato CSS. Por defecto es "#555555". Ver la tabla de colores.
fill-opacity, fill-opacityN (opcional): Opacidad del interior del polígono con valor decimal entre 0 y 1, por defecto 0.6.

También utiliza stroke / stroke-width / stroke-opacity para la línea de contorno del polígono.

Datos para los objetos externos

ids / idsN (opcional): identificador del elemento de Wikidata (Q...) Pueden ser varios identificadores separados por una coma. Por defecto obtiene el identificador de la página actual. Con este identificador obtiene el objeto de OpenStreetMap si tiene definida la propiedad wikidata=Q...
commons / commonsN (opcional): nombre de un mapa, o varios numerados, en Wikimedia Commons sin el prefijo "Data:" y con la extensión ".map". Consultar, para ejemplos c:Special:Allpages/Data:, y ayuda en mw:Help:Map Data.

Se pueden utilizar también los parámetros para polígonos.

Ejemplos

Muestra de diferentes tipos de mapas: Plantilla:Map draw/uso/ejemplos.

Todas las páginas con mapas: Categoría:Wikipedia:Páginas con mapas.
Páginas que usan la extensión Kartographer: Especial:PagesWithProp/kartographer frames

Ayuda

Consulte en Plantilla:Map draw/uso/ayuda algunas herramientas de ayuda.

En caso de dificultades, pregunte en Plantilla Discusión:Map draw.

Uso de iconos Mapi.

Véase también

Módulo:Mapa con el código de apoyo de la plantilla.
mw:Help:Extension:Kartographer, ayuda de la extensión Kartographer.
Especificación simplestyle, versión de GeoJSON utilizada.
En MediaWiki
- Maps

Esta documentación está transcluida desde Plantilla:Map draw/doc.
Los editores pueden experimentar en la zona de pruebas (crear) y en los casos de prueba (crear) de la plantilla.
Por favor, añade las categorías en la subpágina de documentación. Subpáginas de esta plantilla.