Todos los artículos Desarrollador

Buscar una ubicación con latitud y longitud

Por The Kaleidr Team · Publicado 10 de agosto de 2026 · 16 min de lectura

Entradas de latitud y longitud validadas y convertidas en un punto exacto del mapa con una etiqueta de lugar opcional obtenida mediante geocodificación inversa.

Para buscar una ubicación con latitud y longitud, valida el par de coordenadas, confirma el orden, centra el mapa y, si resulta útil, aplica geocodificación inversa para mostrar una etiqueta. El error más habitual es invertir el orden: Google usa campos lat/lng, mientras que GeoJSON, Mapbox GL JS y MapLibre GL JS usan matrices con longitud primero. Una herramienta de producción debe validar los rangos, conservar los valores originales, gestionar resultados vacíos y no atribuir a una dirección más precisión de la que puede ofrecer el geocodificador.

Las secciones siguientes explican la validación, los contratos de orden, ejemplos de Google Maps, Mapbox y MapLibre, la geocodificación inversa, GeoJSON y los fallos habituales. Consulta Kaleidr Spatial AI y la documentación para desarrolladores. Una vez resuelto, el punto puede actuar como origen de una búsqueda de lugares cercanos.

Aspectos esenciales de la búsqueda por coordenadas

  • Valida primero: latitud de -90 a 90; longitud de -180 a 180.
  • Conoce el orden: los campos con nombre reducen la ambigüedad; las matrices necesitan un contrato explícito.
  • Sitúa antes de enriquecer: representa el punto exacto y después aplica geocodificación inversa si hace falta.
  • Conserva los originales: muestra las coordenadas introducidas junto a cualquier dirección.
  • Respeta la API: Google usa lat/lng; GeoJSON, Mapbox y MapLibre usan [lng, lat].

Entradas de latitud y longitud validadas y convertidas en un punto exacto del mapa con una etiqueta de lugar opcional obtenida mediante geocodificación inversa.

¿Cómo buscar una ubicación con latitud y longitud?

Una búsqueda coordinada necesita una secuencia determinista corta: Aceptar latitud y longitud, normalizar los separadores decimales y el espacio en blanco, validar la latitud contra -90 a 90 y la longitud frente a -180 a 180, convertir en el orden de coordenadas requerido por la biblioteca de mapas seleccionada, centrar el mapa y añadir un marcador, opcionalmente, el geocodificado inverso del punto, Y mostrar las coordenadas originales junto con cualquier etiqueta de lugar devuelta. El último paso importa. La geocodificación inversa es una interpretación de una coordenada, no un reemplazo para ella. Google describe la geocodificación inversa como la traducción de una ubicación de mapa en una dirección y notas legibles por humanos que el resultado es una estimación basada en la ubicación directable más cercana (Geocodificación inversa). Mapbox distingue de manera similar la geocodificación directa, que convierte el texto en coordenadas, de la geocodificación inversa, que convierte las coordenadas en una descripción de texto (Entender la API de Geocodificación).

Medidas de latitud situada al norte o al sur del ecuador; La longitud mide la posición al este o al oeste del meridiano principal. Para las coordenadas geográficas ordinarias de grado decimal, La latitud oscila entre -90 y 90 y la longitud desde -180 hasta 180. Un punto en Washington, D.C., por ejemplo, podría escribirse como latitud 38.8977 y longitud -77.0365. Los valores por sí solos no son suficientes: la aplicación también debe saber qué valor viene primero.

¿Por qué el orden de las coordenadas rompe las búsquedas?

El orden de las coordenadas es una de las causas más frecuentes de búsquedas cartográficas incorrectas. La notación para personas suele escribir primero la latitud; Google Maps usa los campos con nombre lat y lng en LatLngLiteral (referencia de coordenadas). GeoJSON Point y los centros de Mapbox GL JS y MapLibre GL JS utilizan matrices longitud-latitud. El RFC de GeoJSON define las posiciones en ese orden y usa coordenadas WGS 84 en grados decimales (RFC 7946). Los campos con nombre reducen la ambigüedad; las matrices posicionales necesitan un contrato explícito.

Comparación entre entrada humana latitud-longitud, campos con nombre de Google y matrices longitud-latitud de GeoJSON, Mapbox y MapLibre.

