LocationPicker

LocationPicker elige una coordenada geográfica en un mapa, con rastreo de GPS y pin arrastrable. Sigue el patrón de los pickers (ver Picker) y devuelve un LatLon.

🔴 · Paquete: dev.crossfly.ui.picker · Extiende: Picker · Hardware: GPS + mapa

Cuándo usar

Recolectar una ubicación (dirección de entrega, punto de interés) en un mapa.

Apariencia

Barra superior con botones circulares (tipo de mapa Normal/Satélite, volver, confirmar), el mapa (FILL) ocupando el cuerpo, un pin arrastrable con círculo de precisión (verde/rojo según el PDOP) y un rótulo de estado en la base.

Ejemplo completo (copiar, pegar y ejecutar)

LocationPicker abre un mapa a pantalla completa — dispáralo desde un Button. El ejemplo reutiliza el uso básico y muestra la coordenada confirmada en un Label. LatLon viene de dev.crossfly.map.

package com.exemplo;

import dev.crossfly.map.LatLon;

import dev.crossfly.ui.*;
import dev.crossfly.ui.layout.*;
import dev.crossfly.ui.picker.*;

/** Pantalla principal ejecutable. Apunta el launcher (classname) y corre: gradlew :lwjgl3:run */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      Label saida = new Label("Nenhuma coordenada");
      add(LAY_AUTO, saida);

      Button escolher = new Button("Escolher local no mapa")
         .onAction(c ->
         {
            LocationPicker lp = new LocationPicker(
               coord -> {},   // onCapture del constructor (opcional; puede ser null)
               10.0,          // minPdop
               true,          // puede arrastrar el pin
               true,          // alta precisión
               false);        // sin street view

            lp.show(answer ->
            {
               LatLon ll = (LatLon) answer;
               if (ll != null)
                  saida.setText("Local: " + ll.lat + ", " + ll.lon);
            });
         });
      add(LAY_AUTO, escolher);
   }
}

Los fragmentos de abajo muestran solo el núcleo (lo que va dentro de onShow()). Para ejecutar, colócalos en el esqueleto MainWindow de arriba.

Uso básico

LocationPicker lp = new LocationPicker(
   coord -> Debug.log("Capturado: " + coord.lat + "," + coord.lon),
   10.0,   // minPdop
   true,   // puede arrastrar el pin
   true,   // alta precisión
   false); // sin street view

lp.show(answer ->
{
   LatLon ll = (LatLon) answer;
   salvarLocal(ll.lat, ll.lon);
});

Constructores

Constructor	Descripción
`LocationPicker(RunnableWith<LatLon> onCapture, double minPdop, boolean canDragPin, boolean highPrecision, boolean streetview)`	Ver parámetros abajo.

Parámetro	Tipo	Qué hace
`onCapture`	`RunnableWith<LatLon>`	Callback con el `LatLon` al confirmar (puede ser `null`).
`minPdop`	`double`	PDOP máximo aceptable; el confirmar queda oculto hasta ser alcanzado.
`canDragPin`	`boolean`	Permite arrastrar el pin a una ubicación manual.
`highPrecision`	`boolean`	Activa el GPS de alta precisión.
`streetview`	`boolean`	Habilita street view en el mapa.

Callbacks y eventos

Callback	Cuándo se dispara
`onCapture` (constructor)	al confirmar, con el `LatLon` (si `!= null`).
`show(onAnswer)`	al cerrar, entrega el `LatLon` confirmado.

getAnswer() devuelve el LatLon confirmado, o null si se cancela. Hay dos caminos para el resultado (el onCapture del constructor y el onAnswer del show) — ambos solo se disparan cuando answer != null.

Estados

Arrastrar el pin apaga el GPS (canUpdateGPS = false), marca “Custom Location” y revela el confirmar.
El botón confirmar solo aparece cuando la precisión es aceptable (o en desktop, o tras arrastre manual).
Los recursos (thread GPS, Location, mapa) se liberan una sola vez al cerrar.

Buenas prácticas

Elige un minPdop realista; en mobile el confirmar queda oculto hasta que el GPS lo alcance.
No reutilices la instancia tras hide() — los recursos de GPS/mapa se liberan.

Errores comunes

Que confirmar nunca aparezca — el GPS no alcanzó minPdop y el usuario no arrastró el pin (en desktop aparece de inmediato).
Esperar onAnswer en la cancelación — no se dispara (answer = null).

Ver también

Guía del área: ui/ · Recetas: cookbook/
Base del patrón: Picker