API Location Fronteira

Fronteira

Dados geoespaciais sobre a faixa de fronteira terrestre brasileira, incluindo proximidade a países vizinhos, presença em municípios fronteiriços e identificação de cidades gêmeas.

Categoria Location
Cobertura Todo o território nacional
Fonte IBGE + processamento interno
Faixa de Fronteira 150 km (IBGE)

Aplicações

O dado de fronteira permite identificar se uma coordenada está dentro da faixa de fronteira terrestre brasileira e a sua proximidade a países vizinhos. É um sinal relevante para compliance, prevenção à lavagem de dinheiro e análise de risco em regiões fronteiriças.

PLD / Compliance

Identifique operações ou cadastros originados de regiões fronteiriças para reforçar políticas de prevenção à lavagem de dinheiro.

Detecção de Fraude

Sinalize transações cujas coordenadas indicam proximidade a fronteiras internacionais ou estão fora do território brasileiro.

Análise de Risco Territorial

Enriqueça modelos de risco com variáveis de proximidade a fronteira, presença em cidades gêmeas e percentual de área municipal fronteiriça.

Validação Cadastral

Verifique se o endereço declarado é coerente com o território brasileiro ou se indica localização em país vizinho.

Conceito

A faixa de fronteira, segundo o IBGE, é uma faixa de até 150 km de largura ao longo das fronteiras terrestres do Brasil, considerada fundamental para a defesa nacional. Essa área abrange 16,7% do território brasileiro.

Mapa da faixa de fronteira brasileira

O dado retorna informações em três níveis: sobre o ponto consultado (se está na faixa de fronteira, distância à borda e ao país mais próximo), sobre o município em que o ponto se encontra (área integrada à faixa, presença de cidade gêmea) e sobre a sede do município (se está dentro da faixa de fronteira).

Ponto

Nível do Ponto

Se o ponto está na faixa de fronteira, distância à borda da faixa e ao país estrangeiro mais próximo.

Município

Nível do Município

Nome, área total, área integrada à faixa, percentual na fronteira e se possui cidade gêmea.

Sede

Nível da Sede

Se a sede (marco zero) do município está dentro da faixa de fronteira.

Parâmetros de Entrada

latitude float

Latitude da coordenada geográfica do ponto a ser analisado.

longitude float

Longitude da coordenada geográfica do ponto a ser analisado.

Exemplos

Três cenários ilustram o retorno em diferentes contextos: dentro da faixa de fronteira, fora do Brasil e distante da fronteira.

Ponto dentro da faixa de fronteira — Foz do Iguaçu, PR -25.52568655357868, -54.59273323017718
Mapa: ponto em Foz do Iguaçu, dentro da faixa de fronteira
{
  "area_municipio_integrada_faixa_de_fronteira_km2": 609.19,
  "area_total_municipio_km2": 609.19,
  "distancia_geodesica_pais_mais_proximo_pt_km": 1.1,
  "distancia_geodesica_ponto_borda_faixa_de_fronteira": 0,
  "municipio_possui_cidade_gemea": true,
  "nome_municipio_de_fronteira": "Foz do Iguaçu",
  "pais_mais_proximo": "PARAGUAI",
  "pais_mais_proximo_pt": "PARAGUAI",
  "ponto_contido_na_faixa_de_fronteira": true,
  "porcentagem_area_municipio_faixa_de_fronteira": 100.0,
  "sede_municipio_dentro_da_faixa_de_fronteira": true
}

O ponto está em Foz do Iguaçu, município integralmente contido na faixa de fronteira (100% da área). Está a 1,1 km do Paraguai. Foz do Iguaçu é classificada como cidade gêmea de Ciudad del Este, separadas apenas pelo Rio Paraná.

Ponto fora do Brasil — Ciudad del Este, Paraguai -25.525949, -54.607493
Mapa: ponto em Ciudad del Este, Paraguai
{
  "area_municipio_integrada_faixa_de_fronteira_km2": null,
  "area_total_municipio_km2": null,
  "distancia_geodesica_pais_mais_proximo_pt_km": 0,
  "distancia_geodesica_ponto_borda_faixa_de_fronteira": 0.69,
  "municipio_possui_cidade_gemea": null,
  "nome_municipio_de_fronteira": null,
  "pais_mais_proximo": null,
  "pais_mais_proximo_pt": "PARAGUAI",
  "ponto_contido_na_faixa_de_fronteira": false,
  "porcentagem_area_municipio_faixa_de_fronteira": null,
  "sede_municipio_dentro_da_faixa_de_fronteira": null
}

