Plantilla:Maplink

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

Mapframe

MaplinkMaplink

Documentación de la plantilla[ver] [editar] [historial] [purgar]

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.

Usos

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

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=
}}

Parámetros

Para la visualización general

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

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.

Para cada característica

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.

Datos de la plantilla

Agrega un enlace o un marco que mostrará datos de mapa

Parámetros de la plantilla[Editar los datos de la plantilla]
Parámetro		Descripción	Tipo	Estado
display	`display`	Cómo se muestra la plantilla Valores sugeridos `inline` `title` `inline,title` Predeterminado inline	Desconocido	opcional
text	`text`	Texto que se mostrará para el enlace (o leyenda si se usa mapframe) Predeterminado Map	Línea	opcional
icon	`icon`	Establece "no" para ocultar el ícono que aparece junto al enlace	Lógico	opcional
zoom	`zoom`	Nivel de zoom, de 1 a 19 (con números mayores se acerca más); por defecto se determina automáticamente a partir del mapa, a menos que la única característica sea un punto.	Número	opcional

Ejemplos y consejos

Múltiples características

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
}}

Infoboxes

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

{{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

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.

Ejemplo de GeoJSON sin procesar

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)

Ejemplos de consultas Raw Wikidata

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}}

Detalles importantes

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.

Tutoriales

Esta documentación está transcluida desde Plantilla:Maplink/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.