API › Location › Fronteira # Fronteira 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). Categoria Location Cobertura Todo o território nacional Fonte IBGE, MDR e processamento interno Faixa de Fronteira 150 km (IBGE) Alinhamento regulatório BACEN 3.978 · GAFI/FATF Nesta página Aplicações Conceito Índice de exposição Escopo do índice Tríplice fronteira e GAFI Formas de consulta Exemplos Atributos retornados Endpoint de metadados Detalhes técnicos Limitações Para que serve ## Aplicações 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). #### PLD / Compliance (BACEN 3.978) 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. #### 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 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. #### Validação Cadastral Verifique se o endereço declarado é coerente com o território brasileiro ou se indica localização em país vizinho. Entendendo o dado ## 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](https://prismadata.io/imagens/border/fronteira_4.png) 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). Ponto #### Nível do Ponto Se o ponto está na faixa de fronteira, distância à borda da faixa e aos **dois** países estrangeiros mais próximos. Município #### Nível do Município Nome, área total, área integrada à faixa, fração na fronteira, arco (NORTE/CENTRAL/SUL) e cidade gêmea identificada por nome e país. Sede #### Nível da Sede 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. Tríplice #### Nível da Tríplice Fronteira 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). O índice ## Exposição do território, de 0 a 100 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. ### As quatro dimensões * D1 #### Proximidade internacional peso 0,35 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. * D2 #### Tríplice fronteira peso 0,30 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). * D3 #### Cidade gêmea peso 0,20 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. * D4 #### Intensidade municipal peso 0,15 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. ### Quatro bandas nomeadas 1. 0 – 19RESIDUALSem sinal geográfico material 2. 20 – 44BAIXAAlguma proximidade à fronteira 3. 45 – 69MODERADACamadas de fronteira acumuladas 4. 70 – 100ELEVADAFaixa, tríplice ou cidade gêmea acionadas ### Piso regulatório 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. ### Renormalização 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. #### Auditabilidade 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. #### Versionamento 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 que o índice não é ## Três limites de uso O índice funciona sob três limites explícitos, incorporados na descrição da API. Não são notas de rodapé. 1. 01 #### Exposição do território, não risco da pessoa 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. 2. 02 #### Insumo da ABR, não a ABR inteira 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. 3. 03 #### Não é fundamento único para recusa 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. Por que importa ## Tríplice fronteira e as normas do GAFI 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. MER Brasil 2023 #### O caso do Iguaçu 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. “As instituições devem adotar procedimentos de identificação, análise e avaliação de riscos […] considerando, no mínimo, os riscos associados a […] região geográfica de atuação, transação ou domicílio de suas partes relacionadas.” — Circular BACEN 3.978/2020, art. 4º 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. **50 km** raio de influência **500 km** alcance descritivo **4** tríplices consideradas **WGS84** elipsoide 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. Request ## Formas de consulta 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. Formas de consulta do dado de Fronteira Três entradas possíveis. Coordenada entra direto no cálculo. Endereço e CNPJ passam antes por uma etapa de geocodificação que os converte em coordenada. O cálculo devolve cinco blocos: ponto, município, sede, tríplice fronteira e índice de exposição. O que você tem O que volta Coordenada lat e lng em WGS84 entrada direta Endereço texto livre ou campos passa pela geocodificação CNPJ somente o número passa pela geocodificação entra direto, sem geocodificação Geocodificação o endereço vira uma coordenada qualidade herdada Dado de Fronteira cálculo sobre a coordenada Ponto faixa, borda e dois países vizinhos Município arco, área na faixa e cidade gêmea Sede posição na faixa e distância Tríplice fronteira nome, países e distância Índice de exposição 0 a 100 em quatro bandas Formas de consulta do dado de Fronteira Mesma informação da versão ampla, empilhada: coordenada entra direto no cálculo; endereço e CNPJ passam por geocodificação; o cálculo devolve cinco blocos. O que você tem Coordenada lat e lng em WGS84 · entrada direta Endereço texto livre ou campos via geocodificação CNPJ somente o número via geocodificação Geocodificação o endereço vira uma coordenada qualidade herdada pelo cálculo entra direto Dado de Fronteira cálculo sobre a coordenada O que volta Ponto faixa, borda e dois países vizinhos Município arco, área na faixa e cidade gêmea Sede posição na faixa e distância Tríplice fronteira nome, países e distância Índice de exposição 0 a 100 em quatro bandas Quatro caminhos, todos em produção. Caminhos relativos à base `https://api.prismadata.io/v1`. 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 * **Por endereço e por CNPJ, a coordenada vem de geocodificação** O resultado de fronteira herda a qualidade do geocoder. Um endereço mal cadastrado produz uma coordenada imprecisa, e o cálculo de fronteira sobre ela não tem como sinalizar isso. No caminho de CNPJ, a própria resposta traz com que confiança o endereço foi resolvido, em `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. * **Por CNPJ sem coordenada geocodificável, o bloco de fronteira não é retornado** Quando o endereço cadastral do CNPJ não produz coordenada, a resposta traz os dados cadastrais sem o bloco de fronteira. A ausência do bloco é a sinalização de que não houve coordenada para calcular. ### Consulta por CNPJ, na esteira de onboarding 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=true Recorte 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. Na prática ## Exemplos medidos em produção 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. #### Foz do Iguaçu · BR -25.525686, -54.592733 ELEVADA 98 D1 · proximidade 94 D2 · tríplice 100 D3 · cidade gêmea 100 D4 · município 100 piso aplicado — 6 fatores acionados PONTO_NA_FAIXA | AREA_INFLUENCIA_TRIPLICE | TRIPLICE_IGUACU | CIDADE_GEMEA | MUNICIPIO_INTEGRALMENTE_NA_FAIXA | SEDE_NA_FAIXA #### Ciudad del Este · PY -25.525949, -54.607493 ELEVADA 97 D1 · proximidade 94 D2 · tríplice 100 D3 · cidade gêmea — D4 · município — piso aplicado — 3 fatores acionados PONTO_FORA_DO_TERRITORIO_NACIONAL | AREA_INFLUENCIA_TRIPLICE | TRIPLICE_IGUACU #### Salvador · BR -13.010292, -38.530743 RESIDUAL 0 D1 · proximidade 0 D2 · tríplice 0 D3 · cidade gêmea — D4 · município — piso aplicado — 0 fatores acionados string vazia, não nula — schema estável 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. 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](https://prismadata.io/imagens/border/fronteira_1.png) { "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. Ponto fora do Brasil — Ciudad del Este, Paraguai -25.525949, -54.607493 ![Mapa: ponto em Ciudad del Este, Paraguai](https://prismadata.io/imagens/border/fronteira_2.png) { "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. Ponto distante da fronteira — Salvador, BA -13.010292048819824, -38.53074331162113 ![Mapa: ponto em Salvador, distante da fronteira](https://prismadata.io/imagens/border/fronteira_3.png) { "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`. Response ## Atributos Retornados 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. 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_km 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. pais_mais_proximo_pt Nome do país estrangeiro mais próximo ao ponto consultado. distancia_geodesica_pais_mais_proximo_pt_km Distância geodésica em quilômetros do ponto até o país estrangeiro mais próximo. segundo_pais_mais_proximo_pt Nome do segundo país estrangeiro mais próximo ao ponto consultado. Útil em áreas tri-fronteiriças, onde dois países vizinhos estão a poucos quilômetros do ponto. distancia_geodesica_segundo_pais_km Distância geodésica em quilômetros do ponto ao segundo país estrangeiro mais próximo. 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. arco_fronteira Arco da faixa de fronteira em que o município está classificado: **NORTE** (AP, PA, AM, RR, AC), **CENTRAL** (RO, MT, MS) ou **SUL** (PR, SC, RS). Recorte oficial do IBGE, usado na avaliação de risco geográfico da Circular BACEN 3.978. 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. frac_area_municipio_faixa_de_fronteira Fração da área do município que está dentro da faixa de fronteira (valor em [0,1]; ex.: 1.0 = 100% do município na faixa). 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. nome_cidade_gemea_estrangeira Nome da cidade gêmea estrangeira, quando o município possui cidade gêmea. Ex.: _Ciudad del Este_ para Foz do Iguaçu. Fonte: Portaria MDR nº 213/2016 e atualizações posteriores. pais_cidade_gemea País da cidade gêmea estrangeira (ex.: _PARAGUAI_). Normalizado como o campo `pais_mais_proximo_pt`. 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. distancia_geodesica_pais_mais_proximo_sede_municipio_km Distância geodésica em quilômetros da _sede_ do município ao país estrangeiro mais próximo. Complementa o campo `distancia_geodesica_pais_mais_proximo_pt_km` (que é medido a partir do ponto consultado). Tríplice Fronteira ponto_em_area_triplice_fronteira Booleano que indica se o ponto está no **raio de 50 km** da tríplice fronteira mais próxima. Áreas listadas pelo GAFI/FATF como de risco elevado para PLD/FT — a tríplice do Iguaçu é citada nominalmente no Relatório de Avaliação Mútua do Brasil (2023). distancia_triplice_fronteira_km Distância geodésica em quilômetros do ponto à tríplice fronteira mais próxima. Retorna `null` quando a distância excede 500 km (alcance máximo para os campos descritivos). nome_triplice_fronteira Nome da tríplice fronteira mais próxima: _Tríplice Fronteira do Iguaçu_ , _de Barra do Quaraí_ , _de Assis Brasil_ ou _de Tabatinga_. Retorna `null` quando a distância excede 500 km. paises_triplice_fronteira Países que compõem a tríplice fronteira, em ordem alfabética, separados por `/` (ex.: `ARGENTINA/BRASIL/PARAGUAI`). Retorna `null` quando a distância excede 500 km. Nível Índice · metodologia 1.0.0 score_exposicao_fronteira Índice de exposição do território à fronteira, inteiro entre **0 e 100**. Agrega as quatro dimensões por média ponderada (renormalizada quando faltam dimensões) e aplica o piso regulatório de tríplice fronteira. Arredondamento _half up_. classificacao_exposicao_fronteira Faixa nomeada correspondente ao score: **RESIDUAL** (0–19), **BAIXA** (20–44), **MODERADA** (45–69), **ELEVADA** (70–100). versao_metodologia_score Versão semver 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. score_componente_proximidade_internacional Componente **D1** (peso 0,35): proximidade à linha internacional, em escala 0–100, com curva logarítmica ancorada em 100 na linha, 25 na borda da faixa e 0 a partir de 500 km. score_componente_triplice_fronteira Componente **D2** (peso 0,30): 100 no Iguaçu, 85 nas outras três tríplices, decaindo até zero em 500 km. score_componente_cidade_gemea Componente **D3** (peso 0,20): 100 se o município tem cidade gêmea reconhecida pelo MDR, 0 caso contrário. Retorna `null` fora de município brasileiro de fronteira. score_componente_intensidade_municipal Componente **D4** (peso 0,15): combinação da fração da área municipal na faixa com a presença da sede na faixa. Retorna `null` fora de município brasileiro de fronteira. piso_aplicado Rótulo do piso regulatório aplicado, _quando o piso elevou o valor_. Hoje só existe `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. qtd_fatores_acionados Quantidade de fatores acionados na coordenada. Zero para pontos residuais. fatores_acionados Fatores acionados concatenados na ordem canônica declarada em `/location/border/metadata`, separados por `|`. String vazia se nenhum foi acionado — nunca `null`. fator_ponto_fora_do_territorio_nacional Booleano. O ponto está em território estrangeiro (distância zero ao país mais próximo). fator_ponto_na_faixa Booleano. O ponto está dentro da faixa de fronteira brasileira. Espelha `ponto_contido_na_faixa_de_fronteira` na nomenclatura de fatores. fator_area_influencia_triplice Booleano. O ponto está no raio de 50 km de alguma tríplice fronteira. fator_triplice_iguacu Booleano. A tríplice mais próxima é a do Iguaçu, dentro do raio de 50 km. Sinal específico pela citação nominal no MER GAFI 2023. fator_cidade_gemea Booleano. O município possui cidade gêmea reconhecida pelo MDR. fator_municipio_integralmente_na_faixa Booleano. Toda a área do município está dentro da faixa (fração igual a um). fator_sede_na_faixa Booleano. A sede do município está dentro da faixa de fronteira. Rastreabilidade ## Endpoint de metadados 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. Blocos da resposta prismadata__border__fontes Lista de 5 fontes que alimentam a API. Cada fonte inclui `NOME`, `ORGAO`, `ANO_REFERENCIA`, `URL` e a lista de `CAMPOS` da resposta principal que ela alimenta — permitindo rastrear campo → fonte sem ambiguidade. prismadata__border__parametros Parâmetros de cálculo: `LARGURA_FAIXA_DE_FRONTEIRA_KM` (150), `RAIO_AREA_TRIPLICE_FRONTEIRA_KM` (50), `ALCANCE_MAXIMO_TRIPLICE_FRONTEIRA_KM` (500) e `ELIPSOIDE_DISTANCIAS_GEODESICAS` (WGS84). prismadata__border__pontos_triplice_fronteira Coordenadas (LAT/LNG) das quatro tríplices fronteiras do Brasil e a lista de países de cada uma, ordenados alfabeticamente. Reprodutível: permite ao consumidor recalcular `distancia_triplice_fronteira_km` caso queira auditar o valor devolvido pela API. Exemplo — resposta de `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. Referência ## Detalhes Técnicos #### Fontes * IBGE — Faixa de Fronteira, Malha Municipal e Arcos * MDR — Portaria nº 213/2016 (cidades gêmeas) * IBGE — planilha _Mun_Faixa_de_Fronteira_Cidades_Gemeas_2022_ * 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. As quatro tríplices fronteiras são consideradas com raio de influência de 50 km e alcance descritivo de 500 km. #### Alinhamento regulatório 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. #### Definições dos arcos (IBGE) * **NORTE:** AP, PA, AM, RR, AC * **CENTRAL:** RO, MT, MS * **SUL:** PR, SC, RS Atenção ## Limitações #### Considere ao utilizar * Quando o ponto está fora de um município fronteiriço, os campos dos blocos **Município** e **Sede** retornam `null`. Os campos dos blocos **Ponto** (país, borda) e **Tríplice Fronteira** continuam sendo calculados para qualquer coordenada. * Os campos descritivos da tríplice fronteira (`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`). * A definição de faixa de fronteira (150 km) e os arcos NORTE/CENTRAL/SUL seguem o critério do IBGE e podem não coincidir com outras definições legais ou regulatórias. * A lista de cidades gêmeas segue a Portaria MDR nº 213/2016 e atualizações posteriores. Municípios com cidade gêmea recém-designada podem ainda não constar da base — o campo `municipio_possui_cidade_gemea` vem do IBGE (2022) e o nome da contraparte, do MDR. ## Pronto para testar? Solicite acesso à sandbox da API de Fronteira e veja o retorno para suas coordenadas. Solicitar acesso