Índice
¿Qué es esta integración?
Pin Vision es un proveedor externo de datos GPS de campos de golf: coordenadas de los hoyos, límites de los greens y, sobre todo, la posición diaria de las banderas.
Esta integración conecta con Pin Vision e importa esos datos al módulo Caddy de Golfmanager, que es el que muestra el caddie digital (distancias, mapa y banderas) a los jugadores.
En resumen: Pin Vision aporta los datos del campo y Caddy los muestra al jugador.
La posición de bandera es el punto del green donde está colocado el hoyo ese día. Pin Vision la mide y la actualiza; gracias a esta integración, el jugador ve la bandera del día en la app. Nota: Pin Vision es solo datos del campo; no tiene nada que ver con máquinas de bolas ni con sistemas de driving range.
¿Qué problema resuelve?
Mantiene el caddie digital al día con datos reales del campo, sin cargarlos a mano.
Actualiza la posición de las banderas cada día de forma automática.
Aporta coordenadas precisas para calcular distancias al green.
Genera los dibujos de los hoyos y greens a partir de los datos del campo.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Funciona en un sentido: de Pin Vision hacia Golfmanager (módulo Caddy).
Golfmanager consulta a Pin Vision los datos del campo y los importa al módulo Caddy.
Esos datos alimentan el caddie digital de la app del jugador (distancias, mapa, banderas).
La posición de bandera se actualiza automáticamente cada día.
¿Qué información se importa?
Dato | Qué incluye |
Hoyos | Número de hoyo, par (caballeros) e índice de hándicap |
Coordenadas (GeoJSON) | Salida (tee), centro del green y frente/fondo del green, para calcular distancias |
Posiciones de bandera | Coordenadas de la bandera, distancia al frente, distancia al lateral y dirección (izquierda/derecha/centro) |
Imágenes de hoyo y green | Dibujos del hoyo (calle, búnkeres, agua, camino) y del green |
Requisitos previos (antes de activar la integración)
Tener el módulo Caddy en funcionamiento (Pin Vision alimenta a Caddy).
Tener el módulo Pin Vision instalado.
Que tu campo esté catalogado en Pin Vision (el proveedor lo mide y lo da de alta).
La clave de API de Pin Vision (se configura una sola vez en el servidor; no hace falta configurarla por club).
Permisos de administración para vincular y sincronizar.
Cómo se configura (paso a paso)
La clave de Pin Vision se configura de forma global en el servidor (lo hace el equipo técnico de Golfmanager), por lo que no tienes que introducir credenciales por club. Lo que sí debes hacer es vincular cada campo con su equivalente en Pin Vision:
Accede a Golfmanager con un usuario administrador.
Entra en Caddy > Campos (Courses) y edita un campo.
Selecciona, en el desplegable "Pin Vision Club", tu club dentro del catálogo de Pin Vision.
Selecciona, en el desplegable "Pin Vision Course", el campo correspondiente.
Guarda los cambios.
Pulsa "Sincronizar Pin Vision" para la primera carga (hoyos, coordenadas y banderas).
(Opcional) Pulsa "Sincronizar imágenes" para generar los dibujos del hoyo y del green.
⚠️ Si no vinculas el campo con su club y curso de Pin Vision, la sincronización no sabrá de dónde traer los datos.
Explicación de cada campo
A continuación se describe cada campo de la integración: dónde está, qué significa, su impacto en el sistema y un ejemplo de uso (qué ocurre cuando se utiliza y cómo se comporta el sistema).
A) Configuración del campo (Caddy > Campos)
1. Pin Vision Club
Descripción: desplegable que identifica tu club dentro del catálogo de Pin Vision.
Impacto en el sistema: es obligatorio para sincronizar; indica de qué club de Pin Vision traer los datos.
Ejemplo de uso: eliges tu club en el desplegable de la ficha del campo.
Qué ocurre cuando se utiliza: la sincronización sabe a qué club de Pin Vision conectarse.
Comportamiento del sistema: si falta (o falta el curso), al sincronizar aparece "Pin Vision Club ID and Course ID must be configured" y no se trae nada.
2. Pin Vision Course
Descripción: desplegable que identifica el campo (course) concreto dentro del club elegido en Pin Vision.
Impacto en el sistema: es obligatorio; junto con el club, determina exactamente de dónde traer hoyos, coordenadas y banderas.
Ejemplo de uso: en un club con varios recorridos, eliges el recorrido que corresponde a este campo.
Qué ocurre cuando se utiliza: la sincronización trae los datos de ese recorrido.
Comportamiento del sistema: si no coincide con el catálogo de Pin Vision, los datos no llegarán o llegarán los de otro recorrido; revisa la selección.
3. Última sincronización (solo lectura)
Descripción: la fecha y hora de la última sincronización correcta del campo.
Impacto en el sistema: es informativo; te ayuda a saber si los datos están al día.
Ejemplo de uso: la consultas tras sincronizar o para comprobar la sincronización diaria.
Qué ocurre cuando se utiliza: se actualiza sola cada vez que se sincroniza con éxito.
Comportamiento del sistema: no se edita a mano; solo refleja la última sincronización.
B) Clave de API de Pin Vision (global, en el servidor)
Nombre del campo: clave de API de Pin Vision.
Descripción: la credencial que autoriza la conexión de Golfmanager con el servicio de Pin Vision.
Impacto en el sistema: imprescindible para sincronizar. La configura el equipo técnico de Golfmanager una sola vez en el servidor; no se introduce por club.
Ejemplo de uso: tu proveedor facilita la clave y soporte la deja configurada al implantar.
Qué ocurre cuando se utiliza: todas las sincronizaciones (de cualquier club) la usan para autenticarse.
Comportamiento del sistema: si no está configurada, las sincronizaciones fallan y la app no podrá traer datos. No es algo que gestiones tú desde la administración del club.
C) Datos que se rellenan automáticamente al sincronizar
Estos datos no se rellenan a mano: los trae la sincronización desde Pin Vision y se guardan en los hoyos y en las posiciones de bandera del módulo Caddy.
Coordenadas del hoyo: salida (tee), centro del green y frente/fondo del green. Impacto: permiten calcular las distancias al green.
Par e índice de hándicap: del hoyo (caballeros). Impacto: completan la información del hoyo en el caddie.
Posiciones de bandera: coordenadas, distancia al frente, distancia al lateral y dirección (izquierda/derecha/centro). Impacto: muestran la bandera del día en la app.
Imágenes de hoyo y green: dibujos generados a partir de los datos. Impacto: son el mapa visual del caddie.
Ejemplo de uso: tras pulsar "Sincronizar Pin Vision", los hoyos tienen sus coordenadas y la bandera del día.
Qué ocurre cuando se utiliza: la app del jugador muestra esos datos (distancias, mapa, bandera).
Comportamiento del sistema: la sincronización actualiza los existentes (no los duplica); las banderas se refrescan a diario de forma automática.
Cómo se usa: sincronización
Botón "Sincronizar Pin Vision"
Al pulsar Sincronizar Pin Vision en un campo, se ejecutan tres operaciones en orden:
Hoyos: trae el número de hoyo, par e índice de hándicap (actualiza los existentes, no los duplica).
Coordenadas (GeoJSON): trae las coordenadas de salida, centro y frente/fondo del green para calcular distancias.
Banderas (posiciones de pin): trae la posición más reciente de la bandera de cada hoyo (coordenadas, distancia al frente, lateral y dirección). Si Pin Vision no da algún dato, se calcula a partir de las coordenadas.
Botón "Sincronizar imágenes"
Genera los dibujos del hoyo y del green a partir de los datos de Pin Vision (calle, búnkeres, agua, camino y pendientes del green), orientados con el green arriba y la salida abajo.
Sincronización diaria automática
Cada día a las 6:00 se sincronizan automáticamente las posiciones de bandera de todos los campos que tengan Pin Vision configurado. Así, la app muestra siempre las banderas del día sin intervención manual.
Qué NO se importa de Pin Vision
Estos datos se gestionan manualmente en Caddy:
Desniveles (elevación).
Consejos del profesional (pro tips).
Distancias por color de barra de salida (blancas, amarillas, rojas).
Limitaciones a tener en cuenta
Depende del módulo Caddy: Pin Vision solo aporta los datos; el caddie digital es de Caddy.
El campo debe estar catalogado en Pin Vision y vinculado correctamente.
Algunos datos no se importan (desniveles, consejos, distancias por color).
La sincronización automática es de banderas; hoyos, coordenadas e imágenes se sincronizan a demanda.
Depende del servicio de Pin Vision: si no está disponible, no se podrán traer datos en ese momento.
Preguntas frecuentes
La sincronización no trae nada.
El campo no está vinculado a Pin Vision. Edita el campo en Caddy > Campos y selecciona el "Pin Vision Club" y el "Pin Vision Course"; sin ellos, aparece "Pin Vision Club ID and Course ID must be configured" y no hay de dónde traer los datos.
Las banderas no se actualizan solas.
La sincronización diaria (a las 6:00) solo cubre los campos que tienen Pin Vision configurado. Vincula el campo con su club y curso de Pin Vision para que entre en la actualización automática.
No se ve la bandera en la imagen del green.
Suele faltar la configuración de los puntos de referencia del green en el hoyo. Configura las referencias del green en el hoyo (en Caddy) para que la posición de la bandera se pueda situar sobre la imagen.
Faltan desniveles, consejos o distancias por color de barra.
Esos datos no los aporta Pin Vision. Introdúcelos manualmente en Caddy.
Aparece "Sync failed" o "Import failed".
Ha habido un error puntual al conectar con Pin Vision. Comprueba que el campo está bien vinculado y que el servicio está disponible, y vuelve a intentarlo. Si persiste, contacta con soporte.
Aparece "No clubs available in Pin Vision".
El catálogo de Pin Vision llegó vacío. Suele deberse a que la clave de API no está configurada en el servidor o a que tu campo aún no está catalogado en Pin Vision. Contacta con soporte y con tu proveedor de Pin Vision.
Al importar un campo me dice que "ya está importado".
Ya existe un campo de Caddy vinculado a ese club y curso de Pin Vision. No es necesario importarlo de nuevo; sincroniza el campo existente.
¿Cómo doy de alta un campo nuevo desde Pin Vision?
Desde el módulo puedes importar un campo eligiendo su club y curso de Pin Vision; al hacerlo, se crea el campo en Caddy y se ejecuta una sincronización inicial. Si el campo ya existe en Caddy, basta con vincularlo y sincronizarlo.
¿De dónde sale la clave de API y tengo que configurarla?
La clave es global y la configura el equipo técnico de Golfmanager una sola vez en el servidor. No se introduce por club ni la gestionas tú desde la administración.
¿Cada cuánto se actualizan los datos?
Las banderas se actualizan automáticamente cada día a las 6:00. Los hoyos, las coordenadas y las imágenes se sincronizan a demanda, cuando pulsas los botones de sincronización.
¿Pin Vision cobra o dispensa bolas en el driving range?
No. Pin Vision es únicamente un proveedor de datos GPS del campo (coordenadas, banderas, imágenes) para el caddie digital. No tiene relación con máquinas de bolas, vales ni cobros.
¿Qué ve el jugador con esta integración?
El caddie digital en la app: las distancias al green, el mapa del hoyo y del green, y la bandera del día.
¿Los datos viajan en los dos sentidos?
No. Es de un solo sentido: de Pin Vision hacia Golfmanager (Caddy). Golfmanager no envía datos a Pin Vision.
Mi campo no aparece en Pin Vision. ¿Qué hago?
Tu campo debe estar catalogado en Pin Vision: el proveedor lo mide y lo da de alta. Contacta con Pin Vision para que añada tu campo a su catálogo; después podrás vincularlo y sincronizarlo.
Buenas prácticas recomendadas
Vincula correctamente cada campo con su club y curso de Pin Vision.
Haz una primera sincronización completa (hoyos, coordenadas, banderas e imágenes) al implantar.
Deja que la sincronización diaria mantenga las banderas al día.
Completa en Caddy los datos que Pin Vision no aporta (desniveles, consejos, distancias por color).