# Geocode reverso

#### 2026-05-23

# Geolocalização reversa: de coordenadas espaciais para endereços

A função `geocode_reverso()` permite fazer geolocalização reversa, isto é, a partir de um conjunto de coordenadas geográficas, encontrar os endereços correspondentes ou próximos. Essa funcionalidade pode ser útil, por exemplo, para identificar endereços próximos a pontos de interesse, como escolas, hospitais, ou locais de acidentes.

A função recebe como input um objeto espacial `sf` com geometria do tipo `POINT`. O resultado é um data frame com o endereço encontrado mais próximo de cada ponto de input, onde a coluna `"distancia_metros"` indica a distância entre coordenadas originais e os endereços encontrados.

    library(geocodebr)
    library(sf)
    #> Warning: package 'sf' was built under R version 4.5.3
    #> Linking to GEOS 3.14.1, GDAL 3.12.1, PROJ 9.7.1; sf_use_s2() is TRUE

    # amostra de pontos espaciais
    pontos <- readRDS(
      system.file("extdata/pontos.rds", package = "geocodebr")
    )

    pontos <- pontos[1:20,]

    # geocode reverso
    df_enderecos <- geocodebr::geocode_reverso(
      pontos = pontos,
      dist_max = 1000,
      verboso = FALSE,
      n_cores = 1
    )

    head(df_enderecos)
    #> Simple feature collection with 3 features and 8 fields
    #> Geometry type: POINT
    #> Dimension:     XY
    #> Bounding box:  xmin: -51.49634 ymin: -19.29416 xmax: -39.92601 ymax: 0.3649148
    #> Geodetic CRS:  SIRGAS 2000
    #> # A tibble: 3 × 9
    #>      id estado municipio  logradouro    numero cep   localidade distancia_metros
    #>   <int> <chr>  <chr>      <chr>          <int> <chr> <chr>                 <dbl>
    #> 1     1 ES     PANCAS     CORREGO BOA …     32 2975… LAJINHA                561.
    #> 2    11 ES     SAO MATEUS RODOVIA SAO …      6 2994… KM 13                  373.
    #> 3    17 AP     SANTANA    RAMAL MATAO …     14 6892… PIACACA                365.
    #> # ℹ 1 more variable: geometry <POINT [°]>

Por padrão, a função busca pelo endereço mais próximo num raio aproximado de 1000 metros. No entanto, o usuário pode ajustar esse valor usando o parâmetro `dist_max` para definir a distância máxima (em metros) de busca. Se um ponto de input não tiver nenhum endereço próximo dentro do raio de busca, o ponto não é incluído no output.

Nota: A função `geocode_reverso()` requer que os dados do CNEFE estejam armazenados localmente. A primeita vez que a função é executada, ela baixa os dados do CNEFE e salva em um cache local na sua máquina. No total, esses dados somam cerca de 3 GB, o que pode fazer com que a primeira execução da função demore. Esses dados, no entanto, são salvos de forma persistente, logo eles são baixados uma única vez. Mais informações sobre o cache de dados aqui.