Encurtar Plus Code

Os Open Location Codes, mais conhecidos como Plus Codes, transformam latitude e longitude em cadeias curtas que se podem dizer, digitar e imprimir sem números de porta. Este encurtador de Plus Code aceita um código completo válido mais uma latitude e longitude de referência próximas, mede o quão perto a referência está do centro da célula e remove tantos pares de caracteres iniciais quanto a regra de segurança do Open Location Code permitir. O resultado é um código curto compacto pronto para combinar com um nome de local, enquanto a API também indica se houve encurtamento, quantos caracteres foram removidos e o alcance angular usado. Códigos completos inválidos, códigos de área com preenchimento e coordenadas em falta falham com erros invalid_input claros em vez de inventar um fragmento ambíguo.

Como funciona o encurtamento do Plus Code em relação a um local de referência

Os dez primeiros dígitos significativos formam pares de latitude e longitude que refinam a célula por fatores sucessivos de vinte; dígitos de grelha opcionais após o separador refinam ainda mais. O encurtamento não se limita a cortar um prefixo fixo: descodifica o código completo até ao centro da célula, compara esse centro com a latitude e longitude de referência mediante uma métrica de Chebyshev (o máximo da diferença absoluta de latitude e de longitude em graus) e percorre uma tabela fixa de resoluções de vinte, um, zero vírgula zero cinco, zero vírgula zero zero dois cinco e zero vírgula zero zero zero um dois cinco graus.

Contrato de entrada, forma da resposta e comportamento de erro

Códigos com preenchimento zero antes do separador são rejeitados com a mensagem de que não se podem encurtar. Campos em falta, cadeias vazias e números não finitos falham com mensagens que nomeiam o campo e não são cobrados. Associe o código curto a uma cadeia de localidade na sua própria interface; este extremo nunca emite nomes de cidade. Envie por POST um corpo JSON com três campos obrigatórios: code, uma cadeia com o Open Location Code completo como eight F V C nine G eight F plus six X; latitude, uma latitude de referência finita em graus decimais com sinal; e longitude, uma longitude de referência finita em graus decimais com sinal. Aceitam-se aliases por conveniência: plus_code, olc, full_code ou location_code para o código; lat, ref_latitude ou reference_latitude para a latitude; lon, lng, ref_longitude ou reference_longitude para a longitude. O código é aparado e passado a maiúsculas; códigos curtos (separador antes da posição oito) e cadeias que falham nas regras de validade do Open Location Code são rejeitados com invalid_input indicando o campo. A latitude é limitada ao intervalo fechado de menos noventa a noventa; a longitude é normalizada no intervalo semiaberto de menos cento e oitenta a cento e oitenta. Em caso de sucesso o corpo devolve o código completo normalizado e as coordenadas limpas, short_code (que pode igualar o código completo quando não há corte seguro), was_shortened como booleano, characters_removed como inteiro não negativo, code_length como a contagem de dígitos significativos da entrada, short_length como a da forma curta, range_degrees como o alcance de Chebyshev arredondado para goldens estáveis, e method igual a olc_shorten. Exemplo: o código eight F V C nine G eight F plus six X com latitude de referência quarenta e sete ponto cinco e longitude oito ponto cinco produz o código curto nine G eight F plus six X após remover os quatro primeiros caracteres.

Onde um encurtador de Plus Code justifica o seu lugar

Como a implementação é parse puro de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo nem rede de saída. Mantenha os pedidos pequenos, fixe short_code e characters_removed nos testes, e obterá Plus Codes curtos reproduzíveis para etiquetas, bots de chat e edge workers sem montar infraestrutura de geocodificação própria.