Esta es la subpágina de documentación para Plantilla:Maplink. Contiene información de uso, categorías y otros contenidos que no forman parte de la plantilla original.

Esta plantilla utiliza los módulos Module:Mapframe y Module:Transcluder. Antes de modificarla, deberías familiarizarte con las funciones de la extensión Scribunto y el lenguaje de programación Lua.

Esta plantilla usa la etiqueta de OpenStreetMap: wikidata (consulta talk; taginfo)

Maplink es una plantilla que añade un enlace, o un marco, que mostrará un mapa de OpenStreetMap junto con los datos de mapa especificados. El mapa y los datos pueden visualizarse en una ventana de pantalla completa desplazable y con zoom. Los datos del mapa pueden provenir de:

• datos almacenados en formato GeoJSON en Wikipedia o Commons
• características lineales/poligonales en OpenStreetMap
• coordenadas, ya sea proporcionadas o desde Wikidata
• GeoJSON sin procesar, preferiblemente transcluido desde otra página

Nota:

• Si tienes un mapa muy grande o lento, deberías usar directamente la etiqueta de extensión mapframe en lugar de esta plantilla, como se hizo en en:Special:Diff/970846012. La razón es que usar la plantilla para llamar a la etiqueta de extensión hará que el tiempo de renderizado del mapa cuente como tiempo de Lua, lo que puede ocasionar errores por exceder el tiempo.
• Actualmente no se pueden subir archivos GeoJSON de forma directa. En Commons, puedes crear una página en el espacio de nombres Data: que termine en .map – consulta mw:Help:Map Data para más información.
• Para hacer disponibles las funciones de OpenStreetMap (OSM), añade la clave de Wikidata a la relación de OSM (y espera 1 o 2 días) – consulta mw:Help:Extension:Kartographer#External_data, mw:Help:Extension:Kartographer/OSM y en:Module talk:mapframe/FAQ para más información.

Esta plantilla está pensada para mostrar puntos, así como características lineales o poligonales en un mapa, incluyendo (pero no limitado a):

• Carreteras
• Ríos
• Líneas de metro o tren
• Rutas de barco
• Rutas de vuelo
• Viajes de exploradores
• Hábitats de animales
• Países y sus subdivisiones
• y más...

Además, esta plantilla puede usarse para mostrar características puntuales en un mapa (coordenadas).

Uso básico

• Data page en Commons (p. ej. Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):

  {{maplink|from=}} (especifica la página de datos .map en from=, sin el prefijo Data)

• {{maplink|raw=}} (especifica GeoJSON sin procesar, preferiblemente transcluido desde una subpágina de Wikipedia:Map data)
• Line of a border or a linear feature desde OSM:

  {{maplink|type=line|id=}} (El id de Wikidata solo es necesario si se utiliza la página de Wikidata de otro artículo)

• Shape desde OSM:

  {{maplink|type=shape|id=}} (El id de Wikidata solo es necesario si se utiliza la página de Wikidata de otro artículo)

• Inverted shape desde OSM:

  {{maplink|type=shape-inverse|id=}} (El id de Wikidata solo es necesario si se utiliza la página de Wikidata de otro artículo)

