Acortar Plus Code

Los Open Location Codes, más conocidos como Plus Codes, convierten latitud y longitud en cadenas cortas que se pueden decir, escribir e imprimir sin números de calle. Un código completo como eight F V C nine G eight F plus six X es único a escala global, pero el uso cotidiano suele ocurrir dentro de una ciudad o barrio conocidos, donde los pares iniciales se repiten y solo el bloque final identifica el punto. Este acortador de Plus Code acepta un código completo válido más una latitud y longitud de referencia cercanas, mide la proximidad de la referencia al centro de la celda y elimina tantos pares de caracteres iniciales como permita la regla de seguridad del Open Location Code.

Cómo funciona el acortamiento del Plus Code respecto a una ubicación de referencia

Un Open Location Code completo codifica una celda rectangular sobre la Tierra con el alfabeto de veinte caracteres del dos al nueve y C F G H J M P Q R V W X, con un separador más obligatorio tras ocho caracteres. Los diez primeros dígitos significativos forman pares de latitud y longitud que refinan la celda por factores sucesivos de veinte; dígitos de rejilla opcionales tras el separador la refinan aún más.

Cuando usted comparte una ubicación dentro de un área conocida, los primeros cuatro o seis caracteres suelen coincidir en todos los lugares cercanos, de modo que aportan ruido en lugar de valor.

El acortamiento no se limita a recortar un prefijo fijo: decodifica el código completo hasta el centro de su celda, compara ese centro con su latitud y longitud de referencia mediante una métrica de Chebyshev (el máximo de la diferencia absoluta de latitud y de longitud en grados) y recorre una tabla fija de resoluciones de veinte, uno, cero coma cero cinco, cero coma cero cero dos cinco y cero coma cero cero cero uno dos cinco grados.

Siempre que el rango sea inferior al treinta por ciento de la resolución de un par, el algoritmo puede eliminar los pares iniciales correspondientes. Ese factor del treinta por ciento es un margen de seguridad deliberado para que el código corto siga siendo la coincidencia más cercana cuando alguien lo recupere después desde un centro de ciudad o una lectura GPS ligeramente distintos. Si la referencia está lejos, no se eliminan pares y se devuelve el código completo sin cambios.

Los códigos rellenados que solo describen un área grande (con ceros antes del separador) no se pueden acortar, porque carecen de suficientes dígitos de precisión para recortar con seguridad. La capacidad implementa únicamente este camino aritmético puro: no busca nombres de lugar, no llama a APIs de mapas ni inventa etiquetas de localidad que usted deba añadir por su cuenta.

Contrato de entrada, forma de la respuesta y comportamiento ante errores

Los códigos rellenados que contienen ceros de relleno antes del separador se rechazan con un mensaje de que no se pueden acortar. La latitud se recorta al intervalo cerrado de menos noventa a noventa; la longitud se normaliza al intervalo semiabierto de menos ciento ochenta a ciento ochenta. Campos ausentes, cadenas vacías y números no finitos fallan con mensajes que nombran el campo y no se facturan.

Ejemplo: el código eight F V C nine G eight F plus six X con latitud de referencia cuarenta y siete punto cinco y longitud ocho punto cinco produce el código corto nine G eight F plus six X tras quitar los cuatro primeros caracteres. Combine el código corto con una cadena de localidad en su propia interfaz; este extremo nunca emite nombres de ciudad.

Dónde aporta valor un acortador de Plus Code

Las aplicaciones de entrega, servicio de campo y logística ya almacenan Open Location Codes completos para puertas sin número de calle; cuando imprimen una etiqueta o envían un SMS dentro de una ciudad conocida necesitan la forma corta que los conductores ya reconocen en Google Maps y plus.codes.

Los flujos de respuesta a desastres y cartografía humanitaria comparten refugios temporales y puntos de agua como códigos cortos más el nombre de un campamento o distrito, y un acortador determinista garantiza que cada cliente —paquete móvil sin conexión, edge worker o importación de hoja de cálculo— acuerde el mismo recorte para la misma referencia. Los desarrolladores que integran OLC en formularios pueden validar y acortar en una sola llamada sin distribuir una biblioteca open-location-code completa a cada cliente. La validación fallida no consume saldo.