Cómo dejar que el usuario elija una ubicación en el mapa

Propósito. Abrir una pantalla de mapa (Google) con pin arrastrable y rastreo GPS, para que el usuario confirme una posición. El resultado es un LatLon entregado por callback.

APIs usadas

• LocationPicker(RunnableWith<LatLon> onCapture, double minPdop, boolean canDragPin, boolean highPrecision, boolean streetview) — constructor completo (es la firma real de la fuente).
  • onCapture — callback llamado con el LatLon confirmado (puede ser null).
  • minPdop — PDOP mínimo aceptable; el botón de confirmar queda oculto hasta que el fix alcance esa precisión (en el escritorio siempre está habilitado).
  • canDragPin — true para permitir arrastrar el pin a una posición personalizada.
  • highPrecision — true para GPS de alta precisión.
  • streetview — true para habilitar street view en el mapa.
• LatLon getAnswer() — posición confirmada, o null si se canceló.
• Estáticos configurables: LocationPicker.defaultZoom, Instrucoes, GpsLocation, CustomLocation, Precision, Meters.

Divergencia vs. la descripción del pedido. El LocationPicker no usa show(onAnswer) para el resultado: la coordenada llega por el RunnableWith<LatLon> onCapture pasado en el constructor (y también queda en getAnswer()). El onCapture solo se llama cuando el usuario confirma con una posición no nula. Internamente el picker ejecuta su propio GPSThread (clase interna) y ya despacha las actualizaciones vía Component.onUI(...), así que tu callback se ejecuta en el paint thread.

Ejemplo completo (copiar, pegar y ejecutar)

package com.exemplo;

import dev.crossfly.ui.*;                   // Window, Button, Label
import dev.crossfly.ui.layout.*;            // VerticalLayout
import dev.crossfly.ui.picker.*;            // LocationPicker
import dev.crossfly.map.*;                  // LatLon
import dev.crossfly.util.*;                 // RunnableWith

/** 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 resultado = new Label("");
      add(LAY_AUTO, resultado);

      Button acao = new Button("Escolher no mapa");
      acao.onAction(c ->
      {
         RunnableWith<LatLon> aoConfirmar = coord ->
         {
            // Ya llega en la paint thread (el picker usa Component.onUI internamente)
            resultado.setText("Lat " + coord.lat + " / Lon " + coord.lon);
         };

         LocationPicker picker = new LocationPicker(
            aoConfirmar,   // callback con el LatLon confirmado
            30.0,          // minPdop: habilita confirmar cuando la precisión <= 30m
            true,          // canDragPin: el usuario puede arrastrar el pin
            true,          // highPrecision
            false);        // streetview
         picker.show();
      });
      add(LAY_AUTO, acao);
   }
}

El fragmento de abajo muestra solo el núcleo. Para ejecutarlo, colócalo en el esqueleto MainWindow de arriba.

Fragmento mínimo

// verificado en la fuente: LocationPicker.java (constructor líneas 129-141, onCapture/closeWith, getAnswer)
import dev.crossfly.ui.picker.*;           // LocationPicker
import dev.crossfly.map.*;                 // LatLon
import dev.crossfly.util.*;                // RunnableWith

RunnableWith<LatLon> aoConfirmar = coord -> {
   // Ya llega en la paint thread (el picker usa Component.onUI internamente)
   double lat = coord.lat, lon = coord.lon;
   salvarLocal(lat, lon);
};

LocationPicker picker = new LocationPicker(
   aoConfirmar,   // callback con el LatLon confirmado
   30.0,          // minPdop: habilita confirmar cuando la precisión <= 30m
   true,          // canDragPin: el usuario puede arrastrar el pin
   true,          // highPrecision
   false);        // streetview
picker.show();

// Alternativa: leer el resultado después con getAnswer() (null si se canceló)

Profundiza

• Guía de ubicación: Location & GPS · Widget: LocationPicker
• Receta hermana: obter-gps.md