Sistema Representación típica Orden
La latitud/longitud legible por el hombre 38.8977, -77.0365 latitud, longitud
Google Maps LatLngLiteral { lat: 38.8977, lng: -77.0365 } campos nombrados
GeoJSON Point [-77.0365, 38.8977] longitud, latitud
Mapbox GL JS centro [-77.0365, 38.8977] longitud, latitud
MapLibre GL JS centro [-77.0365, 38.8977] longitud, latitud

La mayoría de las búsquedas en mapas web usan longitud y latitud WGS 84 en grados decimales. El registro EPSG identifica el sistema geográfico 2D WGS 84 como EPSG:4326 y enumera sus ejes como latitud y longitud (EPSG:4326). GeoJSON, sin embargo, coloca primero la longitud en sus matrices. Por eso, “EPSG:4326 es latitud-longitud” y “GeoJSON es longitud-latitud” pueden ser correctos en sus respectivas especificaciones. En el código, sigue el contrato real de la API o formato, no una frase memorizada como “lat/lon”.

¿Cómo deben analizar y validar coordenadas los equipos?

Un analizador pequeño evita la mayoría de los errores de entrada. Acepta pares como 38.8977, -77.0365, valores separados por espacios o campos independientes. Exige exactamente dos números finitos, rechaza latitudes fuera de -90…90 y longitudes fuera de -180…180, y devuelve campos con nombre { latitude, longitude }. No intercambies automáticamente los valores porque el primero quede fuera del rango de latitud; podría ocultar un error de la fuente. Si ofreces una corrección, presenta explícitamente la posibilidad de que estén invertidos.

function parseCoordinatePair(input) {
  const parts = input
    .trim()
    .split(/[\s,]+/)
    .filter(Boolean);

  if (parts.length !== 2) {
    throw new Error("Enter exactly two coordinate values.");
  }

  const latitude = Number(parts[0]);
  const longitude = Number(parts[1]);

  if (!Number.isFinite(latitude) || !Number.isFinite(longitude)) {
    throw new Error("Coordinates must be valid numbers.");
  }

  if (latitude < -90 || latitude > 90) {
    throw new Error("Latitude must be between -90 and 90.");
  }

  if (longitude < -180 || longitude > 180) {
    throw new Error("Longitude must be between -180 and 180.");
  }

  return { latitude, longitude };
}

Una forma básica accesible debe utilizar etiquetas visibles en lugar de marcadores de posición solos, inputmode="decimal" en ambos campos, un control de envío y una región de estado con role="status" Así que los usuarios de teclado y de pantalla reciben la misma retroalimentación que los usuarios que observan el movimiento del marcador. Mantenga las coordenadas textuales fuera del lienzo del mapa, proporcionar retroalimentación de la copia, Y no requieren arrastrar un marcador como única forma de editar coordenadas.

¿En qué se diferencian Google Maps, Mapbox y MapLibre?

La API de JavaScript de Google Maps representa puntos geográficos con LatLng o LatLngLiteral, Así llamados campos lat y lng evita la ambigüedad de la matriz posicional. La documentación actual de Google recomienda marcadores avanzados para los flujos de trabajo de marcadores modernos (Añadir un marcador). Después de la validación, centra el mapa y crea o mueve un marcador con { lat, lng }. Reemplace la configuración de demostración con la clave restringida de Google Maps del proyecto y el ID del mapa de producción donde requerido.

Mapbox GL JS utiliza [longitude, latitude] para el centro de mapas y coordenadas de marcadores (Mapabox GL JS; Marcadores). Cree la matriz como [longitude, latitude], llame a setLngLat y flyTo el mismo punto. Para la búsqueda de direcciones, Utilizar un producto de geocodificación Mapbox autorizado; Mapbox documenta la geocodificación inversa como la conversión de coordenadas geográficas en una descripción de texto.

MapLibre GL JS también utiliza matrices de longitud-latitud (LngLat; Marcador). La documentación de MapLibre establece explícitamente que la biblioteca utiliza el orden de longitud-latitud para que coincida con el Especificación GeoJSON. MapLibre es un render, No es un proveedor universal de geocodificación: conecte un servicio de geocodificación aprobado por separado y siga la licencia de ese proveedor, Atribución, Almacenamiento, Y requisitos de credenciales.

