Conversor de coordenadas para referência de grade OSGB
Converta coordenadas easting e northing da Grade Nacional Britânica na conhecida referência OSGB de duas letras usada em mapas, registros de campo e bases geográficas da Grã-Bretanha.
Executar grátis
Escolha quantos dígitos manter em cada coordenada, desde um quadrado amplo de 100 quilômetros até uma célula precisa de um metro. O conversor aplica as letras padronizadas e trunca os dígitos corretamente, gerando uma referência clara como TQ 300 800 sem consultar serviços externos.
Informe coordenadas do sistema correto
Informe um easting e um northing em metros na Grade Nacional Britânica. O easting mede a distância para leste a partir da origem da grade, enquanto o northing mede a distância para norte. Esses valores não são longitude e latitude, e o conversor não tenta adivinhar nem transformar o sistema de coordenadas. Antes da conversão, confirme se a fonte identifica os valores como British National Grid, OSGB ou EPSG:27700. Um par de outra projeção pode parecer plausível e ainda gerar uma referência aparentemente válida, porém indicará o local errado. O easting deve ser maior ou igual a zero e menor que 700000; o northing deve ser maior ou igual a zero e menor que 1300000. Valores decimais em metros são aceitos, embora apenas células inteiras possam ser representadas na precisão escolhida. O cálculo é local e determinístico: a mesma entrada sempre produz o mesmo texto, sem geocodificação, correspondência de topônimos ou consulta a mapas remotos.
Escolha a precisão adequada
A precisão é o número de dígitos exibidos para cada coordenada dentro do quadrado de 100 quilômetros identificado por letras. Zero retorna apenas as duas letras e identifica um quadrado de 100 quilômetros. Um dígito por coordenada identifica 10 quilômetros; dois identificam um quilômetro; três, 100 metros; quatro, 10 metros; e cinco, um metro. Assim, a precisão três cria uma referência convencional como TQ 300 800, com três dígitos de easting e três de northing. Mais dígitos reduzem a célula, mas não tornam a medição original mais exata. Escolha uma precisão compatível com a forma de coleta e com a finalidade da referência. Uma observação registrada apenas com exatidão de 100 metros não deve ser apresentada como uma posição de um metro simplesmente porque é possível imprimir dígitos extras. A saída preserva zeros à esquerda, pois eles têm significado posicional na referência.
Entenda as letras e o truncamento
Os dois primeiros caracteres identificam o quadrado de 100 quilômetros da Grade Nacional. O cálculo deriva essas letras diretamente dos índices de easting e northing e pula a letra I, omitida do alfabeto da grade para evitar confusão com o número um. Os grupos numéricos restantes indicam a distância para leste e para norte dentro do quadrado. A ordem é sempre easting primeiro e northing depois: avance horizontalmente e então suba. Os dígitos são truncados na precisão solicitada, e não arredondados. Isso é importante perto do limite de uma célula, pois uma referência de grade identifica convencionalmente o canto sudoeste da célula que contém o ponto. O arredondamento poderia deslocar a referência para uma célula vizinha. O objeto retornado inclui a referência completa formatada, o quadrado de duas letras, os grupos de dígitos separados quando a precisão é maior que zero e a precisão aplicada, facilitando a cópia e o armazenamento estruturado.
Casos de uso
Padronizar registros de campo
Transforme coordenadas métricas em referências com espaçamento uniforme antes de incluí-las em relatórios ou cadastros de ativos.
Preparar rótulos de mapas
Gere referências OSGB legíveis com uma precisão comum para mapas impressos, notas de rota, placas ou informações a visitantes.
Normalizar dados de localização importados
Converta colunas numéricas em um campo de referência padrão para pesquisa, comparação, exportação ou revisão de qualidade.
Perguntas frequentes
Qual sistema de coordenadas devo usar?
Use eastings e northings da Grade Nacional Britânica, normalmente identificada como OSGB ou EPSG:27700. Não informe longitude e latitude.
O que significa precisão?
É o número de dígitos em cada grupo numérico. Zero representa um quadrado de 100 quilômetros, três representam 100 metros e cinco representam um metro.
Por que os dígitos são truncados em vez de arredondados?
O truncamento mantém a referência na célula que contém o ponto e identifica essa célula a partir do canto sudoeste.
Os zeros à esquerda são preservados?
Sim. Cada grupo numérico é preenchido até a precisão selecionada porque os zeros à esquerda têm significado posicional.
Cinco dígitos garantem exatidão de um metro?
Não. Eles produzem uma célula de um metro, mas a exatidão real depende das coordenadas de origem e de como foram medidas ou transformadas.
Quanto custa uma solicitação à API?
O preço da API é US$ 0,002 por solicitação. A mesma conversão determinística também pode ser executada no navegador.
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/osgb-grid-reference \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"easting":530000,"northing":180000}'const res = await fetch("https://api.kit.forhosting.com/geo/osgb-grid-reference", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"easting": 530000,
"northing": 180000
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/osgb-grid-reference",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"easting": 530000,
"northing": 180000
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/osgb-grid-reference", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"easting":530000,"northing":180000}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"easting":530000,"northing":180000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/osgb-grid-reference", 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
{
"easting": 530000,
"northing": 180000
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.osgb_grid_reference",
"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. |