Documentação de Produto - PrismaData API

Location

Validação de Endereço

📌 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.

As APIs de validação de endereço são úteis para:

  • confrontar endereços (muitas vezes declarados) com um sinal de localização (muitas vezes gerado por um GPS);
  • encontrar padrões no deslocamento de determinada entidade que é constantemente monitorada (por um GPS, por exemplo)
  • confrontar padrões no deslocamento de determinada entidade que é constantemente monitorada (por um GPS, por exemplo) com endereços de escolha.

    • Dados históricos de 30 dias de um dispositivo móvel

    valida_1 valida_2

    🧪 Exemplos de uso

    📍 Clusterização de localizações

    Clusters_BH 
        [
  {
    "prismadata__cluster_historic_location__cep": "30380-752",
    "prismadata__cluster_historic_location__cluster_id": 0,
    "prismadata__cluster_historic_location__distancia_m": 12.64653078,
    "prismadata__cluster_historic_location__endereco_completo": "AVENIDA ARTUR BERNARDES, 228 - VILA PARIS, BELO HORIZONTE - MG, 30380-752",
    "prismadata__cluster_historic_location__latitude_endereco": -19.950218200683594,
    "prismadata__cluster_historic_location__latitude_input": -19.950141,
    "prismadata__cluster_historic_location__localidade": "VILA PARIS",
    "prismadata__cluster_historic_location__logradouro": "AVENIDA ARTUR BERNARDES",
    "prismadata__cluster_historic_location__longitude_endereco": -43.947635650634766,
    "prismadata__cluster_historic_location__longitude_input": -43.9477247,
    "prismadata__cluster_historic_location__moradia": 0.5853592589109377,
    "prismadata__cluster_historic_location__moradia_normalizado": 0.9687919528377141,
    "prismadata__cluster_historic_location__municipio": "BELO HORIZONTE",
    "prismadata__cluster_historic_location__numero": 228,
    "prismadata__cluster_historic_location__trabalho": 0.5158601560896914,
    "prismadata__cluster_historic_location__trabalho_normalizado": 0.9704367271420395,
    "prismadata__cluster_historic_location__uf": "MG",
    "prismadata__cluster_historic_location__visita_eventual": 0.0024057361519826295,
    "prismadata__cluster_historic_location__visita_eventual_normalizado": 0.0011620985380875505,
    "prismadata__cluster_historic_location__visita_frequente": 0.0348831742037481,
    "prismadata__cluster_historic_location__visita_frequente_normalizado": 0.08406721888423925
  },
  {
    "prismadata__cluster_historic_location__cep": "30160-019",
    "prismadata__cluster_historic_location__cluster_id": 1,
    "prismadata__cluster_historic_location__distancia_m": 42.60808378,
    "prismadata__cluster_historic_location__endereco_completo": "RUA DA BAHIA, 2425 - SAVASSI, BELO HORIZONTE - MG, 30160-019",
    "prismadata__cluster_historic_location__latitude_endereco": -19.93621253967285,
    "prismadata__cluster_historic_location__latitude_input": -19.9359977,
    "prismadata__cluster_historic_location__localidade": "SAVASSI",
    "prismadata__cluster_historic_location__logradouro": "RUA DA BAHIA",
    "prismadata__cluster_historic_location__longitude_endereco": -43.940513610839844,
    "prismadata__cluster_historic_location__longitude_input": -43.9408513,
    "prismadata__cluster_historic_location__moradia": 0.013448697451330763,
    "prismadata__cluster_historic_location__moradia_normalizado": 0.022258108449909525,
    "prismadata__cluster_historic_location__municipio": "BELO HORIZONTE",
    "prismadata__cluster_historic_location__numero": 2425,
    "prismadata__cluster_historic_location__trabalho": 0.012064049133581927,
    "prismadata__cluster_historic_location__trabalho_normalizado": 0.02269490329708361,
    "prismadata__cluster_historic_location__uf": "MG",
    "prismadata__cluster_historic_location__visita_eventual": 0.5574400106335522,
    "prismadata__cluster_historic_location__visita_eventual_normalizado": 0.26927317897887126,
    "prismadata__cluster_historic_location__visita_frequente": 0.3065920058484537,
    "prismadata__cluster_historic_location__visita_frequente_normalizado": 0.7388759151697422
  },
  {
    "prismadata__cluster_historic_location__cep": "06470-000",
    "prismadata__cluster_historic_location__cluster_id": 2,
    "prismadata__cluster_historic_location__distancia_m": 20.80692223,
    "prismadata__cluster_historic_location__endereco_completo": "ALAMEDA VENEZUELA, 862 - ALPHAVILLE 2, BARUERI - SP, 06470-000",
    "prismadata__cluster_historic_location__latitude_endereco": -23.492918014526367,
    "prismadata__cluster_historic_location__latitude_input": -23.4927481,
    "prismadata__cluster_historic_location__localidade": "ALPHAVILLE 2",
    "prismadata__cluster_historic_location__logradouro": "ALAMEDA VENEZUELA",
    "prismadata__cluster_historic_location__longitude_endereco": -46.861968994140625,
    "prismadata__cluster_historic_location__longitude_input": -46.8620559,
    "prismadata__cluster_historic_location__moradia": 0.004796388601523559,
    "prismadata__cluster_historic_location__moradia_normalizado": 0.007938206510107593,
    "prismadata__cluster_historic_location__municipio": "BARUERI",
    "prismadata__cluster_historic_location__numero": 862,
    "prismadata__cluster_historic_location__trabalho": 0.003000091983952338,
    "prismadata__cluster_historic_location__trabalho_normalizado": 0.0056437765383949845,
    "prismadata__cluster_historic_location__uf": "SP",
    "prismadata__cluster_historic_location__visita_eventual": 0.6489826034166849,
    "prismadata__cluster_historic_location__visita_eventual_normalizado": 0.3134931210362539,
    "prismadata__cluster_historic_location__visita_frequente": 0.04475742092528861,
    "prismadata__cluster_historic_location__visita_frequente_normalizado": 0.10786380504375039
  },
  {
    "prismadata__cluster_historic_location__cep": "30140-100",
    "prismadata__cluster_historic_location__cluster_id": 3,
    "prismadata__cluster_historic_location__distancia_m": 9.39547144,
    "prismadata__cluster_historic_location__endereco_completo": "RUA CLAUDIO MANOEL, 862 - SAVASSI, BELO HORIZONTE - MG, 30140-100",
    "prismadata__cluster_historic_location__latitude_endereco": -19.933401107788086,
    "prismadata__cluster_historic_location__latitude_input": -19.933324900000002,
    "prismadata__cluster_historic_location__localidade": "SAVASSI",
    "prismadata__cluster_historic_location__logradouro": "RUA CLAUDIO MANOEL",
    "prismadata__cluster_historic_location__longitude_endereco": -43.93346405029297,
    "prismadata__cluster_historic_location__longitude_input": -43.93342455,
    "prismadata__cluster_historic_location__moradia": 0.0006113044296059438,
    "prismadata__cluster_historic_location__moradia_normalizado": 0.0010117322022686148,
    "prismadata__cluster_historic_location__municipio": "BELO HORIZONTE",
    "prismadata__cluster_historic_location__numero": 862,
    "prismadata__cluster_historic_location__trabalho": 0.0006509633550085262,
    "prismadata__cluster_historic_location__trabalho_normalizado": 0.0012245930224819308,
    "prismadata__cluster_historic_location__uf": "MG",
    "prismadata__cluster_historic_location__visita_eventual": 0.8613370214380509,
    "prismadata__cluster_historic_location__visita_eventual_normalizado": 0.41607160144678723,
    "prismadata__cluster_historic_location__visita_frequente": 0.028711234047935026,
    "prismadata__cluster_historic_location__visita_frequente_normalizado": 0.06919306090226829
  }
]

    Os pontos destacados na imagem mostram os pontos que foram considerados relevantes no histórico de localizações, isto é, locais em que o sinal do device apresenta um padrão de visita que pode ser classificado em algumas categorias. Elas são:

  • MORADIA: Indica que o local é provavelmente onde o possuidor do device habita.
  • TRABALHO: Indica que o local é provavelmente onde o possuidor do device trabalha.
  • VISITA EVENTUAL: Indica que o local é um endereço no qual o device permaneceu por um tempo considerável, mas sem repeti-lo. Isto é, foi uma visita mais longa e eventual.
  • VISITA FREQUENTE: Indica um local em que o device vistia frequentemente e por um tempo curto.
    • Como um cluster de localizações pode ser encaixado em mais de uma categoria (Ex: MORADIA e TRABALHO para quem atua no formato de trabalho de Homme Office), são fornecidos valores que variam de 0 a 1, indicando o pertencimento daquele endereço a determinada categoria.

    📍 Validação de Endereços

    Av. Artur Bernardes 216, Vila Paris - Belo Horizonte - MG' <--> MORADIA

    MORADIA 
        {'prismadata__valida_endereco__classificacao__atipico': 0,
     'prismadata__valida_endereco__classificacao__moradia': 83,
     'prismadata__valida_endereco__classificacao__proximidade': 100,
     'prismadata__valida_endereco__classificacao__trabalho': 83,
     'prismadata__valida_endereco__classificacao__visita_eventual': 0,
     'prismadata__valida_endereco__classificacao__visita_frequente': 7,
     'prismadata__valida_endereco__classificacao_provavel': 'MORADIA',
     'prismadata__valida_endereco__endereco_validado': 'Av. Artur Bernardes 216, Vila Paris - Belo Horizonte - MG',
     'prismadata__valida_endereco__geocoder__cep': '30380-752',
     'prismadata__valida_endereco__geocoder__classificao_qualidade_geocodificacao': 'MUITO_ALTA',
     'prismadata__valida_endereco__geocoder__endereco_completo': 'AVENIDA ARTUR BERNARDES, 216 - VILA PARIS, BELO HORIZONTE - MG, 30380-752',
     'prismadata__valida_endereco__geocoder__latitude': -19.949094772338867,
     'prismadata__valida_endereco__geocoder__localidade': 'VILA PARIS',
     'prismadata__valida_endereco__geocoder__logradouro': 'AVENIDA ARTUR BERNARDES',
     'prismadata__valida_endereco__geocoder__longitude': -43.9478874206543,
     'prismadata__valida_endereco__geocoder__municipio': 'BELO HORIZONTE',
     'prismadata__valida_endereco__geocoder__numero': 216,
     'prismadata__valida_endereco__geocoder__score_qualidade_geocodificacao': 100.0,
     'prismadata__valida_endereco__geocoder__uf': 'MG'
 }

    O endereço validado com o histórico de localizações, indica que existem sinais de GPS próximos à ele e que provavelmente é um local de moradia, porém, há também um forte sinal de local de trabalho, o que pode ser explicado por um trabalho de Homme Office.

    Rua São João Evangelista, 185, São Pedro - Belo Horizonte - MG <--> PROXIMIDADE

    PROXIMIDADE 
        {'prismadata__valida_endereco__classificacao__atipico': 0,
 'prismadata__valida_endereco__classificacao__moradia': 0,
 'prismadata__valida_endereco__classificacao__proximidade': 100,
 'prismadata__valida_endereco__classificacao__trabalho': 0,
 'prismadata__valida_endereco__classificacao__visita_eventual': 0,
 'prismadata__valida_endereco__classificacao__visita_frequente': 0,
 'prismadata__valida_endereco__classificacao_provavel': 'PROXIMIDADE',
 'prismadata__valida_endereco__endereco_validado': 'Rua São João Evangelista, 185, São Pedro - Belo Horizonte - MG',
 'prismadata__valida_endereco__geocoder__cep': '30330-152',
 'prismadata__valida_endereco__geocoder__classificao_qualidade_geocodificacao': 'MUITO_ALTA',
 'prismadata__valida_endereco__geocoder__endereco_completo': 'RUA SAO JOAO EVANGELISTA, 185 - SAO PEDRO, BELO HORIZONTE - MG, 30330-152',
 'prismadata__valida_endereco__geocoder__latitude': -19.947734832763672,
 'prismadata__valida_endereco__geocoder__localidade': 'SAO PEDRO',
 'prismadata__valida_endereco__geocoder__logradouro': 'RUA SAO JOAO EVANGELISTA',
 'prismadata__valida_endereco__geocoder__longitude': -43.937156677246094,
 'prismadata__valida_endereco__geocoder__municipio': 'BELO HORIZONTE',
 'prismadata__valida_endereco__geocoder__numero': 185,
 'prismadata__valida_endereco__geocoder__score_qualidade_geocodificacao': 100.0,
 'prismadata__valida_endereco__geocoder__uf': 'MG'}

    O endereço validado com o histórico de localizações, indica que existem sinais de GPS próximos à ele, contudo, não existe um cluster de sinais relevantes para classificar este endereço em uma das categorias já mencionadas. Assim, este endereço foi calssificado como um endereço de PROXIMIDADE, ou seja, o device já passou perto deste endereço, apesar de não ser possível classificá-lo em uma das categorias.

    Av. Vieira Souto, 302 - Ipanema - Rio de Janeiro - RJ <--> ATIPICO

    ATIPICO 
        {'prismadata__valida_endereco__classificacao__atipico': 100,
 'prismadata__valida_endereco__classificacao__moradia': 0,
 'prismadata__valida_endereco__classificacao__proximidade': 0,
 'prismadata__valida_endereco__classificacao__trabalho': 0,
 'prismadata__valida_endereco__classificacao__visita_eventual': 0,
 'prismadata__valida_endereco__classificacao__visita_frequente': 0,
 'prismadata__valida_endereco__classificacao_provavel': 'ATIPICO',
 'prismadata__valida_endereco__endereco_validado': 'Av. Vieira Souto, 302 - Ipanema - Rio de Janeiro - RJ',
 'prismadata__valida_endereco__geocoder__cep': '22420-004',
 'prismadata__valida_endereco__geocoder__classificao_qualidade_geocodificacao': 'MEDIA',
 'prismadata__valida_endereco__geocoder__endereco_completo': 'AVENIDA VIEIRA SOUTO, 284 - IPANEMA, RIO DE JANEIRO - RJ, 22420-004',
 'prismadata__valida_endereco__geocoder__latitude': -22.986597061157227,
 'prismadata__valida_endereco__geocoder__localidade': 'IPANEMA',
 'prismadata__valida_endereco__geocoder__logradouro': 'AVENIDA VIEIRA SOUTO',
 'prismadata__valida_endereco__geocoder__longitude': -43.201576232910156,
 'prismadata__valida_endereco__geocoder__municipio': 'RIO DE JANEIRO',
 'prismadata__valida_endereco__geocoder__numero': 284,
 'prismadata__valida_endereco__geocoder__score_qualidade_geocodificacao': 50.0,
 'prismadata__valida_endereco__geocoder__uf': 'RJ'}

    O endereço validado com o histórico de localizações, indica que NÃO existem sinais de GPS próximos à ele, e por isso foi classificado como ATIPICO. Isto é, não há nenhuma relação do endereço com o histórico de localizações do device.

    🔁 Atualizações

    Base de endereços atualizada mensalmente.

    📚 Fontes

    ⚙️ Metodologia

    Nos endpoints de validação de endereço são utilizados algoritmos baseados em regras e algoritmos de aprendizado de máquinas exclusivos da PrismaData.

    ❗ Limitações

    A validação do endereço só é realizada em território nacional e, somente é possível, quando se consegue geocodificar os endereços a serem validados. Para endender mais sobre geocodificação e suas limitações veja a documentação de produto do Geocoder. n