Comparación neutral de campos con nombre y matrices longitud-latitud para centrar mapas y colocar marcadores.

function showGoogleCoordinate(latitude, longitude) {
  const position = { lat: latitude, lng: longitude };
  map.setCenter(position);
  map.setZoom(16);
  marker.position = position;
}

function showLngLatCoordinate(latitude, longitude) {
  const lngLat = [longitude, latitude];
  marker.setLngLat(lngLat);
  map.flyTo({ center: lngLat, zoom: 16, essential: true });
}

¿Cuándo debe aplicarse la geocodificación inversa?

Un marcador le dice al usuario dónde se encuentra la coordenada. La geocodificación inversa puede agregar una dirección o área política legible por humanos cercana después de que se trace el punto. Mantener ambos visibles, coordenadas originales y dirección devuelta más cercana, Y manejar los resultados vacíos sin quitar el marcador. Google señala que la geocodificación inversa no es exacta y puede devolver los resultados en varios niveles geográficos. desde una dirección a un barrio, Ciudad, Condado, o Estado (Ejemplo de geocodificación inversa de JavaScript de mapas).

Flujo que separa la búsqueda de una coordenada exacta de la geocodificación inversa opcional a una dirección cercana o contexto geográfico.

Estos flujos de trabajo resuelven problemas opuestos. La geocodificación hacia adelante convierte una dirección o un nombre de lugar en coordenadas y candidatos. La geocodificación inversa convierte las coordenadas en contexto legible por el ser humano. La búsqueda de coordenadas directas traza un punto exacto del mapa desde las coordenadas. La búsqueda cercana utiliza una coordenada o un lugar de origen más criterios para devolver los lugares cercanos. Si el usuario ya tiene coordenadas, no las geocodifica antes de colocar el punto. Trace primero la coordenada exacta; la geocodificación inversa es el enriquecimiento opcional. Una vez que una coordenada se convierte en el origen de la búsqueda, La aplicación puede recuperar lugares cercanos, Clasénsenlos por distancia o tiempo de viaje, Y deje que el usuario refina el resultado.

Una vez validada la coordenada, un punto GeoJSON crea un objeto geográfico portátil que puede moverse entre muchos sistemas de mapeo web. La matriz de coordenadas es de nuevo [longitude, latitude]. Una utilidad útil puede exponer la copia como latitud/longitud, copia como longitud/latitud, copia como GeoJSON, copiar como una URL de compartir, Abrir en el mapa actual, de geocódigo inverso, Y añadir el punto a un proyecto.

function toGeoJSONPoint(latitude, longitude) {
  return {
    type: "Feature",
    geometry: {
      type: "Point",
      coordinates: [longitude, latitude]
    },
    properties: {
      source: "coordinate-search"
    }
  };
}

¿Qué ocurre con DMS, UTM, la precisión y la IA?

Muchas búsquedas coordinadas usan grados decimales, pero los usuarios pueden llegar con una notación de grados-minutos-segundos. La conversión es grados más minutos divididos por 60 más segundos divididos por 3600, Con una señal negativa para el oeste y el sur. Para una utilidad de producción, no acepte DMS a menos que el analizador esté completamente probado para letras del hemisferio, Símbolos de grado de unicod, faltan segundos, signos negativos combinados con sufijos del hemisferio, minutos malformados o segundos por encima de 60, Y localización. Una herramienta decimal decimal más pequeña y confiable es mejor que un analizador que malinterpreta silenciosamente las coordenadas.

UTM utiliza orientaciones y nordes proyectadas en lugar de latitud y longitud. El registro EPSG define WGS 84 / UTM como un CRS proyectado en zonas con zonas separadas y basados en medidores Las coordenadas. Por lo tanto, una búsqueda UTM necesita una zona y un hemisferio o un identificador de CRS inequívoco; No trate el este y el norte como latitud y longitud. Los lugares más decimales implican una representación más precisa, pero no garantizan la misma precisión de medición. Elija la precisión de la pantalla para el flujo de trabajo, conservar la coordenada completa almacenada, Y no comercialicen la precisión del centímetro simplemente porque un número contiene muchos decimales.

