Dados geoespaciais sobre a faixa de fronteira terrestre brasileira em trinta e oito campos: proximidade aos dois países estrangeiros mais próximos, presença em municípios fronteiriços, cidades gêmeas, arco (NORTE/CENTRAL/SUL), tríplices fronteiras e um índice de exposição de 0 a 100 em quatro bandas nomeadas. Insumos alinhados à Circular BACEN 3.978 (PLD/FT).
O dado de fronteira permite identificar se uma coordenada está dentro da faixa de fronteira terrestre brasileira, a proximidade aos dois países estrangeiros mais próximos e a distância às quatro tríplices fronteiras do Brasil. É um dos insumos da Abordagem Baseada em Risco exigida pela Circular BACEN 3.978, com destaque para as áreas listadas pelo GAFI/FATF como de risco elevado — nominalmente a tríplice fronteira do Iguaçu, citada no Relatório de Avaliação Mútua do Brasil (2023).
Sinalize cadastros e operações originados em faixa de fronteira, cidades gêmeas e tríplices fronteiras — insumos diretos para a Abordagem Baseada em Risco.
Sinalize transações cujas coordenadas indicam proximidade a fronteiras internacionais ou estão fora do território brasileiro.
Enriqueça modelos com fração de área municipal na faixa (0–1), arco NORTE/CENTRAL/SUL, cidade gêmea nomeada e distância à tríplice fronteira mais próxima.
Verifique se o endereço declarado é coerente com o território brasileiro ou se indica localização em país vizinho.
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.
O dado retorna informações em quatro níveis: sobre o ponto consultado (faixa de fronteira, distância à borda e aos dois países estrangeiros mais próximos), sobre o município em que o ponto se encontra (área integrada à faixa, arco, presença e nome da cidade gêmea), sobre a sede do município (se está dentro da faixa e distância ao país mais próximo) e sobre a tríplice fronteira mais próxima (nome, países envolvidos e distância — insumo direto para o Relatório de Avaliação Mútua do GAFI/FATF).
Se o ponto está na faixa de fronteira, distância à borda da faixa e aos dois países estrangeiros mais próximos.
Nome, área total, área integrada à faixa, fração na fronteira, arco (NORTE/CENTRAL/SUL) e cidade gêmea identificada por nome e país.
Se a sede (marco zero) do município está dentro da faixa de fronteira e distância da sede ao país estrangeiro mais próximo.
Distância à tríplice fronteira mais próxima entre as quatro do Brasil (Iguaçu, Barra do Quaraí, Assis Brasil e Tabatinga) e se o ponto está em sua área de influência (raio de 50 km).
Um número que resume as camadas de fronteira, cidade gêmea, tríplice e intensidade municipal em uma única leitura, com quatro bandas nomeadas. Serve para orientar triagem de coordenadas em volume, não para substituir a análise caso a caso.
O índice mede a exposição do território ao redor da coordenada, não a pessoa que está no endereço. É insumo da Abordagem Baseada em Risco da instituição, não score de risco de cliente.
Curva logarítmica ancorada em 100 na linha, 25 na borda da faixa de 150 km e 0 a partir de 500 km. A escala log concentra resolução no campo próximo, onde estão travessia a pé, cidade gêmea e câmbio paralelo.
Vale 100 no Iguaçu e 85 nas outras três tríplices, decaindo até zero em 500 km. O Iguaçu pesa mais por ser a única citada nominalmente pelo GAFI no Relatório de Avaliação Mútua do Brasil (2023).
Vale 100 quando o município é reconhecido como cidade gêmea pelo Ministério da Integração e do Desenvolvimento Regional, 0 caso contrário. Hoje são 33 pares reconhecidos.
Combina a fração da área do município dentro da faixa com a presença da sede na faixa. Mede o quanto o município vive a fronteira como um todo, não apenas o ponto consultado.
Coordenadas em área de tríplice fronteira (raio de 50 km) recebem piso de 70, entrando obrigatoriamente na banda ELEVADA. O campo piso_aplicado vem preenchido com TRIPLICE_FRONTEIRA_GAFI quando o piso elevou o valor calculado; nulo em caso contrário.
Se o ponto está fora de município brasileiro de fronteira, D3 e D4 vêm nulos e os pesos das dimensões presentes são renormalizados, não tratados como zero. Um endereço em Ciudad del Este continua pontuando alto pelo que já é sinal (D1 e D2), sem ser penalizado pela ausência estrutural dos outros dois blocos.
Pesos, âncoras, limiares, piso, ordem canônica dos fatores e regra de arredondamento são publicados em GET /location/border/metadata, no bloco SCORE. A cada consulta, a resposta traz os quatro componentes desagregados e a lista de fatores acionados. Basta aplicar os pesos aos componentes para reproduzir o valor por igualdade exata, sem depender da API.
O campo versao_metodologia_score traz a versão da metodologia que produziu o valor (hoje 1.0.0). Mudança de peso, âncora ou piso incrementa a versão, sem alterar o schema.
O índice funciona sob três limites explícitos, incorporados na descrição da API. Não são notas de rodapé.
O índice mede o quanto o entorno da coordenada carrega sinais de fronteira. Não faz julgamento sobre quem está no endereço. Uma coordenada em Foz do Iguaçu pontua alto pela geografia, independentemente do perfil do titular.
A Abordagem Baseada em Risco exigida pela Circular BACEN 3.978 continua sendo responsabilidade da instituição, com metodologia própria. O índice entra como variável objetiva e auditável no modelo da casa, não como substituição.
Uma banda ELEVADA, sozinha, não deve motivar recusa ou encerramento de relacionamento, pelo risco de discriminação territorial e pelo direito à revisão previsto no art. 20 da LGPD. Serve para priorizar análise humana e calibrar alçada, não para decidir sem revisão.
Dos vários campos do produto, o bloco de tríplice fronteira é o de leitura mais direta pela ótica regulatória. O GAFI/FATF — grupo intergovernamental que estabelece os padrões internacionais de prevenção à lavagem de dinheiro e financiamento do terrorismo (PLD/FT) — trata as tríplices fronteiras como áreas de risco elevado por concentrarem trânsito internacional informal, câmbio paralelo e economia baseada em dinheiro vivo, além de dificultarem a cooperação entre autoridades de três jurisdições distintas.
No Relatório de Avaliação Mútua (Mutual Evaluation Report) do Brasil, o GAFI cita nominalmente a tríplice fronteira do Iguaçu como área que exige monitoramento reforçado por parte das instituições financeiras brasileiras.
Na prática, isso significa que uma coordenada dentro do raio de influência de uma tríplice fronteira é um fator de risco geográfico que compõe a Abordagem Baseada em Risco (ABR) exigida pela Circular BACEN 3.978 — o principal normativo de PLD do sistema financeiro nacional, que exige das instituições metodologia de avaliação de risco por cliente/operação com base em fatores objetivos e verificáveis.
O campo ponto_em_area_triplice_fronteira resolve o "sim/não" com uma regra objetiva — o ponto está a menos de 50 km de uma das quatro tríplices — e é diretamente auditável: as coordenadas dos quatro pontos e o raio usado no cálculo são expostos no endpoint GET /location/border/metadata, permitindo à área de compliance recalcular o valor sem depender exclusivamente da API.
Essa mesma regra vira piso de 70 no índice de exposição: qualquer coordenada em área de tríplice fronteira entra obrigatoriamente na banda ELEVADA, com o campo piso_aplicado preenchido com TRIPLICE_FRONTEIRA_GAFI quando o piso elevou o valor calculado.
Além da tríplice do Iguaçu (BR/AR/PY), o produto cobre outras três: Barra do Quaraí (BR/AR/UY), Assis Brasil (BR/BO/PE) e Tabatinga (BR/CO/PE). Para cada ponto consultado, a API retorna a mais próxima. As coordenadas de referência foram fixadas em confluências fluviais ou marcos oficiais e estão disponíveis, junto com os países envolvidos, no endpoint de metadados.
O dado de Fronteira é calculado sobre uma coordenada. Você chega até ela por quatro caminhos, conforme o que a sua esteira já tem em mãos: coordenada, endereço ou CNPJ. Os caminhos de endereço e de CNPJ passam por uma etapa de geocodificação, e é dela que a coordenada usada no cálculo é derivada.
| O que você tem | Consulta individual | Consulta em lote | Lote máximo |
|---|---|---|---|
| Coordenadalat e lng em WGS84 | GET /location/border |
POST /location/batch/border |
1.024 |
| Coordenada, com os demais pilares geográficosfronteira junto ao restante do agregador | GET /location/aggregator?border=true |
POST /location/batch/aggregator?border=true |
1.024 |
| Endereçotexto livre ou campos estruturados | GET /location/geocoder/aggregator?border=true |
POST /location/batch/geocoder/aggregator?border=true |
512 |
| CNPJdados cadastrais e fronteira do endereço da empresa | GET /cnpj/{cnpj}/enriched?border=true |
POST /cnpj/batch/enriched · flags.border=true no corpo |
256 |
prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao e no
score numérico correspondente, junto de
prismadata__pessoa_juridica__endereco_existe e
prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder. A
coordenada usada no cálculo também volta, em latitude e
longitude, o que torna o resultado auditável ponto a ponto.
O caminho que a esteira de PLD reconhece primeiro: entra o CNPJ do cliente, voltam os
dados cadastrais junto com a exposição de fronteira do endereço da empresa, em uma
única chamada. Abaixo, uma empresa com sede em Foz do Iguaçu. Os campos cadastrais
chegam com o prefixo prismadata__pessoa_juridica__ e os de fronteira com
prismadata__border__, todos no mesmo nível do objeto.
Consulta real, com a identificação da empresa omitida. Razão social e CNPJ foram mascarados; todos os demais valores são os que a API devolveu.
GET /cnpj/{cnpj}/enriched?border=trueRecorte dos campos cadastrais, seguidos do bloco de fronteira completo:
{
"prismadata__pessoa_juridica__cnpj": "XXXXXXXX0001XX",
"prismadata__pessoa_juridica__razao_social": "RAZAO SOCIAL OMITIDA",
"prismadata__pessoa_juridica__situacao_cadastral": "ATIVA",
"prismadata__pessoa_juridica__data_abertura": "2021-06-10",
"prismadata__pessoa_juridica__natureza_juridica_descricao": "Sociedade Empresária Limitada",
"prismadata__pessoa_juridica__cnae_principal_codigo": "6810201",
"prismadata__pessoa_juridica__cnae_principal_descricao": "Compra e venda de imóveis próprios",
"prismadata__pessoa_juridica__total_socios": 4,
"prismadata__pessoa_juridica__total_socios_estrangeiro": 0,
"prismadata__pessoa_juridica__endereco_normalizado": "AVENIDA MARECHAL FLORIANO PEIXOTO, 960 - CENTRO, FOZ DO IGUACU/PR 858510200",
"prismadata__pessoa_juridica__municipio_nome": "FOZ DO IGUACU",
"prismadata__pessoa_juridica__uf": "PR",
"prismadata__pessoa_juridica__latitude": "-25.546354",
"prismadata__pessoa_juridica__longitude": "-54.583672",
"prismadata__pessoa_juridica__endereco_existe": true,
"prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder": false,
"prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao": "ALTA",
"prismadata__pessoa_juridica__qualidade_geocodificacao_score": 70,
"prismadata__border__score_exposicao_fronteira": 97,
"prismadata__border__classificacao_exposicao_fronteira": "ELEVADA",
"prismadata__border__versao_metodologia_score": "1.0.0",
"prismadata__border__score_componente_proximidade_internacional": 91,
"prismadata__border__score_componente_triplice_fronteira": 100,
"prismadata__border__score_componente_cidade_gemea": 100,
"prismadata__border__score_componente_intensidade_municipal": 100,
"prismadata__border__piso_aplicado": null,
"prismadata__border__qtd_fatores_acionados": 6,
"prismadata__border__fatores_acionados": "PONTO_NA_FAIXA|AREA_INFLUENCIA_TRIPLICE|TRIPLICE_IGUACU|CIDADE_GEMEA|MUNICIPIO_INTEGRALMENTE_NA_FAIXA|SEDE_NA_FAIXA",
"prismadata__border__fator_ponto_fora_do_territorio_nacional": false,
"prismadata__border__fator_ponto_na_faixa": true,
"prismadata__border__fator_area_influencia_triplice": true,
"prismadata__border__fator_triplice_iguacu": true,
"prismadata__border__fator_cidade_gemea": true,
"prismadata__border__fator_municipio_integralmente_na_faixa": true,
"prismadata__border__fator_sede_na_faixa": true,
"prismadata__border__ponto_contido_na_faixa_de_fronteira": true,
"prismadata__border__distancia_geodesica_ponto_borda_faixa_de_fronteira_km": 0,
"prismadata__border__pais_mais_proximo_pt": "PARAGUAI",
"prismadata__border__distancia_geodesica_pais_mais_proximo_pt_km": 1.38997681599,
"prismadata__border__segundo_pais_mais_proximo_pt": "ARGENTINA",
"prismadata__border__distancia_geodesica_segundo_pais_km": 3.34,
"prismadata__border__ponto_em_area_triplice_fronteira": true,
"prismadata__border__distancia_triplice_fronteira_km": 5.46,
"prismadata__border__nome_triplice_fronteira": "Tríplice Fronteira do Iguaçu",
"prismadata__border__paises_triplice_fronteira": "ARGENTINA/BRASIL/PARAGUAI",
"prismadata__border__nome_municipio_de_fronteira": "Foz do Iguaçu",
"prismadata__border__arco_fronteira": "SUL",
"prismadata__border__area_total_municipio_km2": 609.19,
"prismadata__border__area_municipio_integrada_faixa_de_fronteira_km2": 609.19,
"prismadata__border__frac_area_municipio_faixa_de_fronteira": 1,
"prismadata__border__pais_mais_proximo": "PARAGUAI",
"prismadata__border__municipio_possui_cidade_gemea": true,
"prismadata__border__nome_cidade_gemea_estrangeira": "Ciudad del Este",
"prismadata__border__pais_cidade_gemea": "PARAGUAI",
"prismadata__border__sede_municipio_dentro_da_faixa_de_fronteira": true,
"prismadata__border__distancia_geodesica_pais_mais_proximo_sede_municipio_km": 1.014
}Uma chamada resolve o que a esteira precisa: a empresa está ativa, o endereço da Receita foi encontrado e geocodificado com qualidade ALTA, sem divergência entre o cadastro e o endereço resolvido, e a coordenada resultante cai em Foz do Iguaçu, município integralmente contido na faixa e cidade gêmea de Ciudad del Este. Os seis fatores se acionam e o índice fica em 97/100 · ELEVADA. Cadastro e sinal geográfico na mesma resposta, sem uma segunda integração.
A coordenada usada no cálculo volta na própria resposta, então o resultado é auditável:
o mesmo par latitude e longitude consultado em
GET /location/border reproduz o bloco de fronteira. Compare com o
primeiro exemplo desta página, que informa uma coordenada em Foz do Iguaçu e devolve 98.
A diferença de um ponto está em D1: aquela coordenada está a 0,76 km do Paraguai e a
derivada do endereço cadastral, a 1,39 km. Nos caminhos de endereço e de CNPJ, a
coordenada é resultado de um cálculo sobre o endereço declarado, não um dado informado,
e é por isso que os campos de qualidade da geocodificação vêm junto.
Três coordenadas contrastantes, três bandas do índice. Todos os valores abaixo foram lidos direto do endpoint. O primeiro par (Foz e Ciudad del Este) ilustra o comportamento em tríplice fronteira quando o ponto atravessa a jurisdição: os dois lados recebem exposição ELEVADA, com o bloco municipal nulo do lado paraguaio e a flag de território estrangeiro acionada.
-25.525686, -54.592733
-25.525949, -54.607493
-13.010292, -38.530743
Abaixo, a resposta completa de cada uma das três coordenadas. Todos os quatro sinais de fronteira aparecem em Foz; o bloco municipal desaparece em Ciudad del Este (fora do BR); tudo silencia em Salvador.
{
"prismadata__border__score_exposicao_fronteira": 98,
"prismadata__border__classificacao_exposicao_fronteira": "ELEVADA",
"prismadata__border__versao_metodologia_score": "1.0.0",
"prismadata__border__score_componente_proximidade_internacional": 94,
"prismadata__border__score_componente_triplice_fronteira": 100,
"prismadata__border__score_componente_cidade_gemea": 100,
"prismadata__border__score_componente_intensidade_municipal": 100,
"prismadata__border__piso_aplicado": null,
"prismadata__border__qtd_fatores_acionados": 6,
"prismadata__border__fatores_acionados": "PONTO_NA_FAIXA|AREA_INFLUENCIA_TRIPLICE|TRIPLICE_IGUACU|CIDADE_GEMEA|MUNICIPIO_INTEGRALMENTE_NA_FAIXA|SEDE_NA_FAIXA",
"prismadata__border__ponto_contido_na_faixa_de_fronteira": true,
"prismadata__border__distancia_geodesica_ponto_borda_faixa_de_fronteira_km": 0.0,
"prismadata__border__pais_mais_proximo_pt": "PARAGUAI",
"prismadata__border__distancia_geodesica_pais_mais_proximo_pt_km": 0.76,
"prismadata__border__segundo_pais_mais_proximo_pt": "ARGENTINA",
"prismadata__border__distancia_geodesica_segundo_pais_km": 5.3,
"prismadata__border__ponto_em_area_triplice_fronteira": true,
"prismadata__border__distancia_triplice_fronteira_km": 7.75,
"prismadata__border__nome_triplice_fronteira": "Tríplice Fronteira do Iguaçu",
"prismadata__border__paises_triplice_fronteira": "ARGENTINA/BRASIL/PARAGUAI",
"prismadata__border__nome_municipio_de_fronteira": "Foz do Iguaçu",
"prismadata__border__arco_fronteira": "SUL",
"prismadata__border__area_total_municipio_km2": 609.19,
"prismadata__border__area_municipio_integrada_faixa_de_fronteira_km2": 609.19,
"prismadata__border__frac_area_municipio_faixa_de_fronteira": 1.0,
"prismadata__border__pais_mais_proximo": "PARAGUAI",
"prismadata__border__municipio_possui_cidade_gemea": true,
"prismadata__border__nome_cidade_gemea_estrangeira": "Ciudad del Este",
"prismadata__border__pais_cidade_gemea": "PARAGUAI",
"prismadata__border__sede_municipio_dentro_da_faixa_de_fronteira": true,
"prismadata__border__distancia_geodesica_pais_mais_proximo_sede_municipio_km": 1.01
}
O ponto está em Foz do Iguaçu (arco SUL), município integralmente contido na faixa de fronteira e cidade gêmea de Ciudad del Este (Paraguai). Está a 0,76 km do Paraguai e 5,3 km da Argentina, dentro do raio da Tríplice Fronteira do Iguaçu. Os quatro sinais do índice se acionam simultaneamente e o resultado é 98/100 · ELEVADA. Como o valor calculado já supera 70, o piso GAFI não precisa entrar em ação e piso_aplicado vem nulo.
{
"prismadata__border__score_exposicao_fronteira": 97,
"prismadata__border__classificacao_exposicao_fronteira": "ELEVADA",
"prismadata__border__versao_metodologia_score": "1.0.0",
"prismadata__border__score_componente_proximidade_internacional": 94,
"prismadata__border__score_componente_triplice_fronteira": 100,
"prismadata__border__score_componente_cidade_gemea": null,
"prismadata__border__score_componente_intensidade_municipal": null,
"prismadata__border__piso_aplicado": null,
"prismadata__border__qtd_fatores_acionados": 3,
"prismadata__border__fatores_acionados": "PONTO_FORA_DO_TERRITORIO_NACIONAL|AREA_INFLUENCIA_TRIPLICE|TRIPLICE_IGUACU",
"prismadata__border__ponto_contido_na_faixa_de_fronteira": false,
"prismadata__border__distancia_geodesica_ponto_borda_faixa_de_fronteira_km": 0.89,
"prismadata__border__pais_mais_proximo_pt": "PARAGUAI",
"prismadata__border__distancia_geodesica_pais_mais_proximo_pt_km": 0.0,
"prismadata__border__segundo_pais_mais_proximo_pt": "ARGENTINA",
"prismadata__border__distancia_geodesica_segundo_pais_km": 5.31,
"prismadata__border__ponto_em_area_triplice_fronteira": true,
"prismadata__border__distancia_triplice_fronteira_km": 7.95,
"prismadata__border__nome_triplice_fronteira": "Tríplice Fronteira do Iguaçu",
"prismadata__border__paises_triplice_fronteira": "ARGENTINA/BRASIL/PARAGUAI",
"prismadata__border__nome_municipio_de_fronteira": null,
"prismadata__border__arco_fronteira": null,
"prismadata__border__area_total_municipio_km2": null,
"prismadata__border__area_municipio_integrada_faixa_de_fronteira_km2": null,
"prismadata__border__frac_area_municipio_faixa_de_fronteira": null,
"prismadata__border__pais_mais_proximo": null,
"prismadata__border__municipio_possui_cidade_gemea": null,
"prismadata__border__nome_cidade_gemea_estrangeira": null,
"prismadata__border__pais_cidade_gemea": null,
"prismadata__border__sede_municipio_dentro_da_faixa_de_fronteira": null,
"prismadata__border__distancia_geodesica_pais_mais_proximo_sede_municipio_km": null
}
O ponto está no Paraguai (distância 0 km ao país mais próximo) e a 890 m da borda da faixa brasileira. Os campos de município e sede voltam null — e, consequentemente, também os componentes D3 e D4 do índice. Só que D1 e D2 são renormalizados (não zerados), e o índice resulta em 97/100 · ELEVADA — quase idêntico ao lado brasileiro. É a leitura correta: o território ao redor do ponto tem a mesma exposição, mesmo com a jurisdição diferente.
{
"prismadata__border__score_exposicao_fronteira": 0,
"prismadata__border__classificacao_exposicao_fronteira": "RESIDUAL",
"prismadata__border__versao_metodologia_score": "1.0.0",
"prismadata__border__score_componente_proximidade_internacional": 0,
"prismadata__border__score_componente_triplice_fronteira": 0,
"prismadata__border__score_componente_cidade_gemea": null,
"prismadata__border__score_componente_intensidade_municipal": null,
"prismadata__border__piso_aplicado": null,
"prismadata__border__qtd_fatores_acionados": 0,
"prismadata__border__fatores_acionados": "",
"prismadata__border__ponto_contido_na_faixa_de_fronteira": false,
"prismadata__border__distancia_geodesica_ponto_borda_faixa_de_fronteira_km": 1911.41,
"prismadata__border__pais_mais_proximo_pt": "PARAGUAI",
"prismadata__border__distancia_geodesica_pais_mais_proximo_pt_km": 2061.16,
"prismadata__border__segundo_pais_mais_proximo_pt": "BOLIVIA",
"prismadata__border__distancia_geodesica_segundo_pais_km": 2108.3,
"prismadata__border__ponto_em_area_triplice_fronteira": false,
"prismadata__border__distancia_triplice_fronteira_km": null,
"prismadata__border__nome_triplice_fronteira": null,
"prismadata__border__paises_triplice_fronteira": null,
"prismadata__border__nome_municipio_de_fronteira": null,
"prismadata__border__arco_fronteira": null,
"prismadata__border__area_total_municipio_km2": null,
"prismadata__border__area_municipio_integrada_faixa_de_fronteira_km2": null,
"prismadata__border__frac_area_municipio_faixa_de_fronteira": null,
"prismadata__border__pais_mais_proximo": null,
"prismadata__border__municipio_possui_cidade_gemea": null,
"prismadata__border__nome_cidade_gemea_estrangeira": null,
"prismadata__border__pais_cidade_gemea": null,
"prismadata__border__sede_municipio_dentro_da_faixa_de_fronteira": null,
"prismadata__border__distancia_geodesica_pais_mais_proximo_sede_municipio_km": null
}
O ponto está em Salvador, BA — a mais de 1.911 km da faixa e a 2.061 km / 2.108 km dos dois países estrangeiros mais próximos (Paraguai e Bolívia). Índice 0/100 · RESIDUAL, todos os componentes disponíveis em zero, campos de tríplice descritivos nulos (o ponto está além do alcance de 500 km), fatores_acionados é string vazia e qtd_fatores_acionados = 0.
Trinta e oito campos organizados em cinco blocos: ponto consultado, município fronteiriço em que o ponto se encontra, sede desse município, tríplice fronteira mais próxima e índice de exposição (metodologia 1.0.0). Nas consultas que partem de coordenada, os trinta e oito campos vêm sempre presentes e os não aplicáveis vêm explicitamente null, nunca omitidos. Na consulta por CNPJ, quando o endereço cadastral não produz coordenada geocodificável, o bloco de fronteira não é retornado.
pais_mais_proximo_pt.distancia_geodesica_pais_mais_proximo_pt_km (que é medido a partir do ponto consultado).null quando a distância excede 500 km (alcance máximo para os campos descritivos).null quando a distância excede 500 km./ (ex.: ARGENTINA/BRASIL/PARAGUAI). Retorna null quando a distância excede 500 km.1.0.0. Mudança de peso, âncora ou piso incrementa a versão sem alterar o schema.null fora de município brasileiro de fronteira.null fora de município brasileiro de fronteira.TRIPLICE_FRONTEIRA_GAFI, que fixa 70 em áreas de tríplice fronteira. null quando o piso não foi atingido ou não se aplica./location/border/metadata, separados por |. String vazia se nenhum foi acionado — nunca null.ponto_contido_na_faixa_de_fronteira na nomenclatura de fatores.
Um segundo endpoint, GET /location/border/metadata, expõe em formato machine-readable a linhagem dos dados, os parâmetros de cálculo, as coordenadas exatas dos quatro pontos de tríplice fronteira e a metodologia do índice (bloco SCORE: pesos, âncoras, limiares, piso, ordem canônica dos fatores e regra de arredondamento). Com isso, o cliente recalcula o índice a partir dos campos devolvidos e confere por igualdade exata, sem depender da API nem de engenharia reversa.
NOME, ORGAO, ANO_REFERENCIA, URL e a lista de CAMPOS da resposta principal que ela alimenta — permitindo rastrear campo → fonte sem ambiguidade.LARGURA_FAIXA_DE_FRONTEIRA_KM (150), RAIO_AREA_TRIPLICE_FRONTEIRA_KM (50), ALCANCE_MAXIMO_TRIPLICE_FRONTEIRA_KM (500) e ELIPSOIDE_DISTANCIAS_GEODESICAS (WGS84).distancia_triplice_fronteira_km caso queira auditar o valor devolvido pela API.GET /location/border/metadata
{
"prismadata__border__fontes": [
{
"NOME": "Faixa de Fronteira e Municípios da Faixa de Fronteira",
"ORGAO": "IBGE",
"ANO_REFERENCIA": 2022,
"URL": "https://www.ibge.gov.br/geociencias/organizacao-do-territorio/estrutura-territorial.html",
"CAMPOS": [
"prismadata__border__nome_municipio_de_fronteira",
"prismadata__border__area_total_municipio_km2",
"prismadata__border__area_municipio_integrada_faixa_de_fronteira_km2",
"prismadata__border__frac_area_municipio_faixa_de_fronteira",
"prismadata__border__sede_municipio_dentro_da_faixa_de_fronteira",
"prismadata__border__ponto_contido_na_faixa_de_fronteira",
"prismadata__border__distancia_geodesica_ponto_borda_faixa_de_fronteira"
]
},
{
"NOME": "Cidades Gêmeas da Faixa de Fronteira",
"ORGAO": "Ministério da Integração e do Desenvolvimento Regional",
"ANO_REFERENCIA": 2022,
"URL": "https://www.gov.br/mdr/pt-br/assuntos/desenvolvimento-regional/fronteiras/cidades-gemeas",
"CAMPOS": [
"prismadata__border__municipio_possui_cidade_gemea",
"prismadata__border__nome_cidade_gemea_estrangeira",
"prismadata__border__pais_cidade_gemea"
]
},
{
"NOME": "Limites internacionais (GEOFT_PAIS)",
"ORGAO": "IBGE",
"ANO_REFERENCIA": 2022,
"URL": "https://www.ibge.gov.br/geociencias/downloads-geociencias.html",
"CAMPOS": [
"prismadata__border__pais_mais_proximo",
"prismadata__border__pais_mais_proximo_pt",
"prismadata__border__distancia_geodesica_pais_mais_proximo_pt_km",
"prismadata__border__distancia_geodesica_pais_mais_proximo_sede_municipio_km",
"prismadata__border__segundo_pais_mais_proximo_pt",
"prismadata__border__distancia_geodesica_segundo_pais_km"
]
},
{
"NOME": "Arcos da Faixa de Fronteira (Norte, Central e Sul)",
"ORGAO": "IBGE",
"ANO_REFERENCIA": 2022,
"URL": "https://www.ibge.gov.br/geociencias/organizacao-do-territorio/estrutura-territorial.html",
"CAMPOS": ["prismadata__border__arco_fronteira"]
},
{
"NOME": "Pontos de Tríplice Fronteira do Brasil",
"ORGAO": "PrismaData (confluências fluviais de referência)",
"ANO_REFERENCIA": 2023,
"URL": "https://www.fatf-gafi.org/en/publications/Mutualevaluations/Mer-brazil-2023.html",
"OBSERVACAO": "Tríplices fronteiras são tratadas pelo GAFI/FATF como áreas de risco elevado para PLD/FT. A do Iguaçu é citada nominalmente no Relatório de Avaliação Mútua do Brasil (2023).",
"CAMPOS": [
"prismadata__border__ponto_em_area_triplice_fronteira",
"prismadata__border__distancia_triplice_fronteira_km",
"prismadata__border__nome_triplice_fronteira",
"prismadata__border__paises_triplice_fronteira"
]
}
],
"prismadata__border__parametros": {
"LARGURA_FAIXA_DE_FRONTEIRA_KM": 150,
"RAIO_AREA_TRIPLICE_FRONTEIRA_KM": 50.0,
"ALCANCE_MAXIMO_TRIPLICE_FRONTEIRA_KM": 500.0,
"ELIPSOIDE_DISTANCIAS_GEODESICAS": "WGS84"
},
"prismadata__border__pontos_triplice_fronteira": [
{ "NOME": "Tríplice Fronteira do Iguaçu", "LAT": -25.5955, "LNG": -54.588, "PAISES": "ARGENTINA/BRASIL/PARAGUAI" },
{ "NOME": "Tríplice Fronteira de Barra do Quaraí","LAT": -30.2107, "LNG": -57.5519, "PAISES": "ARGENTINA/BRASIL/URUGUAI" },
{ "NOME": "Tríplice Fronteira de Assis Brasil", "LAT": -10.9441, "LNG": -69.5697, "PAISES": "BOLIVIA/BRASIL/PERU" },
{ "NOME": "Tríplice Fronteira de Tabatinga", "LAT": -4.2356, "LNG": -69.9387, "PAISES": "BRASIL/COLOMBIA/PERU" }
]
}
O endpoint é estável e cacheável — muda apenas quando uma fonte de dado é atualizada (nova versão dos limites do IBGE, revisão da lista de cidades gêmeas do MDR, etc.). Ideal para incluir num relatório de linhagem ou para snapshot num pipeline de compliance.
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. As quatro tríplices fronteiras são consideradas com raio de influência de 50 km e alcance descritivo de 500 km.
Os campos de fronteira, cidade gêmea, arco e tríplice fronteira são insumos diretos para a Abordagem Baseada em Risco exigida pela Circular BACEN 3.978, considerando as recomendações do GAFI/FATF — incluindo o Relatório de Avaliação Mútua do Brasil (2023), que cita nominalmente a tríplice fronteira do Iguaçu como área de risco elevado.
null. Os campos dos blocos Ponto (país, borda) e Tríplice Fronteira continuam sendo calculados para qualquer coordenada.nome_triplice_fronteira, paises_triplice_fronteira e distancia_triplice_fronteira_km) só são retornados quando o ponto está a menos de 500 km da tríplice mais próxima. Além disso, apenas o boolean ponto_em_area_triplice_fronteira é preenchido (com false).municipio_possui_cidade_gemea vem do IBGE (2022) e o nome da contraparte, do MDR.Solicite acesso à sandbox da API de Fronteira e veja o retorno para suas coordenadas.
Solicitar acesso