API de geolocalización de fotos: qué puede y qué no puede decirte
· 13 min de lectura
Respuesta corta
Una API de geolocalización de fotos recibe una imagen y devuelve una estimación de dónde se tomó: un país, región o ciudad, coordenadas aproximadas y una puntuación de confianza. La estimación se infiere de pruebas visibles como la arquitectura, los carteles y la vegetación. No es una lectura GPS, y los píxeles por sí solos no dan una dirección.
El nombre genera confusión antes de escribir una sola línea de código. La Geolocation API del navegador indica dónde está un dispositivo ahora mismo, y solo después de que el usuario dé permiso. Una API de geolocalización de fotos responde a otra pregunta sobre otra entrada: ¿dónde se tomó esta imagen? La imagen puede tener diez años y venir de cualquier parte de la Tierra.
Otras tres tecnologías vecinas también se describen como «localizar una foto»: leer los metadatos GPS, la búsqueda inversa de imágenes y la detección de lugares emblemáticos. Devuelven cosas distintas y fallan de formas distintas, así que conviene saber qué pregunta hace de verdad tu producto antes de elegir una.
¿Qué hace realmente una API de geolocalización de fotos?
Infiere una ubicación a partir de los píxeles. Un modelo lee pruebas como las marcas viales, la arquitectura, las plantas, la escritura de los carteles y la calidad de la luz, y luego informa del lugar donde coincide la mayoría de esas pruebas, con una puntuación de cuánto coinciden.
Muchos sistemas de investigación lo tratan como un problema de clasificación. PlaNet, un modelo de 2016 de investigadores de Google, dividió la superficie de la Tierra en miles de celdas y entrenó una red con millones de fotos con geoetiqueta para predecir a qué celda pertenece una imagen. El resultado es una probabilidad repartida por todo el globo. La foto de un tranvía de Lisboa concentra esa probabilidad en un solo lugar; la foto de un pinar la reparte, muy diluida, por varios continentes. Una puntuación de confianza es, en la práctica, un resumen de ese reparto.
El detalle que más importa para el diseño del producto es que no hace falta que nada exista en línea. La API funciona con una foto que nunca se ha publicado y puede devolver una respuesta incluso cuando las pruebas son débiles, por lo que la puntuación importa tanto como el lugar. Cómo lee un modelo una escena se explica aparte; esta guía trata de qué haces con el resultado.
La precisión también es desigual por diseño. PlaNet asignaba celdas más pequeñas a las zonas muy fotografiadas que a las poco fotografiadas, así que podía alcanzar precisión de calle en algunas zonas urbanas mientras que las regiones rurales caían en celdas mucho mayores. Espera que la mayoría de los modelos sean más precisos donde sus fotos de entrenamiento eran abundantes.
¿En qué se diferencia del GPS EXIF, la búsqueda inversa y la detección de lugares emblemáticos?
El GPS EXIF es una medición guardada en el archivo. La búsqueda inversa halla copias de la imagen en línea. La detección de lugares emblemáticos reconoce estructuras famosas. Una API de geolocalización de fotos infiere la región de la propia escena: la única vía si no hay metadatos ni copias en línea.
| Método | Qué lee | Qué devuelve | Falla cuando |
|---|---|---|---|
| GPS EXIF | Las coordenadas que el dispositivo escribió en el archivo | Un punto medido, normalmente con un margen de 5 m a cielo abierto | Se eliminaron los metadatos, como hacen la mayoría de las plataformas al subir |
| Búsqueda inversa de imágenes | Copias de la imagen que ya están en la web | Imágenes coincidentes y las páginas donde aparecen | La escena nunca se ha publicado |
| Detección de lugares emblemáticos | Estructuras conocidas, naturales y artificiales | Nombre del lugar emblemático, puntuación y sus coordenadas | No hay ninguna estructura famosa en el encuadre |
| Geolocalización de fotos | Pruebas visuales de toda la escena | Estimación de ciudad, región o país con una puntuación de confianza | El encuadre no contiene pruebas geográficas |
El GPS EXIF es una medición, no una estimación
Cuando un teléfono registra la ubicación, las coordenadas van a un bloque GPS específico de los datos EXIF, bajo etiquetas como GPSLatitude y GPSLongitude. GPS.gov sitúa la precisión típica de un smartphone en 4,9 m a cielo abierto. Ningún método visual se le acerca, así que un flujo sólido lee primero los metadatos y solo infiere cuando faltan. En las imágenes que han pasado por una red social suelen faltar, porque la recodificación al subir las elimina.
La búsqueda inversa de imágenes es una consulta
La detección web de Google Cloud Vision muestra cómo es esta categoría. Devuelve campos como fullMatchingImages, partialMatchingImages y pagesWithMatchingImages. Cuando existe una coincidencia, la página donde está suele nombrar el lugar sin rodeos, lo que supera a cualquier estimación. Cuando la foto es privada u original, no hay nada con qué compararla. La comparativa de buscadores cubre las versiones para el público general de la misma idea.
La detección de lugares emblemáticos reconoce sitios famosos
La detección de lugares emblemáticos de Cloud Vision «detecta estructuras populares, naturales y artificiales, dentro de una imagen». Cada resultado incluye una description con el nombre del lugar emblemático, un score, un boundingPoly que marca dónde está en el encuadre y una lista locations de coordenadas. El propio ejemplo de Google devuelve la catedral de San Basilio con una puntuación de 0,78.
Dos detalles sorprenden a los equipos. Una calle corriente no devuelve ningún lugar emblemático, así que la cobertura es estrecha. Y las coordenadas pueden describir el lugar emblemático y no la cámara: la referencia de Google señala que una ubicación puede describir la escena de la imagen mientras que otra describe dónde se tomó la foto. Quien fotografía la Torre Eiffel desde el otro lado del Sena puede estar a varios cientos de metros de las coordenadas de la propia torre.
La geolocalización de fotos estima una región para cualquier escena exterior
La inferencia visual es la única de las cuatro que tiene algo que decir sobre una calle anodina que nunca ha estado en línea. El coste es la precisión. La respuesta es una ciudad o región con una puntuación de confianza, nunca un punto medido, y un encuadre sin pruebas geográficas recibe una respuesta débil o ninguna.
¿Qué devuelve una API de geolocalización de fotos?
Una estimación del lugar en uno o varios niveles (país, región, ciudad), coordenadas aproximadas que representan esa estimación y una puntuación de confianza. Una buena respuesta informa aparte del GPS de los metadatos si el archivo aún lo conserva, para no confundir una medición con una conjetura.
| Campo | Qué significa | Cómo usarlo |
|---|---|---|
| País, región, ciudad | El lugar al que apuntan las pruebas, en varios niveles | Muestra el nivel más específico que respalde la confianza |
| Coordenadas aproximadas | Un punto que representa la zona estimada, no la posición de la cámara | Muestra el nombre de una ciudad o un área, nunca un marcador a nivel de calle |
| Puntuación de confianza | Cuánto concuerdan las pruebas visuales | Fija umbrales con tus propias fotos de prueba etiquetadas |
| GPS EXIF, si existe | Coordenadas medidas por el dispositivo y guardadas en el archivo | Guárdalo en su propio campo; prevalece sobre cualquier estimación |
El error de diseño que hay que evitar es fundir las coordenadas estimadas y el GPS EXIF en un único campo de ubicación. El código posterior, y las personas que leen su resultado, tratan entonces una conjetura a nivel de ciudad con la seguridad de una posición por satélite. Mantén separadas las ubicaciones medidas y las inferidas hasta la interfaz, y etiquétalas de forma distinta al mostrarlas.
Las coordenadas estimadas piden el mismo cuidado. Un punto devuelto para Oporto representa una zona de muchos kilómetros cuadrados. Si lo dibujas como un marcador con zoom de calle, los usuarios leerán una precisión que nunca existió.
¿Qué devolverá la API de GeoSpy AI?
La API de GeoSpy AI aún no está abierta. Se está diseñando para devolver los mismos campos que hoy devuelve el análisis de la web: una estimación de ciudad, región y país, una puntuación de confianza, coordenadas aproximadas de la estimación y las coordenadas GPS EXIF cuando el archivo subido aún las contiene.
Esa lista se corresponde directamente con la tabla de arriba. No contiene ninguna dirección postal, porque las pruebas visuales no pueden sostener una, y presenta la lectura de los metadatos junto a la estimación visual, no en lugar de ella.
No se han anunciado los endpoints, los precios, los límites de uso ni una fecha de lanzamiento, y nada de esta página debe leerse como una promesa sobre ellos. Si estás planeando una integración, solicita acceso anticipado desde la página de contacto y describe tu caso de uso.
Hasta entonces, la web es la vista previa más cercana del resultado con fotos reales. El análisis web viene con GeoSpy Premium, una suscripción de 7,99 dólares estadounidenses a la semana o 29,99 dólares estadounidenses al año que se renueva hasta que la canceles, y las fotos subidas no se almacenan.
¿Para qué sirve una API de geolocalización de fotos?
Sobre todo para comprobaciones de coherencia y triaje: señalar una foto cuya ubicación probable contradice una afirmación, para que una persona la revise. Marketplaces, redacciones, apps de viajes y de fotos, aseguradoras e investigadores tienen versiones de esa pregunta. Se trata de lugares, nunca de individuos.
- Comprobación de anuncios en marketplaces. Un alquiler vacacional anunciado en Barcelona cuyas fotos apuntan con fuerza a otro país merece una segunda mirada. Envía la discrepancia a un revisor en lugar de rechazar el anuncio de forma automática, y recuerda que las fotos de interiores, que son buena parte de cualquier anuncio, dan poco que leer a un modelo.
- Verificación en redacciones. Una imagen viral que dice mostrar una ciudad puede contrastarse con las pruebas del encuadre antes de que nadie la publique. La geolocalización solo responde «dónde», así que combínala con la búsqueda de copias anteriores, como se explica en cómo verificar una foto.
- Apps de viajes y de fotos. Las copias escaneadas y las imágenes exportadas suelen no llevar GPS. Una estimación puede sugerir la ubicación de un álbum o agrupar fotos en un viaje, siempre que la interfaz la presente como una sugerencia que el usuario confirma.
- Revisión de siniestros de seguros. Cuando un siniestro sitúa los daños en una localidad y las fotos apuntan claramente a otra parte, un perito tiene motivos para hacer preguntas. La estimación por sí sola no es motivo para denegar nada.
- Investigación. Cartografiar la distribución geográfica de un gran archivo de imágenes, o auditar un conjunto de entrenamiento en busca de sesgos regionales, requiere etiquetas gruesas a gran escala, que es justo lo que este método produce bien.
El patrón en los cinco casos es el mismo: la estimación señala, y una persona decide. Un producto que deja que una conjetura a nivel de ciudad desencadene un resultado automático hereda todos los errores del modelo, a escala. Un flujo de trabajo OSINT estructurado muestra dónde encaja una estimación entre el resto de comprobaciones.
¿Qué no puede hacer la geolocalización visual?
No puede dar una dirección postal a partir de una escena corriente, ubicar con fiabilidad interiores ni primeros planos, fechar una foto, identificar a nadie ni confirmar que la imagen sea auténtica. También puede equivocarse con total seguridad cuando un paisaje o un estilo de edificio se da en muchos países.
Algunos de estos límites tienen que ver con las pruebas, no con el modelo. El artículo de PlaNet empieza señalando que es trivial construir situaciones en las que no se puede inferir ninguna ubicación. Una pared blanca, el baño de un hotel o un plato de comida no llevan geografía, y ningún aumento del tamaño del modelo lo cambia.
Los resultados de la investigación sirven como contraste con la realidad. Con 2,3 millones de fotos de Flickr, PlaNet ubicó el 10,1% a menos de 25 km, la distancia que su prueba de referencia considera nivel de ciudad. PIGEON, presentado en CVPR 2024 y entrenado con imágenes de Street View de GeoGuessr, ubicó más del 40% de sus intentos a menos de 25 km. Parte de esa diferencia se debe a métodos más nuevos, y parte a las fotos. Los fotogramas de Street View están llenos de marcas viales y carteles, mientras que una colección general de fotos contiene muchos fotogramas sin nada geográfico.
La geolocalización tampoco puede dar fe de una imagen. Una escena callejera generada por IA recibe igualmente una estimación del lugar al que más se parece. La API responde a «a qué lugar se parece esto», no a «es esto real».
¿Cómo debes probar una API antes de integrarla?
Usa tus propias fotos sin los metadatos GPS y puntúa los resultados a distancias fijas, como 25 km para el nivel de ciudad y 750 km para el de país. Incluye a propósito fotos sin rasgos distintivos y comprueba que las respuestas de confianza alta acierten de verdad más que las de confianza baja.
- Step 1Crea un conjunto de prueba con tráfico realLas imágenes de demostración se eligen para lucirse. Reúne unos cientos de fotos que se parezcan a las que enviarán tus usuarios, con ubicaciones reales conocidas, y mantén el conjunto fijo para comparar proveedores y versiones de forma justa. Las anécdotas también engañan: un prompt viral de 1100 palabras para ChatGPT impresionó a muchos de los que lo probaron, y sin embargo con un conjunto fijo de 200 fotos no funcionó mejor que uno corto.
- Step 2Elimina el GPS antes de medirSi la API también lee metadatos, una foto de prueba con geoetiqueta mide al lector de metadatos y no al modelo. Elimina los datos EXIF de las copias de prueba o registrarás una puntuación perfecta que se esfuma en producción.
- Step 3Puntúa con distancias fijasLas pruebas de referencia de la investigación cuentan un intento como correcto a menos de 1 km (calle), 25 km (ciudad), 200 km (región), 750 km (país) o 2500 km (continente). Una afirmación de precisión sin distancia asociada no se puede comparar con nada.
- Step 4Mezcla ciudades y campoLa precisión tiende a seguir la densidad de las fotos de entrenamiento, así que un modelo preciso en las capitales puede ser impreciso en tierras de cultivo. Prueba ambos casos si tus usuarios envían ambos.
- Step 5Incluye fotos sin nada que leerLos interiores, los primeros planos y los cielos despejados deberían volver con confianza baja. Una herramienta que nombra una ciudad con confianza alta a partir de una habitación de hotel hará lo mismo con tus usuarios.
- Step 6Comprueba que la puntuación esté calibradaAgrupa los resultados por confianza y mide con qué frecuencia acertó cada grupo. Si las respuestas con puntuación superior a 0,8 no son claramente más precisas que las cercanas a 0,4, la puntuación no sirve para fijar umbrales.
- Step 7Lee las condiciones sobre datosAverigua si las imágenes se almacenan, durante cuánto tiempo y si se usan para entrenar. Las fotos pueden considerarse datos personales, sobre todo cuando salen personas.
Preguntas frecuentes
- ¿Una API de geolocalización de fotos es lo mismo que la Geolocation API del navegador?
- No. La API del navegador indica dónde está el propio dispositivo del usuario, y solo después de que este dé permiso. Una API de geolocalización de fotos trabaja con una imagen, que pudo tomarse en cualquier lugar, en cualquier momento y por cualquiera.
- ¿Puede una API de geolocalización de fotos dar una dirección exacta?
- No, no a partir de pruebas visuales únicamente. Dos calles separadas por un kilómetro suelen parecerse, así que un resultado honesto es una ciudad o una región. Las coordenadas exactas solo vienen de los metadatos GPS del archivo, cuando han sobrevivido.
- ¿Funciona la geolocalización visual con capturas de pantalla?
- Una captura de pantalla no conserva el GPS de la foto original, como explica la guía sobre capturas de pantalla. La inferencia visual sigue funcionando si la captura muestra una escena exterior con un tamaño utilizable.
- ¿Cuándo estará disponible la API de GeoSpy AI?
- No se ha anunciado ninguna fecha. Los desarrolladores y los equipos de producto ya pueden solicitar acceso anticipado. Hasta que se abra, el análisis de la web devuelve los mismos tipos de campos en torno a los que se diseña la API.
- ¿Puede una API de geolocalización de fotos identificar personas?
- No. Estima dónde está una escena, no quién aparece en ella, y nunca debe usarse para localizar ni seguir a nadie.
Fuentes
- Detect landmarks — Google CloudDefinición, campos de la respuesta y el ejemplo de la catedral de San Basilio con una puntuación de 0,78.
- AnnotateImageResponse — EntityAnnotation — Google CloudRango de puntuación de 0 a 1; una ubicación puede describir la escena o el lugar donde se tomó la foto.
- PlaNet — Photo Geolocation with Convolutional Neural Networks — Weyand, Kostrikov and Philbin (arXiv)Distancias de referencia de 1, 25, 200, 750 y 2500 km; un 10,1% de acierto a nivel de ciudad con 2,3 millones de fotos de Flickr.
- PIGEON: Predicting Image Geolocations — Haas, Skreta, Alberti and Finn (CVPR 2024, arXiv)Más del 40% de los intentos a menos de 25 km con imágenes de Street View.
- GPS Accuracy — GPS.govLos smartphones suelen tener una precisión de 4,9 m a cielo abierto.
Sigue leyendo
¿Cómo funciona la geolocalización con IA?
Cómo funciona la geolocalización con IA: no consulta una base de datos, lee las mismas pistas visuales que un experto, y de ahí vienen sus límites.
· 5 min de lectura
Mejores herramientas de búsqueda inversa de imágenes
Las mejores herramientas de búsqueda inversa de imágenes: en qué destaca Google Lens, Yandex, Bing y TinEye, y cuándo conviene la geolocalización con IA.
· 7 min de lectura
Ver coordenadas GPS de una foto: paso a paso
Ver coordenadas GPS de una foto con geoetiqueta: latitud y longitud exactas, el formato grados-minutos-segundos y cuánto fiarte de esos números.
· 4 min de lectura
Cómo saber si una foto es real: tres preguntas por separado
Cómo saber si una foto es real implica tres preguntas: si ya apareció antes, dónde se tomó y cuándo. El orden de comprobación y las pruebas que más fallan.
· 4 min de lectura