Para obtener una descripción completa de cómo esta plantilla ha podido volver a tener una funcionalidad casi completa y las nuevas opciones que ahora son posibles, consulte Plantilla:Mapa de ubicación de OSM/Volver al servicio . La documentación que aparece a continuación se ha actualizado e incluye todas las nuevas posibilidades, por lo que se puede utilizar junto con lo anterior.
Esta plantilla proporciona
El mapa de ubicación de OSM permite que un editor incluya un mapa en un marco con un nivel de zoom adecuado al tema. Se proporciona un marcador de escala en la esquina inferior derecha. Esto es, en el mejor de los casos, una guía aproximada de las distancias en el mapa, ya que la proyección del mapa da como resultado cambios de escala según la latitud. Se ha tenido en cuenta esto, pero solo en grandes porciones de 20 grados.
Las marcas, imágenes y etiquetas múltiples (actualmente limitadas a 60, y que pueden exceder los límites de tamaño en páginas muy grandes) pueden ser una forma o imagen, incluir una etiqueta de texto y, potencialmente, "líneas de puntero" y otros elementos gráficos. El mapa de pantalla completa, por otro lado, las mostrará como marcas de puntero, a las que se les pueden dar imágenes en miniatura emergentes y títulos, así como proporcionar enlaces para acceder a otros mapas e imágenes satelitales, y una opción para mostrar las ubicaciones de otros artículos cercanos.
En Plantilla:OSM Mapa de ubicación/ejemplos encontrará una selección de mapas de ejemplo, junto con enlaces a un rango aún más amplio de tipos de uso.
Un mapa sin adornos centrado en coordenadas de latitud y longitud, mediante un valor {{ coord }} . Establezca el zoom para obtener una escala que se ajuste al tema (0=todo el mundo, 18=una calle). Con solo estas opciones establecidas, todos los demás parámetros utilizan los valores predeterminados o se dejan sin usar. También proporciona un enlace a la versión interactiva de pantalla completa.
Un marcador "Red pog" predeterminado y la etiqueta que lo acompaña. Los elementos adicionales (los últimos tres parámetros) no aparecen en la página, pero brindan información adicional al pasar el cursor sobre un punto o hacer clic en él en la versión de pantalla completa.
El título de la marca puede tener un enlace wiki opcional y el punto en el mapa se convierte en un enlace activo, incluso si la página no existe. La etiqueta también puede tener un enlace wiki, pero como en este caso, mostrará la página que contiene una subsección como el enlace activo en lugar de una imagen de la función como se muestra en pantalla completa. Puede funcionar bien cuando hay una página sobre el tema específico.
Además del conjunto de parámetros de marca no numerados, hay 60 numerados. Estos son idénticos al anterior, pero el nombre termina en un número (1-60). Cada marca y etiqueta tiene su propio conjunto de parámetros ( |mark1=, |mark-coord1=, |label1=, |label-pos1=etc... |mark2=, |mark-coord2=, |label2=, |label-pos2=etc.) Los valores se pueden heredar del 'conjunto de parámetros maestro mark1' o de un conjunto especial 'markD' predeterminado que proporciona valores predeterminados de anulación. Cuando se configuran, estos valores son heredados por los otros conjuntos numerados para evitar tener que repetirlos para cada uno, mientras que aún se pueden configurar individualmente cuando sea necesario.
El código fuente del mapa se puede ver haciendo clic en el enlace "Editar". Algunos puntos destacables sobre el ejemplo del mapa de puntos numerados:
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
.jpg/1280px-Old_John_(Leicestershire).jpg){kind=small}
shape = n-circle(cuadrado, triángulo y diamante también están disponibles)| label-pos4 = top,with-line | ldx4 = 8 | ldy4 = -37 mover la etiqueta mucho más lejos y agrega una línea que une la etiqueta con su forma.auto-caption=1, todas las formas numeradas se enumeran dentro del título, utilizando los valores 'mark-title', que, al igual que con shape2 aquí, pueden incluir enlaces o explicaciones de varios elementos diferentes.auto-caption = 14 lo que solicita un ancho de columna de al menos 14 ems . Luego, la plantilla agrega tantas columnas como permita ese ancho.{{ Mapa de Flushing Meadows-Corona Park }} es un ejemplo útil de la vida real en formato de plantilla.
A cada marca y etiqueta se le puede asignar un conjunto único de atributos (tamaño, color, contorno, ángulo, posición relativa, etc.). Para minimizar la repetición de código, existe una escala móvil de herencia que se aplica a cada valor en cada conjunto de parámetros. Por ejemplo, si label-size4=16está configurado, siempre tendrá prioridad. Si no se ha configurado label-size4, heredará el valor de la configuración especial Default (definida mediante label-sizeD= ). Si no se ha configurado Default, heredará el valor establecido por el 'conjunto de parámetros maestro', label-size1=. Si tampoco está definido, volverá al valor predeterminado subyacente, que en el caso de label-size es 13. Lo mismo se aplica a todas las variables relacionadas con marcas y etiquetas (aunque no a las coordenadas, las etiquetas en sí mismas o los títulos de las marcas, que siempre son exclusivos de la marca en particular a la que se relacionan).
Puntos destacables ilustrados en el mapa del área de Banwen:
| mark-size2 = 44,62,4shape6=rule. Una regla tiene atributos de 'shape-outline', que se configuran por | shape-outline6=hard grey,2,60,dashed color y se requiere el ancho de línea. Opacity% y 'style' son opcionales. Las opciones de estilo son sólido, discontinuo, punteado o doble.mark-title6=none, por ejemplo.Muchas páginas con cuadros de información ya incluyen un mapa de localización que muestra dónde se encuentra el tema o lugar. Para aquellas que no lo tienen, puede ser útil incluir uno dentro del mapa. Es posible incorporar un "mapa de localización" existente (de Wikimedia Commons) en una esquina de este mapa.
Tanto el ancho como la altura del mapa de ubicación deben decidirse, especificarse (y calcularse de modo que no se desplace el mapa de la esquina). Algunos mapas de ubicación pueden resaltar la característica, pero si no es así, se puede colocar un localizador opcional 'pog' calculando y especificando los valores minipog-gx y -gy, utilizando una cuadrícula de 100x100 a lo largo del minimapa. (Por lo tanto, los valores gx y gy de 25 y 50 colocarían un punto a un cuarto del ancho y a la mitad del minimapa. No recoge ni utiliza valores de latitud y longitud. El origen (0,0) está en la parte superior izquierda del minimapa y el mapa en sí tiene como valor predeterminado la esquina inferior derecha, pero también puede utilizar minimap=file bottom left, minimap=file top lefty minimap=file top right.
El punto permanecerá en el lugar correcto incluso si modifica el tamaño del minimapa. (Tenga en cuenta que los ahora redundantes minipog-x y minipog-y se conservan por compatibilidad. Estos usaban las mismas dimensiones de píxeles que el ancho y la altura del mapa, lo que hacía que fuera más difícil calcularlos o adivinarlos y era necesario volver a hacerlos si se modificaba el tamaño. Es mucho mejor usar gx y gy de ahora en adelante).
Si el área del mapa real es una gran parte del minimapa, se puede incluir un recuadro rojo abierto en lugar de un punto para mostrar los límites del mapa principal. Para utilizar esta función, simplemente especifique el ancho del recuadro requerido: minimap-boxwidth=xxdonde xx = el porcentaje del ancho del minimapa para el recuadro. En general, cualquier valor muy inferior a xx=15 se verá mejor con un punto. El recuadro se centrará en las coordenadas minipog-gx y minipog-gy. El ancho requerido requerirá algo de prueba y error para determinarlo. Luego, la altura del recuadro se ajusta en proporción al mapa real y se escalará si cambia el tamaño del minimapa.
El texto de las características geográficas más amplias se puede colocar alrededor de un arco para transmitir la sensación de un área más amplia o para seguir la curva de un río, una cadena montañosa, una costa, etc. Esto funciona de forma totalmente independiente de las otras etiquetas. No se adhiere a ninguna marca o punto y no crea ningún marcador de pantalla completa. Requiere coordenadas para la primera letra, parámetros para el ángulo inicial, el radio del arco y el espacio entre las letras. El tamaño y el color del texto también se pueden especificar o heredar de la configuración predeterminada.
Referencias
En lugar de utilizar el 'icono rojo' estándar para marcar puntos en el mapa, se pueden utilizar otras imágenes. Se puede especificar cualquier imagen de Wikimedia Commons. El ejemplo de Pentre Ifan anterior utiliza 'Archaeological site icon (red).svg'. Si se especifica un archivo de imagen en particular mark1=, todas las marcas posteriores también lo utilizarán a menos que nombren su propio archivo de imagen. Si la imagen no es cuadrada, también se debe establecer un valor de dimensión (relación de ancho para una altura de 1)
Una imagen de marcador no tiene por qué ser pequeña y opaca. Se puede utilizar una imagen superpuesta más grande (con un fondo transparente) para mostrar características particulares que no están incluidas en el mapa base, como las antiguas murallas de una ciudad (consulte el mapa adyacente, que utiliza [[Archivo:Leicester Town Walls map overlay.svg]] ). Estas imágenes se pueden crear de varias maneras (como trazando sobre una copia del mapa base); se invocan como cualquier otro archivo de imagen de marcador. (Para obtener una guía detallada sobre cómo crear e implementar una superposición para estos mapas, consulte User:J. Johnson/OSM overlay how-to ). (Vea a continuación formas más directas de mostrar gráficos lineales).
Esta es una característica nueva (para 2024) que utiliza shape=panel. Utiliza el sistema de coordenadas normal para colocar tanto la esquina superior izquierda del panel como cualquier marca o explicación que se coloque sobre ellas (aunque no tengan una relación real con ese punto en el mapa).
Sin números ni etiquetas, el caso de uso aquí muestra la dispersión de diferentes tipos de sitios. Los puntos individuales aún pueden ser "interrogados" para obtener más información, particularmente si se utiliza la versión de pantalla completa, pero solo si se "buscan" en lugar de presentarse de manera directa. Los diferentes contenidos de las páginas tendrán diferentes necesidades. Un mapa debe apuntar a mostrar la información más relevante, y los editores pueden tomar decisiones sobre cómo hacer que el mapa sea parte de la narrativa del artículo.
(Una nota sobre el orden de dibujo: la marca sin numerar se dibuja primero. Las marcas numeradas se dibujan comenzando con 60 y dibujando la forma 1 por último, que por lo tanto está "en la parte superior". La superposición usa la marca sin numerar para ir debajo de todo lo demás. El panel en este ejemplo usa el conjunto forma20 para colocarlo debajo de las dos marcas de leyenda (16 y 17) para que se muestren encima).
El color del texto de la etiqueta se puede especificar usando label-color = . Los colores HTML estándar se pueden especificar por nombre, y cualquier color se puede especificar usando el código de tripletes hexadecimales #xxyyzz (ver Colores web ). Sin embargo, para crear una apariencia consistente en todos los mapas de Wikipedia, hay algunos colores específicos del mapa de ubicación de OSM, con una gama de tonos más apagados que se adaptan bien al esquema de colores de los mapas base. En general, es mejor utilizar esta gama, a menos que haya buenas razones para usar otros tonos particulares para funciones específicas. En condiciones de uso normal, se debe seguir el siguiente esquema de colores de etiquetas:
Novedades de 2024: todos los colores pueden tener un valor de opacidad además del nombre del color. Por ejemplo, label-color3=dark blue,30se establecerá una opacidad del 30 %. (Los parámetros "50 %" y "opacidad" ahora están obsoletos, es decir, todavía funcionan, pero ya no son necesarios)
También es posible especificar cualquier color hexadecimal HTML utilizando el código hexadecimal de seis cifras, por ejemplo, #AAAAAA, pero mantener los valores predeterminados permite una coherencia entre las páginas.
Si no se especifica ningún color válido, el color se establecerá en un valor predeterminado de "gris duro".
Con los cambios de 2024, ahora es posible establecer fácilmente el valor de opacidad de cualquier color especificado. Para 'label-color' y 'shape-color', este es un segundo valor separado por comas. Para 'shape-outline' es el tercer elemento (toma el nombre del color, el ancho de línea, la opacidad y el estilo). Por ejemplo, shape-outline4=hard red,8,30,solidagregaría un contorno rojo transparente de 8 píxeles de grosor alrededor de la forma. (Tenga en cuenta que la opacidad se expresa como un %. Por razones históricas, una opacidad de 0 y 100 dan colores completamente opacos. Para establecerlo como completamente transparente, use un valor de 1 o el nombre del color 'transparente').
| label-color=#1659165A. Es posible establecer un valor de opacidad al usar #hexvalues en lugar de solo colores nombrados del espacio de color HTML. La opacidad es un valor hexadecimal adicional de dos dígitos para formar un #value de 8 dígitos, con dígitos de opacidad que van desde 00 (opaco) hasta FF (transparente).Anteriormente existía una opción para especificar las características de "Halo" alrededor de las formas. Estas se usaban rara vez (si es que se usaban) y habrían generado demandas considerables de recursos mediante el uso de múltiples formas adicionales. Como el tamaño de la plantilla podía generar dificultades cuando se usaban muchos puntos, el parámetro de halo se ha eliminado por ahora. Se pueden obtener varios efectos similares a los de un halo utilizando la opción de contorno de forma.
label = , cualquier línea ahora se puede dividir tantas veces como se desee utilizando el símbolo de sombrero ^. Esto reemplaza al ahora obsoleto labela = y labelb = . Para colocar un ^ real en su etiqueta, utilice la ^entidad.mark-size=0esto tiene el efecto de una etiqueta flotante sin marcadorlabel-angle = , que hará que el texto de la etiqueta gire alrededor del centro del punto del marcador en el ángulo especificado. El uso de una etiqueta en ángulo que tampoco tenga marcador es particularmente bueno para etiquetar varias características geográficas y lineales. Una alternativa con más carácter es establecer el texto en un arco, utilizando las opciones de ArcText . Para lograr una coherencia estilística, normalmente no se debe dar un ángulo a los nombres de asentamientos y edificios.{{ OSM Location map }} se puede mostrar en muchos cuadros de información. Esto puede depender de si permiten un map_imageparámetro (preferible) o los parámetros moduley/o embedded, ya que su imageparámetro se usa generalmente y es mejor reservarlo para imágenes. Vea por ejemplo {{ infobox school }} usando la instrucción |module={{OSM Location map| ...}}. Para un ejemplo, vea St John Fisher Catholic School que usa el mapa para mostrar sus dos sitios dentro de un mapa de cuadro de información. Algunos cuadros de información también permiten que se incorpore dentro del título debajo de una imagen. Sin embargo, esto solo funciona si también hay una imagen y algún texto de título. (vea Inishmore Lighthouse ). Una plantilla de doble uso con lógica de control es posible como con {{ Karakoram OSM }} y su visualización diferente en K2 usando {{ infobox mountain }} .
Con la llegada de diversas funciones de dibujo de contornos y líneas, ya no es tan necesario recurrir a etiquetas de texto como forma de mostrar gráficos simples. Sin embargo, para ciertos casos, algunos de los numerosos elementos Unicode de la lista de Dibujo de cuadro pueden resultar útiles.
Desde mayo de 2018, también es posible crear un mapa en un marco a través de {{ Maplink }} , que en algunos aspectos hace un trabajo similar al mapa de ubicación de OSM. En ambos casos, se puede agregar una imagen de mapa estática a un artículo, para cualquier parte del mundo, extrayendo el mapa de los datos de OpenStreetMap. Las diferencias están en lo que pueden y no pueden agregar al mapa base. Maplink, tanto en su versión enmarcada como en la de pantalla completa, puede agregar puntos (puntos puntiagudos numerados o estilo ícono) y varias líneas y áreas generalmente importadas de OpenStreetMap a través de valores Q de wikidata. Una gran parte de su función es proporcionar un mapa "automatizado", utilizando wikidata para brindar resultados rápidos, a menudo dentro de un cuadro de información. Con el mapa de ubicación de OSM, el proceso es mucho más manual, reuniendo elementos del artículo. El mapa enmarcado puede mostrar una selección mucho más rica de puntos, formas, gráficos, superposiciones, imágenes y especialmente texto para transmitir detalles específicos relevantes para un artículo en particular. Ahora también se ha habilitado la posibilidad de mostrar el valor Q (actualmente limitado a límites y carreteras). El equivalente en pantalla completa es mucho más parecido a un elemento de pantalla completa de Maplink, ya que reutiliza como elementos puntuales los detalles proporcionados para el mapa enmarcado.
El mapa de ubicación de OSM no tiene capacidad de visualización ni de mapa propia. Hasta 2023, todo lo que se encontraba dentro del marco se producía a través de la plantilla {{ Graph:Street map with marks }} , creada por User:Yurik . Utilizaba el paquete de visualización Vega , que mostraba tanto el mapa base como una variedad de características de texto y gráficos. En su versión original, el resultado era una imagen de mapa de bits renderizada, lo que hacía que la sobrecarga de visualización fuera muy baja en comparación con la edición, pero con una salida de baja resolución. En 2020, se eliminó el proceso de creación de mapas de bits, lo que dio como resultado una vista de página mucho más clara, pero aumentó considerablemente la sobrecarga de recursos.
En abril de 2023, el paquete Vega fue retirado, junto con todas sus dependencias "gráficas", en medio de preocupaciones de seguridad. Después de un prolongado período de incertidumbre (aún sin resolver en abril de 2024), se encontró una forma de replicar los resultados manejados anteriormente por "gráfico". Al hacer uso de Extension:Kartographer, a través de su etiqueta <mapframe>, el mapa base podría mostrarse dentro de un elemento HTML <div>. La codificación CSS en línea podría usarse para mostrar los gráficos y el texto dentro del marco resultante. Las "coordenadas" de Mercator se convierten en valores de píxeles (x, y) para que coincidan con la ubicación del mapa y el nivel de zoom. Este cambio no solo hizo que el stock existente de 5600 plantillas volviera a funcionar, sino que también permitió la implementación de elementos gráficos adicionales, así como un uso más estándar del marcado wiki y los enlaces wiki.
La opción de pantalla completa, a la que se puede acceder haciendo clic desde el mapa enmarcado, ofrece un enfoque cartográfico completamente diferente, aunque también utiliza Kartographer para acceder a los datos del mapa base de OSM. Esta opción utiliza <maplink> para proporcionar un mapa interactivo de pantalla completa que se puede desplazar y ampliar. También replica (como marcadores numerados) las distintas marcas y colores del mapa enmarcado. A continuación, se les puede dar contenido adicional, mediante un título, una imagen y una descripción, junto con la visualización de los valores de las coordenadas. El resultado es una página basada en mapas que ofrece otra forma de interactuar con el contenido del artículo.
El desarrollo de la tecnología cartográfica no es actualmente una prioridad para la Fundación Wikimedia . Tras la creación de {{ maplink }} , que inicialmente sólo creaba un enlace de texto a un mapa de pantalla completa, hasta el punto de que proporciona una imagen enmarcada con datos directamente de Wikidata, no hay desarrollos activos para otras soluciones cartográficas. (¡Por favor, díganos si sabe algo diferente!). La sobrecarga del procesador se reduce mostrando una imagen estática en el marco, sobre la que se puede hacer clic para que se vuelva interactiva en pantalla completa. Maplink ahora se implementa de manera efectiva dentro de los cuadros de información, donde el mapa se genera automáticamente a partir de los datos ya disponibles.
Esta plantilla está orientada más bien a producir un mapa editable a mano, en el que el área mostrada y la selección de elementos y etiquetas incluidos se seleccionan, editan y añaden para adaptarse a las particularidades del tema en cuestión. Otro enfoque, que actualmente no es compatible con ninguna plantilla de mapeo, es extraer los datos de datos en vivo externos, como el uso de una consulta SPARQL, para generar, por ejemplo, diagramas de dispersión de áreas grandes para mostrar diferentes distribuciones en un mapa. Los aspectos de seguridad y mantenimiento de tales tareas, al igual que con otras visualizaciones gráficas de datos en vivo, son una barrera importante para la implementación.
La tecnología utilizada aquí (Kartographer más CSS en línea) probablemente se describa mejor como "razonablemente bien desarrollada". A fines de abril de 2024, parecería estar en un estado estable y sostenible, por lo que no debería ver el tipo de pausa experimentada por "Graph" en 2023. Es muy probable que esta solución o una comparable aún estén disponibles en el futuro. De las posibles evoluciones a lo largo del tiempo, una puede ser a través de gráficos basados en SVG, lo que permite un contenido gráfico más rico y tal vez incluso avanzar hacia un entorno de edición visual adecuado. En la dirección opuesta, existe una demanda de mapas que puedan mostrar más puntos con un menor impacto en los recursos, tal vez reduciendo el conjunto de características. Pero lo más probable es que estos deban verse como alternativas en lugar de reemplazos para esta plantilla.