Una búsqueda de coordenadas en sí no requiere AI. El flujo de trabajo determinista es análisis, validación, trazado y opcionalmente de código inverso. AI se vuelve útil después de que se establece el punto geográfico, para preguntas sobre lo que hay alrededor de la coordenada, comestibles dentro de un viaje, El contexto de barrio, hoteles entre el punto y un aeropuerto, o comparar sitios candidatos. Kaleidr Spatial AI Está diseñado en torno a la exploración de lugares basados en preguntas. Los desarrolladores también pueden adjuntar Kaleidr Chat a un Mapbox existente, Google Maps, o MapLibre mapa para que una coordenada resuelta se convierta en contexto para la exploración del lenguaje natural; Ver Chat de AI en Mapbox, Google Maps y MapLibre. El renderista existente todavía posee el mapa; El lugar autorizado y los servicios de enrutamiento siguen siendo responsables de las respuestas objetivas.

¿Qué errores y casos límite importan más?

Error ¿Qué pasa Corrección recomendada
Suponiendo que cada API utiliza la latitud primero Los puntos aparecen en el país equivocado o en la validación de fallo Orden de coordenadas del documento en cada límite
Cambiar silenciosamente las entradas Los errores de datos ascendentes se vuelven invisibles Ofrece una sugerencia de swap explícita
Reverso-geocodificado antes de trazar Una dirección difusa reemplaza la coordenada exacta Trama primero; enriquecer segundo
Tratar la geocodificación inversa como exacta Los usuarios pueden creer que una dirección cercana es el punto exacto Mostrar tanto la coordenada original como la etiqueta devuelta
Almacenando solo direcciones formateadas La precisión y la interoperabilidad se pierden Conservar las coordenadas originales y los ID estables
Aceptar rangos inváliros La renderadora sujeta, envuelve o se comporta de manera impredecible Validar antes de la llamada del proveedor
Tratar MapLibre como un geocodificador La aplicación no tiene fuente para la búsqueda de direcciones Conecte un servicio de geocodificación aprobado por separado
Mezcla [lat, lng] Con GeoJSON Cambios de datos a la ubicación incorrecta Uso [lng, lat] En GeoJSON
Ocultar toda la salida dentro del lienzo La accesibilidad y la visibilidad de búsqueda sufren Render un resultado de texto al lado del mapa
Reivindicación de una precisión excesiva La interfaz de usuario exagera la precisión de la fuente Separar la precisión numérica de la precisión de medición

Gestiona las entradas invertidas con una sugerencia explícita y rechaza los valores fuera de rango. Mantén 0,0 como coordenada válida, aunque pueda marcarse en controles de calidad. No elimines el punto si la geocodificación inversa no devuelve resultados ni fuerces coordenadas oceánicas o remotas a una dirección. Conserva los originales cerca de la línea internacional de cambio de fecha y usa identificadores estables, en vez de asumir que coordenadas iguales representan la misma entidad. Explica la utilidad en texto indexable; una herramienta sólida y una guía autorizada son mejores que páginas superficiales para cada sinónimo.

Veredicto final

Buscar un mapa por latitud y longitud es un flujo espacial sencillo, pero revela una verdad importante: el significado de los números depende de su contrato. Valida los valores, declara el orden, sitúa primero el punto exacto y trata la geocodificación inversa como enriquecimiento contextual. Google Maps suele usar campos lat y lng; GeoJSON, Mapbox y MapLibre usan longitud-latitud en las matrices.

Para Kaleidr, el siguiente paso de mayor valor no consiste en convertir esta búsqueda determinista en una tarea de IA. La coordenada debe ser primero un ancla geográfica fiable. Después, Spatial AI puede ayudar a formular preguntas más ricas sobre el área, lugares cercanos, rutas y relaciones espaciales.

Explora el área alrededor de una coordenada

Después de localizar el punto, usa Kaleidr Spatial AI para hacer preguntas contextuales sobre lugares cercanos y relaciones geográficas. Abre Kaleidr Spatial AI para explorar una coordenada resuelta y profundiza la integración mediante la documentación para desarrolladores cuando la aplicación anfitriona controla el mapa.

