Title: Mapa de ruta GPX
Author: Manuel Camargo
Published: 25 de julio de 2026
Last modified: 22 de septiembre de 2026
---
Buscar plugins
# Mapa de ruta GPX
Por [Manuel Camargo](https://profiles.wordpress.org/sirlouen/)
[Descargar](https://downloads.wordpress.org/plugin/gpx-route-map.1.7.0.zip)
* [Detalles](https://es.wordpress.org/plugins/gpx-route-map/#description)
* [Valoraciones](https://es.wordpress.org/plugins/gpx-route-map/#reviews)
* [Instalación](https://es.wordpress.org/plugins/gpx-route-map/#installation)
* [Desarrollo](https://es.wordpress.org/plugins/gpx-route-map/#developers)
[Soporte](https://wordpress.org/support/plugin/gpx-route-map/)
## Descripción
GPX Route Map convierte un archivo GPX en un mapa interactivo en la parte pública
de tu sitio. Coloca el bloque en cualquier entrada o página, elige un archivo `.
gpx` y tus visitantes verán:
* Un mapa interactivo de OpenStreetMap basado en MapLibre GL.
* La pista dibujada como una línea de ruta con marcadores de inicio y de fin.
* Compatibilidad con pistas GPX (``) y rutas GPX (``), por ejemplo las
exportaciones de recorridos de Garmin Connect.
* Marcadores de waypoints con ventanas emergentes para los puntos `` que haya
en el archivo.
* Una barra de estadísticas: distancia, desnivel positivo, desnivel negativo y
altitud máxima, en unidades métricas o imperiales.
* Un perfil de desnivel trazado a mano alzada que puedes recorrer con el ratón
o con el dedo, y la posición se sincroniza en el mapa.
El mapa se carga de forma diferida (solo cuando aparece en pantalla), así que nunca
ralentiza tu página, y puede haber varios mapas en la misma página.
Puedes crear pistas con cualquier herramienta GPX, por ejemplo el editor gratuito
[gpx.studio](https://gpx.studio), y luego subir el archivo resultante a tu biblioteca
de medios.
#### Código fuente
El JavaScript de la parte pública que hay en `build/` está minificado (el del editor
de bloques no lo está, para que sus cadenas se puedan traducir). El código fuente
legible está en el directorio `src/` del plugin, que se incluye en él, y también
está disponible, con las instrucciones completas de compilación, en el repositorio
público: [https://github.com/SirLouen/gpx-route-map](https://github.com/SirLouen/gpx-route-map).
El plugin se compila con Vite (`pnpm install && pnpm run build`).
### Servicios externos
Este plugin muestra los mapas con imágenes de mapa (teselas) que sirve un tercero.
Las teselas las carga directamente el navegador de cada visitante cuando se ve una
página que contiene un mapa, así que el proveedor de teselas recibe la dirección
IP de ese visitante, el User-Agent de su navegador y las coordenadas de la zona
del mapa que se está viendo. No se envía ningún dato cuando una página no tiene
ningún mapa, y el plugin nunca envía tus archivos GPX a ninguna parte.
#### OpenStreetMap (predeterminado)
De serie, el plugin usa el servidor público de teselas de OpenStreetMap en `tile.
openstreetmap.org`. No hace falta cuenta ni clave, y no hay que configurar nada.
Servicio: [OpenStreetMap](https://www.openstreetmap.org/). Condiciones: [Política de uso de teselas](https://operations.osmfoundation.org/policies/tiles/).
Privacidad: [Política de privacidad de la OSMF](https://osmfoundation.org/wiki/Privacy_Policy).
El servidor público de teselas de OSM tiene un límite de uso y no está pensado para
sitios con mucho tráfico.
#### Thunderforest (opcional)
Si eliges Thunderforest en Ajustes > GPX Route Map e introduces una clave de API,
las teselas se cargan desde `api.thunderforest.com` en su lugar, y tu clave de API
se incluye en cada petición de teselas. Esto solo ocurre cuando has seleccionado
Thunderforest y has facilitado una clave; por lo demás, el plugin nunca contacta
con ellos.
Como son los navegadores de los visitantes los que cargan las teselas, la clave
queda visible en el código fuente de tus páginas. Thunderforest no ofrece ninguna
forma de restringir una clave a tu dominio, así que trata la clave como pública
y vigila tu consumo.
Servicio: [Thunderforest](https://www.thunderforest.com/). Condiciones: [Términos y condiciones de Thunderforest](https://www.thunderforest.com/terms/).
Privacidad: [Política de privacidad de Thunderforest](https://www.thunderforest.com/privacy/).
#### Cualquier otro proveedor
Si configuras tu propia URL de teselas personalizada, lo mismo se aplica al servidor
al que apunte esa URL.
### Uso
Bloque: busca «GPX Route Map» en el insertador de bloques y luego elige un archivo
GPX.
Shortcode: `[gpx_route_map]`
Ejemplos:
```
[gpx_route_map id="123"] - render the GPX attachment with ID 123.
[gpx_route_map gpx="https://example.com/route.gpx" height="520" elevation="false"]
```
Atributos del shortcode:
* `id` – ID de adjunto de un archivo .gpx subido a la biblioteca de medios.
* `gpx` – ID de adjunto, o una URL absoluta a un archivo .gpx (alternativa a `id`).
* `height` – Altura del mapa en píxeles, de 200 a 1200. Por defecto: el ajuste
del sitio.
* `height_tablet` – Map height at 782px and below. Default: the site’s Tablet height,
or `height` when the site sets none.
* `height_mobile` – Map height at 480px and below. Default: the site’s Mobile height,
or `height_tablet` when the site sets none.
* `stats` – Muestra la barra de estadísticas (distancia, desnivel, waypoints). `
true` o `false`. Por defecto: el ajuste del sitio.
* `elevation` – Muestra el perfil de desnivel interactivo. `true` o `false`. Por
defecto: el ajuste del sitio.
* `download` – Muestra el botón de descarga del GPX en el mapa. `true` o `false`.
Por defecto: el ajuste del sitio (desactivado).
* `maxzoom` – Nivel de zoom máximo, de 1 a 22. Por defecto: 17.
* `tile` – Plantilla de URL de teselas ráster personalizada con `{z}/{x}/{y}`.
Por defecto: OpenStreetMap.
* `units` – `metric` (km / m) o `imperial` (mi / ft). Por defecto: el ajuste del
sitio.
* `fields` – Qué estadísticas mostrar, p. ej. `distance,gain`. Por defecto: el
ajuste del sitio. Usa `stats="false"` para quitar la barra.
Indica `id` o `gpx`. El bloque ofrece las mismas opciones en su barra lateral (paneles
Origen, Visualización y Teselas del mapa).
Filtros (para desarrolladores):
* `gpxrm_tile_url` – cambia la plantilla de URL de teselas ráster predeterminada.
* `gpxrm_tile_attribution` – cambia el HTML de la atribución.
* `gpxrm_height` – change the site-wide map height in pixels (integer).
* `gpxrm_heights` – change the site-wide height for every viewport band (array
of `base`, `tablet`, `mobile`; 0 means «follow the next larger band»).
* `gpxrm_units` – cambia el sistema de unidades de todo el sitio (`metric` o `imperial`).
* `gpxrm_show_stats` – cambia si la barra de estadísticas se muestra por defecto(
booleano).
* `gpxrm_show_elevation` – cambia si el perfil de desnivel se muestra por defecto(
booleano).
* `gpxrm_show_download` – cambia si el botón de descarga se muestra por defecto(
booleano).
* `gpxrm_stat_fields` – cambia qué estadísticas muestra la barra por defecto (array
de `distance`, `gain`, `loss`, `max`, `waypoints`).
## Capturas
[⌊Un mapa interactivo de la ruta con waypoints y un perfil de desnivel.⌉⌊Un mapa
interactivo de la ruta con waypoints y un perfil de desnivel.⌉[
Un mapa interactivo de la ruta con waypoints y un perfil de desnivel.
[⌊Selección de un archivo GPX en el editor de bloques.⌉⌊Selección de un archivo
GPX en el editor de bloques.⌉[
Selección de un archivo GPX en el editor de bloques.
## Bloques
Este plugin proporciona 1 bloque.
* GPX Route Map Render a GPX track as an interactive OpenStreetMap map with waypoints,
distance and an elevation profile.
## Instalación
1. Sube la carpeta `gpx-route-map` a `/wp-content/plugins/`, o instálalo desde la
pantalla de plugins.
2. Activa el plugin.
3. Añade el bloque **GPX Route Map** a una entrada o página y selecciona un archivo
GPX, o usa el shortcode.
## FAQ
### ¿Necesita Advanced Custom Fields o algún otro plugin?
No. No tiene dependencias de otros plugins y funciona con el núcleo de WordPress.
### ¿De dónde salen los mapas y el desnivel?
El mapa se muestra con MapLibre GL JS (BSD-3-Clause) y teselas ráster de OpenStreetMap.
La pista, el perfil de desnivel y las estadísticas de distancia y desnivel se calculan
en el navegador a partir de tu archivo GPX. Al añadir el bloque, esas estadísticas
se guardan con él para que el resumen siga viéndose sin JavaScript.
### ¿Puedo mostrar millas y pies en lugar de kilómetros y metros?
Sí. Ve a Ajustes > GPX Route Map y pon «Unidades» en Imperial, y todos los mapas
del sitio pasarán a millas y pies. Un mapa concreto puede usar unidades distintas
del resto: elígelas en el panel Visualización del bloque o añade `units="imperial"`
al shortcode. El cambio es inmediato y se puede deshacer en cualquier momento, porque
el plugin siempre guarda las distancias y los desniveles en métrico y solo los convierte
al mostrarlos.
### Can I change how tall the maps are?
Yes, for the whole site or for a single map. Go to Settings > GPX Route Map and
set «Map height» to size every map that does not set its own. To change just one
map, turn off «Use site default height» in the block’s Display panel and pick a
height, or add `height="600"` to the shortcode. Heights run from 200 to 1200 pixels.
### Can maps be shorter on phones?
Yes. Alongside the main height there are separate Tablet and Mobile heights, both
site-wide and per map, and a shortcode accepts `height_tablet` and `height_mobile`.
Tablet applies at 782px and below and Mobile at 480px and below, matching the widths
WordPress itself uses. Leave one empty and the map follows the site’s size for that
screen, or the size above it when the site sets none – so a site-wide Mobile height
applies to every map, including one given its own taller height. The elevation profile
also gets shorter on phones so the map and the profile stay visible together.
### ¿Puedo ocultar la barra de estadísticas o el perfil de desnivel?
Sí, cualquiera de las dos, para todo el sitio o para un solo mapa. Ve a Ajustes
> GPX Route Map y pon «Barra de estadísticas» o «Perfil de desnivel» en Ocultar
para cambiar todos los mapas de una vez. Para cambiar solo un mapa, usa el panel
Visualización del bloque, o añade `stats="false"` o `elevation="false"` al shortcode.
Un mapa con «Ajuste del sitio» sigue el ajuste general, así que puedes cambiar de
idea más adelante en un solo lugar.
### ¿Puedo mostrar solo algunas de las cifras en la barra de estadísticas?
Sí. En Ajustes > GPX Route Map, la opción «Estadísticas mostradas» tiene una casilla
de selección para cada una de las siguientes opciones: Distancia, Desnivel positivo,
Desnivel negativo, Altitud máxima y Puntos de ruta, para que puedas quedarte solo
con las que te interesen. Un mapa concreto puede ser diferente: abre el panel «Elementos
de la barra de estadísticas» del bloque, desactiva «Usar valores predeterminados
del sitio» y marca lo que quieras, o pasa `fields="distance,gain"` al shortcode.
Siempre hay al menos una opción marcada; para eliminar la barra por completo, usa
la configuración independiente «Barra de estadísticas».
### ¿Pueden los visitantes descargar el archivo GPX?
Sí, si activas el botón de descarga. Está desactivado por defecto. Ve a Ajustes
> GPX Route Map y pon «Botón de descarga» en Mostrar, o actívalo para un solo mapa
desde el panel Visualización del bloque o con `download="true"` en el shortcode.
El botón aparece en el mapa, junto a los controles de zoom y pantalla completa.
Los archivos de tu biblioteca de medios se descargan con su propio nombre; un GPX
alojado en otro sitio se abre en lugar de descargarse, porque los navegadores solo
respetan la indicación de descarga en archivos servidos desde el mismo sitio.
### ¿Puedo usar los mapas de montaña y ciclismo de Thunderforest?
Sí. Regístrate en [thunderforest.com](https://www.thunderforest.com/pricing/), luego
ve a Ajustes > GPX Route Map, pon el proveedor de teselas en Thunderforest y pega
tu clave de API. Elige entre los estilos Outdoors, OpenCycleMap, Landscape y Atlas.
Su plan gratuito cubre 150.000 teselas al mes, que son unas 8.000 visitas con mapa;
los sitios con más tráfico necesitan un plan de pago.
Dos cosas que conviene saber. La clave aparece en el código fuente de tus páginas,
porque son los navegadores de los visitantes los que descargan las teselas, y Thunderforest
no permite limitar una clave a un solo dominio, así que vigila tu consumo. Y el
mapa muestra automáticamente la atribución de Thunderforest y de OpenStreetMap,
algo que exigen sus condiciones y que no te permiten quitar.
### ¿Puedo usar mis propias teselas de mapa?
Sí, indica una URL de teselas personalizada en el panel Teselas del mapa del bloque
o con el filtro `gpxrm_tile_url`.
### ¿Puedo enlazar un archivo GPX alojado en otro sitio?
Solo si ese servidor permite peticiones de origen cruzado (CORS), porque es el navegador
del visitante el que descarga el archivo directamente, y la mayoría de los sitios
externos no envían la cabecera necesaria. Entonces la parte pública muestra «No
se ha podido cargar el archivo GPX.» aunque el enlace se abra sin problema en una
pestaña del navegador. Subir el archivo a tu biblioteca de medios es la opción fiable.
### ¿Por qué no aparecen en el selector de medios los archivos GPX que ya tenía?
Los archivos GPX subidos antes de activar este plugin pueden estar guardados con
un tipo XML genérico o sin tipo alguno. El selector muestra los tipos GPX y XML;
los archivos guardados con un tipo vacío o ajeno no aparecerán. Vuelve a subirlos
para corregir el tipo guardado. En multisitio, el ajuste «Tipos de archivos que
se pueden subir» de la red también debe incluir `gpx`.
### La parte pública muestra «Map failed to load.» ¿Qué ocurre?
No se ha podido descargar la biblioteca del mapa. El plugin carga su código de mapa
como un módulo nativo de JavaScript, algo que los plugins de optimización no suelen
tocar. Pero si el tuyo está configurado para combinar, incrustar o mover los scripts
de tipo módulo, excluye de él el script de vista de este plugin. Los visitantes
con una conexión inestable solo tienen que hacer clic en el mensaje para reintentarlo.
## Reseñas
### [The best GPX plugin you can get](https://wordpress.org/support/topic/the-best-gpx-plugin-you-can-get/)
[Leo](https://profiles.wordpress.org/lesi/) 9 de septiembre de 2026
The best GPX plugin you can get with amazing support!
### [Excellent GPX viewer, nice graphics w/ modern look](https://wordpress.org/support/topic/excellent-gpx-viewer-nice-graphics-w-modern-look/)
[ywamer](https://profiles.wordpress.org/ywamer/) 14 de agosto de 2026
I am using this on the site of a friend's adventure race company. We had been using
WP GPX Maps plugin, but that had seemingly been abandoned by its developer and we
were looking for a better option for hiking and running routes for the company site
and an affiliated nonprofit. SO glad we found this. There's no complex setup or
admin section. To use, simply add the GPX block to the page, upload a GPX files
and save the page. Works flawlessly. Thanks!
[ Leer todas las 2 reseñas ](https://wordpress.org/support/plugin/gpx-route-map/reviews/)
## Colaboradores y desarrolladores
«Mapa de ruta GPX» es un software de código abierto. Las siguientes personas han
colaborado con este plugin.
Colaboradores
* [ Manuel Camargo ](https://profiles.wordpress.org/sirlouen/)
«Mapa de ruta GPX» está traducido en 2 idiomas. Gracias a [los traductores](https://translate.wordpress.org/projects/wp-plugins/gpx-route-map/contributors)
por sus contribuciones.
[Traduce «Mapa de ruta GPX» a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/gpx-route-map)
### ¿Interesado en el desarrollo?
[Revisa el código](https://plugins.trac.wordpress.org/browser/gpx-route-map/) ,
echa un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/gpx-route-map/)
o suscríbete al [registro de desarrollo](https://plugins.trac.wordpress.org/log/gpx-route-map/)
por [RSS](https://plugins.trac.wordpress.org/log/gpx-route-map/?limit=100&mode=stop_on_copy&format=rss).
## Registro de cambios
#### 1.7.0
* New: set the map height once for the whole site under Settings > GPX Route Map,
instead of repeating it on every map. Individual maps can still set their own.
* New: separate heights for tablets and phones, site-wide and per map, so a map
can be shorter on a small screen. Leave one empty and the map follows the site’s
size for that screen. The elevation profile shrinks on phones too, so the map
and the profile stay visible together.
* The block’s height control now moves in steps of 10 pixels rather than 20, so
more heights can actually be chosen.
* Maps that never had a height set follow the site setting, so existing maps are
unaffected until you change it.
* Updated the map library to MapLibre GL JS 6. Maps now need a browser with WebGL2,
which covers Chrome, Edge, Firefox and Safari 15 or newer. Where it is missing,
the map shows its «could not load» notice instead of failing silently.
#### 1.6.1
* Fixed: the «Map failed to load» message on the front end was always in English.
It is now translated like every other message the plugin shows.
* Fixed: a hint in the block editor still pointed at Settings > General after the
settings moved to their own screen in 1.6.0.
* The Custom tile URL field now documents `{ratio}`, the placeholder for providers
that serve retina tiles, and notes that the address should use https.
#### 1.6.0
* Los ajustes del plugin tienen ahora su propia pantalla en Ajustes > GPX Route
Map, en lugar de estar al final de Ajustes > Generales. Tus preferencias actuales
se conservan intactas.
* Novedad: teselas de mapa de Thunderforest. Introduce una clave de API y elige
entre los estilos Outdoors, OpenCycleMap, Landscape y Atlas, con mapas pensados
para senderismo y ciclismo.
* Ahora los mapas acreditan el servicio de teselas que utilizan realmente. Un mapa
dirigido a Thunderforest de forma manual, con una URL de teselas personalizada,
ahora incluye la atribución que exigen las condiciones de Thunderforest en lugar
de acreditar solo a OpenStreetMap.
#### 1.5.0
* Novedad: elige qué datos aparecen en la barra de estadísticas. En Ajustes > Generales
hay una casilla para Distancia, Desnivel positivo, Desnivel negativo, Altitud
máxima y Waypoints, y un mapa concreto puede diferenciarse del resto mediante
el panel «Elementos de la barra de estadísticas» del bloque o el atributo `fields`
del shortcode.
* Los dos ajustes siguen siendo distintos: «Barra de estadísticas» decide si aparece
la barra y «Estadísticas mostradas» decide qué datos incluye. La elección del
contenido se oculta mientras la barra está desactivada.
#### 1.4.0
* Novedad: elige si se muestran la barra de estadísticas y el perfil de desnivel.
Configúralo para todo el sitio en Ajustes > Generales o cámbialo en un mapa concreto
desde el panel Visualización del bloque.
* Los atributos `stats` y `elevation` del shortcode siguen ahora el ajuste del
sitio cuando los omites, y siguen aceptando `true` o `false` para forzar una
u otra opción.
* Novedad: un botón de descarga opcional en el mapa, en la misma columna de controles
que el zoom y la pantalla completa, que permite a los visitantes guardar el archivo
GPX. Está desactivado hasta que lo actives, en Ajustes > Generales o en un mapa
concreto.
* Los mapas existentes no cambian: lo que ya tuvieras desactivado sigue desactivado
y no aparece ningún botón de descarga a menos que lo pidas.
#### 1.3.0
* Novedad: elige entre unidades métricas (km / m) e imperiales (mi / ft). Configúralo
para todo el sitio en Ajustes > Generales, cámbialo en un mapa concreto desde
el panel Visualización del bloque o pasa `units="imperial"` al shortcode.
* La elección de unidades se aplica a la barra de estadísticas y al perfil de desnivel,
incluidos sus ejes y los valores que aparecen al recorrerlo.
* Las distancias y los desniveles se siguen guardando en métrico, así que cambiar
de unidades es instantáneo y no altera nada de tu contenido guardado.
#### 1.2.1
* Probado con WordPress 7.1.
* Los controles del editor de bloques usan ahora el tamaño de 40px que pasa a ser
el predeterminado en WordPress 7.1, de modo que el panel de ajustes mantiene
la disposición prevista.
* Se ha sustituido una llamada de datos del editor obsoleta desde WordPress 6.9.
Sin cambios visibles.
#### 1.2.0
* Traducción completa al español (es_ES).
* El plugin es ahora totalmente traducible: todas las cadenas del editor de bloques,
de la barra de estadísticas y de los mensajes de la parte pública se pueden traducir,
y se incluye una plantilla `.pot` para los traductores.
#### 1.1.0
* Las estadísticas de la ruta (distancia, desnivel positivo/negativo, altitud máxima
y número de waypoints) se calculan ahora en tu navegador al añadir el bloque
y se guardan con él: una única fuente de verdad que elimina un analizador duplicado
en el servidor. La barra de estadísticas que se muestra sin JavaScript incluye
ahora también el número de waypoints.
* El shortcode `[gpx_route_map]` rellena ahora su barra de estadísticas con JavaScript;
el bloque sigue mostrando las estadísticas sin JavaScript.
#### 1.0.0
* Versión inicial: bloque GPX Route Map y shortcode `[gpx_route_map]` con mapa
MapLibre, waypoints, estadísticas y un perfil de desnivel interactivo.
## Meta
* Versión **1.7.0**
* Última actualización **hace 5 días**
* Instalaciones activas **90+**
* Versión de WordPress ** 6.6 o superior **
* Probado hasta **7.1.2**
* Versión de PHP ** 7.4 o superior **
* Idiomas
* [English (US)](https://wordpress.org/plugins/gpx-route-map/), [Spanish (Chile)](https://cl.wordpress.org/plugins/gpx-route-map/)
y [Spanish (Spain)](https://es.wordpress.org/plugins/gpx-route-map/).
* [Traducir a tu idioma](https://translate.wordpress.org/projects/wp-plugins/gpx-route-map)
* Etiquetas:
* [elevation](https://es.wordpress.org/plugins/tags/elevation/)[GPX](https://es.wordpress.org/plugins/tags/gpx/)
[map](https://es.wordpress.org/plugins/tags/map/)[openstreetmap](https://es.wordpress.org/plugins/tags/openstreetmap/)
[route](https://es.wordpress.org/plugins/tags/route/)
* [Vista avanzada](https://es.wordpress.org/plugins/gpx-route-map/advanced/)
## Valoraciones
5 de 5 estrellas.
* [ 2 valoraciones de 5 estrellas ](https://wordpress.org/support/plugin/gpx-route-map/reviews/?filter=5)
* [ 0 valoraciones de 4 estrellas ](https://wordpress.org/support/plugin/gpx-route-map/reviews/?filter=4)
* [ 0 valoraciones de 3 estrellas ](https://wordpress.org/support/plugin/gpx-route-map/reviews/?filter=3)
* [ 0 valoraciones de 2 estrellas ](https://wordpress.org/support/plugin/gpx-route-map/reviews/?filter=2)
* [ 0 valoraciones de 1 estrellas ](https://wordpress.org/support/plugin/gpx-route-map/reviews/?filter=1)
[Tu valoración](https://wordpress.org/support/plugin/gpx-route-map/reviews/#new-post)
[Ver todas las reseñas](https://wordpress.org/support/plugin/gpx-route-map/reviews/)
## Colaboradores
* [ Manuel Camargo ](https://profiles.wordpress.org/sirlouen/)
## Soporte
Problemas resueltos en los últimos dos meses:
3 de 3
[Ver el foro de soporte](https://wordpress.org/support/plugin/gpx-route-map/)