O ponto está no Paraguai — a distância ao país mais próximo é 0 km e pais_mais_proximo_pt confirma PARAGUAI. Está a 690 m da borda da faixa de fronteira brasileira. Os campos de município retornam null pois o ponto não está em território brasileiro.

Ponto distante da fronteira — Salvador, BA -13.010292048819824, -38.53074331162113
Mapa: ponto em Salvador, distante da fronteira
{
  "area_municipio_integrada_faixa_de_fronteira_km2": null,
  "area_total_municipio_km2": null,
  "distancia_geodesica_pais_mais_proximo_pt_km": 2061.16,
  "distancia_geodesica_ponto_borda_faixa_de_fronteira": 1911.23,
  "municipio_possui_cidade_gemea": null,
  "nome_municipio_de_fronteira": null,
  "pais_mais_proximo": null,
  "pais_mais_proximo_pt": "PARAGUAI",
  "ponto_contido_na_faixa_de_fronteira": false,
  "porcentagem_area_municipio_faixa_de_fronteira": null,
  "sede_municipio_dentro_da_faixa_de_fronteira": null
}

O ponto está em Salvador, BA — a mais de 1.911 km da faixa de fronteira e 2.061 km do país mais próximo (Paraguai). Todos os campos de município retornam null por estar fora de qualquer município fronteiriço.

Atributos Retornados

O retorno é organizado em três níveis: informações sobre o ponto consultado, sobre o município fronteiriço e sobre a sede do município.

Ponto
ponto_contido_na_faixa_de_fronteira
Booleano que indica se o ponto está dentro da faixa de fronteira definida pelo IBGE.
distancia_geodesica_ponto_borda_faixa_de_fronteira
Distância geodésica em quilômetros do ponto até a borda da faixa de fronteira. Retorna 0 quando o ponto está dentro da faixa.
distancia_geodesica_pais_mais_proximo_pt_km
Distância geodésica em quilômetros do ponto até o país estrangeiro mais próximo.
pais_mais_proximo_pt
Nome do país estrangeiro mais próximo ao ponto consultado.
Município
nome_municipio_de_fronteira
Nome do município de fronteira em que o ponto se encontra. Retorna null se o ponto não está em um município fronteiriço.
pais_mais_proximo
Nome do país mais próximo ao município de fronteira em que o ponto se encontra.
area_total_municipio_km2
Área total do município em quilômetros quadrados.
area_municipio_integrada_faixa_de_fronteira_km2
Área do município que está contida dentro da faixa de fronteira, em quilômetros quadrados.
porcentagem_area_municipio_faixa_de_fronteira
Percentual da área do município que está dentro da faixa de fronteira.
municipio_possui_cidade_gemea
Booleano que indica se o município possui uma cidade gêmea em outro país — ou seja, se as manchas urbanas são contíguas apesar de estarem em países distintos.
Sede do Município
sede_municipio_dentro_da_faixa_de_fronteira
Booleano que indica se a sede do município (marco zero — tipicamente a prefeitura, praça principal ou igreja matriz) está dentro da faixa de fronteira.

Detalhes Técnicos

Fontes

  • IBGE — Faixa de Fronteira e Malha Municipal
  • Processamento geoespacial interno PrismaData

Cobertura

Todo o território nacional e pontos em países vizinhos. A faixa de fronteira abrange 150 km ao longo das fronteiras terrestres, cobrindo 16,7% do território brasileiro.

Limitações

Considere ao utilizar

  • Quando o ponto está fora de um município fronteiriço, os campos de município e sede retornam valores nulos. Os campos de distância ao país e à borda da faixa continuam sendo calculados.
  • A definição de faixa de fronteira (150 km) segue o critério do IBGE e pode não coincidir com outras definições legais ou regulatórias.

Pronto para testar?

Solicite acesso à sandbox da API de Fronteira e veja o retorno para suas coordenadas.

Solicitar acesso