• Point feature (coordenadas):

  ...desde Wikidata:
  {{maplink|type=point|id=}} (El id de Wikidata solo es necesario si se utiliza la página de Wikidata de otro artículo)

  ...desde coordenadas especificadas:
  {{maplink|type=point|coord=}} (especifica coordenadas usando {{Coord}})

  ...desde la página actual: {{maplink|type=named}} o {{maplink|type=named|from=#Section}}

  ...desde otra página: {{maplink|type=named|from=Other page}} o {{maplink|type=named|from=Other page#Section}}

• Circle (centrado en las coordenadas de un punto):

  ...desde Wikidata:
  {{maplink|type=circle|radius=|id=}} (El id de Wikidata solo es necesario si se utiliza la página de Wikidata de otro artículo)

  ...desde coordenadas especificadas:
  {{maplink|type=circle|radius=|coord=}} (especifica coordenadas usando {{Coord}})

• Para mostrarlo en un marco, añade el parámetro |frame=yes: {{maplink|frame=yes|frame-align=left|type=line|id=Q1094308|text=Mapframe example}}.
  
  

  Mapframe example

• Hay parámetros adicionales para personalizar el mapa mostrado, como |plain=yes para eliminar el marco externo: {{maplink|frame=yes|frame-align=left|plain=yes|type=line|id=Q37240364|frame-width=200|frame-height=250|frame-long=19.1009|frame-lat=47.5001|zoom=9}}.
  

• También se pueden mostrar superposiciones en la parte superior del mapa: {{maplink|frame=yes|frame-align=left|frame-width=400|frame-height=300|type=point|id=Q8688|marker=airport|zoom=12 |text=San Francisco International Airport}}
  
  

  San Francisco International Airport

}}

Conjunto de parámetros – página de datos

{{maplink
|display=
|from=
|zoom=
|text=
|icon=
}}

Conjunto de parámetros – datos sin procesar

{{maplink
|display=
|raw= <!-- preferiblemente {{Wikipedia:Map data/subpágina}} -->
|zoom=
|text=
|icon=
}}

Conjunto de parámetros – geoline/geoshape

{{maplink
|display=
|type=
|id=
|title=
|description=
|stroke-color=
|stroke-width=
|zoom=
|text=
|icon=
}}

Conjunto de parámetros – características puntuales/coordenadas

{{maplink
|display=
|type=point
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

Conjunto de parámetros – círculos

{{maplink
|display=
|type=circle
|radius=  <!-- en metros; hay parámetros alternativos para otras unidades -->
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

display

Cómo se muestra la plantilla. Los valores válidos son:

inline - Solo se muestra el enlace en línea (puedes omitirlo, pues es el valor por defecto)

title - Solo se muestra el enlace en el título

inline,title - Muestra el enlace en línea y también en el título

title,inline - Igual que lo anterior

text

Texto a mostrar para el enlace (o título si se usa mapframe); por defecto es "Map"

icon

Establece "no" para desactivar el ícono que aparece junto al enlace

zoom

Nivel de zoom, de 1 a 19 (mayor número = mayor acercamiento); por defecto se determina automáticamente a partir del mapa, a menos que la única característica sea un solo punto.

Parámetros de Mapframe (solo funcionan con la visualización en línea)

frame

Establece "yes" para mostrar un mapa enmarcado en lugar de un enlace

plain

Establece "yes" para mostrar solo el mapa sin el marco envolvente y sin subtítulo (se ignorará el parámetro text)

frame-align

Alineación respecto a la página: left, center o right; por defecto right

frame-width

Anchura del marco del mapa en píxeles; por defecto 300

frame-height

Altura del marco del mapa en píxeles; por defecto 200

frame-coordinates

(o frame-coord)

Opcional - coordenadas del centro del mapa. Usa la plantilla {{Coord}} para especificarlas (p. ej. |frame-coordinates={{Coord|12.34|S|56.78|W}}). Si no se establecen, se obtendrán de Wikidata.

frame-latitude

(o frame-lat)

(se ignora si se define |frame-coordinates= o |frame-coord=)

Opcional - latitud del centro del mapa.

frame-longitude

(o frame-long)

(se ignora si se define |frame-coordinates= o |frame-coord=)

Opcional - longitud del centro del mapa.

Información: Si no se definen la latitud y la longitud del marco, entonces las coordenadas del marco pueden determinarse automáticamente, ya sea:

• En base a los objetos de línea y forma (si se han especificado),
• A partir de la característica puntual indicada en |coord= (si se ha configurado),
• Obtenidas desde Wikidata (si está disponible – para el elemento especificado en el parámetro |id=, o para la página en la que se coloca la plantilla).

overlay

Una imagen u otro mapa que se mostrará sobre el mapa. Ejemplos:

|overlay=[[File:Example.svg|140x140px]]

|overlay={{maplink|frame=yes|plain=yes|frame-width=100|frame-height=100|type=shape|id={{get QID|French submarine Ariane (1914)}}|frame-align=center}}

|overlay={{Graph:Street map with marks|width=100|height=100|lat=37.8|lon=-122.4|zoom=6|{ "lat": 37.8, "lon": -122.4 }|minimap=false}}

(consulta en:Template:Maplink/testcases/overlays para ver ejemplos)

overlay-horizontal-alignment

Alineación horizontal de la superposición, puede ser left o right; por defecto right

overlay-vertical-alignment

Alineación vertical de la superposición, puede ser top o bottom; por defecto bottom

overlay-horizontal-offset y overlay-vertical-offset

Opcional – número de píxeles para desplazar la superposición desde el borde del mapa, p. ej. 10 para 10 píxeles de separación

overlay-border

Estilo CSS para el borde, p. ej. 3px solid black; por defecto 1px solid white. El color puede ser cualquier nombre de web color o código hexadecimal.

raw

GeoJSON sin procesar (preferiblemente transcluido desde una subpágina de en:Wikipedia:Map data) y toda la funcionalidad de <maplink> que no esté disponible mediante otros parámetros. Ver más abajo para más información.

Se pueden mostrar múltiples características en un solo mapa. Para cada característica adicional, añade un número secuencial al final del nombre del parámetro. Por ejemplo, la segunda usa parámetros como |type2=, |id2=, etc.; la tercera usa |type3=, |id3=, etc. Los números más altos se dibujan encima.

type

Tipo de dato. Valores válidos:

line – una característica geoline desde OSM (por ejemplo, una carretera)

shape – una característica geoshape desde OSM (por ejemplo, un estado o provincia)

shape-inverse – una característica geomask desde OSM (el inverso de una geoshape, permitiendo ver el mapa subyacente)

data – una página de datos geoJSON en Commons (en este caso, el parámetro puede omitirse)

point – una característica puntual (coordenadas)

named – todas las coordenadas con nombre en una página o sección (plantillas {{coord}} con el parámetro |name=)

circle – un círculo centrado en las coordenadas de un punto

id

(o ids)

Id de Wikidata (Q-number) de la característica puntual, o el id de Wikidata con el que está etiquetado el line/shape de OSM. Separa varios ids con comas. Toma por defecto la página de Wikidata actual (si no se establece |from=).

from

Fuente de los datos del mapa:

• Si type es data o no está establecido: la página JSON (.map) de Commons (sin el prefijo Data:)
• Si type es named: nombre de la página, o nombre#sección, de donde obtener coordenadas nombradas. Si se omite o se especifica solo #sección, se usará la página actual.

title

Título de la característica (para características desde OSM), mostrado al hacer clic en la misma; por defecto, el título de la página

description

Descripción de la característica (para características desde OSM), mostrada al hacer clic en ella; opcional

stroke-color

(o stroke-colour)

Código de color para la línea que dibuja la característica (para datos desde OSM); por defecto #ff0000 (rojo)

stroke-width

Ancho de la línea para dibujar la característica (para datos desde OSM); por defecto 6

stroke-opacity

Opacidad de la línea para la característica (para datos desde OSM), un valor entre 0 (totalmente transparente) y 1 (totalmente opaco); por defecto 1

fill

Código de color para el relleno de la característica (para shape o shape-inverse desde OSM); por defecto #000000 (negro). Ten en cuenta que por defecto se usa una versión semitransparente del color especificado, de modo que el mapa subyacente aún pueda verse.

fill-opacity

Opacidad del color de relleno (para shape o shape-inverse desde OSM), un valor entre 0 (transparente) y 1 (opaco); por defecto 0.5

coord

Coordenadas que se mostrarán para una característica puntual. Usa la plantilla {{Coord}} para especificarlas (p. ej. |coord={{Coord|12.34|S|56.78|W}}). Si no se establece, se obtendrán de Wikidata.

marker

Nombre del ícono Maki que se mostrará en la característica puntual. Consulta mw:Maps/Icons para ver opciones. Si no se configura, se mostrará un marcador sencillo sin ícono.

marker-color

(o marker-colour)

Código de color (Triplete hexadecimal) para el fondo del marcador. Por defecto 5E74F3 (    )

marker-size

Tamaño del marcador. Puede ser small, medium (por defecto) o large.

radius

(o radius_m), o los parámetros alternativos radius_km, radius_mi, radius_ft

Radio del círculo, en metros por defecto, o en kilómetros/millas/pies si se usan los parámetros alternativos.

edges

Número de lados usados para construir el círculo. Por defecto 32. Con números más altos el círculo se verá más suave, pero se consumirán más recursos de Lua.

Varias características permiten:

• Usar datos externos de Wikimedia Commons y OpenStreetMap juntos
• Aplicar diferentes estilos a diferentes características de datos externos de OSM
• Incluir varios enlaces a datos externos de Wikimedia Commons

Map

{{Maplink|frame=yes
|type=shape|id=Q3495894|title=Shape|description=Description of shape
|type2=line|id2=Q1318331|title2=Line|description2=Description of line
|type3=point|coord3={{coord|32|S|116|E}}|title3=Point|description3=Description of point
}}

{{Maplink|frame=yes|plain=yes|frame-width=250|frame-height=280|zoom=6|frame-lat=29.185|frame-long=76.225
|type=shape-inverse|id=Q1174|title=Haryana
|type2=point|id2=Q200663|stroke-width=3|title2=Faridabad
}}

Se pueden incluir mapframes dentro de plantillas de infobox. Se recomienda usar |plain=yes para eliminar el marco externo.

Mitchell Freeway
Mapa de los suburbios del norte de Perth con Mitchell Freeway resaltado en rojo
Datos de la ruta
Tipo	freeway

{{Ficha de vía de transporte
| nombre    = Mitchell Freeway
| mapa  = {{maplink |type=line |frame=yes |plain=yes |frame-align=center |frame-lat=-31.8262 |frame-long=115.7877 |zoom=9 |id=Q1939502}}
|aclaración_mapa =  Mapa de los suburbios del norte de Perth con Mitchell Freeway resaltado en rojo
| tipo         = freeway
  ...  (otros parámetros omitidos)  ...
}}

El parámetro "raw" permite los mismos valores que la etiqueta completa <maplink>. Permite:

• Usar datos GeoJSON directamente
• Usar consultas a Wikidata para obtener información para el mapa
• Usar plantillas: si el mapa incluye GeoJSON directo o muchos componentes, colocar esos datos en una plantilla evita sobrecargar el texto del artículo

Consulta mw:Help:Extension:Kartographer para instrucciones.

Información: Actualmente (16 de enero de 2025) no existen Map data en Wikipedia en español que permitan ejemplificar este atributo

{{maplink|raw={{Wikipedia:Map data/Carreteras principales Australia Occidental/Forrest Highway}}|text=Route map}}

(Enlace a subpágina de datos GeoJSON: en:Wikipedia:Map data/Main Roads Western Australia/Forrest Highway)

Ten countries

{{maplink|frame=yes|text=Ten countries|raw={
  "type": "ExternalData",
  "service": "geoshape",
  "query": "
SELECT * WHERE {
  ?id wdt:P463 wd:Q1065 .
} LIMIT 10
"}
|frame-width=600|frame-height=400|frame-lat=25|frame-long=10|zoom=1
}}

Map

{{maplink|frame=yes|raw={
  "type": "ExternalData",
  "service": "geoshape",
  "query": "
SELECT ?id ?head
  (SAMPLE(?img) as ?img_) 
  (min(?partyId) as ?party) 
  (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill)
  (concat('[[', substr(str(?link),31,500),  '{{!}}', ?headLabel, ']]') as ?title)
  (concat(?stateLabel, '\\n', '[[File:', substr(str(?img_), 52, 500), '{{!}}200px]]') as ?description)
WHERE {  
  ?id wdt:P31 wd:Q35657 .
  ?id wdt:P6 ?head .
  ?head wdt:P102 ?party .
  BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId) 
  SERVICE wikibase:label {
    bd:serviceParam wikibase:language 'en' .
    ?head rdfs:label ?headLabel .
    ?id rdfs:label ?stateLabel .
  }
  OPTIONAL {
    ?head wdt:P18 ?img .
  }
  ?link schema:about ?head .
  ?link schema:isPartOf <https://en.wikipedia.org/> .
} GROUP BY ?id ?head ?headLabel ?link ?stateLabel
"}|frame-width=600|frame-height=400|frame-lat=52|frame-long=-110|zoom=3}}

• Al recuperar líneas o shapes desde OSM, no puedes dar estilo al color de relleno ni al nivel de opacidad en rellenos o contornos (a menos que uses el parámetro |raw=)
• El siguiente código que utiliza el parámetro |raw= no funcionará porque la llave para cerrar el GeoJSON está adyacente a las llaves para cerrar la plantilla:

  {{Maplink|raw= {"type": "ExternalData","service": "geoshape","ids": "Q13518258"}}}
  

  Para arreglarlo, pon un espacio antes de las dos llaves de cierre de la plantilla o muévelas a otra línea.

• Wikipedia:Creación de mapas de rutas a partir de datos de OpenStreetMap
• Wikipedia:Creación de mapas de formas a partir de datos de OpenStreetMap