Preguntas frecuentes

¿Cómo busco una ubicación con latitud y longitud?

Introduce una latitud válida entre -90 y 90 y una longitud entre -180 y 180, conviértelas al orden que exige la API, centra el mapa y añade un marcador. La geocodificación inversa es opcional si también necesitas una dirección legible.

¿Qué va primero, la latitud o la longitud?

Depende de la interfaz. Las coordenadas para personas suelen escribir primero la latitud. Google Maps JavaScript usa campos lat y lng; GeoJSON, Mapbox GL JS y MapLibre GL JS ponen primero la longitud en las matrices.

¿Por qué mi coordenada muestra el lugar equivocado?

La causa más común es invertir el orden. También puede tratarse de un sistema de referencia incorrecto, sobre todo si se confunden coordenadas UTM proyectadas con latitud y longitud en grados decimales.

¿Qué es la geocodificación inversa?

La geocodificación inversa convierte una coordenada en una dirección o descripción geográfica legible. El resultado es una estimación basada en los datos y la lógica de coincidencia del proveedor.

¿GeoJSON usa latitud-longitud o longitud-latitud?

Las matrices de posición de GeoJSON usan primero la longitud y después la latitud.

¿EPSG:4326 es lo mismo que GeoJSON?

No. EPSG:4326 identifica el sistema geográfico 2D WGS 84. GeoJSON es un formato de datos que usa coordenadas WGS 84, pero define las matrices en orden longitud-latitud.

¿Puedo buscar coordenadas UTM del mismo modo?

No directamente. UTM requiere zona, hemisferio o identificador CRS, además de valores proyectados de este y norte. Aplica una transformación CRS probada antes de tratar el punto como longitud y latitud.

¿MapLibre incluye geocodificación inversa?

MapLibre GL JS es principalmente un motor de representación. La geocodificación inversa procede de un servicio separado elegido por la aplicación anfitriona.

¿Debo usar IA para encontrar una coordenada?

No para la búsqueda básica. El análisis, la validación, la representación y la geocodificación inversa son tareas deterministas. La IA ayuda después, cuando se conoce el punto y se desea explorar contexto o múltiples variables.

¿Puede Kaleidr trabajar con un mapa centrado en coordenadas?

Sí. El mapa anfitrión puede centrarse primero en la coordenada resuelta y después conectar Kaleidr Chat a un mapa compatible para consultas conscientes del mapa. El mapa y los servicios autorizados siguen siendo responsables de las coordenadas exactas y los datos de lugares.

Referencias

@misc{ietf_geojson,
  title  = {RFC 7946: The GeoJSON Format},
  author = {{Internet Engineering Task Force}},
  note   = {Accessed 10 August 2026},
  url    = {https://datatracker.ietf.org/doc/html/rfc7946}
}

@misc{epsg_wgs84,
  title  = {WGS 84 -- EPSG:4326},
  author = {{EPSG}},
  note   = {Accessed 10 August 2026},
  url    = {https://epsg.org/crs_4326/WGS-84.html}
}

@misc{google_coordinates,
  title  = {Coordinates -- Maps JavaScript API},
  author = {{Google}},
  note   = {Accessed 10 August 2026},
  url    = {https://developers.google.com/maps/documentation/javascript/reference/coordinates}
}

@misc{google_reverse_geocode,
  title  = {Reverse geocode a location},
  author = {{Google}},
  note   = {Geocoding API; accessed 10 August 2026},
  url    = {https://developers.google.com/maps/documentation/geocoding/reverse-geocoding}
}

@misc{mapbox_geocoding,
  title  = {Understanding the Geocoding API},
  author = {{Mapbox}},
  note   = {Accessed 10 August 2026},
  url    = {https://docs.mapbox.com/help/dive-deeper/geocoding/}
}

@misc{maplibre_lnglat,
  title  = {LngLat -- MapLibre GL JS},
  author = {{MapLibre}},
  note   = {Accessed 10 August 2026},
  url    = {https://maplibre.org/maplibre-gl-js/docs/API/classes/LngLat/}
}

Contenido relacionado

Convierte tu mapa en un motor de crecimiento