Recupere un código Plus abreviado con coordenadas cercanas
Un código Plus abreviado resulta práctico cuando ya se conoce la zona general, pero no permite identificar un lugar por sí solo.
Ejecutar — gratis
Esta herramienta repone el prefijo ausente al combinar el Open Location Code corto con una latitud y una longitud de referencia cercanas. Devuelve el código completo recuperado, la coordenada de su centro y los límites de latitud y longitud del área codificada. El cálculo es determinista, no consulta mapas y sigue las reglas de selección de celdas de Open Location Code.
Por qué un código Plus abreviado necesita un punto de referencia
Un código Plus completo comienza con caracteres que ubican una zona amplia y continúa con caracteres cada vez más precisos. La versión abreviada elimina deliberadamente una parte de ese prefijo porque quienes comparten el código ya conocen la ciudad, el barrio o un punto próximo. Por ejemplo, un cartel o un mensaje local puede mostrar solo unos caracteres antes del signo más. Los caracteres restantes describen celdas de una cuadrícula que se repiten por todo el planeta, de modo que el texto aislado es ambiguo. La recuperación aporta el contexto perdido mediante una latitud y una longitud de referencia. La calculadora codifica primero esa coordenada cercana con la precisión estándar por pares, toma exactamente tantos caracteres iniciales como omitió el código corto y une ese prefijo al código facilitado. Después compara el centro de la celda resultante con el punto de referencia. Este proceso no busca direcciones, comercios, carreteras ni divisiones administrativas. Restablece el Open Location Code completo geográficamente más cercano que concuerda con el texto abreviado y las coordenadas indicadas. Por ello, una referencia de la misma localidad es un dato imprescindible y no una mera sugerencia para mejorar la precisión.
Cómo se elige el código coincidente más cercano
Normalmente basta con copiar un prefijo obtenido de la coordenada de referencia, pero los lugares próximos al límite de una celda exigen un paso adicional. El código completo provisional se decodifica como un rectángulo con centro y límites norte, sur, este y oeste. La calculadora determina la resolución del prefijo omitido y compara el centro provisional con la referencia. Si el centro queda a más de la mitad de esa resolución, desplaza el candidato una celda equivalente hacia el punto de referencia, sin rebasar los límites de latitud en los polos. La longitud se normaliza al cruzar el antimeridiano, por lo que un punto cercano al otro lado de los 180 grados no produce un resultado lejano. El código definitivo se decodifica de nuevo y se entrega con sus límites y coordenadas centrales explícitos. Así se aplica la interpretación prevista del área más cercana para un código Plus corto. El resultado no afirma que el centro sea la entrada de un edificio ni que todos los puntos de la celda compartan dirección postal. Los límites describen el área codificada; el código completo es el identificador portátil que usted puede guardar o enviar a otra implementación de Open Location Code.
Cómo elegir las coordenadas e interpretar el resultado
Use una coordenada que esté realmente cerca del lugar donde se creó el código corto. El centro de la población, un punto de paso conocido o la posición GPS actual pueden servir si pertenecen a la misma zona. Cuantos más caracteres se eliminan, mayor es la parte del prefijo geográfico que falta y más importante resulta la proximidad de la referencia: una coordenada imprecisa o distante puede seleccionar otra celda repetida que también coincida con los caracteres conservados. Tras la recuperación, revise tanto full_code como el centro devuelto. Los campos latitude_lo, latitude_hi, longitude_lo y longitude_hi muestran el rectángulo exacto codificado por el resultado y permiten ajustar un mapa o comprobar si un punto está contenido. Conserve el código abreviado original y la coordenada de referencia en su registro de auditoría cuando necesite reproducibilidad, pues el resultado completo depende de ambos. Las entradas utilizan grados decimales; la latitud debe permanecer entre los polos y la longitud dentro del intervalo convencional con signo. La operación no usa servicios de red, bases cartográficas, la hora actual ni decisiones aleatorias. Por tanto, una misma entrada válida genera siempre el mismo código y la misma área numérica, tanto de forma interactiva como en un flujo automatizado por $0.002 cada solicitud.
Qué puede hacer con ella
Complete un código recibido en un mensaje local
Combine un código corto de barrio con una coordenada cercana conocida antes de guardarlo o compartirlo globalmente.
Normalice registros de levantamientos de campo
Convierta códigos abreviados y coordenadas de referencia en identificadores completos con límites decodificados explícitos.
Prepare datos de navegación para otro sistema
Recupere códigos completos portátiles antes de exportar puntos de paso a programas que no admiten códigos Plus abreviados.
Preguntas frecuentes
¿Qué se necesita para recuperar un código Plus abreviado?
Facilite el código corto y una latitud y longitud cercanas en grados decimales. Los tres valores son obligatorios porque el prefijo omitido representa el contexto geográfico.
¿A qué distancia puede estar la coordenada de referencia?
Debe pertenecer a la misma localidad que el lugar buscado. Cuantos más caracteres falten, más importante es que la referencia sea verdaderamente cercana.
¿Puede recuperar una dirección o el nombre de un lugar?
No. Solo realiza la aritmética de Open Location Code; no consulta mapas, geocodificadores, directorios comerciales ni bases postales.
¿Por qué se incluyen límites junto al código completo?
Un código Plus representa un área y no un punto de precisión infinita. Los límites y el centro hacen explícito ese rectángulo codificado.
¿Puedo enviar un código Plus que ya esté completo?
No. Esta capacidad está destinada a códigos abreviados y rechaza aquellos cuyo signo más ya ocupa la posición propia de un código completo.
¿Cuánto cuesta una solicitud de API?
Cada solicitud de API cuesta $0.002. La versión del navegador se ejecuta localmente sin enviar el cálculo a un servicio cartográfico.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/geo/plus-code-recover \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}'const res = await fetch("https://api.kit.forhosting.com/geo/plus-code-recover", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/plus-code-recover",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/plus-code-recover", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/plus-code-recover", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.plus_code_recover",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |