Documentação de Produto - PrismaData API

Location

Fronteira

📌 Visão Geral

A PrismaData oferece acesso via API a dados enriquecidos sobre características socioeconômicas e demográficas associadas a coordenadas geográficas ou endereços.

Ideal para instituições financeiras, seguradoras, proptechs e empresas de compliance que desejam enriquecer seus modelos preditivos ou processos de análise e/ou verificação.

💡 Fronteiras

fronteira_4

O dado de fronteiras indica se um ponto está localizado em uma faixa de fronteira e traz algumas informações desta fronteira, como proximidade da fronteira, qual é o país mais próximo e se a manha urbana do municipio que o ponto se encontra está pŕoximo da faixa de fronteira. A faixa de fronteira, segundo o IBGE, é uma faixa de até 150 km de largura ao longo das fronteiras terrestres do Brasil, considerada importante para a defesa nacional. Essa área abrange 16,7% do território brasileiro.

🧪 Exemplos de uso

📍 Foz do Iguaçu, PR

(lat, lng) <--> (-25.52568655357868, -54.59273323017718)

fronteira_1
{
  "area_municipio_integrada_faixa_de_fronteira_km2": 609.19,
  "area_total_municipio_km2": 609.19,
  "distancia_geodesica_pais_mais_proximo_pt_km": 1.112,
  "distancia_geodesica_pais_mais_proximo_sede_municipio_km": 1.014,
  "distancia_geodesica_ponto_borda_faixa_de_fronteira_km": 0.757,
  "muncipio_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 destacado na imagem, se encontra em Foz do Iguaçú, município que se encontra integralmente na faixa de fronteira definida pelo IBGE e faz fronteira com o Paraguai. O ponto em análise se distância 757 metros da faixa de fronteira e, pelo fato da sua mancha urbana ser muito próxima à mancha urbana de Cidade do Leste, as duas cidades são consideradasd cidades gêmeas, sendo separadas apenas pelo Rio Paraguai.

📍 Cidade do Leste, Paraguai

(lat, lng) <--> (-25.525949,-54.607493)

fronteira_2
{
  "area_municipio_integrada_faixa_de_fronteira_km2": null,
  "area_total_municipio_km2": null,
  "distancia_geodesica_pais_mais_proximo_pt_km": 0.0,
  "distancia_geodesica_pais_mais_proximo_sede_municipio_km": null,
  "distancia_geodesica_ponto_borda_faixa_de_fronteira_km": 0.7,
  "muncipio_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 destacado na imagem, se encontra no Paraguai, já que sua distância até o país mais proximo é de 0 km, e este país é o Paraguai. Além disso, o ponto está a 700 metros da fronteira do Brasil.

📍 Salvador, BA

(lat, lng) <--> (-13.010292048819824, -38.53074331162113)

fronteira_3
{
  "area_municipio_integrada_faixa_de_fronteira_km2": null,
  "area_total_municipio_km2": null,
  "distancia_geodesica_pais_mais_proximo_pt_km": 2066.51,
  "distancia_geodesica_pais_mais_proximo_sede_municipio_km": null,
  "distancia_geodesica_ponto_borda_faixa_de_fronteira_km": 1926.319,
  "muncipio_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 destacado na imagem, se encontra em Salvador, Bahia e, como esperado, muito distante da fronteira ou de qualquer país fronteiriço.

📥 Entradas

📦 Atributos Retornados

📚 Fontes

❗ Limitações

Se o ponto estiver fora da faixa de fronteira, o valor retornado é nulo.