Recupere um Plus Code abreviado com coordenadas próximas
Um Plus Code abreviado é prático quando a região geral já é conhecida, mas não consegue identificar um lugar sozinho.
Executar grátis
Esta ferramenta recompõe o prefixo ausente combinando o Open Location Code curto com uma latitude e uma longitude de referência próximas. O resultado traz o código completo recuperado, sua coordenada central e os limites de latitude e longitude da área codificada. O cálculo é determinístico, dispensa consulta a mapas e segue as regras de seleção de células do Open Location Code.
Por que um Plus Code abreviado precisa de um ponto de referência
Um Plus Code completo começa com caracteres que localizam uma área ampla e termina com caracteres de precisão progressivamente maior. O código abreviado remove de propósito uma parte desse prefixo geral porque as pessoas que o compartilham já conhecem a cidade, o bairro ou um ponto de referência próximo. Uma placa ou mensagem local, por exemplo, pode exibir apenas alguns caracteres antes do sinal de adição. Os caracteres restantes descrevem células de grade que se repetem pelo mundo, portanto o texto isolado é ambíguo. A recuperação fornece o contexto ausente por meio de uma latitude e uma longitude de referência. Primeiro, a calculadora codifica essa coordenada próxima com a precisão padrão de pares, seleciona exatamente a quantidade de caracteres iniciais que o código curto omitiu e junta o prefixo ao código informado. Em seguida, compara o centro da célula resultante com o ponto de referência. Esse processo não pesquisa endereços, empresas, vias nem regiões administrativas. Ele recompõe o Open Location Code completo geograficamente mais próximo que seja compatível com o texto abreviado e as coordenadas fornecidas. Assim, uma referência da mesma localidade é uma informação essencial, e não apenas uma sugestão opcional de precisão.
Como o código correspondente mais próximo é escolhido
Na maioria dos casos, copiar um prefixo da coordenada de referência é suficiente, mas locais perto do limite de uma célula exigem mais uma etapa. O código completo provisório é decodificado como uma área retangular, com centro e limites ao norte, sul, leste e oeste. A calculadora determina a resolução do prefixo omitido e compara o centro provisório com a referência. Quando o centro fica a mais de metade dessa resolução, o candidato é deslocado uma célula equivalente na direção da referência, sem ultrapassar os limites de latitude nos polos. A longitude é normalizada na passagem pelo antimeridiano; assim, um ponto próximo do outro lado dos 180 graus não gera um resultado distante. O código final é decodificado novamente e devolvido com limites explícitos e coordenadas centrais. Esse procedimento corresponde à interpretação da área compatível mais próxima prevista para um Plus Code curto. Ele não afirma que o centro seja a entrada de um edifício nem que todos os pontos da célula tenham o mesmo endereço postal. Os limites descrevem a área da grade codificada, enquanto o código completo é o identificador portátil que você pode armazenar ou enviar para outra implementação de Open Location Code.
Como escolher as coordenadas e interpretar o resultado
Use uma coordenada realmente próxima do local em que o código curto foi criado. O centro da cidade, um ponto de passagem já conhecido ou a posição atual do GPS podem funcionar quando estão na mesma região. Quanto maior a abreviação, maior a parte removida do prefixo geográfico e mais importante se torna a proximidade da referência: uma coordenada imprecisa ou distante pode selecionar outra célula repetida que também corresponda aos caracteres restantes. Após a recuperação, confira tanto full_code quanto o centro retornado. Os campos latitude_lo, latitude_hi, longitude_lo e longitude_hi mostram o retângulo exato codificado pelo resultado e ajudam a enquadrar um mapa ou testar se um ponto está contido. Guarde o código curto original e a coordenada de referência em um registro de auditoria quando a reprodução do resultado for importante, pois o código completo deriva dos dois. As entradas usam graus decimais; a latitude deve permanecer entre os polos e a longitude dentro do intervalo convencional com sinal. A operação não usa serviço de rede, base cartográfica, horário atual nem escolha aleatória. Por isso, a mesma entrada válida sempre gera o mesmo código recuperado e a mesma área numérica, de forma interativa ou em um fluxo automatizado por US$ 0,002 por solicitação.
Casos de uso
Complete um código recebido em uma mensagem local
Combine um código curto de bairro com uma coordenada próxima conhecida antes de armazená-lo ou compartilhá-lo globalmente.
Normalize registros de levantamento em campo
Transforme códigos abreviados e coordenadas de referência em identificadores completos com limites decodificados explícitos.
Prepare dados de navegação para outro sistema
Recupere códigos completos portáteis antes de exportar pontos de passagem para programas que não aceitam Plus Codes abreviados.
Perguntas frequentes
O que é necessário para recuperar um Plus Code abreviado?
Informe o código curto e uma latitude e longitude próximas em graus decimais. Os três valores são obrigatórios porque o prefixo omitido representa o contexto geográfico.
Quão perto deve estar a coordenada de referência?
Ela deve pertencer à mesma localidade do lugar desejado. Quanto mais caracteres forem omitidos, mais importante será usar uma referência realmente próxima.
A ferramenta consegue recuperar um endereço ou nome de lugar?
Não. Ela executa somente a aritmética do Open Location Code e não consulta mapas, geocodificadores, cadastros comerciais nem bases postais.
Por que os limites acompanham o código completo?
Um Plus Code representa uma área, não um ponto de precisão infinita. Os limites e o centro tornam explícito esse retângulo codificado.
Posso enviar um Plus Code que já esteja completo?
Não. Esta capacidade recupera especificamente códigos abreviados e rejeita um código cujo sinal de adição já esteja na posição de código completo.
Quanto custa uma solicitação de API?
Cada solicitação de API custa US$ 0,002. A versão do navegador é executada localmente, sem enviar o cálculo a um serviço de mapas.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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)Exemplo de requisição
{
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.plus_code_recover",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |